金蝶云星空和聚水潭·奇门单据接口集成

对接源平台:聚水潭·奇门
聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。
接通系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
数据对接方案
在轻易云平台进行集成方案的配置时,为了实现快速搭建,轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案,参考市场主流所进行的字段配置完成集成方案的自定义化快速配置,即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置,让配置更加清晰,首先确定该方方案的对接内容,第二歩获取筛选数据源平台的数据,第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

聚水潭·奇门接口明细
- API:jushuitan.saleout.list.query
- NAME:查询销售出库单列表
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
page_index | 页数 | 1 | 第几页,从第一页开始,默认1 |
page_size | 每页行数 | 50 | 每页多少条,默认25,最大25 |
start_time | 修改开始时间 | {{LAST_SYNC_TIME datetime}} | 修改起始时间,和结束时间必须同时存在,时间间隔不能超过七天,与线上单号不能同时为空 |
end_time | 修改结束时间 | {{CURRENT_TIME datetime}} | 修改结束时间,和起始时间必须同时存在,时间间隔不能超过七天,与线上单号不能同时为空 |
status | 单据状态 | Confirmed | 单据状态: WaitConfirm=待出库; Confirmed=已出库; Cancelled=作废 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
co_id | 公司编号 | | 公司编号 |
shop_id | 店铺编号 | | 店铺编号 |
io_id | 出库单号 | | 出库单号 |
o_id | 内部单号 | | 内部单号 |
so_id | 线上单号 | | 线上单号 |
created | 创建时间 | | 创建时间 |
modified | 修改时间 | | 修改时间 |
status | 状态 | | 状态;Archive:归档,WaitConfirm:待出库,Confirmed:已出库,Cancelled:取消,Delete:作废,OuterConfirming:外部发货中 |
order_type | 单据类型 | | 单据类型 |
invoice_title | 发票抬头 | | 发票抬头 |
shop_buyer_id | 买家帐号 | | 买家帐号 |
receiver_country | 国家 | | 国家 |
receiver_state | 省 | | 省 |
receiver_city | 市 | | 市 |
receiver_district | 区 | | 区 |
receiver_town | 街道 | | 街道 |
receiver_address | 地址 | | 地址 |
receiver_name | 收件人姓名 | | 收件人姓名 |
receiver_phone | 收件人手机 | | 收件人手机 |
receiver_mobile | 收件人电话 | | 收件人电话 |
buyer_message | 买家留言 | | 买家留言 |
remark | 备注 | | 备注 |
is_cod | 是否货到付款 | | 是否货到付款 |
pay_amount | 应付金额 | | 应付金额 |
l_id | 物流单号 | | 物流单号 |
io_date | 出库时间 | | 出库时间 |
lc_id | 快递公司编码 | | 快递公司编码 |
stock_enabled | 是否启用库存管理 | | 是否启用库存管理 |
drp_co_id_from | 分销商编号 | | 分销商编号 |
labels | 标记 | 多标签 | | 标记 多标签 |
paid_amount | 实付金额 | | 实付金额 |
free_amount | 优惠金额 | | 优惠金额 |
freight | 运费 | | 运费 |
weight | 预估重量 | | 预估重量 |
f_weight | 实称重量 | | 实称重量 |
merge_so_id | 合并订单号 | | 合并订单号 |
wms_co_id | 分仓编号 | | 分仓编号 |
business_staff | 业务人员 | | 业务人员 |
currency | 货币类型 | | 货币类型 |
items | 商品集合 | | 商品集合 |
items.ioi_id | 子单号 | | 子单号 |
items.pic | 图片 | | 图片 |
items.sku_id | 商品编码 | | 商品编码 |
items.qty | 数量 | | 数量 |
items.name | 商品名称 | | 商品名称 |
items.properties_value | 颜色规格 | | 颜色规格 |
items.sale_price | 单价 | | 单价 |
items.sale_amount | 金额 | | 金额 |
items.i_id | 款式编码 | | 款式编码 |
items.sale_base_price | 原价 | | 原价 |
items.is_gift | 是否赠品 | | |
items.batchs | 批次集合 | | 批次集合 |
items.batchs.batch_no | 批次号 | | 批次号 |
items.batchs.product_date | 批次日期 | | 批次日期 |
items.batchs.supplier_id | 供应商编号 | | 供应商编号 |
items.batchs.supplier_name | 供应商名称 | | 供应商名称 |
items.batchs.expiration_date | 有效期至 | | 有效期至 |
items.batchs.sns | 唯一码集合 | | 唯一码集合 |
items.batchs.sns.sn | 唯一码 | | 唯一码 |
items.batchs.sns.pay_date | 支付时间 | | 支付时间 |
items.batchs.sns.code | 错误码 | | 错误码 |
items.batchs.sns.issuccess | true代表成功 | | true代表成功 |
items.batchs.sns.msg | 执行描述 | | 执行描述 |
金蝶云星空接口明细
- API:batchSave
- NAME:销售出库单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillTypeID | 单据类型 | XSCKD01_SYS | 单据类型 |
FBillNo | 单据编号 | {{io_id}} | 单据编号 |
FDate | 日期 | {{io_date}} | 日期 |
FSaleOrgId | 销售组织 | 100 | 组织 |
FCustomerID | 客户 | {{shop_id}} | 基础资料 |
FCarriageNO | 运输单号 | {{l_id}} | 文本 |
FStockOrgId | 发货组织 | | 组织 |
FLinkPhone | 联系电话 | | 文本 |
FLinkMan | 收货人姓名 | | 文本 |
FReceiveAddress | 收货方地址 | | 文本 |
FEntity | 明细信息 | items | |
FEntity.FMaterialID | 物料编码 | {{items.i_id}} | 基础资料 |
FEntity.FTaxPrice | 含税单价 | {{items.sale_pric}} | 单价 |
FEntity.FRealQty | 实发数量 | {{items.qty}} | |
FEntity.FIsFree | 是否赠品 | _function case '{{items.sale_price}}' when '0.0' then 'true' else 'false' end | |
FEntity.FStockID | 仓库 | CK | |
FEntity.FAmount | 金额 | {{items.sale_amount}} | |
FEntity.SubHeadEntity | 财务信息 | | |
FEntity.SubHeadEntity.FReceiverAddress | 收货人地址 | | 文本 |
FEntity.SubHeadEntity.FReceiverName | 收货人 | | 文本 |
FEntity.SubHeadEntity.FReceiverMobile | 收货人手机 | | 文本 |
FEntity.SubHeadEntity.FAllDisCount | 整单折扣额 | {{free_amount}} | |
FEntity.SubHeadEntity.FNote | 备注 | | |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FEntity.SubHeadEntity.Operation | 执行的操作 | Save | |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | false | |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | true | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FEntity.SubHeadEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
FEntity.SubHeadEntity.BatchCount | 服务端开启的线程数 | 5 | |
数据对接价值
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。

