TTWUSA APIV2

入库管理

添加入库单

创建入库预报单。

POST
生产环境https://ssl.glitzcloud.com/agent/v1/asn/storage/add
测试环境http://gztest.glitzcloud.com/agent/v1/asn/storage/add

说明

1、功能名称:添加入库单

2、功能描述:添加入库单

鉴权说明

请参阅鉴权签名说明。

请求参数

名称必填类型示例值描述
store_nameStringThe Warehouse USA仓库名称
declared_valueFloat122.63申报价值
weightFloat0.08申报重量(kg)
lengthFloat2.13申报长(cm)
widthFloat3.12申报宽(cm)
heightFloat1.32申报高(cm)
container_noStringC156415621箱子编号,商家自行定义
seal_noStringC56145621封号,商家根据实际箱封号如实填写
reference_noString5645621引用编号,商家自行定义,不能和以往的订单有重复
track_numString5645621tracking #,如果source_type为FBA TRANSFER,必填,并且不能和以往的订单有重复
remarkString备注备注
shipping_timeString2016-08-15发货时间
schedule_timeString2016-08-15预计到达时间
etd_timeString2016-08-15预计离港时间
eta_timeString2016-08-15预计到港时间,如果填写必须小于等于schedule_time
20GPInteger1海运整柜入库时必填,四种集装箱型根据实际情况选一个填写,且值仅能为1
40GPInteger1
40HQInteger1
45HQInteger1
palletInteger2托盘入库时必填
cartonInteger8包裹入库时必填
lclInteger1海运拼箱入库时必填
source_typeStringNORMAL ASN入库来源类型,有三个值NORMAL ASN、FBA TRANSFER、OTHER
carrierStringUPS,USPS,FEDEX承运商,物流公司
productsString[ { "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_typeInteger1入库派送方式 1:海运整柜 2:海运拼箱 3:零担卡车 4:快递派送
split_boxInteger0是否需要拆箱(0 否 1 是)
head_transport_typeInteger0是否使用TWUSA头程服务(0 否 1 是)

返回字段

参数类型示例值描述
asn_noString20170703001参考订单号,如果存在就是入库单号
storage_snStringGCI17070300001入库单号

示例

请求示例
{
    "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
}
返回示例
{
    "status": 200,
    "reqMsg": "ok",
    "result": {
        "asn_no": "20170703001",
        "storage_sn": "GCI17070300001"
    }
}
示例 3
{
    "status": "2030",
    "reqMsg": "No skus, please create sku at first",
    "result": []
}