添加出库单
1、功能名称:添加出库单
2、功能描述:添加出库单
3、请求地址:https://ssl.glitzcloud.com/agent/v1/orders/order/add
测试地址:http://gztest.glitzcloud.com/agent/v1/orders/order/add
4、请求方式:POST
请求体格式:application/json
5、请求参数
| 名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| store_name | String | 是 | The Warehouse USA | 仓库名称 |
| platform_shop_name | String | 否 | Amazon | 平台名称 |
| is_hot | Integer | 否 | 1 | 是否加急 |
| shop_id | String | 否 | APIStore | 店铺名称 |
| order_sn | String | 是 | G201608150001 | 平台店铺订单编号 |
| pre_outflow_time | String | 否 | 2016-08-15~2016-08-20 或 2016-08-15 | 要求出库时间 |
| client_order_id | String | 否 | XM3K9U034033 | 客户订单编号 |
| remark | Text | 否 | remark | 备注 |
| business_type | Integer | 是 | 1,2,3,5,6 | 1:B2B,2:B2C,3:SHOW,5:FBA,6:3rd Party |
| reference_id | String | 否 | reference_id | 参考订单号,如果business_type是FBA 此选项必填 |
| transport_id | String | 是 | UPS | 快递公司名称,[物流方式]接口获取 |
| shipmethod_id | String | 是 | UPS Ground | 派送方式,[物流方式]接口获取 |
| packagetype_id | String | 是 | Your Packaging | 包裹类型,[物流方式]接口获取 |
| declared_c | Float | 否 | 100.5 | 预报长度 |
| declared_k | Float | 否 | 100.5 | 预报宽度 |
| declared_g | Float | 否 | 100.5 | 预报高度 |
| company | String | 否 | Glitzhome | 收件人公司 |
| name | String | 是 | Jim | 收件人 |
| telephone | String | 是 | 021-5370246 | 电话号码 |
| postcode | String | 是 | 200000 | 邮编 |
| address_1 | Text | 是 | 上海浦东新区 | 地址第一行 |
| address_2 | Text | 否 | 金科路2889号 | 地址第二行 |
| address_3 | Text | 否 | 长泰广场C栋1002 | 地址第三行 |
| country | String | 是 | US | 国家二字码 |
| province | String | 是 | WA | 省/州 |
| city | String | 是 | New York | 市 |
| bill_type | Integer | 是 | 支付方式 | 0:TWUSA平台支付 1:第三方平台支付 2:到付 3:客户自供面单 4:客户自有快递账号支付 |
| tp_accnt | String | 否 | 支付账号 | bill_type=1时必填,第三方平台支付账号 |
| bill_name | String | 否 | 账单名称 | bill_type=1时必填,第三方平台支付账单名称 |
| bill_phone | String | 否 | 账单电话 | bill_type=1时必填,第三方平台支付账单电话 |
| bill_country | String | 否 | 账单国家 | bill_type=1时必填,第三方平台支付账单国家 |
| bill_state | String | 否 | 账单州 | bill_type=1时必填,第三方平台支付账单州 |
| bill_city | String | 否 | 账单城市 | bill_type=1时必填,第三方平台支付账单城市 |
| bill_zip | String | 否 | 账单邮编 | bill_type=1时必填,第三方平台支付账单邮编 |
| bill_attention | String | 否 | 账单备注 | 第三方平台支付账单备注 |
| bill_addr1 | String | 否 | 账单地址 | bill_type=1时必填,第三方平台支付账单地址 |
| bill_addr2 | String | 否 | 账单地址 | 第三方平台支付账单地址 |
| track_num | String | 否 | 物流跟踪号 | bill_type=3时必填,否则为非必填 |
| forecast_apply_package | Integer | 是 | 1 |
建议包装方式
值参考范围: 1、使用自己箱子 2、使用仓库箱子 3、自带包装单件包裹 4、多件包装 5、多件缠绕膜缠绕 |
| allow_edit_package_method | Integer | 是 | 0 | 是否允许仓库修改包装方式,0:不允许,1:允许 |
| is_do_best_way | Integer | 否 | 2 | 是否智能换仓,0:智能换仓,2:选定仓库(默认) |
| is_allow_warehouse_edit | Integer | 否 | 0 | 是否允许仓库修改快递公司,0:否,1:是 |
| is_print_packlist | Integer | 是 | 1 | 是否打印PackList 0 否 1 是 |
| is_print_attachment | Integer | 是 | 1 | 是否打印附件 0 否 1 是 |
| is_route | Integer | 否 | 0 | 是否需要Route |
| is_insurance | Float | 否 | 0 | 是否投保,0:不投保;1:投保;当transport_id是Ups或Fedex支持投保。 |
| signature_value | Integer | 否 | 1 | 签名服务,1:直接签名;2:间接签名;3:成人签名。留空表示无需签名服务 |
| status | Integer | 否 | 0 | 是否预录出库单,0:否;4:是 |
| ship_short | Integer | 否 | 0,1 | 是否短缺发货 0 否 1 是;仅未生成拣货批次或订单异常时可修改此字段 |
| products | string | 是 | [{\"exp_piece_qty\":1, \"product_sn\":\"X003GUP025\"}] |
产品列表,json字符串 |
| file | file | 否 | 附件(此字段是为了兼容老客户form表单创建出库单而保留,新对接用户请使用[添加出库单附件]接口异步添加附件) |
6、请求示例
{
"apikey": "85082f5f62a811e684f500163e06045f",
"randoms": 1234,
"sign": "656d6fbe6b7dec6c2e77ffe27f04bd6d",
"store_name": "The Warehouse USA",
"platform_shop_name": "Amazon",
"is_hot": 1,
"shop_id": "APIStore",
"order_sn": "G201608150001",
"pre_outflow_time": "2016-08-15",
"remark": "remark",
"business_type": "1",
"transport_id": "UPS",
"shipmethod_id": "UPS Ground",
"packagetype_id": "Your Packaging",
"declared_c": 100.5,
"declared_k": 100.5,
"declared_g": 100.5,
"company": "glitzhome",
"name": "Jim",
"telephone": "021-5370246",
"postcode": "200000",
"address_1": "上海浦东新区",
"address_2": "金科路2889号",
"address_3": "长泰广场C栋1002",
"country": "US",
"province": "WA",
"city": "New York",
"bill_type": 1,
"forecast_apply_package": 1,
"allow_edit_package_method": 1,
"is_do_best_way": 1,
"status": 0,
"products": "[{\"exp_piece_qty\":1,\"product_sn\":\"X003GUP025\"}]"
}
7、返回格式:JSON
8、返回示例:
成功返回:
{
"status": 200,
"reqMsg": "ok",
"result": {
"order_id": "2509",
"outflow_sn": "GCO03172100003"
}
}
错误返回:
{
"status": "2518",
"reqMsg": "Carrier is compulsory",
"result": []
}
9、返回参数说明:
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| order_id | Integer | 2509 | 出库单ID |
| outflow_sn | string | GCO03172100003 | 出库单编号 |
