数据源系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
目标系统:旺店通·企业版
旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展
数据接口配置
在轻易云平台进行集成方案的配置时,为了实现快速搭建,轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案,参考市场主流所进行的字段配置完成集成方案的自定义化快速配置,即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置,让配置更加清晰,首先确定该方方案的对接内容,第二歩获取筛选数据源平台的数据,第三步数据源与写入目标形成映射关系配置。完成配置后一键启用
金蝶云星空接口明细
调用接口:executeBillQuery
接口名称:销售出库单查询
方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
FBillNo | 单据编号 | string | FBillNo |
FDate | 日期 | string | FDate |
FSaleOrgId_FNumber | 销售组织 | string | FSaleOrgId.FNumber |
FCustomerID_FNumber | 客户 | string | FCustomerID.FNumber |
FCarriageNO | 运输单号 | string | FCarriageNO |
FStockOrgId_FNumber | 发货组织 | string | FStockOrgId.FNumber |
FLinkPhone | 联系电话 | string | FLinkPhone |
FLinkMan | 收货人姓名 | string | FLinkMan |
FReceiveAddress | 收货方地址 | string | FReceiveAddress |
FSettleTypeID_FNumber | 结算方式 | string | FSettleTypeID.FNumber |
FReceiverAddress | 收货人地址 | string | FReceiverAddress |
FReceiverMobile | 收货人手机 | string | FReceiverMobile |
FReceiverCountry | 收货人国家 | string | FReceiverCountry |
FReceiverState | 收货人省份 | string | FReceiverState |
FReceiverCity | 收货人城市 | string | FReceiverCity |
FReceiverDistrict | 收货人地区 | string | FReceiverDistrict |
FReceiverPhone | 收货人电话 | string | FReceiverPhone |
FSHOPNUMBER | 网店编码 | string | FSHOPNUMBER |
FSALECHANNEL | 销售渠道 | string | FSALECHANNEL |
FVIPCODE | 会员编码 | string | FVIPCODE |
FCustMatID_FNumber | 客户物料编码 | string | FCustMatID.FNumber |
FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
FBarcode | 零售条形码 | string | FBarcode |
FMustQty | 应发数量 | string | FMustQty |
FRealQty | 实发数量 | string | FRealQty |
FPrice | 单价 | string | FPrice |
FTaxPrice | 含税单价 | string | FTaxPrice |
FIsFree | 是否赠品 | string | FIsFree |
FLot | 批号 | string | FLot |
FProduceDate | 生产日期 | string | FProduceDate |
FExpiryDate | 有效期至 | string | FExpiryDate |
FEntryTaxRate | 税率% | string | FEntryTaxRate |
FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
FAmount | 金额 | string | FAmount |
FAllAmount | 价税合计 | string | FAllAmount |
FStockID_FNumber | 仓库 | string | FStockID.FNumber |
FStockStatusID_FNumber | 库存状态 | string | FStockStatusID.FNumber |
FMtoNo | 计划跟踪号 | string | FMtoNo |
FEntrynote | 备注 | string | FEntrynote |
FSrcType | 源单类型 | string | FSrcType |
FSrcBillNo | 源单编号 | string | FSrcBillNo |
FSoorDerno | 订单单号 | string | FSoorDerno |
FDiscountRate | 折扣率% | string | FDiscountRate |
FDiscount | 折扣额 | string | FDiscount |
FPriceDiscount | 单价折扣 | string | FPriceDiscount |
FSOEntryId | 销售订单EntryId | string | FSOEntryId |
FB2CORDERDETAILID | B2C订单明细Id | string | FB2CORDERDETAILID |
FThirdEntryId | 管易订单单号 | string | FThirdEntryId |
FETHIRDBILLID | 第三方单据ID | string | FETHIRDBILLID |
FETHIRDBILLNO | 第三方单据编号 | string | FETHIRDBILLNO |
FGYFINDate | 管易到账时间 | string | FGYFINDate |
Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
TopRowCount | 返回总行数 | int | |
FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FSaleOrgId.FNumber ='100' |
FieldKeys | 需查询的字段key集合 | array | |
FormId | 业务对象表单Id | string | SAL_OUTSTOCK |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
FBillNo | 单据编号 | string | FBillNo |
FDate | 日期 | string | FDate |
FSaleOrgId_FNumber | 销售组织 | string | FSaleOrgId.FNumber |
FCustomerID_FNumber | 客户 | string | FCustomerID.FNumber |
FCarriageNO | 运输单号 | string | FCarriageNO |
FStockOrgId_FNumber | 发货组织 | string | FStockOrgId.FNumber |
FLinkPhone | 联系电话 | string | FLinkPhone |
FLinkMan | 收货人姓名 | string | FLinkMan |
FReceiveAddress | 收货方地址 | string | FReceiveAddress |
FSettleTypeID_FNumber | 结算方式 | string | FSettleTypeID.FNumber |
FReceiverAddress | 收货人地址 | string | FReceiverAddress |
FReceiverMobile | 收货人手机 | string | FReceiverMobile |
FReceiverCountry | 收货人国家 | string | FReceiverCountry |
FReceiverState | 收货人省份 | string | FReceiverState |
FReceiverCity | 收货人城市 | string | FReceiverCity |
FReceiverDistrict | 收货人地区 | string | FReceiverDistrict |
FReceiverPhone | 收货人电话 | string | FReceiverPhone |
FSHOPNUMBER | 网店编码 | string | FSHOPNUMBER |
FSALECHANNEL | 销售渠道 | string | FSALECHANNEL |
FVIPCODE | 会员编码 | string | FVIPCODE |
FCustMatID_FNumber | 客户物料编码 | string | FCustMatID.FNumber |
FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
FBarcode | 零售条形码 | string | FBarcode |
FMustQty | 应发数量 | string | FMustQty |
FRealQty | 实发数量 | string | FRealQty |
FPrice | 单价 | string | FPrice |
FTaxPrice | 含税单价 | string | FTaxPrice |
FIsFree | 是否赠品 | string | FIsFree |
FLot | 批号 | string | FLot |
FProduceDate | 生产日期 | string | FProduceDate |
FExpiryDate | 有效期至 | string | FExpiryDate |
FEntryTaxRate | 税率% | string | FEntryTaxRate |
FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
FAmount | 金额 | string | FAmount |
FAllAmount | 价税合计 | string | FAllAmount |
FStockID_FNumber | 仓库 | string | FStockID.FNumber |
FStockStatusID_FNumber | 库存状态 | string | FStockStatusID.FNumber |
FMtoNo | 计划跟踪号 | string | FMtoNo |
FEntrynote | 备注 | string | FEntrynote |
FSrcType | 源单类型 | string | FSrcType |
FSrcBillNo | 源单编号 | string | FSrcBillNo |
FSoorDerno | 订单单号 | string | FSoorDerno |
FDiscountRate | 折扣率% | string | FDiscountRate |
FDiscount | 折扣额 | string | FDiscount |
FPriceDiscount | 单价折扣 | string | FPriceDiscount |
FSOEntryId | 销售订单EntryId | string | FSOEntryId |
FB2CORDERDETAILID | B2C订单明细Id | string | FB2CORDERDETAILID |
FThirdEntryId | 管易订单单号 | string | FThirdEntryId |
FETHIRDBILLID | 第三方单据ID | string | FETHIRDBILLID |
FETHIRDBILLNO | 第三方单据编号 | string | FETHIRDBILLNO |
FGYFINDate | 管易到账时间 | string | FGYFINDate |
旺店通·企业版接口明细
接口:trade_push
接口名称:原始订单新增
接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
tid | 原始单号 | string | 指商城、官网等平台的订单编号,ERP称之为原始单号,同一个sid下通过本接口新增订单的tid保证唯一。 |
trade_status | 平台状态 | string | 平台订单状态较多且涉及变更,详情介绍单击这里 |
pay_status | 支付状态 | string | 平台订单付款状态:0:未付款,1:部分付款,2:已付款 |
delivery_term | 发货条件 | string | 1:款到发货,2:货到付款(包含部分货到付款),3:分期付款,4:挂账 |
trade_time | 下单时间 | string | 平台订单创建时间,时间格式:yyyy-MM-dd HH:mm:ss |
pay_time | 支付时间 | string | 平台订单付款时间,时间格式:yyyy-MM-dd HH:mm:ss,未付款订单为:0000-00-00 00:00:00 |
fenxiao_type | 分销类别 | string | 0非分销订单 1转供销 2代销 3经销 |
purchase_id | 采购单ID | string | 转供销情况下,采购单ID |
fenxiao_nick | 分销商id | string | 分销订单的分销商id,或转供销时供应商id |
buyer_nick | 客户网名 | string | 平台买家昵称,注意:一次推送网名相同的订单不能超过30 |
buyer_email | 买家email | string | 买家email |
pay_id | 支付单号 | string | 支付单号 |
pay_account | 支付账号 | string | 支付账号 |
receiver_name | 收件人 | string | 收件人姓名 |
receiver_address | 地址详情 | string | 收件人地址详情 |
receiver_province | 省份 | string | 收件人省份 |
receiver_city | 城市 | string | 收件人城市 |
receiver_district | 区县 | string | 收件人区县 |
receiver_mobile | 手机 | string | 手机号码 |
receiver_telno | 电话 | string | 电话号码 |
receiver_zip | 邮编 | string | 收件人邮编 |
logistics_type | 物流方式 | string | 不传本参数,输入值默认-1,表示由ERP系统策略选择。平台指定订单发货物流可选输入值单击这里 |
invoice_kind | 发票类别 | string | 0:不需要,1:普通发票,2:增值税普通发票电子,3:增值税普通发票纸质,4:增值税专用发票 |
invoice_title | 发票抬头 | string | 发票抬头 |
invoice_content | 发票内容 | string | 常见内容:纳税人识别号、地址、电话、开户银行、银行账户,按照以下格式推送,系统开发票时可解析。 |
remark_flag | 客户备注标旗 | string | 客户备注标旗,取值0至5对应的标旗颜色依次为灰(无标旗)、红、黄、绿、蓝、紫,不传默认0 |
buyer_message | 买家备注 | string | 买家下单时填写的订单备注 |
seller_memo | 客服备注 | string | 商家客服对订单进行的备注内容 |
seller_flag | 标旗 | string | 客服标旗,取值0至5对应的标旗颜色依次为灰(无标旗)、红、黄、绿、蓝、紫,不传默认0 |
post_amount | 邮费 | string | 商家收取买家的物流或者快递费用 |
cod_amount | 货到付款金额 | string | 货到付款金额 |
ext_cod_fee | 货到付款买家费用 | string | 货到付款买家费用,扣除货到付款订单金额后,卖家仍需支付的货到付款其他金额。这个钱卖家收不回来,是快递公司直接收走,但在快递单里是要打印出来,否则快递收款就错了 |
other_amount | 其它收费 | string | 其它应从买家收取的服务费,其他费用 |
paid | 已付 | string | 订单已付金额,paid计算公式:paid = Σ(price * num + adjust_amount -discount – share_discount)+ post_amount+other_amount,所有金额相关字段推送处理办法,单击这里 |
is_auto_wms | 自动流转模式 | string | 是否为自动流转模式(1:是 0:不是 不传默认0),非自动流转模式一定不要传值。自动流转模式处理办法,”自动流转模式处理办法详解”)单击这里 |
warehouse_no | 仓库编号 | string | ERP内自定义的仓库编号,查看路径ERP→设置→基本设置→仓库→仓库列表,测试环境仓库编号查看测试环境分配邮件。平台订单需指定ERP内仓库时,传哪个仓库的编号,ERP将为订单选择哪个仓库。 |
order_list | 订单货品明细节点 | array | 货品明细列表(子订单列表)节点 |
order_list.oid | 子订单编号 | string | 平台订单货品表主键,子订单唯一标识,同一个sid下通过本接口新增订单的oid(子订单编号)要保证唯一;如果oid重复,ERP生成系统单(递交)时会提示“订单货品数量不一致xxxxxx” |
order_list.num | 数量 | string | 货品数量,订单推送成功以后本字段值不能更改 |
order_list.price | 单价 | string | 标价,折扣前的价格,可以推送价格为0的商品。订单推送成功以后本字段值不能更改 |
order_list.status | 状态 | string | 平台子订单状态,子订单状态可以和主订单不一样,比如其中一个子订单退款完成,其状态是80,但主订单仍然是待发货,可选值同trade_status |
order_list.refund_status | 退款状态 | string | 0:无退款,1:取消退款,2:已申请退款,3:等待退货,4:等待收货,5:退款成功。本字段在售前退款的时候,根据不同的场景填写不同的值,eg:申请退款值为2,取消退款值为1…… |
order_list.goods_id | 平台货品ID | string | 平台系统货品(SPU)的唯一标识。goods_id不能为空,SPU和SKU概念介绍,单击这里 |
order_list.spec_id | 平台规格ID | string | 平台系统单品(SKU)的的唯一标识,尽量不为空,SPU和SKU概念介绍,单击这里 |
order_list.goods_no | 货品编码 | string | 平台货品SPU编码,对应ERP货品编号,尽量不为空 |
order_list.spec_no | 规格编码 | string | 平台货品SKU唯一码,对应ERP商家编码,goods_no和spec_no不能同时为空 |
order_list.goods_name | 货品名称 | string | 平台货品名称 |
order_list.spec_name | 规格名称 | string | 平台货品规格名称 |
order_list.adjust_amount | 调整 | string | 客服调整总金额(大于0加价,小于0减价,是折扣来源的一部分,没有传0) |
order_list.discount | 优惠 | string | 下单总折扣,客户下单时折扣(比如促销打折,不包含客服调整、分摊折扣,没有传0) |
order_list.share_discount | 分摊优惠 | string | 分摊总折扣,由总订单分摊而来,一般是付款时产生,如使用优惠券,没有传0。分摊优惠传值注意:例如三个商品,优惠10,分摊优惠可以是:3/3/4,或者3.33/3.33/3.34.即最后一个商品的分摊优惠使用减法计算 |
order_list.remark | 备注 | string | 货品明细备注推送此字段ERP客户端需升级至V2.3.9.2及以上 |
order_list.cid | 类目 | string | 平台货品所属类目 |
order_list.trade_list | trade_list | string | 0:非严格模式,1:严格模式,默认1。 |
order_list.shop_no | shop_no | string | |
order_list.switch | switch | string |
数据对接效果
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与旺店通·企业版之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。