交易清单

POST

/v3/finance/transaction/list

返回所有应计项目的详细信息。在一次请求中可获取信息的最长时间为1月。

如果请求中未指出 posting_number, 那么响应将包含指定时间段内的所有订单或特定订单类型。
与个人中心中的财务→应计费用部分相符。

请求参数

Header 参数

Body 参数application/json

示例

{
    "filter": {
        "date": {
            "from": "2021-11-01T00:00:00.000Z",
            "to": "2021-11-02T00:00:00.000Z"
        },
        "operation_type": [],
        "posting_number": "",
        "transaction_type": "all"
    },
    "page": 1,
    "page_size": 1000
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-seller.ozon.ru/v3/finance/transaction/list' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filter": {
        "date": {
            "from": "2021-11-01T00:00:00.000Z",
            "to": "2021-11-02T00:00:00.000Z"
        },
        "operation_type": [],
        "posting_number": "",
        "transaction_type": "all"
    },
    "page": 1,
    "page_size": 1000
}'

返回响应

🟢200成功

application/json

交易清单

Body

示例

{
    "result": {
        "operations": [
            {
                "operation_id": 11401182187840,
                "operation_type": "MarketplaceMarketingActionCostOperation",
                "operation_date": "2021-11-01 00:00:00",
                "operation_type_name": "商品推销服务",
                "delivery_charge": 0,
                "return_delivery_charge": 0,
                "accruals_for_sale": 0,
                "sale_commission": 0,
                "amount": -6.46,
                "type": "services",
                "posting": {
                    "delivery_schema": "",
                    "order_date": "",
                    "posting_number": "",
                    "warehouse_id": 0
                },
                "items": [],
                "services": []
            }
        ],
        "page_count": 1,
        "row_count": 355
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

修改于 2025-06-10 08:30:17

按订单细分的商品销售报告

清单数目