添加入库单
1、功能名称:添加入库单
2、功能描述:添加入库单
3、请求地址:https://ssl.glitzcloud.com/agent/v1/asn/storage/add
测试地址:http://gztest.glitzcloud.com/agent/v1/asn/storage/add
4、请求方式:POST
5、请求参数
必填说明
1.如果 source_type == NORMAL ASN 且 入库类型 是(20GP, 40GP, 40HQ, 45HQ, LCL) container_no,seal_no 必填
2.如果 source_type == NORMAL ASN 且 入库类型 是(Pallet, carton) track_num 必填 container_no,seal_no非必填
3.如果 source_type == FBA TRANSFER或者OTHER 且 入库类型 是(20GP, 40GP, 40HQ, 45HQ, LCL) container_no,seal_no 必填
4.如果 source_type == FBA TRANSFER或者OTHER 且 入库类型 是(Pallet, carton) track_num 必填 container_no,seal_no, etd_time, eta_time非必填
名称 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
store_name | 是 | String | The Warehouse USA | 仓库名称 |
declared_value | 否 | Float | 122.63 | 申报价值 |
weight | 否 | Float | 0.08 | 申报重量(kg) |
length | 否 | Float | 2.13 | 申报长(cm) |
width | 否 | Float | 3.12 | 申报宽(cm) |
height | 否 | Float | 1.32 | 申报高(cm) |
container_no | 否 | String | C156415621 | 箱子编号,商家自行定义 |
seal_no | 是 | String | C56145621 | 封号,商家根据实际箱封号如实填写 |
reference_no | 否 | String | 5645621 | 引用编号,商家自行定义,不能和以往的订单有重复 |
track_num | 否 | String | 5645621 | tracking #,如果source_type为FBA TRANSFER,必填,并且不能和以往的订单有重复 |
remark | 否 | String | 备注 | 备注 |
shipping_time | 是 | date | 2016-08-15 | 发货时间 |
schedule_time | 是 | date | 2016-08-15 | 预计到达时间 |
etd_time | 是 | date | 2016-08-15 | 预计离港时间 |
eta_time | 是 | date | 2016-08-15 | 预计到港时间,如果填写必须 小于等于schedule_time |
20GP | 是; 如果选择了20GP 到45HQ字段中, 只允许填写一项, 且数字仅为1; 如果是pallet和carton, 可以一起输入自己 需要的数量 |
Integer | 数量,请根据实际入库箱型,仔细填写 | |
40GP | Integer | |||
40HQ | Integer | |||
45HQ | Integer | |||
pallet | Integer | |||
carton | Integer | |||
lcl | Integer | |||
source_type | 是 | String | NORMAL ASN | 入库来源类型,有三个值NORMAL ASN、FBA TRANSFER、OTHER |
carrier | 否 | String | UPS,USPS,FEDEX | 承运商,物流公司 |
products | 是 | json | [ { "product_sn":"string", "exp_carton_qty": 0, "exp_piece_qty": 0, "container_max_qty": 0 } ] | 产品列表,数组json格式 product_sn: 产品SKU exp_carton_qty: 箱子总数 exp_piece_qty: 预报数量 container_max_qty:箱入数 |
delivery_type | 是 | int | 1 | 入库派送方式 1:海运整柜 2:海运拼箱 3:零担卡车 4:快递派送 |
split_box | 否 | int | 0 | 是否需要拆箱(0 否 1 是) |
head_transport_type | 否 | int | 0 | 是否使用TWUSA头程服务(0 否 1 是) |
6、请求示例
array( 'format'=>'json', 'apikey'=>'85082f5f62a811e684f500163e06045f', 'randoms'=>1234, 'sign'=>'656d6fbe6b7dec6c2e77ffe27f04bd6d', 'store_name' => 'The Warehouse USA', 'declared_value' => 111, 'length' => 2.54, 'width' => 2.54, 'height' => 2.54, 'weight' => 0.02, 'container_no' => 'C123456', 'seal_no' => 'S123456', 'remark' => '备注', 'schedule_time' => '2016-08-15', 'etd_time' => '2016-08-15', 'eta_time' => '2016-08-15', 'reference_no' => 'R123456', '20GP' => 1, 'source_type' => 'NORMAL ASN', 'carrier' => 'UPS', 'products' => '[ { "product_sn":"Amy001", "exp_carton_qty":"1", "exp_piece_qty":"4", "container_max_qty":4 }, { "product_sn":"AMY002", "exp_carton_qty":"2", "exp_piece_qty":"6", "container_max_qty":3 } ]', 'delivery_type' => 1 );
7、返回格式:JSON
8、返回示例:
正确时的返回JSON数据包如下:
{"status":200,"reqMsg":"ok","result":{"asn_no":"20170703001","storage_sn":"GCI17070300001"}}
错误时的返回JSON数据包如下:
{"status":"2030","reqMsg":"No skus, please create sku at first","result":[]}
9、返回参数说明:
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
asn_no | String | 20170703001 | 参考订单号,如果存在就是入库单号 |
storage_sn | String | GCI17070300001 | 入库单号 |