下单接口

(1) 接口描述

请求方法 POST ${API_URL}/order ,以JSON流数据提交

接口说明 实现海贸接口下单

(2) 请求参数

字段名称 类型 是否必填 字段说明

appid string 接口调用方唯一标识

supplierId string 供应商标识,来源见查询供应商接口

orderNo string 客户单号,为空则系统自动生成

receivingType string 供应商交货方式,代码见供应商交货方式

deliveryTime date 当receivingType=”pick”时必填; 供应商要求提货时间,24小时制,格式:yyyy-MM-dd HH:mm

supplierAddressId string 当receivingType=”pick”时必填; 供应商提货地址标识,来源见查询供应商提货地址接口

inDeliveryFile string 当receivingType=”pick”时必填; 提货文件的Base64编码,必须是PDF文档

packingFile string 当receivingType=”pick”时必填; 装箱单文件的Base64编码,必须是PDF文档

expressNo string 当receivingType=”express”时可传,快递单号

deliveryWay string 国内送货方式,代码见国内送货方式

pickGoodsPerName string 当deliveryWay=”02”时必填;国内送货自提方式下提货人姓名

pickGoodsPerTel string 当deliveryWay=”02”时可传;国内送货自提方式下提货人电话

pickGoodsPerId string 当deliveryWay=”02”时必填;国内送货自提方式下提货人身份证

pickGoodsPlateNur string 当deliveryWay=”02”时可传;国内送货自提方式下提货人车牌号

pickGoodsDate date 当deliveryWay=”02”时可传;国内送货自提方式下提货时间,24小时制,格式:yyyy-MM-dd HH:mm

pickMemo string 当deliveryWay=”02”时可传;国内送货自提方式下提货备注

customerAddressId string 当deliveryWay=”03,05”时必填;客户国内送货地址标识,来源见查询客户国内收货地址接口

expressWay string 当deliveryWay=”03”时必填;国内送货快递方式下,快递类型,代码见快递类型

sFExpressWayType string 当expressWay=”EXPRESS”时必填,顺丰寄件类型,1:顺丰标快;2:顺丰特惠;3:顺丰次晨达 ;4:广东省内即日件;5:物流普运

dBExpressWayType string 当expressWay=”DEBON”时必填,德邦物流类型,1:精准卡航;2:汽运普航

dBExpressWayService string 当expressWay=”DEBON”时必填,德邦物流派件服务,1:送货到门;2:送货上楼;3:站点自提

dBExpressWayMoney double 当expressWay=”DEBON”时可传,德邦物流保价金额,默认3000元;说明:保价费率0.6%,最低保价RMB3000.00,最低保价收费18元

strideAcrossExpressWayType string 当expressWay=”SPAN”时必填,跨越快递类型,1:省内件(22:30前取件次日达,22:30以后取件隔日达);2:省外当天达;3:省外次日达;4:省外隔日达;5:陆运件

currency string 币制,代码见币制代码

autoPay string 是否自动付款,默认为1; 1:自动付款;2:手动付款。说明:自动付款:款项到账后自动充值到您的系统账户,并自动从您的系统账户扣除该订单费用 手动付款:款项到账后自动充值到您的系统账户,但需手动确认对该订单付款,确认后从您的系统账户扣除该订单款项

isAdvances string 为空或0:不垫款,1:垫款

isClearance string 是否需要香港清关服务,1:供应商由香港以外地址发货,需要做香港进口清关;2:供应商由香港本地发货,无需做香港进口清关

deliveryPayment string 国内送货付款方式,默认为1;1:到付;2:预付

isChartered string 是否需要包车,不填默认为1;1:不包车;2:包车

transportDestination string 包车目的地,不填默认为1;1:货运深圳仓;2:到客户指定地点(收货地址)

invoiceFile string 发票(供应商盖章),发票文件的Base64编码,必须是PDF文档

memo string 订单备注

products array 待下单的产品明细

  products数组中的字段说明如下:

name string 产品物料标识,来源见查询物料列表接口

brand string 产品物料标识,来源见查询物料列表接口

model string 产品物料标识,来源见查询物料列表接口

spec string 产品物料标识,来源见查询物料列表接口

unit string 单位,默认为”7”:个;代码见单位代码

quantity int 数量,默认为1,需大于0

totalPrice double 总价,需大于0

carton int 箱数,默认为1,需大于0

netWeight double 净重(KG),需大于0

grossWeight double 毛重(KG),需大于0

goodsAreaName string 产地,默认为”142”:中国;代码见国家代码

示例:

(3)响应参数

字段名称 类型 是否必填 字段说明

docNo string 海贸订单号

示例:

获取PID/KEY      海贸网