March 29, 2024
Method : What changed
/v2/product/info : The `minValue` parameter in the method response is deprecated, we removed it from the documentation.
/v4/product/info/prices, /v2/product/info] : The `recommended_price` parameter in the method response is deprecated, we removed it from the documentation.
Link to Seller API Documentation
Method : What changed
/v2/product/info : The `minValue` parameter in the method response is deprecated, we removed it from the documentation.
/v4/product/info/prices, /v2/product/info] : The `recommended_price` parameter in the method response is deprecated, we removed it from the documentation.
Link to Seller API Documentation
April 1, 2024
Method / Section : What changed
/v1/carriage/get : Added the method to retrieve a shipping information.
/v1/carriage/pass/create : Added the method to create a pass.
/v1/carriage/pass/update : Added the method to update a pass.
/v1/carriage/pass/delete : Added the method to delete a pass.
/v1/return/pass/create : Added the method to create a pass for exporting returns.
/v1/return/pass/update : Added the method to update a return export pass.
/v1/return/pass/delete : Added the method to delete a return export pass.
/v1/pass/list : Added the method to get a list of passes.
/v1/returns/company/fbs/info : Added the method to get information about FBS returns and their quantity.
Methods Workflow : In sections [FBS Standard Scheme](#section/Managing-FBO-FBS-and-rFBS-orders/FBS-Standard-scheme) and [Get return shipments by barcode](#section/Get-return-shipments-by-barcode) described new methods for working with passes.
FBS delivery : Created the new section, transferred old methods into it and added a new one — [/v1/carriage/get](#operation/CarriageGet).
rFBS delivery : Created the new section and transferred old methods into it.
Link to Seller API Documentation
Method / Section : What changed
/v1/carriage/get : Added the method to retrieve a shipping information.
/v1/carriage/pass/create : Added the method to create a pass.
/v1/carriage/pass/update : Added the method to update a pass.
/v1/carriage/pass/delete : Added the method to delete a pass.
/v1/return/pass/create : Added the method to create a pass for exporting returns.
/v1/return/pass/update : Added the method to update a return export pass.
/v1/return/pass/delete : Added the method to delete a return export pass.
/v1/pass/list : Added the method to get a list of passes.
/v1/returns/company/fbs/info : Added the method to get information about FBS returns and their quantity.
Methods Workflow : In sections [FBS Standard Scheme](#section/Managing-FBO-FBS-and-rFBS-orders/FBS-Standard-scheme) and [Get return shipments by barcode](#section/Get-return-shipments-by-barcode) described new methods for working with passes.
FBS delivery : Created the new section, transferred old methods into it and added a new one — [/v1/carriage/get](#operation/CarriageGet).
rFBS delivery : Created the new section and transferred old methods into it.
Link to Seller API Documentation
April 8, 2024
Method : What changed
/v1/product/pictures/import, , /v1/product/pictures/info : Changed `failed` to `pending` status of the `result.pictures.state` field in the method response.
Link to Seller API Documentation
Method : What changed
/v1/product/pictures/import, , /v1/product/pictures/info : Changed `failed` to `pending` status of the `result.pictures.state` field in the method response.
Link to Seller API Documentation
April 9, 2024
Method / Section : What changed
/v1/carriage/get : Updated the `status` parameter description in the method response.
Link to Seller API Documentation
Method / Section : What changed
/v1/carriage/get : Updated the `status` parameter description in the method response.
Link to Seller API Documentation
April 16, 2024
Method : What changed
/v3/finance/transaction/list : Updated the `result.operations.services.name` parameter description in the method response.
/v1/pricing-strategy/product/info : Added the method description.
/v3/product/import : Added information about uploading video covers to the method description.
— : In the [**Common errors**](#tag/Errors) section for [/v2/products/stocks](#operation/ProductAPI_ProductsStocksV2) method:
• removed `SKU STOCK NOT CHANGED` error description;
• added `NOT_FOUND_ERROR` error description.
— : Added information about getting `exemplar_id` parameter by [/v5/fbs/posting/product/exemplar/create-or-get](#operation/PostingAPI_FbsPostingProductExemplarCreateOrGet) method to the [**Methods Workflow → FBS Standard scheme**](#section/Managing-FBO-FBS-and-rFBS-orders/FBS-Standard-scheme) section.
Link to Seller API Documentation
Method : What changed
/v3/finance/transaction/list : Updated the `result.operations.services.name` parameter description in the method response.
/v1/pricing-strategy/product/info : Added the method description.
/v3/product/import : Added information about uploading video covers to the method description.
— : In the [**Common errors**](#tag/Errors) section for [/v2/products/stocks](#operation/ProductAPI_ProductsStocksV2) method:
• removed `SKU STOCK NOT CHANGED` error description;
• added `NOT_FOUND_ERROR` error description.
— : Added information about getting `exemplar_id` parameter by [/v5/fbs/posting/product/exemplar/create-or-get](#operation/PostingAPI_FbsPostingProductExemplarCreateOrGet) method to the [**Methods Workflow → FBS Standard scheme**](#section/Managing-FBO-FBS-and-rFBS-orders/FBS-Standard-scheme) section.
Link to Seller API Documentation
April 26, 2024
Method : What changed
— : In the [**Common errors**](#tag/Errors) section added descriptions of error messages: errors `GTD_IS_REQUIRED_ONLY_FOR_LEGAL_CUSTOMER` and `EXEMPLAR_ID does not belong to product PRODUCT_ID` for methods [/v4/fbs/posting/product/exemplar/set](#operation/PostingAPI_SetProductExemplar) and [/v5/fbs/posting/product/exemplar/set](#operation/PostingAPI_FbsPostingProductExemplarSet).
Link to Seller API Documentation
Method : What changed
— : In the [**Common errors**](#tag/Errors) section added descriptions of error messages: errors `GTD_IS_REQUIRED_ONLY_FOR_LEGAL_CUSTOMER` and `EXEMPLAR_ID does not belong to product PRODUCT_ID` for methods [/v4/fbs/posting/product/exemplar/set](#operation/PostingAPI_SetProductExemplar) and [/v5/fbs/posting/product/exemplar/set](#operation/PostingAPI_FbsPostingProductExemplarSet).
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
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
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
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 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
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 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
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 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
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 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
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 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
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
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
Section : What changed
Methods Workflow : Added information about [products reservation](#section/Updating-prices-and-product-stocks/Reserve-products).
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
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 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
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 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
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
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
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
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
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
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
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 8, 2024
Method : What changed
Push Notifications : Described the errors that may occur when enabling push notifications.
Link to Seller API Documentation
Method : What changed
Push Notifications : Described the errors that may occur when enabling push notifications.
Link to Seller API Documentation