Бухгалтерия просит «закрывающие», продавец идёт в кабинет и находит там десяток разных файлов. Часть из них действительно закрывает расчёты, часть нужна для склада, а часть вообще про маркировку. Разбираемся, что там есть на самом деле и почему все эти документы забираются одинаково.
Разбираем по спецификации Ozon Seller API, сверено 13 августа 2026 года. Состава колонок внутри файлов не приводим: площадка отдаёт ссылку на готовый XLSX, а его структуру спецификация не описывает.
Типов отчётов ровно двенадцать
Коротко: они лежат в одном справочнике, и «закрывающие» это только часть списка.
Тип отчёта приходит отдельным полем, и набор значений закрытый. Вот он целиком, сгруппированный по назначению.
| Назначение | Отчёты |
|---|---|
| Расчёты с площадкой | взаиморасчёты, компенсации, декомпенсации, продажи юридическим лицам |
| Товары и остатки | по товарам, об остатках, об уценённых товарах |
| Операции | о возвратах, об отправлениях, по продажам маркированных товаров |
| Хранение | стоимость размещения по товарам, стоимость размещения по поставкам |
Первая строка и есть то, что обычно имеют в виду под закрывающими документами. Остальные восемь к бухгалтерскому закрытию месяца отношения не имеют, но лежат рядом и потому регулярно попадают в один запрос «выгрузи всё».
Все отчёты получаются по одной схеме
Коротко: запрос возвращает код, файл забирается вторым обращением по этому коду.
Это главное, что экономит время. Не нужно изучать двенадцать разных механик: она одна.
- Вы запрашиваете формирование нужного отчёта.
- В ответ приходит уникальный код отчёта, а не сам файл.
- По этому коду запрашивается информация об отчёте, и в ней уже лежит ссылка на XLSX.
Есть и общий список ранее созданных отчётов, так что найти вчерашнюю выгрузку можно, не формируя её заново.
Четыре состояния генерации и одно поле ошибки
Коротко: очередь, обработка, готовность или неудача, причём про неудачу нужно спрашивать отдельно.
Состояний ровно четыре. waiting означает очередь, processing говорит, что идёт сборка, success сообщает о готовом файле со ссылкой, failed фиксирует неудачу.
Особенность именно этой пары полей: при неудаче рядом появляется код ошибки генерации, и без него причину не восстановить. Для интеграции это значит вот что. Проверять надо состояние, а не наличие ссылки: у отчёта в очереди ссылки тоже нет, но с ним всё в порядке, он просто ещё собирается. Разница между «ещё не готов» и «уже не будет» видна только в состоянии.
У ссылки на файл есть срок, а у возвратов он пять минут
Коротко: срок приходит отдельным полем и для одного типа отчёта измеряется минутами.
Вместе с готовым файлом площадка отдаёт время, после которого адрес перестанет работать. Для документов, собранных до 14 октября 2025 года, это поле приходит пустым: тогда механики срока ещё не было.
Резче всего ограничен отчёт о возвратах: его ссылка доступна пять минут после выполнения запроса. Отсюда и типовая жалоба, что адрес, сохранённый в задачу на вечер, к вечеру уже не открывается.
Для автоматизации отсюда следует одно требование: скачивание должно идти в том же проходе, что и получение ссылки. Схема «собрали адреса, ночью выгрузили пачкой» на отчёте о возвратах не работает в принципе, а на остальных типах держится только пока срок не истёк.
Что ещё приходит вместе с отчётом
Коротко: дата создания, код ошибки и фильтры, с которыми отчёт заказывали.
Кроме статуса и ссылки в ответе лежат три полезных поля. Дата создания отчёта, код ошибки при неудачной генерации и массив фильтров, которые были указаны при создании.
Последнее недооценивают. Через месяц по выгруженному файлу невозможно вспомнить, за какой период и с какими условиями его заказывали, а фильтры хранятся вместе с отчётом. Если строите архив закрывающих документов, сохраняйте их рядом с файлом.
Периоды у разных отчётов заданы по-разному
Коротко: где-то месяц целиком, где-то произвольные даты с ограничением длины.
Компенсации и декомпенсации запрашиваются парой «год и месяц», то есть только целым месяцем. У них же есть выбор языка отчёта, русский или английский.
У отчёта о выкупленных товарах правило другое: даты начала и конца выбираете вы сами, но интервал ограничен 31 днём. Квартал из-за этого собирается тремя запросами со склейкой на своей стороне.
Пару компенсаций и декомпенсаций заказывают за один месяц: по одной половине сумма не собирается. Что эти строки означают в общем расчёте с площадкой, показано в разборе акта сверки.
Чего в спецификации нет
Коротко: состава файлов, порядка учёта и правил начисления компенсаций.
Документация описывает механику: типы, статусы, сроки жизни ссылок, параметры запроса. В ней нет ответов на три вопроса, которые задают бухгалтеры: какие именно колонки внутри XLSX, как проводить документ в учёте и по каким правилам начисляются сами компенсации.
Первое зависит от версии файла, второе от вашей учётной системы, третье от правил площадки. Ни то, ни другое, ни третье мы здесь числами не описываем.
Как выгружать документы на практике
- Определить, какой именно отчёт нужен: под «закрывающими» чаще всего понимают взаиморасчёты, компенсации, декомпенсации и продажи юрлицам.
- Запросить формирование и сохранить код отчёта, а не ждать файл сразу.
- Читать статус явно, а не по факту наличия ссылки: у неудачной генерации есть свой код ошибки.
- Скачивать файл сразу после получения ссылки. Для отчёта о возвратах окно всего пять минут.
- Складывать рядом с файлом фильтры и дату создания: через месяц восстановить условия выгрузки будет нечем.
- Компенсации и декомпенсации брать за один и тот же месяц парой.
- Перед повторным формированием заглядывать в список созданных отчётов: возможно, нужный уже есть.
Короткие ответы
Как выгрузить отчёты Ozon
Механика одинакова для всех двенадцати типов: сначала запрос на формирование, в ответ код отчёта, затем обращение по этому коду за ссылкой на XLSX. Файл не приходит первым же ответом, и это не сбой, а устройство: тяжёлые отчёты собираются асинхронно. Отдельным методом можно посмотреть список уже созданных отчётов и не формировать выгрузку заново.
Как скачать отчёты в Ozon Seller
В кабинете документы лежат в разделе «Финансы», подраздел «Документы». Компенсации и прочие начисления вынесены в отдельный пункт с этим же названием. Если скачиваете через интеграцию, помните про срок действия ссылки: он приходит отдельным полем, а у отчёта о возвратах ссылка живёт всего пять минут.
Где взять закрывающие документы Ozon
Под закрывающими обычно понимают четыре документа: отчёт о взаиморасчётах, компенсации, декомпенсации и реестр продаж юридическим лицам. Все четыре формируются одинаково и лежат в разделе документов кабинета. Остальные восемь типов отчётов из справочника относятся к товарам, остаткам, отправлениям и хранению, и к закрытию месяца отношения не имеют.
Как провести отчёт о компенсации
Спецификация описывает, как документ получить: запрос за месяц в формате «год и месяц», код отчёта, затем ссылка на файл. Порядок проведения в бухгалтерском учёте она не описывает вовсе, потому что это зона вашей учётной системы, а не площадки. Единственное, что стоит учесть до проведения: компенсацию имеет смысл сверять с парной декомпенсацией за тот же месяц, иначе сумма будет неполной.
Что такое реестр продаж юридическим лицам
Это отдельный тип отчёта для сделок с юрлицами, и у него есть две версии метода: обычная и в формате JSON. Вторая удобна, когда данные идут сразу в учётную систему и промежуточный XLSX не нужен.
Где отчёт о возвратах и почему ссылка не открывается
Отчёт о возвратах формируется тем же способом, что и остальные, но у него самое короткое окно: ссылка доступна пять минут после выполнения запроса. Если файл скачивается фоновой задачей с задержкой, к моменту обращения адрес уже недействителен. Лечится это не повторными попытками, а скачиванием сразу в момент получения ссылки.
Что за отчёт по выкупленным товарам
Это документ по товарам, которые площадка выкупила сама. Период у него задаётся произвольными датами, но не длиннее 31 дня, поэтому квартал собирается из трёх запросов. Он относится к расчётам с площадкой и запрашивается отдельно от месячных отчётов.
Какие документы Ozon нужны для бухгалтерии
Из двенадцати типов к бухгалтерскому закрытию относятся четыре: взаиморасчёты, компенсации, декомпенсации и продажи юридическим лицам. Отчёт о реализации стоит особняком и разобран отдельно: что в него входит и чего в нём нет, описано в материале про отчёт о реализации.
Что запомнить
Типов отчётов двенадцать, и «закрывающими» в бухгалтерском смысле являются четыре: взаиморасчёты, компенсации, декомпенсации и реестр продаж юрлицам. Механика получения у всех одна: запрос возвращает код, файл забирается вторым обращением, у генерации четыре статуса. Ссылка на готовый файл действует ограниченное время, а у отчёта о возвратах всего пять минут. Состав колонок внутри файлов спецификацией не описан, поэтому строить автоматический разбор XLSX нужно с проверкой заголовков, а не вслепую.
Если каждое закрытие месяца превращается в сбор файлов по разным разделам, причина обычно не в бухгалтерии. Данные о товаре, отгрузках и возвратах живут в разных местах и не сводятся сами.
FulSystem отвечает за физическую часть этой цепочки: принимает партию, хранит, комплектует, отгружает по FBO и FBS и разбирает возвраты. Зафиксированное движение товара сокращает разбор расхождений: понятно, что и когда уехало со склада.
Стоимость складских операций под ваш объём считается в калькуляторе. Разбор самого отчёта о взаиморасчётах лежит в статье про акт сверки, а состояние кабинета по метрикам показано в материале про рейтинг продавца.
Источники
- Спецификация Ozon Seller API, метод информации об отчёте: двенадцать типов, четыре статуса генерации, ссылка на файл, срок её действия и оговорка про отчёты до 14 октября 2025 года, отдельное окно пять минут для отчёта о возвратах, поля даты создания, кода ошибки и фильтров. Сверено 13 августа 2026 года.
- Спецификация Ozon Seller API, методы отчётов о компенсациях и декомпенсациях: период в формате «год и месяц», выбор языка, путь в кабинете. Сверено 13 августа 2026 года.
- Спецификация Ozon Seller API, реестр продаж юридическим лицам в двух версиях и отчёт о выкупленных товарах с ограничением периода в 31 день. Сверено 13 августа 2026 года.
- Состав колонок внутри файлов, порядок проведения документов в учёте и правила начисления компенсаций спецификацией не описаны и здесь не приводятся.