接口配置打通金蝶云星空和聚水潭数据对接接入系统：聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。目标系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。系统对接接口配置在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用聚水潭接口明细调用接口： orders.out.simple.query 接口名称：销售出库查询方法： POST 请求参数字段字段名称类型配置值 shop_id 店铺编码 string is_offline_shop shop_id为0且is_offline_shop为true查询线下店铺单据 string status 单据状态 string Confirmed modified_begin 修改开始时间 string {{LAST_SYNC_TIME datetime}} modified_end 修改结束时间 string {{CURRENT_TIME datetime}} so_ids 线上单号 string page_index 页数 string {{PAGINATION_START_PAGE}} page_size 每页行数 string {{PAGINATION_PAGE_SIZE}} 响应参数字段字段名称类型配置值 co_id 公司编号 string shop_id 店铺编号 string io_id 出库单号 string o_id 内部单号 string so_id 线上单号 string created 创建时间 string modified 修改时间 string status 状态 string order_type 单据类型 string invoice_title 发票抬头 string shop_buyer_id 买家帐号 string receiver_country 国家 string receiver_state 省 string receiver_city 市 string receiver_district 区 string receiver_town 街道 string receiver_address 地址 string receiver_name 收件人姓名 string receiver_phone 收件人手机 string receiver_mobile 收件人电话 string buyer_message 买家留言 string remark 备注 string is_cod 是否货到付款 string pay_amount 应付金额 string l_id 物流单号 string io_date 出库时间 string lc_id 快递公司编码 string stock_enabled 是否启用库存管理 string drp_co_id_from 分销商编号 string labels 标记多标签 string paid_amount 实付金额 string free_amount 优惠金额 string freight 运费 string weight 预估重量 string f_weight 实称重量 string merge_so_id 合并订单号 string wms_co_id 分仓编号 string business_staff 业务人员 string currency 货币类型 string items 商品集合 array items.ioi_id 子单号 string items.pic 图片 string items.sku_id 商品编码 string items.qty 数量 string items.name 商品名称 string items.properties_value 颜色规格 string items.sale_price 单价 string items.sale_amount 金额 string items.i_id 款式编码 string items.sale_base_price 原价 string items.batchs 批次集合 array items.batchs.batch_no 批次号 string items.batchs.sku_id 商品编码 string items.batchs.qty 数量 string items.batchs.product_date 批次日期 string items.batchs.supplier_id 供应商编号 string items.batchs.supplier_name 供应商名称 string items.batchs.expiration_date 有效期至 string items.batchs.sns 唯一码集合 array items.batchs.sns.sn 唯一码 string items.batchs.sns.pay_date 支付时间 string items.batchs.sns.code 错误码 string items.batchs.sns.issuccess true代表成功 string items.batchs.sns.msg 执行描述 string 金蝶云星空接口明细 API： batchSave NAME：销售出库新增 METHOD： POST 请求参数接口字段名称预设值 FBillTypeID 单据类型 DSXSCKD FBillNo 单据编号 {{o_id}} FDate 日期 {{io_date}} F_XC_ASSISTANT 快递公司 {{lc_id}} FSaleOrgId 销售组织 findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}} FCustomerID 客户 {{shop_id}} FStockOrgId 发货组织 100 FNote 备注 {{remark}} F_XC_TEXT4 订单标签 {{labels}} F_XC_Text6 业务员 {{order_staff_name}} FEntity 明细信息 items FEntity.FMaterialID 物料编码 {{items.sku_id}} FEntity.FRealQty 实发数量 {{items.qty}} FEntity.FLot 批号 {{items.batch_no}} FEntity.FProduceDate 生产日期 {{items.product_date}} FEntity.FPrice 单价 FEntity.FTaxPrice 含税单价 _function ({{items.sale_amount}}/{{items.calAmount}})*{{items.calPamount}}/{{items.qty}} FEntity.FEntryTaxRate 税率% FEntity.FOwnerTypeId 货主类型 BD_OwnerOrg FEntity.FOwnerId 货主 100 FEntity.FStockID 仓库 {{wms_co_id}} FEntity.FEntrynote 备注 FEntity.FIsFree 是否赠品 function case when '{{items.sale_price}}'='0' then 'true' when LOCATE('仔细','{{remark}}')>0 then 'true' else 'false' end FEntity.F_XC_TEXT1 快递单号 {{l_id}} FEntity.F_XC_Text 电商单号 _findCollection find so_id from 64023c69-0029-319b-932b-a5bce3416df4 where o_id={{o_id}} FEntity.FEXPIRYDATE 有效期至 {{items.expiration_date}} FEntity.SubHeadEntity 财务信息 FEntity.SubHeadEntity.FSettleOrgID 结算组织 _findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}} FEntity.SubHeadEntity.FSETTLECURRID 结算币别 PRE001 FEntity.SubHeadEntity.FormId 业务对象表单Id SAL_OUTSTOCK FEntity.SubHeadEntity.Operation 执行的操作 Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 true FEntity.SubHeadEntity.SubSystemId 系统模块 21 FEntity.SubHeadEntity.InterationFlags 允许负库存 STK_InvCheckResult FEntity.SubHeadEntity.BatchCount 服务端开启的线程数 5 数据对接效果可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。

接口配置打通金蝶云星空和聚水潭数据对接

刘培强qeasy

接口配置打通金蝶云星空和聚水潭数据对接

接入系统：聚水潭

聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。

目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

系统对接接口配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

聚水潭接口明细

调用接口：orders.out.simple.query
接口名称：销售出库查询
方法：POST

请求参数

字段	字段名称	类型	配置值
shop_id	店铺编码	string
is_offline_shop	shop_id为0且is_offline_shop为true查询线下店铺单据	string
status	单据状态	string	Confirmed
modified_begin	修改开始时间	string	{{LAST_SYNC_TIME datetime}}
modified_end	修改结束时间	string	{{CURRENT_TIME datetime}}
so_ids	线上单号	string
page_index	页数	string	{{PAGINATION_START_PAGE}}
page_size	每页行数	string	{{PAGINATION_PAGE_SIZE}}

响应参数

字段	字段名称	类型	配置值
co_id	公司编号	string
shop_id	店铺编号	string
io_id	出库单号	string
o_id	内部单号	string
so_id	线上单号	string
created	创建时间	string
modified	修改时间	string
status	状态	string
order_type	单据类型	string
invoice_title	发票抬头	string
shop_buyer_id	买家帐号	string
receiver_country	国家	string
receiver_state	省	string
receiver_city	市	string
receiver_district	区	string
receiver_town	街道	string
receiver_address	地址	string
receiver_name	收件人姓名	string
receiver_phone	收件人手机	string
receiver_mobile	收件人电话	string
buyer_message	买家留言	string
remark	备注	string
is_cod	是否货到付款	string
pay_amount	应付金额	string
l_id	物流单号	string
io_date	出库时间	string
lc_id	快递公司编码	string
stock_enabled	是否启用库存管理	string
drp_co_id_from	分销商编号	string
labels	标记	多标签	string
paid_amount	实付金额	string
free_amount	优惠金额	string
freight	运费	string
weight	预估重量	string
f_weight	实称重量	string
merge_so_id	合并订单号	string
wms_co_id	分仓编号	string
business_staff	业务人员	string
currency	货币类型	string
items	商品集合	array
items.ioi_id	子单号	string
items.pic	图片	string
items.sku_id	商品编码	string
items.qty	数量	string
items.name	商品名称	string
items.properties_value	颜色规格	string
items.sale_price	单价	string
items.sale_amount	金额	string
items.i_id	款式编码	string
items.sale_base_price	原价	string
items.batchs	批次集合	array
items.batchs.batch_no	批次号	string
items.batchs.sku_id	商品编码	string
items.batchs.qty	数量	string
items.batchs.product_date	批次日期	string
items.batchs.supplier_id	供应商编号	string
items.batchs.supplier_name	供应商名称	string
items.batchs.expiration_date	有效期至	string
items.batchs.sns	唯一码集合	array
items.batchs.sns.sn	唯一码	string
items.batchs.sns.pay_date	支付时间	string
items.batchs.sns.code	错误码	string
items.batchs.sns.issuccess	true代表成功	string
items.batchs.sns.msg	执行描述	string

金蝶云星空接口明细

API：batchSave
NAME：销售出库新增
METHOD：POST

请求参数

接口字段	名称	预设值
FBillTypeID	单据类型	DSXSCKD
FBillNo	单据编号	{{o_id}}
FDate	日期	{{io_date}}
F_XC_ASSISTANT	快递公司	{{lc_id}}
FSaleOrgId	销售组织	findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}}
FCustomerID	客户	{{shop_id}}
FStockOrgId	发货组织	100
FNote	备注	{{remark}}
F_XC_TEXT4	订单标签	{{labels}}
F_XC_Text6	业务员	{{order_staff_name}}
FEntity	明细信息	items
FEntity.FMaterialID	物料编码	{{items.sku_id}}
FEntity.FRealQty	实发数量	{{items.qty}}
FEntity.FLot	批号	{{items.batch_no}}
FEntity.FProduceDate	生产日期	{{items.product_date}}
FEntity.FPrice	单价
FEntity.FTaxPrice	含税单价	_function ({{items.sale_amount}}/{{items.calAmount}})*{{items.calPamount}}/{{items.qty}}
FEntity.FEntryTaxRate	税率%
FEntity.FOwnerTypeId	货主类型	BD_OwnerOrg
FEntity.FOwnerId	货主	100
FEntity.FStockID	仓库	{{wms_co_id}}
FEntity.FEntrynote	备注
FEntity.FIsFree	是否赠品	function case when '{{items.sale_price}}'='0' then 'true' when LOCATE('仔细','{{remark}}')>0 then 'true' else 'false' end
FEntity.F_XC_TEXT1	快递单号	{{l_id}}
FEntity.F_XC_Text	电商单号	_findCollection find so_id from 64023c69-0029-319b-932b-a5bce3416df4 where o_id={{o_id}}
FEntity.FEXPIRYDATE	有效期至	{{items.expiration_date}}
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgID	结算组织	_findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}}
FEntity.SubHeadEntity.FSETTLECURRID	结算币别	PRE001
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_OUTSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	true
FEntity.SubHeadEntity.SubSystemId	系统模块	21
FEntity.SubHeadEntity.InterationFlags	允许负库存	STK_InvCheckResult
FEntity.SubHeadEntity.BatchCount	服务端开启的线程数	5

数据对接效果

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。