聚水潭和金蝶云星空接口打通对接实战对接系统：聚水潭聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。对接目标平台:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。配置集成方案异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取聚水潭的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。聚水潭接口明细调用接口： /open/orders/out/simple/query 接口名称：销售出库查询方法： POST 请求参数字段字段名称类型配置值 shop_id 店铺编码 string is_offline_shop shop_id为0且is_offline_shop为true查询线下店铺单据 string status 单据状态 string modified_begin 修改开始时间 string 2022-11-01 9:16:00 modified_end 修改结束时间 string 2022-11-01 9:16:59 so_ids 线上单号 string page_index 页数 string 1 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.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 单据类型 XSCKD01_SYS 单据类型 FBillNo 单据编号 {{io_id}} 单据编号 FDate 日期 {{io_date}} 日期 FSaleOrgId 销售组织 101 销售组织 FCustomerID 客户 {{shop_id}} 客户 FStockOrgId 发货组织 101 发货组织 FNote 备注 {{remark}} 备注 F_sms_Text3 聚水潭线上单号 {{so_id}} 备注 F_sms_Text31 聚水潭内部单号 {{o_id}} 备注 F_sms_Text32 聚水潭物流单号 {{l_id}} 备注 FEntity 明细信息 items 明细信息 FEntity.FMaterialId 物料编码 {{items.sku_id}} 物料编码 FEntity.FRealQty 实发数量 {{items.qty}} 实发数量 FEntity.FPrice 单价单价 FEntity.FTaxPrice 含税单价 {{items.sale_price}} 含税单价 FEntity.FIsFree 是否赠品 _function case '{{items.sale_price}}' when '0' then true else false end 是否赠品 FEntity.FEntryTaxRate 税率% 税率% FEntity.FAllAmount 价税合计价税合计 FEntity.FStockId 仓库 {{wms_co_id}} 仓库 FEntity.FEntrynote 备注备注 FEntity.F_sms_Text2 触发更新 1 FEntity.SubHeadEntity 财务信息财务信息 FEntity.SubHeadEntity.FSettleOrgId 结算组织 101 结算组织 FEntity.SubHeadEntity.FSETTLECURRID 结算币别 PRE001 结算币别 FEntity.SubHeadEntity.FAllDisCount 整单折扣额 {{free_amount}} 整单折扣额 FEntity.SubHeadEntity.FormId 业务对象表单Id SAL_OUTSTOCK 必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation 执行的操作 BatchSave FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录）系统对接总览从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

聚水潭和金蝶云星空接口打通对接实战

庄颜_qeasy

聚水潭和金蝶云星空接口打通对接实战

对接系统：聚水潭

聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。

对接目标平台:金蝶云星空

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

配置集成方案

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取聚水潭的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

聚水潭接口明细

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

请求参数

字段	字段名称	类型	配置值
shop_id	店铺编码	string
is_offline_shop	shop_id为0且is_offline_shop为true查询线下店铺单据	string
status	单据状态	string
modified_begin	修改开始时间	string	2022-11-01 9:16:00
modified_end	修改结束时间	string	2022-11-01 9:16:59
so_ids	线上单号	string
page_index	页数	string	1
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.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	单据类型	XSCKD01_SYS	单据类型
FBillNo	单据编号	{{io_id}}	单据编号
FDate	日期	{{io_date}}	日期
FSaleOrgId	销售组织	101	销售组织
FCustomerID	客户	{{shop_id}}	客户
FStockOrgId	发货组织	101	发货组织
FNote	备注	{{remark}}	备注
F_sms_Text3	聚水潭线上单号	{{so_id}}	备注
F_sms_Text31	聚水潭内部单号	{{o_id}}	备注
F_sms_Text32	聚水潭物流单号	{{l_id}}	备注
FEntity	明细信息	items	明细信息
FEntity.FMaterialId	物料编码	{{items.sku_id}}	物料编码
FEntity.FRealQty	实发数量	{{items.qty}}	实发数量
FEntity.FPrice	单价		单价
FEntity.FTaxPrice	含税单价	{{items.sale_price}}	含税单价
FEntity.FIsFree	是否赠品	_function case '{{items.sale_price}}' when '0' then true else false end	是否赠品
FEntity.FEntryTaxRate	税率%		税率%
FEntity.FAllAmount	价税合计		价税合计
FEntity.FStockId	仓库	{{wms_co_id}}	仓库
FEntity.FEntrynote	备注		备注
FEntity.F_sms_Text2	触发更新	1
FEntity.SubHeadEntity	财务信息		财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	101	结算组织
FEntity.SubHeadEntity.FSETTLECURRID	结算币别	PRE001	结算币别
FEntity.SubHeadEntity.FAllDisCount	整单折扣额	{{free_amount}}	整单折扣额
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_OUTSTOCK	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	BatchSave
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统对接总览

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。