查询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": "610",
"order_sn": "NCI03302300002",
"store_id": "13",
"platform_id": "0",
"user_id": "276",
"type": "1",
"status": "3",
"carrier": "",
"tracking_no": "",
"rma": null,
"shipper": "",
"container_no": "",
"seal_no": "",
"received_time": "1679500800",
"reference_no": "",
"reference_no_wms": "",
"hsn_code": "",
"reference_id": null,
"package_type": "[{\"id\":\"3\",\"quantity\":\"1\"}]",
"remark": "",
"nci_defined": "",
"comments_issues": null,
"product_info": "[{\"product_sn\":\"LNZJBD060\",\"description\":\"1\",\"carton\":1,\"pieces\":1,\"location\":\"1-1-1\",\"remark\":\"\"}]",
"operator_id": "641",
"create_time": "1680141564",
"confirm_time": "1680141693",
"update_time": "1680141721",
"rederence_no": "",
"disposition": "5",
"charges": [
{
"id": "48737",
"cost_id": "71",
"cost_currency": "usd",
"cost_price": "50.00",
"cost_amount": "1.00",
"real_cost": "25.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",
"6898": "antiquefarmhouse",
"6937": "athome",
"6938": "b2b",
"6884": "bbb",
"6882": "belk",
"6888": "biglots",
"6826": "bonanza",
"6935": "brandx",
"6915": "chewy",
"6916": "christmascentral",
"6921": "dressbarn",
"6048": "ebay",
"6881": "etsy",
"6917": "ewtsy",
"6925": "franklinmint",
"6905": "gordmans",
"6877": "groupon",
"6824": "homedepot",
"6919": "homedepotcanada",
"6823": "houzz",
"6931": "HSN",
"6833": "jcpenney",
"6926": "kohls",
"6918": "kroger",
"6936": "krogermarketplace",
"6922": "lnt",
"6893": "lowes",
"6889": "ltd",
"6368": "mabang",
"6892": "macys",
"6933": "maurices",
"6903": "menards",
"6920": "mercatalyst",
"6878": "michaels",
"6941": "michaelsmarketplace",
"6828": "newegg",
"6865": "overstock",
"6879": "pier1",
"6896": "qvc",
"6861": "ruelala",
"6842": "Ruralking",
"6849": "selfsite",
"6887": "shopify",
"6911": "show",
"6904": "stage",
"6934": "staples",
"6834": "steinmart",
"6871": "target",
"6942": "Temu",
"6886": "The Paper Store",
"6885": "tompal",
"6369": "tongtu",
"6897": "tradegecko",
"6930": "tuesdaymorning",
"6940": "Tuesday Morning",
"6829": "unbeatablesale",
"6827": "walmart",
"6891": "walmartdsv",
"6822": "wayfair",
"6303": "Wish",
"6825": "zulily",
"6913": "zulilyds"
},
"chargeSchemas": {
"1": "20GP",
"2": "40GP",
"3": "40HQ",
"4": "45HQ",
"5": "Pallet",
"6": "Carton",
"12": "LCL",
"15": "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",
"6898": "antiquefarmhouse",
"6937": "athome",
"6938": "b2b",
"6884": "bbb",
"6882": "belk",
"6888": "biglots",
"6826": "bonanza",
"6935": "brandx",
"6915": "chewy",
"6916": "christmascentral",
"6921": "dressbarn",
"6048": "ebay",
"6881": "etsy",
"6917": "ewtsy",
"6925": "franklinmint",
"6905": "gordmans",
"6877": "groupon",
"6824": "homedepot",
"6919": "homedepotcanada",
"6823": "houzz",
"6931": "HSN",
"6833": "jcpenney",
"6926": "kohls",
"6918": "kroger",
"6936": "krogermarketplace",
"6922": "lnt",
"6893": "lowes",
"6889": "ltd",
"6368": "mabang",
"6892": "macys",
"6933": "maurices",
"6903": "menards",
"6920": "mercatalyst",
"6878": "michaels",
"6941": "michaelsmarketplace",
"6828": "newegg",
"6865": "overstock",
"6879": "pier1",
"6896": "qvc",
"6861": "ruelala",
"6842": "Ruralking",
"6849": "selfsite",
"6887": "shopify",
"6911": "show",
"6904": "stage",
"6934": "staples",
"6834": "steinmart",
"6871": "target",
"6942": "Temu",
"6886": "The Paper Store",
"6885": "tompal",
"6369": "tongtu",
"6897": "tradegecko",
"6930": "tuesdaymorning",
"6940": "Tuesday Morning",
"6829": "unbeatablesale",
"6827": "walmart",
"6891": "walmartdsv",
"6822": "wayfair",
"6303": "Wish",
"6825": "zulily",
"6913": "zulilyds"
},
"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 | 实际费用 |