NB NB Agent API Demo

代理创建订单

用于演示商家如何通过 API 创建代理订单。页面内包含完整接口说明、字段约束、请求示例、响应示例和可直接发送的测试区。

商家联调测试台
Create Order API v1
POST
请求方式
未设置
当前 API 名称
未填写
API Key 状态
JSON
请求内容类型

接口文档

请求地址
请求方式
POST
Content-Type
application/json
请求头
apikey: 左侧共用配置中填写的测试 Key
字段说明
字段名类型 / 是否必填说明
shipperNameString / 必填发货联系人,length < 50。
shipperPhoneString / 必填发货联系电话,length < 20。
shipperOriginString / 必填发货始发地,格式按“/”分割,例如 Canada/ON/Toronto,length < 100。
shipperPostalCodeString / 必填始发地邮编,例如 V7H 2X5,length < 50。
shipperAddressString / 必填始发地详细地址,length < 200。
receiverNameString / 必填收货联系人,length < 50。
receiverPhoneString / 必填收货联系电话,length < 20。
receiverDestString / 必填收货地,格式按“/”分割,例如 Canada/ON/Ajax,length < 100。
receiverPostalCodeString / 必填收货地邮编,例如 M9W0E6,length < 50。
receiverAddressString / 必填收货地地址,length < 200。
receiverAddress2String / 选填收货地详细地址2,length < 200。
unitTypeInteger / 选填单位制,1 = 公制,2 = 英法制;默认 1。
remarkString / 选填订单备注,length < 255。
storeOrderGoodsList / 必填货物信息列表,至少包含一项,每项请参考下方“货物信息说明”。
storeProviderRelationVOObject / 必填产品渠道对象,需包含 channelCode

货物信息说明

storeOrderGoods 中每个对象包含:lengthwidthheightweight(均为必填,需大于 0.01,精确 2 位小数),其中重量最大 68kg / 150lb;goodValuegoodInforemark 为选填。

storeProviderRelationVO 中当前必填字段为 channelCode,类型为 String,length < 50。

响应说明

code:0 成功 / 1 失败;msg:成功或失败描述;data:响应数据详情,失败时为 null;OK:请求结果状态,true 成功,false 失败。

{
  "code": 1,
  "msg": "发货-联系人不能为空!",
  "OK": false
}

{
  "code": 0,
  "data": "N25AUE0000378",
  "OK": true
}

在线测试

实时响应

响应状态
--
耗时
--
API 名称
--
点击“发送请求”后,这里会显示接口返回内容。

cURL 参考

发送请求后会自动生成对应的 cURL 示例。