旺店通·企业版对接打通金蝶云星空订单查询接口与销售出库新增接口

旺店通·企业版对接打通金蝶云星空订单查询接口与销售出库新增接口

数据源平台:旺店通·企业版

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

接入系统：金蝶云星空

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

数据接口配置方案

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

旺店通·企业版接口明细

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

请求参数

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

响应参数

接口字段	字段名称	预设值	描述
trade_id	erp订单表的主键	trade_id
trade_no	订单编号	trade_no
platform_id	平台ID	platform_id
shop_no	店铺编号	shop_no
shop_name	店铺名称	shop_name
shop_remark	店铺备注	shop_remark
warehouse_type	仓库类型	warehouse_type
warehouse_no	仓库编号	warehouse_no
src_tids	原始单号	src_tids
trade_status	订单状态	trade_status
consign_status	发货状态	consign_status
trade_type	订单类型	trade_type
delivery_term	发货条件	delivery_term
freeze_reason	冻结原因	freeze_reason
refund_status	退款状态	refund_status
fenxiao_type	分销类别	fenxiao_type
fenxiao_nick	分销商名称	fenxiao_nick
trade_time	下单时间	trade_time
pay_time	付款时间	pay_time
customer_name	客户名称	customer_name
customer_no	客户编码	customer_no
pay_account	买家付款账号	pay_account
buyer_nick	客户网名	buyer_nick
receiver_name	收件人	buyer_nick
receiver_province	收件人省份	receiver_province
receiver_city	收件人城市	receiver_city
receiver_district	收件人地区	receiver_district
receiver_address	地址	receiver_address
receiver_mobile	手机	receiver_mobile
receiver_telno	电话	receiver_telno
receiver_zip	邮编	receiver_zip
receiver_area	省市县	receiver_area
receiver_ring	区域	receiver_ring
receiver_dtb	大头笔	receiver_dtb
to_deliver_time	派送时间	to_deliver_time
bad_reason	异常订单	bad_reason
logistics_id	物流公司ID	logistics_id
logistics_name	物流公司名称	logistics_name
logistics_code	物流公司编号	logistics_code
logistics_type	物流方式	logistics_type
logistics_no	物流单号	logistics_no
shop_id	店铺id	shop_id
warehouse_id	仓库id	warehouse_id
check_step	审核步骤	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	子单付款时间

金蝶云星空接口明细

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

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	{{FBillTypeID}}	单据类型
FBillNo	单据编号	{{FBillTypeID}}	单据编号
FDate	日期	{{FDate}}	日期
FSaleOrgId	销售组织	{{FSaleOrgId}}	组织
FCustomerID	客户	{{FCustomerID}}	基础资料
FCarriageNO	运输单号	FCarriageNO	文本
FStockOrgId	发货组织	FStockOrgId	组织
FLinkPhone	联系电话	FLinkPhone	文本
FLinkMan	收货人姓名	FLinkMan	文本
FReceiveAddress	收货方地址	FReceiveAddress	文本
SubHeadEntity	财务信息
SubHeadEntity.FSettleTypeID	结算方式	JSFS04_SYS	基础资料
SubHeadEntity.FReceiverAddress	收货人地址	FReceiverAddress	文本
SubHeadEntity.FReceiverName	收货人		文本
SubHeadEntity.FReceiverMobile	收货人手机	FReceiverMobile	文本
SubHeadEntity.FEntity	明细信息	FEntity
SubHeadEntity.FEntity.FMaterialID	物料编码	{{FEntity}}	基础资料
SubHeadEntity.FEntity.FRealQty	实发数量	{{FRealQty}}	数量
SubHeadEntity.FEntity.FTaxPrice	含税单价	FTaxPrice	单价
SubHeadEntity.FEntity.FStockID	仓库	FStockID	基础资料
SubHeadEntity.FEntity.FormId	业务对象表单Id	{{FormId}}	必须填写金蝶的表单ID如UR_PurchaseOrder
SubHeadEntity.FEntity.Operation	执行的操作	{{Operation}}
SubHeadEntity.FEntity.IsAutoSubmitAndAudit	提交并审核	{{IsAutoSubmitAndAudit}}
SubHeadEntity.FEntity.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
SubHeadEntity.FEntity.SubSystemId	系统模块	SubSystemId	默认仓库模块

系统对接概况

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