Lingxing
切换旧版

查询库存分类账detail数据

POST/cost/center/ods/detail/query

支持查询亚马逊库存分类账detail数据，来源 GET_LEDGER_DETAIL_VIEW_DATA

注意：由于亚马逊库存分类账生成数据后5天内会发生变更，领星在获取数据的5天内会继续获取数据并覆盖更新历史版本，因此接口获取的5天内数据是有可能发生变更的

接口信息

API Path请求协议请求方式令牌桶容量
/cost/center/ods/detail/query HTTPSPOST10

请求参数

sellerIdsarray<any>必填
亚马逊店铺id
startDatestring必填
统计起始日期 Y-m-d 闭区间
endDatestring必填
统计结束日期 Y-m-d 闭区间
fnskusarray<any>
fnsku列表
asinsarray<any>
asin列表
mskusarray<any>
msku列表
eventTypesarray<any>
事件类型，支持传多值：
01 Shipments
02 CustomerReturns
03 WhseTransfers
04 Receipts
05 VendorReturns
06 Adjustments
referenceIdstring
引用id，支持模糊搜索
dispositionstring
库存类型：
01 SELLABLE
02 UNSELLABLE
03 ALL
locationsarray<any>
国家编码列表
offsetinteger
分页偏移量，默认0
lengthinteger
分页长度，默认20，上限1000

请求示例

{
    "sellerIds": [
        "AN05PRUL7R796"
    ],
    "startDate": "2024-03-02",
    "endDate": "2024-06-1",
    "fnskus": [
        "B085M7NH7S"
    ],
    "asins": [
        "B097MP26YP"
    ],
    "mskus": [
        "DA19037B1"
    ],
    "eventTypes": [
        "01",
        "02"
    ],
    "disposition": "01",
    "location": "GB",
    "offset": 0,
    "length": 20
}

返回结果

Json Object

codeinteger必填
状态码，1 成功
示例 1
msgstring必填
响应信息
successboolean必填
操作是否成功
traceIdstring必填
请求链路id
dataobject必填
明细数据
隐藏子属性
totalnumber必填
总记录条数
sizenumber必填
每个数据页大小
currentnumber必填
当前所在数据页
recordsarray<object>必填
明细数据列表
隐藏子属性
sellerIdstring必填
亚马逊店铺id
datestring必填
数据日期
示例 2022-04-01
fnskustring必填
fnsku
asinstring必填
asin
mskustring必填
msku
titlestring
标题
eventTypestring必填
事件类型
示例 01
eventTypeDescstring必填
事件类型描述
示例 Shipments
referenceIdstring
货物id
quantitynumber必填
数量
fulfillmentCenterstring必填
储存库存的履行中心
dispositionstring必填
库存属性
示例 01
dispositionDescstring必填
库存属性描述
示例 SELLABLE
reasonstring
原因
locationstring必填
国家
示例 GB
uniqueMd5Idxstring必填
和uniqueMd5联合作为唯一键，uniqueMd5Idx是标识uniqueMd5的index
示例 bc4f83291d4fda71272fc586b81c3240
uniqueMd5string必填
和uniqueMd5Idx联合作为唯一键
示例 0

返回成功示例

{
    "code": 1,
    "msg": "操作成功",
    "data": {
        "records": [
            {
                "sellerId": "xxxxxxxxxxxxxxxx",
                "date": "2022-04-01",
                "fnsku": "X0010DNT2F",
                "asin": "B07Q3PV8SR",
                "msku": "1300U1207",
                "title": "HEETA Scalp Massager [Soft& Convenient] Shampoo Brush with Silicone Bristles for Wet and Dry Hair",
                "eventType": "01",
                "eventTypeDesc": "Shipments",
                "referenceId": "41247588491302",
                "quantity": -1,
                "fulfillmentCenter": "EUK5",
                "disposition": "01",
                "dispositionDesc": "SELLABLE",
                "reason": "",
                "location": "GB",
                "uniqueMd5Idx": "bc4f83291d4fda71272fc586b81c3240",
                "uniqueMd5": "0",
            }
        ],
        "total": 12673,
        "size": 20,
        "current": 1,
        "orders": [],
        "optimizeCountSql": true,
        "hitCount": false,
        "countId": null,
        "maxLimit": null,
        "searchCount": true,
        "pages": 634
    },
    "traceId": "b2532fc7-9c1b-4b08-8d30-301b31b70562.1663226369188",
    "success": true
}

返回失败示例

{
    "code": 0,
    "msg": "操作失败",
    "data": null,
    "traceId": "b2532fc7-9c1b-4b08-8d30-301b31b70562.1663226369188",
    "success": false
}