1、基本信息
(1)请求方法: http post
(2)请求地址: http://{hostname}/apicenter/headProcess/order
(3)说明:
一个头程对应一个货柜,一个货柜对应多个工作单新增头程订单新增工作单
2、请求参数
| 名称 | 数据类型 | 说明 | 是否必填 |
|---|---|---|---|
| initialOrder | Object | 头程订单信息 | 是 |
| - billLadingNumber | String | B/LNo | 是 |
| - bookingSpaceSo | String | 订舱SO | 是 |
| - container | String | 货柜号 | 是 |
| - company | String | 头程公司 | 否 |
| - shipCompany | String | 船公司 | 是 |
| - sailingTime | Date | 开航时间 | 是 |
| - actualArrivalDate | Date | 预计到港日期 | 是 |
| - shipName | String | 船名 | 是 |
| - flightMade | String | 航次 | 是 |
| - portOfDeparture | String | 起运港 | 否 |
| - portOfDischarge | String | 卸货港 | 是 |
| - containerType | Integer | 柜型 4:20GP 5:20HQ 6:40GP 7:40HQ 8:45HQ 9:AKE |
是 |
| - inFlightDay | Integer | 在航天数 | 否 |
| - bookingType | Integer | 订舱类型 1:FBA海运整箱 2:FBA海运拼箱 3:FBA空运 |
是 |
| commissionSheet | Array | 工作单信息 | 是 |
| - centreCode | Long | 仓库编码,默认CKMX | 是 |
| - inquiryNo | String | 询价单号 | 是 |
| - referenceNo | String | 参考单号 | 是 |
| - orderList | Array | 工作单明细 | 是 |
| -- countryCode | String | 国家代码 | 否 |
| -- countryName | String | 贸易国家 | 否 |
| -- comment | String | 预发货备注 | 否 |
| -- warehouseAddress | String | 入库仓库地址 | 否 |
| -- warehouseContacts | String | 入库仓库联系人 | 否 |
| -- warehousePhone | String | 入库仓库联系电话 | 否 |
| -- estimatedDeliveryDate | Date | 预计发货日期 | 是 |
| -- expectedArrivalDate | Date | 期望到货日期 | 是 |
| -- originCountry | String | 原产地(国家) | 是 |
| -- destination | String | 目的地 | 否 |
| -- salePlatform | String | 销售平台 | 否 |
| -- arrivalMethod | Integer | 到仓方式 4货柜(20GP), 5货柜(20HQ), 6货柜(40GP), 7货柜(40HQ), 8货柜(45HQ), 9AKE |
是 |
| -- notifiNumber | String | 发货通知单号 | 是 |
| -- orderNo | String | 订单号 | 是 |
| -- fbaShipmentId | String | FBAShipmentId,FBA转运必填 | 否 |
| -- fbaReferenceId | String | FBAReferenceId,FBA转运必填 | 否 |
| -- shipMode | String | 派送方式 | 否 |
| -- address | String | 详细地址 | 否 |
| -- fbaWarehouseCode | String | fba仓库代码,FBA转运必填 | 否 |
| -- shipType | String | 产品类型 | 否 |
| -- hwReadyDeliveryBox | Array | 箱子列表 | 是 |
| --- boxLength | BigDecimal | 箱子长度(cm) | 是 |
| --- boxWidth | BigDecimal | 箱子宽度(cm) | 是 |
| --- boxHeight | BigDecimal | 箱子高度(cm) | 是 |
| --- boxWeight | BigDecimal | 箱子重量(kg) | 是 |
| --- boxVolume | BigDecimal | 箱子体积(立方米) | 否 |
| --- customBarcode | String | 自定义箱类型号 | 是 |
| --- num | Long | 数量 | 是 |
| --- hwReadyDeliveryProduct | Array | 产品列表 | 是 |
| ---- sku | String | sku | 是 |
| ---- qty | Long | 每箱产品数量 | 是 |
| ---- loadingNum | Long | 装柜数量 | 是 |
3、请求示例
{"initialOrder": {"billLadingNumber": "B/LNo","bookingSpaceSo": "订舱SO","container": "货柜号","company": "头程公司","shipCompany": "船公司","sailingTime": "2022-01-01","actualArrivalDate": "2022-01-10","shipName": "船名","flightMade": "航次","portOfDeparture": "起运港","portOfDischarge": "卸货港","containerType": 4,"inFlightDay": 10,"bookingType": 1},"commissionSheet": [{"warehouseId": 123,"referenceNo": "工作单号","inquiryNo":"询价单号","orderList": [{"countryCode": "国家","comment": "预发货备注","warehouseAddress": "入库仓库地址","warehouseContacts": "入库仓库联系人","warehousePhone": "入库仓库联系电话","estimatedDeliveryDate": "2022-01-15","expectedArrivalDate": "2022-01-25","originCountry": "原产地","arrivalMethod": 4,"notifiNumber":"发货通知单号","orderNo":"订单号","referenceNo": "参考单号","fbaShipmentId": "FBAshipmentid","fbaReferenceId": "FBAreferenceid","fbaWarehouseCode": "fba仓库代码","hwReadyDeliveryBox": [{"boxLength": 10,"boxWidth": 20,"boxHeight": 30,"boxWeight": 15,"boxVolume": 0.018,"customBarcode": "自定义箱类型号","num": 2,"hwReadyDeliveryProduct": [{"sku": "sku001","qty": 10},{"sku": "sku002","qty": 20}]}]}]}]}
4、响应参数
| 名称 | 数据类型 | 说明 |
|---|---|---|
| code | Integer | code |
| msg | String | 提示信息 |
5、响应示例
下单成功相应:
{"msg": "操作成功","code": 201}
备注
- 更多返回错误代码请看首页的错误代码描述
