旺店通·企业版和金蝶云星空接口打通对接实战

旺店通·企业版和金蝶云星空接口打通对接实战

对接系统：旺店通·企业版

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

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

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

配置集成方案

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·企业版、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

旺店通·企业版接口明细

• API：trade_query
• NAME：订单查询
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
status	订单状态
start_time	开始时间	{{DAYS_AGO_1 datetime}}
end_time	结束时间	{{CURRENT_TIME datetime}}
src_tid	原始单号
trade_no	订单编号
shop_no	店铺编号
warehouse_no	仓库编号
goodstax	使用税率
has_logistics_no	物流单号限制
src	是否返回交易流水号、付款状态、付款时间
logistics_no	物流单号
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	{{PAGINATION_START_PAGE}}	不传值默认从0页开始

响应参数

接口字段	字段名称	预设值	描述
trade_id	erp订单表的主键
trade_no	订单编号
platform_id	平台ID
shop_no	店铺编号
shop_name	店铺名称
shop_remark	店铺备注
warehouse_type	仓库类型
warehouse_no	仓库编号
src_tids	原始单号
trade_status	订单状态
consign_status	发货状态
trade_type	订单类型
delivery_term	发货条件
freeze_reason	冻结原因
refund_status	退款状态
fenxiao_type	分销类别
fenxiao_nick	分销商名称
trade_time	下单时间
pay_time	付款时间
customer_name	客户名称
customer_no	客户编码
pay_account	买家付款账号
buyer_nick	客户网名
receiver_name	收件人
receiver_province	收件人省份
receiver_city	收件人城市
receiver_district	收件人地区
receiver_address	地址
receiver_mobile	手机
receiver_telno	电话
receiver_zip	邮编
receiver_area	省市县
receiver_ring	区域
receiver_dtb	大头笔
to_deliver_time	派送时间
bad_reason	异常订单
logistics_id	物流公司ID
logistics_name	物流公司名称
logistics_code	物流公司编号
logistics_type	物流方式
logistics_no	物流单号
shop_id	店铺id
warehouse_id	仓库id
check_step	审核步骤
unmerge_mask	未合并标记
delay_to_time	延迟处理
customer_type	客户类型
customer_id	买家id
receiver_country	收件人国家
pre_charge_time	预配送时间
is_prev_notify	是否京配
note_count	便签条数
buyer_message_count	买家留言条数
cs_remark_count	客服备注条数
cs_remark_change_count	客服备注变化
discount_change	优惠变化金额
trade_prepay	使用的预存款
pi_amount	分期付款金额
other_cost	其它成本
volume	体积
sales_score	销售积分
flag_id	标记id
is_sealed	不可合并拆分
gift_mask	赠品标记
split_from_trade_id	拆分订单，原单ID
logistics_template_id	物流单模板ID
sendbill_template_id	发货单模板id
revert_reason	驳回原因
cancel_reason	取消原因
is_unpayment_sms	催未付款订单消息发送标记
package_id	包装id
trade_mask	订单标记位
reserve	保留
large_type	大件类型
buyer_message	买家留言
cs_remark	客服备注
remark_flag	标旗
print_remark	打印备注
goods_type_count	货品种类数
goods_count	货品总数
goods_amount	货品总额
post_amount	邮资
other_amount	其它费用
discount	折扣
receivable	应收金额
dap_amount	款到发货金额
cod_amount	COD金额
ext_cod_fee	买家COD费用
goods_cost	货品预估成本
post_cost	邮资成本
paid	已付金额
weight	预估重量
profit	预估毛利
tax	税额
tax_rate	税率
commission	佣金
invoice_type	发票类型
invoice_title	发票抬头
invoice_content	发票内容
salesman_id	业务员
checker_id	审核人
fullname	业务员姓名
checker_name	审核人
fchecker_id	财审人
checkouter_id	签出人
stockout_no	出库单号
flag_name	标记名称
trade_from	订单来源
single_spec_no	货品商家编码
raw_goods_count	原始货品数量
raw_goods_type_count	原始货品种类数
currency	币种
split_package_num	线上包裹拆分数
invoice_id	发票ID
version_id	版本号
modified	最后修改时间
created	订单生成时间
id_card_type	证件类别
id_card	证件号码
goods_list	货品列表节点
goods_list.rec_id	erp子订单主键
goods_list.trade_id	erp订单主键
goods_list.spec_id	erp内商品主键
goods_list.platform_id	平台
goods_list.src_oid	子订单编号
goods_list.platform_goods_id	平台货品ID
goods_list.platform_spec_id	平台商品ID
goods_list.suite_id	组合装ID
goods_list.flag	区分子单拆分的唯一性标记
goods_list.src_tid	原始订单编号
goods_list.gift_type	赠品方式
goods_list.refund_status	退款状态
goods_list.guarantee_mode	担保方式
goods_list.delivery_term	发货条件
goods_list.bind_oid	关联发货
goods_list.num	下单数量
goods_list.price	标价
goods_list.actual_num	实发数量
goods_list.refund_num	售后退款数量
goods_list.order_price	成交价
goods_list.share_price	分摊后价格
goods_list.adjust	手工调整价
goods_list.discount	总折扣金额
goods_list.share_amount	分摊后总价
goods_list.share_post	分摊邮费
goods_list.paid	已付
goods_list.goods_name	货品名称
goods_list.prop2	自定义属性2
goods_list.barcode	主条码
goods_list.goods_id	货品id
goods_list.goods_no	货品编号
goods_list.spec_name	规格名
goods_list.spec_no	商家编码
goods_list.spec_code	规格码
goods_list.suite_no	组合装编码
goods_list.suite_name	拆自组合装
goods_list.suite_num	组合装数量
goods_list.suite_amount	组合装分摊后总价
goods_list.suite_discount	组合装优惠
goods_list.share_amount2	share_amount备份值
goods_list.is_print_suite	是否打印组合装
goods_list.is_zero_cost	是否允许0成本
goods_list.stock_reserved	库存保留情况
goods_list.is_consigned	平台已发货
goods_list.is_received	是否打款
goods_list.is_master	是否为主子订单
goods_list.api_goods_name	平台货品名称
goods_list.api_spec_name	平台规格名称
goods_list.weight	估重
goods_list.commission	佣金
goods_list.goods_type	货品类别
goods_list.large_type	大件类型
goods_list.invoice_type	发票类别
goods_list.invoice_content	发票内容
goods_list.from_mask	原始单标记
goods_list.cid	类目id
goods_list.remark	备注
goods_list.modified	最后修改时间
goods_list.created	创建时间
goods_list.tax_rate	税率
goods_list.base_unit_id	基本单位
goods_list.unit_name	基本单位名称
goods_list.pay_id	交易流水单号
goods_list.pay_status	子单付款状态
goods_list.pay_time	子单付款时间

金蝶云星空接口明细

• 调用接口：batchSave
• 接口名称：销售订单新增
• 方法：POST

请求参数

字段	字段名称	类型	配置值
FBillNo	单据编号	string
FSaleOrgId	销售组织	string	100
FDate	日期	string	{{trade_time}}
FCustId	客户	string	{{shop_no}}
FBillTypeID	单据类型	string	XSDD01_SYS
FNote	备注	string
FLinkMan	收货人姓名	string
FLinkPhone	联系电话	string
FSaleOrderEntry	订单明细	array
FSaleOrderEntry.FMaterialId	物料编码	string
FSaleOrderEntry.FQty	销售数量	string
FSaleOrderEntry.FPrice	单价	string
FSaleOrderEntry.FTaxPrice	含税单价	string
FSaleOrderEntry.FSettleOrgIds	结算组织	string	100
FSaleOrderEntry.FEntryNote	备注	string
FSaleOrderEntry.FSalerId	销售员	string	008_GW000002_100052
FSaleOrderEntry.FormId	业务对象表单Id	string	SAL_SaleOrder
FSaleOrderEntry.Operation	执行的操作	string	BatchSave
FSaleOrderEntry.IsAutoSubmitAndAudit	提交并审核	bool	true
FSaleOrderEntry.IsVerifyBaseDataField	验证基础资料	bool	false

系统对接总览

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