shop_no | 店铺编号 | string | 代表店铺所有属性的唯一编码,用于店铺区分,ERP内支持自定义(ERP店铺界面设置,查看路径ERP→设置→基本设置→店铺→店铺列表),用于创建指定店铺单据信息,测试环境店铺编号信息同接口账号。ERP内shop_no对应的“店铺平台”必须为“自有”。正式环境店铺创建成功后ERP会自动授权,如果自动授权失败,在ERP店铺界面(路径ERP→设置→基本设置→店铺→店铺列表)选中授权失败的店铺,点击店铺界面提供的店铺授权按钮重新授权。 |
switch | 模式 | string | 0:非严格模式,1:严格模式,默认1。 |
trade_list | 订单列表节点 | array | 请求参数的1级数据节点,包含销售订单所有属性信息的数据节点,节点下数据字段详见下述“trade_list” |
trade_list.tid | 原始单号 | string | 指商城、官网等平台的订单编号,ERP称之为原始单号,同一个sid下通过本接口新增订单的tid保证唯一。 |
trade_list.trade_status | 平台状态 | string | 平台订单状态较多且涉及变更,详情介绍单击这里 |
trade_list.pay_status | 支付状态 | string | 平台订单付款状态:0:未付款,1:部分付款,2:已付款 |
trade_list.delivery_term | 发货条件 | string | 1:款到发货,2:货到付款(包含部分货到付款),3:分期付款,4:挂账 |
trade_list.trade_time | 下单时间 | string | 平台订单创建时间,时间格式:yyyy-MM-dd HH:mm:ss |
trade_list.pay_time | 支付时间 | string | 平台订单付款时间,时间格式:yyyy-MM-dd HH:mm:ss,未付款订单为:0000-00-00 00:00:00 |
trade_list.fenxiao_type | 分销类别 | string | 0非分销订单 1转供销 2代销 3经销 |
trade_list.purchase_id | 采购单ID | string | 转供销情况下,采购单ID |
trade_list.fenxiao_nick | 分销商id | string | 分销订单的分销商id,或转供销时供应商id |
trade_list.buyer_nick | 客户网名 | string | 平台买家昵称,注意:一次推送网名相同的订单不能超过30 |
trade_list.buyer_email | 买家email | string | 买家email |
trade_list.pay_id | 支付单号 | string | 支付单号 |
trade_list.pay_account | 支付账号 | string | 支付账号 |
trade_list.receiver_name | 收件人 | string | 收件人姓名 |
trade_list.receiver_province | 省份 | string | 收件人省份,需与旺店通地址库匹配,点击查看,如果不传省市区,则会尝试从详细地址解析省市区,必须是空格分隔的才能解析成功,需要注意直辖市的地址格式,举例“北京 北京市 海淀区 花园路xxxx” |
trade_list.receiver_city | 城市 | string | 收件人城市,需与旺店通地址库匹配,点击查看 |
trade_list.receiver_district | 区县 | string | 收件人区县,需与旺店通地址库匹配,点击查看 |
trade_list.receiver_address | 地址详情 | string | 收件人地址详情 |
trade_list.receiver_mobile | 手机 | string | 手机号码 |
trade_list.receiver_telno | 电话 | string | 电话号码 |
trade_list.receiver_zip | 邮编 | string | 收件人邮编 |
trade_list.logistics_type | 物流方式 | string | 不传本参数,输入值默认-1,表示由ERP系统策略选择。平台指定订单发货物流可选输入值单击这里 |
trade_list.invoice_kind | 发票类别 | string | 0:不需要,1:普通发票,2:增值税普通发票电子,3:增值税普通发票纸质,4:增值税专用发票 |
trade_list.invoice_title | 发票抬头 | string | 发票抬头 |
trade_list.invoice_content | 发票内容 | string | 常见内容:纳税人识别号、地址、电话、开户银行、银行账户,按照以下格式推送,系统开发票时可解析。 |
trade_list.remark_flag | 客户备注标旗 | string | 客户备注标旗,取值0至5对应的标旗颜色依次为灰(无标旗)、红、黄、绿、蓝、紫,不传默认0 |
trade_list.buyer_message | 买家备注 | string | 买家下单时填写的订单备注 |
trade_list.seller_memo | 客服备注 | string | 商家客服对订单进行的备注内容 |
trade_list.seller_flag | 标旗 | string | 客服标旗,取值0至5对应的标旗颜色依次为灰(无标旗)、红、黄、绿、蓝、紫,不传默认0 |
trade_list.post_amount | 邮费 | string | 商家收取买家的物流或者快递费用 |
trade_list.cod_amount | 货到付款金额 | string | 货到付款金额 |
trade_list.ext_cod_fee | 货到付款买家费用 | string | 货到付款买家费用,扣除货到付款订单金额后,卖家仍需支付的货到付款其他金额。这个钱卖家收不回来,是快递公司直接收走,但在快递单里是要打印出来,否则快递收款就错了 |
trade_list.other_amount | 其它收费 | string | 其它应从买家收取的服务费,其他费用 |
trade_list.paid | 已付 | string | 订单已付金额,paid计算公式:paid = Σ(price * num + adjust_amount -discount – share_discount)+ post_amount+other_amount,所有金额相关字段推送处理办法,单击这里 |
trade_list.id_card_type | 证件类型 | string | 1:身份证 |
trade_list.id_card | 证件号码 | string | 证件号码 |
trade_list.is_auto_wms | 自动流转模式 | string | 是否为自动流转模式(1:是 0:不是 不传默认0),非自动流转模式一定不要传值。自动流转模式处理办法,”自动流转模式处理办法详解”)单击这里 |
trade_list.wms_type | 仓库类型 | string | 非自动流转模式一定不要传值 |
trade_list.warehouse_no | 仓库编号 | string | ERP内自定义的仓库编号,查看路径ERP→设置→基本设置→仓库→仓库列表,测试环境仓库编号查看测试环境分配邮件。平台订单需指定ERP内仓库时,传哪个仓库的编号,ERP将为订单选择哪个仓库。 |
trade_list.order_list | 订单货品明细节点 | array | 货品明细列表(子订单列表)节点 |
trade_list.order_list.oid | 子订单编号 | string | 平台订单货品表主键,子订单唯一标识,同一个sid下通过本接口新增订单的oid(子订单编号)要保证唯一;如果oid重复,ERP生成系统单(递交)时会提示“订单货品数量不一致xxxxxx” |
trade_list.order_list.num | 数量 | string | 货品数量,订单推送成功以后本字段值不能更改 |
trade_list.order_list.price | 单价 | string | 标价,折扣前的价格,可以推送价格为0的商品。订单推送成功以后本字段值不能更改 |
trade_list.order_list.status | 状态 | string | 平台子订单状态,子订单状态可以和主订单不一样,比如其中一个子订单退款完成,其状态是80,但主订单仍然是待发货,可选值同trade_status |
trade_list.order_list.refund_status | 退款状态 | string | 0:无退款,1:取消退款,2:已申请退款,3:等待退货,4:等待收货,5:退款成功。本字段在售前退款的时候,根据不同的场景填写不同的值,eg:申请退款值为2,取消退款值为1…… |
trade_list.order_list.goods_id | 平台货品ID | string | 平台系统货品(SPU)的唯一标识。goods_id不能为空,SPU和SKU概念介绍,单击这里 |
trade_list.order_list.spec_id | 平台规格ID | string | 平台系统单品(SKU)的的唯一标识,尽量不为空,SPU和SKU概念介绍,单击这里 |
trade_list.order_list.goods_no | 货品编码 | string | 平台货品SPU编码,对应ERP货品编号,尽量不为空 |
trade_list.order_list.spec_no | 规格编码 | string | 平台货品SKU唯一码,对应ERP商家编码,goods_no和spec_no不能同时为空 |
trade_list.order_list.goods_name | 货品名称 | string | 平台货品名称 |
trade_list.order_list.spec_name | 规格名称 | string | 平台货品规格名称 |
trade_list.order_list.adjust_amount | 调整 | string | 客服调整总金额(大于0加价,小于0减价,是折扣来源的一部分,没有传0) |
trade_list.order_list.discount | 优惠 | string | 下单总折扣,客户下单时折扣(比如促销打折,不包含客服调整、分摊折扣,没有传0) |
trade_list.order_list.share_discount | 分摊优惠 | string | 分摊总折扣,由总订单分摊而来,一般是付款时产生,如使用优惠券,没有传0。分摊优惠传值注意:例如三个商品,优惠10,分摊优惠可以是:3/3/4,或者3.33/3.33/3.34.即最后一个商品的分摊优惠使用减法计算 |
trade_list.order_list.remark | 备注 | string | 货品明细备注推送此字段ERP客户端需升级至V2.3.9.2及以上 |
trade_list.order_list.cid | 类目 | string | 平台货品所属类目 |