Ozon seller API notification

September 18, 2024

Method : What changed

/v3/finance/transaction/list : Updated the `filter.operation_type` parameter description in the method request and `result.operations.services.name` parameter description in the method response.


Link to Seller API Documentation

September 10, 2024

Method : What changed

/v3/product/import, /v3/products/info/attributes] : Added the `items.type_id` parameter to the [/v3/product/import](#operation/ProductAPI_ImportProductsV3) method request and the `result.type_id` parameter in the [/v3/products/info/attributes](#operation/ProductAPI_GetProductAttributesV3) method response.


Link to Seller API Documentation

August 27, 2024

Method : What changed

/v1/description-category/attribute/values/search : Added a method for searching by reference values of a characteristic.


Link to Seller API Documentation

August 26, 2024

Method : What changed

/v3/product/import : Added the `new_description_category_id` parameter to the method request.


Link to Seller API Documentation

August 16, 2024

Method : What changed

/v3/product/import : Added the `new_description_category_id` parameter to the method request.


Link to Seller API Documentation

August 8, 2024

Method : What changed

Push Notifications : Described the errors that may occur when enabling push notifications.


Link to Seller API Documentation

August 5, 2024

Method : What changed

/v1/supply-order/list : Deleted the supply statuses on the requisition in the method request and response: `DRAFT`, `SUPPLY_VARIANTS_ARRANGING`, `HAS_NO_SUPPLY_VARIANTS_ARCHIVE`, `HAS_NO_SUPPLY_VARIANTS_NEW`, `SUPPLY_VARIANT_CONFIRMATION`, `TIMESLOT_BOOKING`.

/v1/products/geo-restrictions-catalog-by-filter : Method is deprecated and will be disabled on October 1, 2024.


Link to Seller API Documentation

August 2, 2024

Method : What changed

Common errors : Updated the `Invalid Api-Key, please contact support` error description in the [/v2/posting/fbs/act/create](#operation/PostingAPI_PostingFBSActCreate) method.

/v2/posting/fbs/ship : Removed the /v2/posting/fbs/ship method from the documentation.

/v3/finance/transaction/list : Added the `OperationMarketplaceAgencyFeeAggregator3PLGlobal` service type to the `result.operations.services.name` parameter in the method response.

/v1/report/info, /v1/report/list], /v1/report/products/create], /v1/report/returns/create], /v1/report/postings/create], /v1/report/discounted/create], /v1/report/warehouse/stock] : Updated the `code` and `file` parameters description in the methods responses and requests.


Link to Seller API Documentation

July 30, 2024

Method : What changed

Common errors : Updated the `Invalid Api-Key, please contact support` error description in the [/v2/posting/fbs/act/create](#operation/PostingAPI_PostingFBSActCreate) method.

/v2/posting/fbs/ship : Removed the /v2/posting/fbs/ship method from the documentation.

/v3/finance/transaction/list : Added the `OperationMarketplaceAgencyFeeAggregator3PLGlobal` service type to the `result.operations.services.name` parameter in the method response.

/v1/report/info, /v1/report/list], /v1/report/products/create], /v1/report/returns/create], /v1/report/postings/create], /v1/report/discounted/create], /v1/report/warehouse/stock] : Updated the `code` and `file` parameters description in the methods responses and requests.


Link to Seller API Documentation

June 27, 2024

Method / Section : What changed

/v3/posting/fbs/list : Added the `filter.last_changed_status_date` parameter to the method request.

Common errors : Added descriptions of the `GTD_MUST_BE_SPECIFIED_FOR_PRODUCT_COUNTRY` error for the [/v4/fbs/posting/product/exemplar/validate](#operation/PostingAPI_FbsPostingProductExemplarValidate) method and the `NO_POSTINGS_FOR_BATCH_DOWNLOAD` error for the [/v2/posting/fbs/package- label](#operation/PostingAPI_PostingFBSPackageLabel) method.

/v2/product/info/list : In the `product_id` parameter, changed the description of the data input format.

/v2/posting/fbo/list, , /v2/posting/fbo/get : Added possible values for the `result.analytics_data.payment_type_group_name` parameter in the method response.

/v3/posting/fbs/list, , /v3/posting/fbs/unfulfilled/list, , /v3/posting/fbs/get : Added possible values of the `result.postings.analytics_data.payment_type_group_name` parameter in the method response. Added description of the `cancelled_from_split_pending` status.


Link to Seller API Documentation

June 18, 2024

Method : What changed

/v3/product/import, , /v1/product/import-by-sku, , /v2/product/info/list], , /v2/product/info](, , /v4/product/info/prices] : The `premium_price` parameter in method responses and requests is deprecated, we removed it from the code samples.


Link to Seller API Documentation

June 10, 2024

Method : What changed

/v3/posting/fbs/get, /v3/posting/fbs/list], /v3/posting/fbs/unfulfilled/list] : Removed the `customer.customer_email` parameter from the methods response.


Link to Seller API Documentation

June 7, 2024

Section : What changed

Methods Workflow : Added information about [products reservation](#section/Updating-prices-and-product-stocks/Reserve-products).


Link to Seller API Documentation

May 31, 2024

Method : What changed

/v1/invoice/create-or-update : The method is deprecated, we removed it from the documentation. Use the [/v2/invoice/create-or-update](#operation/InvoiceAPI_InvoiceCreateOrUpdateV2) method.

/v1/invoice/get : The method is deprecated, we removed it from the documentation. Use the [/v2/invoice/get](#operation/invoice_getV2) method.


Link to Seller API Documentation

May 24, 2024

Method : What changed

/v3/finance/transaction/list : Replaced `Market place Service Storage Item` with `Operation Market place Service Storage` in the `operations.services` response parameter.

/v1/product/related-sku/get : Updated the method description.

/v2/product/info/list : Updated the `items.id ` parameter description in the method response.

/v3/returns/company/fbs : Updated the `returns.moving_to_place_name` parameter description in the method response.

/v2/posting/fbo/get, , /v2/posting/fbo/list, , /v3/posting/fbs/unfulfilled/list], , /v3/posting/fbs/get], , /v3/posting/fbs/list] : Marked the `postings.financial_data.products.item_services` and `postings.financial_data.posting_services` parameters as outdated in the method response.

Common errors : Added the `Incorrect_density` error description for the [/v3/product/import](#operation/ProductAPI_ImportProductsV3) method and `Incorrect_carriage_status` for the [/v2/posting/fbs/act/create](#operation/PostingAPI_PostingFBSActCreate) method.


Link to Seller API Documentation

May 23, 2024

Method : What changed

/v2/posting/fbs/package-label/create : Added a new version of the method for creating a task to generate labels.

/v1/posting/fbs/package-label/create : Method is deprecated and will be disabled. We'll give you one month's notice. Switch to the new version [/v2/posting/fbs/package-label/create](#operation/PostingAPI_CreateLabelBatchV2).


Link to Seller API Documentation

May 16, 2024

Method : What changed

/v3/returns/company/fbs : Updated the `filter.status` parameter description in the method request and the `returns.product_id` parameter in the method response.

/v4/posting/fbs/ship/package, , /v1/product/import/prices : Updated the method description.

/v3/product/import : Changed the `items.description_category_id` parameter description in the sample request.

/v4/product/info/prices, , /v3/product/import, , /v2/product/info/list, , /v2/product/info, , /v1/product/import-by-sku : The `premium_price` parameter in method responses and requests is deprecated.

— : In the [**Push notifications**](#tag/push_types) section updated the description of notifications:
• [TYPE_NEW_POSTING](#section/New-shipment),
• [TYPE_POSTING_CANCELLED](#section/Shipment-cancellation),
• [TYPE_STATE_CHANGED](#section/Shipment-status-change),
• [TYPE_CUTOFF_DATE_CHANGED](#section/Shipment-shipping-date-change),
• [TYPE_DELIVERY_DATE_CHANGED](#section/Shipment-delivery-date-change).

— : In the [**Common Errors**](#tag/Errors) section added a description of the `EXEMPLAR_INFO_NOT_FILLED_COMPLETELY` error message for [/v4/posting/fbs/ship](#operation/PostingAPI_ShipFbsPostingV4) method.


Link to Seller API Documentation

May 15, 2024

Method : What changed

/v1/product/import/stocks : Updated the method description. Method is deprecated and will be disabled. Switch to the latest version: it's specified in the method description.

— : In the [**Common errors**](#tag/Errors) section added descriptions of error messages: `Fatal error: You have more than 1 FBS warehouses. Please use API Method POST /v2/products/stocks`, `product_is_not_created`, `offer_id_not_found`, `FLAMMABLE_ONLY_ON_SELF_OR_PROVIDER_DELIVERY` and `WAREHOUSE_NOT_FOUND` for methods [/v2/products/stocks](#operation/ProductAPI_ProductsStocksV2) and [/v1/product/import/stocks](#operation/ProductAPI_ImportProductsStocks).

/v1/product/import/stocks, , /v2/products/stocks] : Updated the `result.errors.code` parameter description in the method response.


Link to Seller API Documentation

May 7, 2024

Method : What changed

/v2/finance/realization : Added a new version of the method to get a report on sold products.


Link to Seller API Documentation

May 2, 2024

Method : What changed

/v1/invoice/create-or-update : Method is deprecated and will be disabled on May 31, 2024. Switch to the latest version [/v2/invoice/create-or-update](#operation/InvoiceAPI_InvoiceCreateOrUpdateV2).

/v1/invoice/file/upload : Added the method for uploading an invoice.

/v1/invoice/get : Method is deprecated and will be disabled on May 31, 2024. Switch to the latest version [/v2/invoice/get](#operation/invoice_getV2).


Link to Seller API Documentation