交易清单 - Ozon Seller API

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

示例值:

Api-Key

string

API-密钥。

必需

示例值:

Body 参数application/json

filter

object (object)

过滤器。

可选

date

object (object)

日期过滤。

可选

operation_type

array[string]

可选

交易类型:

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

MarketplaceMarketingActionCostOperation — 商品促销服务；

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

MarketplaceSellerCompensationOperation — 其他补贴；

OperationAgentDeliveredToCustomer — 交付给买家；

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

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

OperationClaim — 索赔应计；

OperationCorrectionSeller — 相互结算清单；

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

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

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

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

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

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

MarketplaceSellerReexposureDeliveryReturnOperation — 买方交货转移；

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

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

MarketplaceSellerShippingCompensationReturnOperation — 转移运费的补偿；

OperationMarketplaceServicePremiumCashback — Premium 促销服务；

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

MarketplaceRedistributionOfAcquiringOperation — 收单业务费用；

MarketplaceReturnStorageServiceAtThePickupPointFbsItem — FBS 短期退货存储；

MarketplaceReturnStorageServiceInTheWarehouseFbsItem — FBS 长期退货存储；

MarketplaceServiceItemDeliveryKGT — 超大货件物流；

MarketplaceServiceItemDirectFlowLogistic — 物流；

MarketplaceServiceItemReturnFlowLogistic — 逆向物流；

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

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

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>

页数。

可选

row_count

integer <int64>

商品数量。

可选

示例

{
  "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无响应

🟠409请求冲突

🔴500服务器内部错误