下单接口
(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 是 海贸订单号
示例:
