Отчёт об услугах Маркета можно заказать по датам начисления либо по месяцу акта. Эти выборки отвечают на разные вопросы и не должны складываться как независимые расходы.

Определите вопрос до формирования файла

Если команда разбирает расходы за рабочий интервал, ей может понадобиться выборка по датам начисления услуг. Если бухгалтерия закрывает документы определённого месяца, нужен отбор по месяцу и году акта. Официальный API отчёта об услугах поддерживает оба варианта. Разница заключается в основании отбора, а не в формате скачанного файла или названии внутренней таблицы.

Запишите назначение выгрузки рядом с периодом: например, оперативная сверка начислений либо сопоставление с актом. Без этой записи два сотрудника могут получить разные суммы и ошибочно решить, что одна интеграция сломана. Сначала сравните критерии отбора, затем строки. Общий подход к финансовым периодам Маркета помогает сохранить различие между событием, документом и выплатой.

Передайте одну группу параметров

Для отбора по начислению используются dateFrom и dateTo. Для отбора по акту — year и month. Документация не разрешает смешивать эти две группы в одном запросе. Проверьте форму настроек интеграции: пользователь не должен случайно оставить месяц предыдущего отчёта, одновременно задав новый диапазон дат. Такая ошибка возникает даже при правильном названии создаваемого файла.

Метод generateUnitedMarketplaceServicesReport требует доступа к финансам и бухгалтерии либо соответствующего полного доступа. Сохраните параметры формирования вместе с полученным reportId. Это позволит повторить ту же выборку при разборе расхождения. Пересоздание отчёта с другими параметрами под прежним именем лишает команду воспроизводимого результата и затрудняет сравнение с уже переданными бухгалтеру данными.

Дождитесь готового отчёта и сохраните основание

Запуск формирования возвращает идентификатор отчёта, после чего его состояние проверяется через получение информации об отчёте. Не воспринимайте выдачу reportId как готовый финансовый файл. Для скачивания используйте действующую ссылку после завершения формирования. Порядок работы с ожиданием и сроком ссылки разобран в руководстве по выгрузкам Маркета через API.

В сохранённом наборе данных оставьте имя услуги, единицу измерения, дату начисления, дату акта и итоговую сумму. Тариф, скидки и бонусы помогают объяснять результат, но сами по себе не заменяют итоговую строку начисления. Не удаляйте служебные даты ради красивой сводной таблицы: именно они показывают, почему одна услуга появилась в соседних по времени выгрузках.

Исключите двойной счёт при сверке

Представим редакционный пример: услуга начислена в конце одного периода и попала в акт другого. Она может оказаться в двух отчётах, сформированных по разным основаниям. Складывание итогов этих файлов завысит расходы. Сначала установите, что это одна операция, затем сравните её отражение в каждой выборке. Не вычитайте расхождение вручную без понятного сопоставления строк.

Для закрытия проверки подготовьте таблицу с основанием каждого отчёта, периодом, количеством строк и объяснёнными переходящими операциями. Неразобранные суммы вынесите отдельно, сохранив идентификаторы и исходные файлы. Цель процедуры — получить согласованную картину начислений и документов. Красивое совпадение общих итогов после ручных поправок не доказывает правильности учёта каждой услуги.

Это практическое руководство по официальной справке, проверенной 20 октября 2026 года. Дата проверки не означает, что описанная возможность появилась сегодня. Примеры организации работы отражают рекомендации редакции.