查询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 | 实际费用 |
