Отчеты и выгрузки: транзакции, сверка, бухгалтерия

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

Table of contents

• Что дает модуль отчетов
• Форматы и каналы выгрузки
• API отчетов: как запросить выгрузку
• Фильтры отчетов и сегментация
• Типы отчетов: транзакции, сверка, бухгалтерия
• Структура выгрузки: поля и примеры
• Периодические отчеты и расписание
• Интеграция с процессами и системами
• Безопасность и доступы
• Тестирование, тарифы и SLA
• Частые сценарии применения
• Итоги и следующий шаг

Что дает модуль отчетов

• Полная видимость платежного потока: авторизации, списания, возвраты, чарджбеки, выплаты. См. также прием платежей в разделе Прием платежей API и Возвраты и отмены.
• Ежедневная reconciliation платежей: сверка с банковской выпиской и контроль комиссий провайдера.
• Сверка с кассой и фискализацией 54-ФЗ: идентичность сумм и статусов чеков. Подробнее в Фискализация 54-ФЗ.
• Бухгалтерская выгрузка для 1С, ERP и BI: единый формат для учета выручки, НДС и комиссий.
• Быстрый доступ через отчеты платежи API: формируйте разовые или периодические отчеты, подключайте webhooks и автоматизируйте загрузку в хранилище данных.

Форматы и каналы выгрузки

Мы поддерживаем популярные форматы и удобные каналы поставки данных.

Таблица сравнения форматов:

Формат	Преимущества	Типичные задачи
CSV	Легко открывать в Excel и 1С, компактный размер	Бухгалтерия, ежедневная сверка, быстрый анализ
JSON	Структурированные записи, удобно для ETL и хранилищ	Интеграции в DWH, автоматизация в BI и сервисах

Каналы доставки:

• Скачивание по API: получите ссылку и загрузите файл напрямую из системы.
• SFTP и S3-совместимые хранилища: безопасная машинная загрузка, удобна для ETL.
• Отправка по email для небольших реестров и ручной обработки.

Технические детали экспорта:

• Кодировка CSV: UTF-8 с BOM или Windows-1251 по выбору.
• Разделители: запятая или точка с запятой, настраиваемо.
• Десятичный разделитель: точка, формат сумм в минимальных единицах или в целевых валютах.

API отчетов: как запросить выгрузку

API отчетов обеспечивает программное управление всеми выгрузками.

Базовый сценарий:

1. Создайте задачу отчета через endpoint POST /reports с параметрами типа отчета, формата и диапазона дат.
2. Отслеживайте статус queued, processing, ready, failed через GET /reports/{id}.
3. Заберите файл по выдаваемой ссылке или получите его в настроенном канале доставки.

Альтернативно вы можете читать транзакции потоково из GET /transactions с фильтрами и пагинацией. Это удобно, если нужен не файл, а интеграция напрямую в сервис.

Особенности:

• Фильтры и сортировка: по датам, статусам, методам оплаты, проектам, суммам и другим параметрам.
• Пагинация: по курсору для надежной итерации больших массивов.
• Идемпотентность: повторные запросы с одинаковым ключом не создадут дубликат отчета.

См. полные примеры в Документации API и начните интеграцию по гайду Быстрый старт интеграции.

Фильтры отчетов и сегментация

Гибкие фильтры отчетов помогают выгружать только релевантные данные:

• Диапазон дат: по времени создания, авторизации, списания, успешного проведения, возврата.
• Статусы: created, authorized, succeeded, refunded, canceled, chargeback, payout.
• Методы оплаты: карты, СБП, кошельки, интернет-банки. Подробнее в Методы оплат.
• Проект, магазин или MID: для мультиаккаунтной структуры.
• Валюта и диапазон суммы: min, max с возможностью округления.
• Признаки операции: первая оплата или рекуррентная. О рекуррентных — в разделе Рекуррентные платежи.
• Клиент и заказ: customer_id, order_id, внешние метки и теги.
• Карточные параметры: BIN, последняя цифра маски, бренд, страна эмитента.
• Гео и канал: web, mobile, SDK. См. Mobile SDK.
• Тип события: платежи, возвраты, выплаты. По выплатам — Выплаты и вывод средств.

Эти настройки работают как для разовых запросов, так и для периодических выгрузок по расписанию.

Типы отчетов: транзакции, сверка, бухгалтерия

Операционные отчеты по транзакциям

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

Reconciliation платежей: сверка с банком и кассой

• Сверка с банком. Наши выгрузки содержат идентификаторы транзакций и служебные поля для сопоставления с банковской выпиской: RRN или авторизационный код для карт, идентификатор операции по СБП, референс провайдера. Вы сверяете суммы, комиссии, даты поступления и статусы зачисления.
• Сверка с кассой. В отчет включаются статусы фискализации, номера чека, ФД, ФП, признак коррекции, а также итог по номенклатуре и ставкам налога. Это упрощает контроль корректности чеков по 54-ФЗ. Подробнее — в Фискализация 54-ФЗ.

Пример сопоставления для банковской сверки:

Поле в отчете API	Поле выписки банка	Комментарий
transaction_id	Назначение платежа или комментарий	Используется как внешний ключ
rrn или approval_code	RRN или код авторизации	Для картовых платежей
provider_reference	Идентификатор операции	Для альтернативных методов
amount_settled	Сумма зачисления	С учетом комиссий банка
settled_at	Дата зачисления	Дата в выписке

Бухгалтерские формы

• Реестр оплат по проектам и методам оплаты.
• Разрез по ставкам НДС и товарам для корректного учета выручки и налогов.
• Раздельный учет комиссий провайдера и банковских комиссий.

Структура выгрузки: поля и примеры

Типичные поля в отчете транзакций:

Поле	Описание	Пример
transaction_id	Уникальный идентификатор операции	tr_9c2f1a
created_at	Время создания операции в UTC	2025-01-15T10:21:33Z
paid_at	Время успешного списания	2025-01-15T10:21:40Z
status	Статус операции	succeeded
amount	Сумма операции в мин. единицах	125000
currency	Валюта	RUB
fee_total	Итоговая комиссия провайдера	3500
amount_settled	Нетто к зачислению	121500
method	Метод оплаты	card
card_mask	Маска карты	411111******1111
bin	Первые 6 цифр карты	411111
rrn	Номер ссылки операции	123456789012
approval_code	Код авторизации	A1B2C3
order_id	Идентификатор заказа	ORD-100500
customer_id	Идентификатор клиента	cust_42
project_id	Магазин или проект	shop_main
refund_of	Ссылка на исходную операцию при возврате	tr_9c2f1a
payout_id	Связь с выплатой	po_77aa33
receipt_status	Статус фискализации	sent

Пример CSV-заголовка:

transaction_id,created_at,status,amount,currency,fee_total,amount_settled,method,order_id,customer_id

Вы также можете запросить расширенный состав полей или выбрать только необходимые колонки — это упрощает csv json экспорт под конкретные задачи.

Периодические отчеты и расписание

• Ежедневные, еженедельные, ежемесячные отчеты по фиксированному расписанию с доставкой на SFTP, в облачное хранилище или на email.
• Окно агрегации и часовой пояс настраиваются: UTC или локальное время магазина.
• Контроль целостности: хэш файла, версия, инкрементальные и полные выгрузки.
• Уведомления: через webhooks о готовности файла или об ошибке формирования. Настройте события в разделе Вебхуки и события.

Интеграция с процессами и системами

• CRM и ERP. Подключайте ETL-процессы, чтобы загрузить данные в 1С, SAP, Power BI или Tableau.
• Интернет-магазины. Готовые модули упрощают подключение и настройки отчетов. См. CMS плагины.
• Мобильные приложения. Статистика по мобильным платежам доступна вместе с данными SDK. См. Mobile SDK.
• Возвраты и рекурренты. Все взаимосвязи сохраняются в полях отчетов, что упрощает анализ LTV и удержания. См. Рекуррентные платежи и Возвраты и отмены.

Безопасность и доступы

• Соответствие требованиям PCI DSS. Данные карт в отчетах обезличены, доступны только маска и BIN. Подробности — в разделе Безопасность и PCI DSS.
• Контроль доступа: роли для пользователей, ограничения по API-ключам и whitelist IP.
• Антифрод. Маркеры рисковых операций доступны в выгрузках для последующего анализа. См. Antifraud и риск.

Тестирование, тарифы и SLA

• Песочница. Проверьте сценарии выгрузки, фильтры и интеграцию в безопасной среде. Подробнее — Песочница и тестирование.
• Тарифы. Экспорт и хранение отчетов входят в набор сервисов. Смотрите детали в Тарифы и комиссии.
• SLA и поддержка. Мы обеспечиваем стабильную генерацию отчетов и помогаем с настройкой. Условия — в разделе SLA и поддержка.
• Документация. Полные описания эндпоинтов, форматов и примеров — в Документации API.

Частые сценарии применения

• Ежедневная сверка с банком. Выгрузка за предшествующий банковский день, сопоставление amount_settled, комиссий и RRN/approval_code.
• Сверка с кассой. Контроль receipt_status, сверка итогов по отделам продаж и ставкам налогов, устранение расхождений с ОФД.
• Бухгалтерская закрывашка месяца. Разрез по НДС, учет комиссий и распределение выручки по проектам.
• Аналитика возвратов. Отчет по refunded, связь с исходными оплатами и причинами возвратов. См. Возвраты и отмены.
• Контроль рекуррентных подписок. Мониторинг ретраев и успешности продлений. См. Рекуррентные платежи.
• Сопоставление выплат мерчантам/агентам. Выгрузка операций и связей с payout_id — см. Выплаты и вывод средств.

Итоги и следующий шаг

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

Готовы начать? Откройте Быстрый старт интеграции и подробную Документацию API, подключите webhooks из раздела Вебхуки и события — и получите готовые отчеты уже сегодня.