查询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 | 是 | Integer | 1 | 是否有归属 -1: 全部; 0: 无归属客户; 1: 归属客户是当前客户 |
| order_sn | 否 | String | NCI05112200001 | NCI单据号 |
| type | 否 | Integer | 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 | 创建时间 |
| include_comment_file | 否 | Integer | 1 | 是否返回留言和附件 |
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": "14348",
"order_sn": "NCI07232600014",
"store_id": "12",
"platform_id": "0",
"user_id": "390",
"type": "3",
"status": "3",
"carrier": "",
"tracking_no": "TBA332898323779",
"rma": null,
"shipper": "",
"container_no": "",
"seal_no": "",
"received_time": "1784563200",
"reference_no": "GCR26072313325",
"hsn_code": "",
"reference_no_wms": "",
"reference_id": null,
"package_type": "[{\"id\":\"19\",\"quantity\":\"5\"}]",
"remark": "",
"nci_defined": "no gcr",
"comments_issues": null,
"product_info": "[{\"product_sn\":\"6941327128500\",\"description\":\"\",\"carton\":1,\"pieces\":5,\"location\":\"ra-wed\",\"remark\":\"\"}]",
"operator_id": "352",
"create_time": "1784742358",
"confirm_time": "1784794213",
"update_time": "1784816607",
"rederence_no": "",
"disposition": "2",
"comments": [
{
"comment_id": "109371",
"store_id": "12",
"order_id": "14348",
"order_sn": "NCI07232600014",
"order_status": "Created",
"content": "no reply discarded",
"order_type": "7",
"create_time": "1784742359",
"comment_file": [
{
"id": "8081",
"comment_id": "109371",
"file_name": "http://oss.twusa.cn/2607230145594950.jpeg"
}
]
},
{
"comment_id": "109389",
"store_id": "12",
"order_id": "14348",
"order_sn": "NCI07232600014",
"order_status": "Confirmed",
"content": "go to good position,thanks",
"order_type": "7",
"create_time": "1784794213",
"comment_file": []
},
{
"comment_id": "109391",
"store_id": "12",
"order_id": "14348",
"order_sn": "NCI07232600014",
"order_status": "Completed",
"content": "put away",
"order_type": "7",
"create_time": "1784816607",
"comment_file": []
}
],
"charges": [
{
"id": "11955359",
"cost_id": "71",
"cost_currency": "usd",
"cost_price": "50.00",
"cost_amount": "1.00",
"real_cost": "50.00",
"charge_name": "NCI"
}
]
}
],
"orderTypes": {
"1": "Normal ASN",
"2": "FBA Transfer",
"3": "Return",
"4": "Received Damaged",
"5": "Other",
"6": "Over Received",
"7": "Return-HSN"
},
"platforms": {
"6831": "Alibaba",
"6830": "Aliexpress",
"6038": "Amazon",
"6835": "amazonvendor"
},
"chargeSchemas": {
"9": "20GP",
"18": "Pallet",
"19": "Carton",
"24": "40GP",
"25": "40HQ",
"26": "45HQ",
"40": "LCL",
"62": "PCS"
}
}
}
错误时的返回JSON数据包如下：
{
"status": 200,
"reqMsg": "ok",
"result": {
"orderList": [],
"orderTypes": {
"1": "Normal ASN",
"2": "FBA Transfer",
"3": "Return",
"4": "Received Damaged",
"5": "Other",
"6": "Over Received",
"7": "Return-HSN"
},
"platforms": {
"6831": "Alibaba",
"6830": "Aliexpress",
"6038": "Amazon",
"6835": "amazonvendor"
},
"chargeSchemas": {
"1": "20GP",
"2": "40GP",
"3": "40HQ",
"4": "45HQ",
"5": "Pallet",
"6": "Carton",
"12": "LCL",
"15": "PCS"
}
}
}
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 | 实际费用 |