Список возвратов покупателей

GET https://mrp.zolotenkov.ru/api/external/v1/sales-returns

Требуемое право ключа: read:sales

Возвраты покупателей постранично, по курсору, с фильтрами по статусу, исходному заказу и дате документа.

Параметры запроса

limit целое число необязателен

Сколько записей вернуть: от 1 до 200, по умолчанию 50
cursor строка необязателен

Курсор из поля next_cursor предыдущего ответа. Без него чтение начинается сначала
status строка необязателен

Статус возврата: NOT_RETURNED, PARTIALLY_RETURNED, RETURNED или CANCELLED
sales_order_id целое число необязателен

Только возвраты по этому заказу покупателя
created_after строка необязателен

Оформленные не раньше даты: created_date >= значение. ISO-8601 — дата 2026-08-01 (начало суток UTC) либо момент 2026-08-01T00:00:00Z
created_before строка необязателен

Оформленные раньше даты: created_date < значение. ISO-8601 — дата 2026-08-01 (начало суток UTC) либо момент 2026-08-01T00:00:00Z

Ответы

200 Страница списка возвратов покупателей
400 Недопустимое значение фильтра или курсора
401 Ключ не передан, недействителен или отозван
403 У ключа нет права read:sales
429 Превышена частота обращений. Задержка до повтора — в заголовке Retry-After

curl --request GET \ --url 'https://mrp.zolotenkov.ru/api/external/v1/sales-returns?limit=1' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Accept: application/json'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/sales-returns?limit=1", { method: "GET", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, }); const data = await response.json();

import requests response = requests.get( "https://mrp.zolotenkov.ru/api/external/v1/sales-returns?limit=1", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/sales-returns?limit=1'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ", "Accept: application/json", ], ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "data": [ { "cancellation_reason": "Покупатель товар не привез", "created_date": "2026-08-01T09:00:00Z", "customer_id": "42", "external_return_ref": "OZON-RET-88213", "id": "42", "notes": "Возврат по заявке покупателя", "number": "В-4", "refund_amount": 432, "return_date": "2026-08-01T09:00:00Z", "sales_order_id": "42", "sales_order_number": "ЗК-1", "source_type": "SALES_ORDER", "status": "NOT_RETURNED", "storage_place_id": "42", "tracking_info": "Трек СДЭК 1234567890" } ], "next_cursor": "eyJpZCI6NDJ9" }