旺店通·企业版原始订单新增_v1接口

所属平台: 旺店通·企业版
类型: WebAPI
作用: EXECUTE
接口版本: 0.1
适配器: \Adapter\Wdt\WdtExecuteAdapter
授权方式: OTHER
更新日期: 2022-10-19

原始订单新增_v1

POSTtrade_push

加工厂

{
  "operation": {
    "method": "none"
  }
}

接口请求参数

序号	字段	名称	类型	默认值	必填	描述
1	tid	原始单号	string	{{FBillNo}}{{FSOStockId_FNumber}}	可选	指商城、官网等平台的订单编号，ERP称之为原始单号，同一个sid下通过本接口新增订单的tid保证唯一。
2	trade_status	平台状态	string	30	可选	平台订单状态较多且涉及变更，详情介绍单击这里
3	pay_status	支付状态	string	2	可选	平台订单付款状态:0:未付款,1:部分付款,2:已付款
4	delivery_term	发货条件	string	1	可选	1:款到发货,2:货到付款(包含部分货到付款),3:分期付款,4:挂账
5	trade_time	下单时间	string	{{FDate}}	可选	平台订单创建时间,时间格式：yyyy-MM-dd HH:mm:ss
6	pay_time	支付时间	string	{{FDate}}	可选	平台订单付款时间,时间格式：yyyy-MM-dd HH:mm:ss，未付款订单为:0000-00-00 00:00:00
7	fenxiao_type	分销类别	string	0	可选	0非分销订单 1转供销 2代销 3经销
8	purchase_id	采购单ID	string		可选	转供销情况下，采购单ID
9	fenxiao_nick	分销商id	string		可选	分销订单的分销商id,或转供销时供应商id
10	buyer_nick	客户网名	string	{{FCustId_FName}}	可选	平台买家昵称，注意：一次推送网名相同的订单不能超过30
11	buyer_email	买家email	string		可选	买家email
12	pay_id	支付单号	string		可选	支付单号
13	pay_account	支付账号	string		可选	支付账号
14	receiver_name	收件人	string	{{FLINKMAN}}	可选	收件人姓名
15	receiver_address	地址详情	string	{{F_ora_FADDRESS}}	可选	收件人地址详情
16	receiver_province	省份	string	{{F_ora_sheng}}	可选	收件人省份
17	receiver_city	城市	string	{{F_ora_shi}}	可选	收件人城市
18	receiver_district	区县	string	{{F_ora_qu}}	可选	收件人区县
19	receiver_mobile	手机	string	{{FLINKPHONE}}	可选	手机号码
20	receiver_telno	电话	string	{{FLINKPHONE}}	可选	电话号码
21	receiver_zip	邮编	string		可选	收件人邮编
22	logistics_type	物流方式	string	-1	可选	不传本参数，输入值默认-1，表示由ERP系统策略选择。平台指定订单发货物流可选输入值单击这里
23	invoice_kind	发票类别	string	0	可选	0:不需要,1:普通发票,2:增值税普通发票电子,3:增值税普通发票纸质,4:增值税专用发票
24	invoice_title	发票抬头	string		可选	发票抬头
25	invoice_content	发票内容	string		可选	常见内容：纳税人识别号、地址、电话、开户银行、银行账户，按照以下格式推送，系统开发票时可解析。
26	remark_flag	客户备注标旗	string		可选	客户备注标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0
27	buyer_message	买家备注	string	{{FNote}}	可选	买家下单时填写的订单备注
28	seller_memo	客服备注	string	{{FCustId_FName}}	可选	商家客服对订单进行的备注内容
29	seller_flag	标旗	string	0	可选	客服标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0
30	post_amount	邮费	string	0	可选	商家收取买家的物流或者快递费用
31	cod_amount	货到付款金额	string	0	可选	货到付款金额
32	ext_cod_fee	货到付款买家费用	string	0	可选	货到付款买家费用，扣除货到付款订单金额后，卖家仍需支付的货到付款其他金额。这个钱卖家收不回来，是快递公司直接收走，但在快递单里是要打印出来，否则快递收款就错了
33	other_amount	其它收费	string	0	可选	其它应从买家收取的服务费，其他费用
34	paid	已付	string	{{FAllAmount}}	可选	订单已付金额，paid计算公式：paid = Σ(price * num + adjust_amount -discount – share_discount）+ post_amount+other_amount，所有金额相关字段推送处理办法，单击这里
35	is_auto_wms	自动流转模式	string	0	可选	是否为自动流转模式（1：是 0：不是不传默认0），非自动流转模式一定不要传值。自动流转模式处理办法，”自动流转模式处理办法详解”)单击这里
36	warehouse_no	仓库编号	string	{{FSOStockId_FNumber}}	可选	ERP内自定义的仓库编号，查看路径ERP→设置→基本设置→仓库→仓库列表，测试环境仓库编号查看测试环境分配邮件。平台订单需指定ERP内仓库时，传哪个仓库的编号，ERP将为订单选择哪个仓库。
37	order_list	订单货品明细节点	array	details_list	可选	货品明细列表（子订单列表）节点
37.1	oid	子订单编号	string	{{details_list.FSaleOrderEntry_FEntryID}}	可选	平台订单货品表主键,子订单唯一标识,同一个sid下通过本接口新增订单的oid（子订单编号）要保证唯一；如果oid重复,ERP生成系统单（递交）时会提示“订单货品数量不一致xxxxxx”
37.2	num	数量	string	{{details_list.FQty}}	可选	货品数量，订单推送成功以后本字段值不能更改
37.3	price	单价	string	{{details_list.FTaxPrice}}	可选	标价,折扣前的价格,可以推送价格为0的商品。订单推送成功以后本字段值不能更改
37.4	status	状态	string	30	可选	平台子订单状态，子订单状态可以和主订单不一样，比如其中一个子订单退款完成，其状态是80，但主订单仍然是待发货，可选值同trade_status
37.5	refund_status	退款状态	string	0	可选	0:无退款,1:取消退款,2:已申请退款,3:等待退货,4:等待收货,5:退款成功。本字段在售前退款的时候，根据不同的场景填写不同的值，eg：申请退款值为2，取消退款值为1……
37.6	goods_id	平台货品ID	string	{{details_list.FMaterialId_Fnumber}}	可选	平台系统货品（SPU）的唯一标识。goods_id不能为空，SPU和SKU概念介绍，单击这里
37.7	spec_id	平台规格ID	string	{{details_list.FMaterialId_Fnumber}}	可选	平台系统单品（SKU）的的唯一标识，尽量不为空，SPU和SKU概念介绍，单击这里
37.8	goods_no	货品编码	string	{{details_list.FMaterialId_Fnumber}}	可选	平台货品SPU编码，对应ERP货品编号，尽量不为空
37.9	spec_no	规格编码	string	{{details_list.FMaterialId_Fnumber}}	可选	平台货品SKU唯一码，对应ERP商家编码，goods_no和spec_no不能同时为空
37.10	goods_name	货品名称	string	{{details_list.FMaterialName}}	可选	平台货品名称
37.11	spec_name	规格名称	string		可选	平台货品规格名称
37.12	adjust_amount	调整	string	0	可选	客服调整总金额(大于0加价，小于0减价，是折扣来源的一部分,没有传0)
37.13	discount	优惠	string	0	可选	下单总折扣，客户下单时折扣(比如促销打折，不包含客服调整、分摊折扣，没有传0)
37.14	share_discount	分摊优惠	string	0	可选	分摊总折扣，由总订单分摊而来，一般是付款时产生，如使用优惠券，没有传0。分摊优惠传值注意：例如三个商品，优惠10，分摊优惠可以是：3/3/4，或者3.33/3.33/3.34.即最后一个商品的分摊优惠使用减法计算
37.15	remark	备注	string	{{details_list.FAllAmount}}	可选	货品明细备注推送此字段ERP客户端需升级至V2.3.9.2及以上
37.16	cid	类目	string		可选	平台货品所属类目

接口响应参数

暂无参数说明

旺店通·企业版的接口：原始订单新增_v1（trade_push），由轻易云数据集成平台 API 资产管理模块整理收纳，并随旺店通·企业版版本更新同步更新。

需要对接这个接口？

轻易云已预置该接口的适配能力，联系我们即可开始配置数据集成。

联系我们