(1) 接口描述

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

接口说明 实现海贸接口新下单，整合其它依赖数据新增接口

(2) 请求参数

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

appid string 是 接口调用方唯一标识

customerName string 是 该订单所属客户的公司全称，也是收货单位

supplierName string 是 境外供应商英文名称

supplierAddress string 否 境外供应商地址

supplierBankName string 否 境外供应商银行名称，若传此值，则必须传下面4个属性

supplierBankCode string 否 境外供应商银行SWIFT CODE

supplierBankAddress string 否 境外供应商银行地址

supplierBankAccount string 否 境外供应商银行账号

supplierBankCurrency string 否 境外供应商银行币制code，代码见 币制代码

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

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

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

supplierAddressPerson string 否 当receivingType=”pick”时必填；供应商提货地址联系人，若传此值，则必须传下面2个属性

supplierAddressPhone string 否 当receivingType=”pick”时必填；供应商提货地址联系电话

supplierAddressDetail string 否 当receivingType=”pick”时必填；供应商提货地址详细地址，无需包含省市区

supplierAddressArea string 否 当receivingType=”pick”时必填；供应商提货地址详细地址香港区域CODE，只能是香港下面的区，见 区域CODE

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”时可传；国内送货自提方式下提货备注

customerAddressPerson string 否 当deliveryWay=”03,05,06”时必填；客户国内送货地址联系人，若传此值，则必须传下面2个属性

customerAddressPhone string 否 当deliveryWay=”03,05,06”时必填；客户国内送货地址联系电话

customerAddressDetail string 否 当deliveryWay=”03,05,06”时必填；客户国内送货地址详细地址，无需包含省市区

customerAddressProvince string 否 当deliveryWay=”03,05,06”时必填；客户国内送货地址详细地址省份code，代码见附录 省份CODE

customerAddressCity string 否 当deliveryWay=”03,05,06”时必填；客户国内送货地址详细地址城市code，代码见附录 城市CODE

customerAddressArea string 否 当deliveryWay=”03,05,06”时必填；客户国内送货地址详细地址区域code，代码见附录 区域CODE

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”:中国；代码见 国家代码

示例：

{

  appid:"your32bitappid",

  supplierName:"my supplier name",

  supplierAddress:"my supplier address",

  supplierBankName:"my supplier bank name",

  supplierBankCode:"my supplier bank code",

  supplierBankAddress:"香港某某区某某街道",

  supplierBankAccount:"6221123456789012",

  supplierBankCurrency:"USD",

  receivingType:"express",

  expressNo:"100100",

  deliveryWay:"03",

  customerAddressPerson:"海贸",

  customerAddressPhone:"075588889999",

  customerAddressDetail:"海贸",

  expressWay:"1",

  sFExpressWayType:"1",

  currency:"USD",

  isClearance:"2",

  products:[

    {

      name:"测试物料名称1",

      brand:"测试物料品牌1",

      model:"测试物料型号1",

      spec:"测试物料规格1",

      unit:"7",

      quantity:10,

      totalPrice:1000.00,

      carton:8,

      netWeight:100.00,

      grossWeight:95.50,

      goodsAreaName:"142"

    }

  ]

}

(3)响应参数

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

docNo string 是 海贸订单号

supplierId string 是 此海贸订单的供应商ID

supplierBankId string 否 供应商银行ID，供申请付汇时选择

supplierAddressId string 否 供应商提货地址ID，供旧下单接口使用

customerAddressId string 否 客户国内收货地址ID，供旧下单接口使用

示例：

{

  "class": "base.Result",

  "code": 0,

  "data": {

    "docNo" : "YTO160929001",

    "supplierId" : "32bitsupplierId",

    "supplierBankId" : "32bitsupplierBankId",

    "customerAddressId" : "32bitcustomerAddressId"

    },

  "msg": "请求成功"

}