### Upload Multiple Product Videos Example Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md This example demonstrates how to upload multiple videos for a product by structuring the `values` array within `complex_attributes` to include multiple video names and links. ```json { "complex_id": 100001, "id": 21837, "values": [ { "value": "videoName_1" }, { "value": "videoName_2" } ] }, { "complex_id": 100001, "id": 21841, "values": [ { "value": "https://www.youtube.com/watch?v=ZwM0iBn03dY" }, { "value": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" } ] } ``` -------------------------------- ### Get Reviews Response (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/working-with-reviews.md This is an example of a successful response when retrieving a list of reviews. It contains pagination information and an array of review details. ```json { "has_next": true, "last_id": "string", "reviews": [ { "comments_amount": 0, "id": "string", "is_rating_participant": true, "order_status": "string", "photos_amount": 0, "published_at": "2019-08-24T14:15:22Z", "rating": 0, "sku": 0, "status": "string", "text": "string", "videos_amount": 0 } ] } ``` -------------------------------- ### List Discount Requests Payload Example Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/promotions.md Example JSON payload for requesting a list of discount requests. Specify status, page number, and limit. ```json { "status": "UNKNOWN", "page": 1, "limit": 50 } ``` -------------------------------- ### List Passes Response Body Example (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/passes.md This is an example of a successful response (200 OK) when listing passes. It contains an array of arrival passes and a cursor for pagination. ```json { "arrival_passes": [ { "arrival_pass_id": 0, "arrival_reasons": [ "string" ], "arrival_time": "2019-08-24T14:15:22Z", "driver_name": "string", "driver_phone": "string", "dropoff_point_id": 0, "is_active": true, "vehicle_license_plate": "string", "vehicle_model": "string", "warehouse_id": 0 } ], "cursor": "string" } ``` -------------------------------- ### Product Category Tree Response Example Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/ozon-attributes-and-characteristics.md Example of a successful response (200 OK) containing the product category tree structure. Each category includes its ID, name, disabled status, and a list of children categories or types. ```json { "result": [ { "description_category_id": 0, "category_name": "string", "disabled": false, "children": [ { "description_category_id": 0, "category_name": "string", "disabled": false, "children": [ { "type_name": "sting", "type_id": 0, "disabled": false, "children": [ ] } ] } ] } ] } ``` -------------------------------- ### Product Queries Analytics Request Example Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/premium-methods.md This is an example of a request payload to get product queries analytics. It includes parameters for date range, pagination, SKUs, and sorting. ```json { "date_from": "2019-08-24T14:15:22Z", "date_to": "2019-08-24T14:15:22Z", "page": 0, "page_size": 1000, "skus": [ "string" ], "sort_by": "BY_SEARCHES", "sort_dir": "DESCENDING" } ``` -------------------------------- ### Get Product Rating by SKU Response (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md This is an example of a successful response (200 OK) containing product content ratings and detailed group-wise ratings. It includes SKU, overall rating, and breakdown by characteristic groups. ```json { "products": [ { "sku": 179737222, "rating": 42.5, "groups": [ { "key": "media", "name": "Медиа", "rating": 70, "weight": 25, "conditions": [ { "key": "media_images_2", "description": "Добавлено 2 изображения", "fulfilled": true, "cost": 50 }, { "key": "media_images_3", "description": "Добавлено 3 изображения и более", "fulfilled": true, "cost": 20 }, { "key": "media_image_3d", "description": "Добавлено 3D-изображение", "fulfilled": false, "cost": 15 }, { "key": "media_video", "description": "Добавлено видео", "fulfilled": false, "cost": 15 } ], "improve_attributes": [ { "id": 4074, "name": "Код ролика на YouTube" }, { "id": 4080, "name": "3D-изображение" } ], "improve_at_least": 2 }, { "key": "important_attributes", "name": "Важные атрибуты", "rating": 50, "weight": 30, "conditions": [ { "key": "important_2", "description": "Заполнено 2 атрибута и более", "fulfilled": true, "cost": 50 }, { "key": "important_50_percent", "description": "Заполнено более 50% атрибутов", "fulfilled": false, "cost": 25 }, { "key": "important_70_percent", "description": "Заполнено более 70% атрибутов", "fulfilled": false, "cost": 25 } ], "improve_attributes": [ { "id": 4385, "name": "Гарантийный срок" }, { "id": 4389, "name": "Страна-изготовитель" }, { "id": 8513, "name": "Количество в упаковке, шт" }, { "id": 8590, "name": "Макс. диагональ, дюймы" }, { "id": 8591, "name": "Мин. диагональ, дюймы" }, { "id": 9336, "name": "Модель браслета/умных часов" }, { "id": 11046, "name": "Покрытие" }, { "id": 11047, "name": "Прозрачность покрытия" }, { "id": 11048, "name": "Дополнительные свойства покрытия" }, { "id": 11049, "name": "Вид стекла" }, { "id": 11603, "name": "Размер циферблата" } ], "improve_at_least": 6 }, { "key": "other_attributes" } ] } ] } ``` -------------------------------- ### GET /v1/finance/realization/posting Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/news.md Retrieves a sales report by order. This is a beta method. ```APIDOC ## GET /v1/finance/realization/posting ### Description Added a beta method for getting a sales report by order. ### Method GET ### Endpoint /v1/finance/realization/posting ``` -------------------------------- ### Response Sample for Products in Promotion (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/promotions.md This is a sample successful response containing a list of products eligible for a promotion. It includes product details like ID, prices, stock information, and pagination details. ```json { "result": { "products": [ { "id": 226, "price": 250, "action_price": 0, "alert_max_action_price_failed": true, "alert_max_action_price": 31, "max_action_price": 175, "add_mode": "NOT_SET", "stock": 0, "min_stock": 0 }, { "id": 1366, "price": 2300, "action_price": 630, "alert_max_action_price_failed": true, "alert_max_action_price": 31, "max_action_price": 770, "add_mode": "MANUAL", "stock": 0, "min_stock": 0 } ], "total": 2, "last_id": "bnVсbA==" } } ``` -------------------------------- ### Get Category Characteristics Response (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/ozon-attributes-and-characteristics.md Example JSON response for a successful request to get category characteristics. The 'result' array contains detailed information about each attribute. ```json { "result": [ { "category_dependent": true, "description": "string", "dictionary_id": 0, "group_id": 0, "group_name": "string", "id": 0, "is_aspect": true, "is_collection": true, "is_required": true, "name": "string", "type": "string", "attribute_complex_id": 0, "max_value_count": 0, "complex_is_collection": true } ] } ``` -------------------------------- ### Upload Product Video Example Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md This snippet shows how to structure the request to upload a video for a product. It involves passing video links and names within the `complex_attributes` array. ```json { "complex_id": 100001, "id": 21841, "values": [ { "value": "https://www.youtube.com/watch?v=ZwM0iBn03dY" } ] } ``` ```json { "complex_id": 100001, "id": 21837, "values": [ { "value": "videoName_1" } ] } ``` -------------------------------- ### Chat History Request Payload Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/chats-with-customers.md Example of a JSON payload to request chat history. Specify chat ID, direction, starting message ID, and limit. ```json { "chat_id": "18b8e1f9-4ae7-461c-84ea-8e1f54d1a45e", "direction": "Forward", "from_message_id": 3000000000118032000, "limit": 1 } ``` -------------------------------- ### Response Sample for Creating or Getting Product Exemplar Data (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/fbs-and-rfbs-products-labeling-and-order-packaging.md This is a successful response (200 OK) containing data about product items, including shipment details and a list of products with their exemplars. It may include quantities, exemplar IDs, and information about required markings or identifiers. ```json { "multi_box_qty": 0, "posting_number": "string", "products": [ { "exemplars": [ { "exemplar_id": 0, "gtd": "string", "is_gtd_absent": true, "is_rnpt_absent": true, "marks": [ { "mark": "string", "mark_type": "string" } ], "rnpt": "string" } ], "has_imei": true, "is_gtd_needed": true, "is_jw_uin_needed": true, "is_mandatory_mark_needed": true, "is_mandatory_mark_possible": true, "is_rnpt_needed": true, "product_id": 0, "quantity": 0 } ] } ``` -------------------------------- ### Response Sample: Strategy IDs by Product IDs Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/pricing-strategies.md Example of a successful response when retrieving strategy identifiers for products. It includes product information with their corresponding strategy IDs. ```json { "result": { "products_info": [ { "product_id": 29209, "strategy_id": "b7cd30e6-5667-424d-b105-fbec30a52477" } ] } } ``` -------------------------------- ### Get Status of Canceled Supply Request Response (Success) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/creation-and-management-of-fbo-supply-requests.md Example response indicating a successful cancellation of a supply request. Includes details about canceled supplies and the overall status. ```json { "error_reasons": [ "INVALID_ORDER_STATE" ], "result": { "is_order_cancelled": true, "supplies": [ { "error_reasons": [ "INVALID_SUPPLY_STATE" ], "is_supply_cancelled": true, "supply_id": 0 } ] }, "status": "SUCCESS" } ``` -------------------------------- ### Get Barcode Value for Return Shipments Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/return-shipments.md Use this method to retrieve the barcode value in text format for return shipments. This is useful when you need the barcode data itself, for example, to display it or process it further. ```json { } ``` ```json { "barcode": "string" } ``` -------------------------------- ### Response Sample: Products in a Strategy Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/pricing-strategies.md Example of a successful response when listing products within a strategy. It returns an object containing an array of product IDs. ```json { "result": { "product_id": [ "string" ] } } ``` -------------------------------- ### Response Sample for Discounted Product Info (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/prices-and-stocks.md This is a sample successful response containing information about a discounted product and its main product SKU. It includes details on condition, damage, and packaging. ```json { "items": [ { "discounted_sku": 635548518, "sku": 320067758, "condition_estimation": "4", "packaging_violation": "", "warranty_type": "", "reason_damaged": "Механическое повреждение", "comment_reason_damaged": "повреждена заводская упаковка", "defects": "", "mechanical_damage": "", "package_damage": "", "shortage": "", "repair": "", "condition": "" } ] } ``` -------------------------------- ### Get Category Characteristics Request Payload Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/ozon-attributes-and-characteristics.md Example JSON payload for requesting category characteristics. Ensure 'description_category_id' and 'type_id' are set to valid identifiers obtained from the category tree endpoint. ```json { "description_category_id": 0, "language": "DEFAULT", "type_id": 0 } ``` -------------------------------- ### List Products Associated with Certificate Response Sample Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/quality-certificates.md Sample response for listing products associated with a certificate. Includes a result object with a list of items (product ID and status code) and the total count. ```json { "result": { "items": [ { "product_id": 0, "product_status_code": "string" } ], "count": 0 } } ``` -------------------------------- ### Get Product Attributes Request Payload Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md Example JSON payload for requesting product attributes. It demonstrates filtering by product ID, offer ID, SKU, and visibility, along with setting limits, last ID, and sort direction. ```json { "filter": { "product_id": [ "213761435" ], "offer_id": [ "testtest5" ], "sku": [ "123495432" ], "visibility": "ALL" }, "limit": 100, "last_id": "okVsfA==«", "sort_dir": "ASC" } ``` -------------------------------- ### Response Sample for Unpaid Legal Product List (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/fbs-and-rfbs-orders-processing.md This is a sample successful response (200 OK) containing a list of unpaid products. It includes product details, quantity, name, image URL, and a cursor for fetching the next page of results. ```json { "products": [ { "product_id": 145123054, "offer_id": "10032", "quantity": 1, "name": "Телевизор LG", "image_url": "https://cdn1.ozon.ru/multimedia/10741275.jpg" } ], "cursor": "hCGiPPopcBFMgMErdzaCEpzQfinuPyEhUoSmBMADuoFAhBjXeA==" } ``` -------------------------------- ### Successful Response (200) for Get Shipments List Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/working-with-digital-products.md This is an example of a successful response when retrieving a list of shipments. It contains an array of shipment objects, each detailing order information, status, product details, and financial data. Use this to verify the structure of returned shipment data. ```json { "result": [ { "order_id": 354680487, "order_number": "16965409-0014", "posting_number": "16965409-0014-1", "status": "awaiting_packaging", "cancel_reason_id": 0, "created_at": "2021-09-01T00:23:45.607000Z", "in_process_at": "2021-09-01T00:25:30.120000Z", "waiting_deadline_for_digital_code": "2025-06-16T10:12:00.664Z", "legal_info": { "company_name": "string", "inn": "string", "kpp": "string" }, "products": [ { "sku": 160249683, "name": "Так говорил Омар Хайям. Жизнеописание. Афоризмы и рубайят. Классика в словах и картинках", "offer_id": "978-5-906864-56-7", "price": "81.00", "required_qty_for_digital_code": 3, "currency_code": "RUB" } ], "analytics_data": { "city": "", "delivery_type": "PVZ", "is_premium": false, "payment_type_group_name": "Карты оплаты", "warehouse_id": 17717042026000, "warehouse_name": "РОСТОВ-НА-ДОНУ_РФЦ", "is_legal": false }, "financial_data": { "products": [ { "commission_amount": 12.15, "commission_percent": 15, "payout": 68.85, "product_id": 160249683, "currency_code": "RUB", "old_price": 115, "price": 81, "total_discount_value": 34, "total_discount_percent": 29.57, "actions": [ "Системная виртуальная скидка селлера" ] } ] }, "additional_data": [ ] } ] } ``` -------------------------------- ### Create Product by SKU Response (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md A successful response for creating a product by SKU, returning the task ID for the import process and a list of unmatched SKUs. ```json { "result": { "task_id": 176594213, "unmatched_sku_list": [] } } ``` -------------------------------- ### Get details about the items Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/fbs-and-rfbs-products-labeling-and-order-packaging.md Use this method to get product item details from a shipment and the exemplar_id. ```APIDOC ## POST /v5/fbs/posting/product/exemplar/create-or-get ### Description Retrieves details for product items within a shipment using the `posting_number` and `exemplar_id`. ### Method POST ### Endpoint /v5/fbs/posting/product/exemplar/create-or-get ### Parameters #### Header Parameters - **Client-Id** (string) - Required - Client ID. - **Api-Key** (string) - Required - API key. #### Request Body - **posting_number** (string) - Required - Shipment number. ### Request Example ```json { "posting_number": "string" } ``` ### Response #### Success Response (200) - **multi_box_qty** (integer) - Quantity of boxes the product is packed in. - **posting_number** (string) - Shipment number. - **products** (Array of objects) - Product list. - **exemplars** (Array of objects) - List of exemplars for the product. - **exemplar_id** (integer) - The ID of the exemplar. - **gtd** (string) - GTD (Goods Transport Declaration) number. - **is_gtd_absent** (boolean) - Indicates if GTD is absent. - **is_rnpt_absent** (boolean) - Indicates if RNPT is absent. - **mandatory_mark** (string) - Mandatory mark information. - **rnpt** (string) - RNPT (Russian National Product Trace) identifier. - **jw_uin** (string) - JW UIN. - **is_gtd_needed** (boolean) - Indicates if GTD is needed for the product. - **is_mandatory_mark_needed** (boolean) - Indicates if a mandatory mark is needed. - **is_rnpt_needed** (boolean) - Indicates if RNPT is needed for the product. - **product_id** (integer) - The ID of the product. - **quantity** (integer) - The quantity of the product. #### Response Example ```json { "multi_box_qty": 0, "posting_number": "string", "products": [ { "exemplars": [ { "exemplar_id": 0, "gtd": "string", "is_gtd_absent": true, "is_rnpt_absent": true, "mandatory_mark": "string", "rnpt": "string", "jw_uin": "string" } ], "is_gtd_needed": true, "is_mandatory_mark_needed": true, "is_rnpt_needed": true, "product_id": 0, "quantity": 0 } ] } ``` ``` -------------------------------- ### Get Finance Products Buyout Report (Beta) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/news.md Retrieves a report for purchased products. This is a beta method. ```APIDOC ## GET /v1/finance/products/buyout ### Description Added a beta method for getting purchased product report. ### Method GET ### Endpoint /v1/finance/products/buyout ``` -------------------------------- ### Product List Response (200 OK) Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md Example JSON response for a successful product list retrieval. It includes product details, total count, and the last_id for pagination. ```json { "result": { "items": [ { "archived": true, "has_fbo_stocks": true, "has_fbs_stocks": true, "is_discounted": true, "offer_id": "136748", "product_id": 223681945, "quants": [ { "quant_code": "string", "quant_size": 0 } ] } ], "total": 1, "last_id": "bnVсbA==" } } ``` -------------------------------- ### List Passes Request Body Example Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/passes.md This is an example of the JSON payload used to request a list of passes. It includes optional filters and a limit for the number of entries. ```json { "cursor": "", "filter": { "arrival_pass_ids": [ "string" ], "arrival_reason": "string", "dropoff_point_ids": [ "string" ], "only_active_passes": true, "warehouse_ids": [ "string" ] }, "limit": 1000 } ``` -------------------------------- ### Get Product Import Status Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md Allows you to get the status of a product description page creation or update process. This is useful for tracking the progress of bulk product imports. ```APIDOC ## POST /v1/product/import/info ### Description Allows you to get the status of a product description page creation or update process. ### Method POST ### Endpoint /v1/product/import/info ### Parameters #### Header Parameters - **Client-Id** (string) - Required - Client ID. - **Api-Key** (string) - Required - API key. #### Request Body - **task_id** (integer) - Required - Importing products task code. You can get it using the [/v3/product/import](https://docs.ozon.ru/api/seller/en?__rr=1#operation/ProductAPI_ImportProductsV3) method. ### Request Example ```json { "task_id": "172549793" } ``` ### Response #### Success Response (200) - **result** (object) - Product import status. - **items** (Array of objects) - Product details. - **total** (integer) - Product identifier in the seller's system. #### Response Example ```json { "result": { "items": [ { "offer_id": "143210608", "product_id": 137285792, "status": "imported", "errors": [] } ], "total": 1 } } ``` ``` -------------------------------- ### Get ETGB Customs Declarations Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/fbs-and-rfbs-orders-processing.md Method for getting Elektronik Ticaret Gümrük Beyannamesi (ETGB) customs declarations for sellers from Turkey. Requires date range for filtering. ```json { "date": { "from": "2023-02-13T12:13:16.818Z", "to": "2023-02-13T12:13:16.818Z" } } ``` -------------------------------- ### Create or Get Product Exemplar Data Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/managing-fbo-fbs-and-rfbs-orders.md Retrieves data about created items or creates new ones for the “Chestny ZNAK” system. ```APIDOC ## POST /v5/fbs/posting/product/exemplar/create-or-get ### Description Retrieves data about created items or creates new ones for the “Chestny ZNAK” system. ### Method POST ### Endpoint /v5/fbs/posting/product/exemplar/create-or-get ### Request Body - **posting_number** (string) - Required - Posting number. - **products** (array) - Required - List of products. - **sku** (string) - Required - Product SKU. - **exemplar_codes** (array) - Required - List of labeling codes. - **code** (string) - Required - Labeling code. ### Request Example { "posting_number": "1234567890-06", "products": [ { "sku": "SKU102", "exemplar_codes": [ { "code": "CODE1122334455" } ] } ] } ### Response #### Success Response (200) - **exemplars** (array) - List of product exemplars. - **sku** (string) - Product SKU. - **code** (string) - Labeling code. - **created** (boolean) - Indicates if the exemplar was created. #### Response Example { "result": { "exemplars": [ { "sku": "SKU102", "code": "CODE1122334455", "created": true } ] } } ``` -------------------------------- ### Pack Order Request Body Example with Additional Data Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/fbs-and-rfbs-products-labeling-and-order-packaging.md An example of the request body for packing an order, including the 'with.additional_data' field to request additional shipment information. ```json { "packages": [ { "products": [ { "product_id": 185479045, "quantity": 1 } ] } ], "posting_number": "89491381-0072-1", "with": { "additional_data": true } } ``` -------------------------------- ### Finance Transactions Response Example Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/finance.md This is an example of a successful (200 OK) response when retrieving financial transactions. It includes details about operations, page count, and row count. ```json { "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 } } ``` -------------------------------- ### Product Response Sample Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products-1.md This snippet provides a sample JSON response for product-related API calls, illustrating the structure and fields returned upon successful operations. It includes details about product attributes, pricing, stock, and status. ```APIDOC ## Product Response ### Description This is a sample response structure for product-related API operations. It details various attributes of a product, including its identification, pricing, stock information, images, and status. ### Response #### Success Response (200) - **items** (array) - A list of product objects. - **barcodes** (array of string) - List of product barcodes. - **color_image** (array of string) - URLs for color images. - **commissions** (array of object) - Commission details for the product. - **delivery_amount** (number) - Delivery cost. - **percent** (number) - Commission percentage. - **return_amount** (number) - Return cost. - **sale_schema** (string) - Sale schema identifier. - **value** (number) - Commission value. - **created_at** (string) - Timestamp of creation (ISO 8601 format). - **currency_code** (string) - Currency code for pricing. - **description_category_id** (number) - Category ID for description. - **discounted_fbo_stocks** (number) - Discounted FBO stock quantity. - **errors** (array of object) - List of errors encountered during processing. - **attribute_id** (number) - ID of the attribute related to the error. - **code** (string) - Error code. - **field** (string) - Field name where the error occurred. - **level** (string) - Error level (e.g., ERROR_LEVEL_UNSPECIFIED). - **state** (string) - Current state of the error. - **texts** (object) - Error message details. - **attribute_name** (string) - Name of the attribute. - **description** (string) - Detailed error description. - **hint_code** (string) - Hint code for the error. - **message** (string) - Error message. - **params** (array of object) - Parameters for the error message. - **name** (string) - Parameter name. - **value** (string) - Parameter value. - **short_description** (string) - Short error description. - **has_discounted_fbo_item** (boolean) - Indicates if the item has discounted FBO stock. - **id** (number) - Unique product identifier. - **images** (array of string) - URLs for product images. - **images360** (array of string) - URLs for 360-degree product images. - **is_archived** (boolean) - Indicates if the product is archived. - **is_autoarchived** (boolean) - Indicates if the product is auto-archived. - **is_discounted** (boolean) - Indicates if the product is discounted. - **is_kgt** (boolean) - Indicates if the product is KGT. - **is_prepayment_allowed** (boolean) - Indicates if prepayment is allowed. - **is_super** (boolean) - Indicates if the product is a super product. - **marketing_price** (string) - Marketing price of the product. - **min_price** (string) - Minimum price of the product. - **model_info** (object) - Information about the product model. - **count** (number) - Count of models. - **model_id** (number) - Model ID. - **name** (string) - Product name. - **offer_id** (string) - Offer ID. - **old_price** (string) - Old price of the product. - **price** (string) - Current price of the product. - **price_indexes** (object) - Price index data. - **color_index** (string) - Color index. - **external_index_data** (object) - External price index data. - **minimal_price** (string) - Minimal price from external index. - **minimal_price_currency** (string) - Currency of minimal external price. - **price_index_value** (number) - Price index value. - **ozon_index_data** (object) - Ozon price index data. - **minimal_price** (string) - Minimal price from Ozon index. - **minimal_price_currency** (string) - Currency of minimal Ozon price. - **price_index_value** (number) - Price index value. - **self_marketplaces_index_data** (object) - Self-marketplaces price index data. - **minimal_price** (string) - Minimal price from self-marketplaces index. - **minimal_price_currency** (string) - Currency of minimal self-marketplaces price. - **price_index_value** (number) - Price index value. - **primary_image** (array of string) - URLs for primary product image. - **promotions** (array of object) - Active promotions for the product. - **is_enabled** (boolean) - Whether the promotion is enabled. - **type** (string) - Type of promotion. - **sku** (number) - Stock Keeping Unit. - **sources** (array of object) - Stock sources. - **created_at** (string) - Timestamp of source creation. - **quant_code** (string) - Quantity code. - **shipment_type** (string) - Type of shipment. - **sku** (number) - SKU of the source. - **source** (string) - Source identifier. - **statuses** (object) - Product statuses. - **is_created** (boolean) - Indicates if the product is created. - **moderate_status** (string) - Moderation status. - **status** (string) - Overall status. - **status_description** (string) - Description of the status. - **status_failed** (string) - Reason for status failure. - **status_name** (string) - Name of the status. - **status_tooltip** (string) - Tooltip for the status. - **status_updated_at** (string) - Timestamp of last status update. - **validation_status** (string) - Validation status. - **stocks** (object) - Stock information. - **has_stock** (boolean) - Indicates if there is stock available. - **stocks** (array of object) - List of stock details per source. - **present** (number) - Quantity in stock. - **reserved** (number) - Quantity reserved. - **sku** (number) - SKU for the stock. - **source** (string) - Source of the stock. - **type_id** (number) - Product type ID. - **updated_at** (string) - Timestamp of last update (ISO 8601 format). - **vat** (string) - VAT rate. - **visibility_details** (object) - Visibility details. - **has_price** (boolean) - Indicates if the product has a price. - **has_stock** (boolean) - Indicates if the product has stock. - **volume_weight** (number) - Volume weight of the product. ### Response Example ```json { "items": [ { "barcodes": [ "string" ], "color_image": [ "string" ], "commissions": [ { "delivery_amount": 0, "percent": 0, "return_amount": 0, "sale_schema": "string", "value": 0 } ], "created_at": "2019-08-24T14:15:22Z", "currency_code": "string", "description_category_id": 0, "discounted_fbo_stocks": 0, "errors": [ { "attribute_id": 0, "code": "string", "field": "string", "level": "ERROR_LEVEL_UNSPECIFIED", "state": "string", "texts": { "attribute_name": "string", "description": "string", "hint_code": "string", "message": "string", "params": [ { "name": "string", "value": "string" } ], "short_description": "string" } } ], "has_discounted_fbo_item": true, "id": 0, "images": [ "string" ], "images360": [ "string" ], "is_archived": true, "is_autoarchived": true, "is_discounted": true, "is_kgt": true, "is_prepayment_allowed": true, "is_super": true, "marketing_price": "string", "min_price": "string", "model_info": { "count": 0, "model_id": 0 }, "name": "string", "offer_id": "string", "old_price": "string", "price": "string", "price_indexes": { "color_index": "COLOR_INDEX_UNSPECIFIED", "external_index_data": { "minimal_price": "string", "minimal_price_currency": "string", "price_index_value": 0 }, "ozon_index_data": { "minimal_price": "string", "minimal_price_currency": "string", "price_index_value": 0 }, "self_marketplaces_index_data": { "minimal_price": "string", "minimal_price_currency": "string", "price_index_value": 0 } }, "primary_image": [ "string" ], "promotions": [ { "is_enabled": true, "type": "UNSPECIFIED" } ], "sku": 0, "sources": [ { "created_at": "2019-08-24T14:15:22Z", "quant_code": "string", "shipment_type": "SHIPMENT_TYPE_UNSPECIFIED", "sku": 0, "source": "string" } ], "statuses": { "is_created": true, "moderate_status": "string", "status": "string", "status_description": "string", "status_failed": "string", "status_name": "string", "status_tooltip": "string", "status_updated_at": "2019-08-24T14:15:22Z", "validation_status": "string" }, "stocks": { "has_stock": true, "stocks": [ { "present": 0, "reserved": 0, "sku": 0, "source": "string" } ] }, "type_id": 0, "updated_at": "2019-08-24T14:15:22Z", "vat": "string", "visibility_details": { "has_price": true, "has_stock": true }, "volume_weight": 0 } ] } ``` ``` -------------------------------- ### Get Economy Products List Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/news.md Retrieves a list of economy products. This is a beta method. ```APIDOC ## GET /v1/product/quant/list ### Description Retrieves a list of economy products. This is a beta method. ### Method GET ### Endpoint /v1/product/quant/list ``` -------------------------------- ### Getting Discounted Product Information Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/uploading-and-updating-products.md Retrieve information about markdown and the main product using the markdown product SKU. ```APIDOC ## GET /v1/product/info/discounted ### Description Retrieves information about the markdown and the main product by the markdown product SKU. ### Method GET ### Endpoint /v1/product/info/discounted ### Parameters (Details not provided in source) ### Response (Details not provided in source) ``` -------------------------------- ### Supply or supply request contents Source: https://github.com/dragonsigh/ozon-seller-api-docs/blob/master/fbo.md Use the method for getting the contents of a supply or draft supply request. A single call to the method can get the contents of one supply or one draft supply request. ```APIDOC ## POST /v1/supply-order/bundle ### Description Use the method for getting the contents of a supply or draft supply request. A single call to the method can get the contents of one supply or one draft supply request. ### Method POST ### Endpoint /v1/supply-order/bundle ### Parameters #### Request Body - **bundle_ids** (Array of strings) - Required - Identifiers of supply contents. You can get them using the [/v2/supply-order/get](https://docs.ozon.ru/api/seller/en?__rr=1#operation/SupplyOrderAPI_GetSupplyOrdersV2) method. - **is_asc** (boolean) - Optional - `true`, to sort in ascending order. - **item_tags_calculation** (object) - Optional - List of warehouses for determining product tags. - **last_id** (string) - Optional - Identifier of the last SKU value on the page. - **limit** (integer) - Required - Number of products on the page. [ 1 .. 100 ] - **query** (string) - Optional - Search query, for example: by name, article code, or SKU. - **sort_field** (string) - Optional - Default: "UNSPECIFIED". Enum: "UNSPECIFIED" "SKU" "NAME" "QUANTITY" "TOTAL_VOLUME_IN_LITRES". Sorting by parameters: SKU, NAME, QUANTITY, TOTAL_VOLUME_IN_LITRES. ### Request Example ```json { "bundle_ids": [ "string" ], "is_asc": true, "item_tags_calculation": { "dropoff_warehouse_id": 0, "storage_warehouse_ids": [ "string" ] }, "last_id": "string", "limit": 100, "query": "string", "sort_field": "UNSPECIFIED" } ``` ### Response #### Success Response (200) - **items** (Array of objects) - List of products in the supply request. - **total_count** (integer) - Quantity of products in the request. - **has_next** (boolean) - Indication that the response hasn't returned all products: `true`: create another request with a different `last_id` value to get the remaining values; `false`: the response contains all characteristic values. - **last_id** (string) - Identifier of the last value on the page. #### Response Example ```json { "items": [ { "icon_path": "string", "sku": 0, "name": "string", "quantity": 0, "barcode": "string", "product_id": 0, "quant": 0, "is_quant_editable": true, "volume_in_litres": 0, "total_volume_in_litres": 0, "contractor_item_code": "string", "sfbo_attribute": "ITEM_SFBO_ATTRIBUTE_UNSPECIFIED", "shipment_type": "BUNDLE_ITEM_SHIPMENT_TYPE_UNSPECIFIED", "tags": [ "EVSD_REQUIRED" ] } ], "total_count": 0, "has_next": true, "last_id": "string" } ``` ```