交易清单 - Ozon Seller API

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

filter

object

可选

过滤器。

One of

posting_number

date

object

可选

日期过滤。

operation_type

array[string]

可选

交易类型:

ClientReturnAgentOperation — 收到买家的退货、取消订单、非赎金；

MarketplaceMarketingActionCostOperation — 商品促销服务；

MarketplaceSaleReviewsOperation — 在平台上的购买评论；

MarketplaceSellerCompensationOperation — 其他补贴；

OperationAgentDeliveredToCustomer — 交付给买家；

OperationAgentDeliveredToCustomerCanceled — 交付买家 — 更正应计；

OperationAgentStornoDeliveredToCustomer — 交付买家 — 取消应计；

OperationClaim — 索赔应计；

OperationCorrectionSeller — 相互结算清单；

OperationDefectiveWriteOff — 仓库损坏货物的赔偿；

OperationItemReturn — 快递和处理退货、取消订单、不赎回的交付和处理；

OperationLackWriteOff — 仓库丢失货物的补偿；

OperationMarketplaceCrossDockServiceWriteOff — 将商品运送到Ozon仓库 (交叉对接)；

OperationMarketplaceServiceStorage — 将货物放入仓库的服务；

OperationSetOff — 与其他交易对手协议抵消；

MarketplaceSellerReexposureDeliveryReturnOperation — 买方交货转移；

OperationReturnGoodsFBSofRMS — 快递和处理退货、取消订单、非赎回的交付和处理；

ReturnAgentOperationRFBS — 交付给买方的退货转移；

ItemAgentServiceStarsMembership — “明星商品” 服务的奖励；

MarketplaceSellerShippingCompensationReturnOperation — 转移运费的补偿；

OperationMarketplaceServicePremiumCashback — Premium 促销服务；

MarketplaceServicePremiumPromotion — Premium 促销服务，固定佣金；

MarketplaceRedistributionOfAcquiringOperation — 收单业务费用；

MarketplaceReturnStorageServiceAtThePickupPointFbsItem — FBS 短期退货存储；

MarketplaceReturnStorageServiceInTheWarehouseFbsItem — FBS 长期退货存储；

MarketplaceServiceItemDeliveryKGT — 超大货件物流；

MarketplaceServiceItemDirectFlowLogistic — 物流；

MarketplaceServiceItemReturnFlowLogistic — 逆向物流；

MarketplaceServicePremiumCashbackIndividualPoints — 促销服务“卖家奖金”；

OperationMarketplaceWithHoldingForUndeliverableGoods — 商品交付金不足引起的滞留;

MarketplaceServiceItemRedistributionReturnsPVZ — 在取货点重新放置退货；

OperationElectronicServiceStencil — “模板”服务；

OperationElectronicServicesPromotionInSearch — “搜索结果推广”服务；

OperationMarketplaceServiceItemElectronicServicesBrandShelf — “品牌货架”服务；

OperationSubscriptionPremium — Premium订阅。

posting_number

string

发货号。

必需

transaction_type

string

可选

收费类型：

all — 所有,

orders — 订单,

returns — 退货和取消,

services — 服务费,

compensation — 补贴,

transferDelivery — 运费,

other — 其他。

些操作可能会按时间分开。例如，当接收买家退货时，扣除商品成本并退回佣金，当商品返回仓库时，收取处理退货的服务费用。

page

integer <int64>

请求中返回的页码。

必需

page_size

integer <int64>

每页的元素数。

必需

示例

{
    "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

返回响应

🟢200成功

application/json

交易清单

Body

result

object (object)

询问结果。

可选

operations

array[object (object) {13}]

操作信息。

可选

page_count

integer <int64>

可选

页数。如果为0，则说明已无页面。

row_count

integer <int64>

可选

所有页面上的交易数量。如果为0，说明已无交易。

示例

{
    "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服务器错误