查询NCI
1、功能名称:查询NCI
2、功能描述:查询NCI
3、请求地址:https://ssl.glitzcloud.com/agent/v1/nci/nci/index
测试地址:http://gztest.glitzcloud.com/agent/v1/nci/nci/index
4、请求方式:POST
5、请求参数
名称 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
store_name | 是 | string | The Warehouse USA | 仓库名称 |
ownerless | 是 | int | 1 | 是否有归属 -1: 全部; 0: 无归属客户; 1: 归属客户是当前客户 |
order_sn | 否 | String | NCI05112200001 | NCI单据号 |
type | 否 | int | 1 | 类型(1:Normal ASN', 2:FBA Transfer', 3:Return', 4:Received Damaged', 5:Other') |
tracking_no | 否 | String | 272763838596 | 物流跟踪号 |
reference_no | 否 | String | GCR22051152172 | 参考订单号 |
create_time_start | 否 | String | 2022-10-17 | 创建时间 |
create_time_end | 否 | String | 2022-10-17 | 创建时间 |
6、请求示例
{ "store_name": "TWUSA01", "format": "json", "apikey": "85082f5f62a811e684f500163e0605f", "secretkey": "85082f5f62a8e684f500163e0605f", "randoms": 1931, "sign": "470c59856a790dc36594044c89151f40", "ownerless": 1, "order_sn":"NCI05112200001" }
7、返回格式:JSON
8、返回示例:
正确时的返回JSON数据包如下:
{ "status": 200, "reqMsg": "ok", "result": { "orderList": [ { "id": "534", "order_sn": "NCI05102200001", "store_id": "13", "platform_id": "0", "user_id": "0", "type": "3", "status": "1", "carrier": "aa", "tracking_no": "aa", "rma": null, "shipper": "aa", "container_no": "aa", "seal_no": "aa", "received_time": "1652112000", "reference_no": null, "reference_no_wms": "", "hsn_code": "", "reference_id": null, "package_type": "[{\"id\":\"1\",\"quantity\":\"11\"}]", "remark": "dfdf", "nci_defined": "aa", "comments_issues": null, "product_info": "[{\"product_sn\":\"sasha02214444\",\"description\":\"11\",\"carton\":1,\"pieces\":1,\"location\":\"1-1-1\",\"remark\":\"11\"}]", "charge_info": null, "operator_id": "277", "create_time": "1652176355", "confirm_time": null, "update_time": "0", "rederence_no": "", "disposition": "0", "charges": [ { "id": "13587", "cost_currency": "usd",//费用币种 "cost_price": "1.00",//费用价格 "cost_amount": "1.00",//数量 "real_cost": "63.00"//实际费用 } ] }, { "id": "533", "order_sn": "NCI03302200009", "store_id": "13", "platform_id": "0", "user_id": "276", "type": "1", "status": "1", "carrier": "", "tracking_no": "", "rma": null, "shipper": "", "container_no": "", "seal_no": "", "received_time": "1648569600", "reference_no": null, "reference_no_wms": "", "hsn_code": "", "reference_id": null, "package_type": "[{\"id\":\"6\",\"quantity\":\"10\"}]", "remark": "", "nci_defined": "", "comments_issues": null, "product_info": "[{\"product_sn\":\"lydia0001\",\"description\":\"\",\"carton\":10,\"pieces\":101,\"location\":\"\",\"remark\":\"\"}]", "charge_info": null, "operator_id": "277", "create_time": "1648627350", "confirm_time": null, "update_time": "0", "rederence_no": "", "disposition": "0" } ], "orderTypes": { "1": "Normal ASN", "2": "FBA Transfer", "3": "Return", "4": "Received Damaged", "5": "Other", "6": "Over Received" } } }
错误时的返回JSON数据包如下:
{ "status":"6001", "reqMsg":"Params error", "result":[] }
9、返回参数说明:
参数 | 子参数 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
id | String | 534 | Nci Id | |
order_sn | String | NCI05102200001 | Nci单据号 | |
store_id | String | 13 | 仓库ID | |
type | String | 1 | 1:Normal ASN', 2:FBA Transfer', 3:Return', 4:Received Damaged', 5:Other' | |
status | String | 1 | 订单状态(1:已收货;2:已确认;3:已完成;4:已取消;5:待处理) | |
tracking_no | String | 272763838596 | 物流跟踪号 | |
disposition | String | 1 | 处理方式(1:提供入库单;2:提供退货单;3:弃货;4:不是我的产品;5:其他) | |
user_id | String | 276 | 归属客户ID | |
charges | array | [] | 费用 | |
cost_currency | string | usd | 费用币种 | |
cost_price | string | 1.00 | 费用价格 | |
cost_amount | string | 1.00 | 数量 | |
real_cost | string | 63.00 | 实际费用 |