旺店通·企业版原始订单新增_v1API接口文档

所属平台： 旺店通·企业版
类型： WebAPI
作用： EXECUTE
接口版本： 0.1
适配器： \Adapter\Wdt\WdtExecuteAdapter
帮助链接：
描述：
更新日期： 2022-10-19 11:12:29
原始订单新增_v1

接口地址：trade_push

请求方法： POST

加工厂： {"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资产管理模块整理收纳，并且根据旺店通·企业版版本更新同步实时更新。API资产管理平台支持API的市场推广和商业化，帮助企业发掘API的商业价值，拓展新的收入来源和业务模式。
联系轻易云集成专家
联系系统对接开发人员何海波

何海波 加微信

18175716035

轻易云的技术专家，拥有丰富的数据集成规划经验。他能够为客户提供专业、全面的数据集成规划方案，熟练掌握多种集成技术和工具，帮助企业在数据集成领域得到长远发展。

数据集成平台架构
更多系统对接方案