Документы отчётов для мерчанта
Основные моменты из условий:
Данная документация описывает процесс формирования, структуру и взаимосвязи отчётных документов, предоставляемых мерчант по итогам отчётного периода.
Документация предназначена для:
- разработки и поддержки системы отчётности
- финансового и юридического контроля
- сопровождения мерчантов
Общие условия
Отчётный период
- Полный календарный месяц
- С 1-го числа 00:00:00 по последний день 23:59:59
Дата формирования отчёта
- 1-й рабочий день месяца, следующего за отчётным
Период обжалования
- 5 рабочих дней с даты формирования отчёта
Планируемая выплата
- В течение 5 банковских дней после окончания периода обжалования
info
Знаения сроков отчетного периода, значение даты формирования отчета, период обжалования должны быть вынесены в конфигурацию системы для взаимодействия и настройкой условий.
Структура формируемых файлов
📁 reports/
└── 📁 october_2025/
└── 📁 {merchant_id}/ # ID мерчанта в системе
└── 📁 {legal_entity_id}/ # ID юридического лица в системе
├── 📊 DETAIL-REP-2025-10-001.csv # Детализация операций
├── 📊 CORE-REP-2025-10-001.csv # Сводный отчёт
├── 📊 FORM-REP-2025-10-001.doc # Форма отчёта партнера
└── 📋 README.txt # Инструкция и контакты
Форма отчёта мерчанта в формате Word документа
Процесс формирования отчёта
Цель процесса
Автоматически сформировать комплект юридически и финансово значимых отчётных документов для мерчанта по каждому юридическому лицу в бренде за закрытый отчётный период.
Входные данные
- Операции и бронирования
- История статусов операций
- Договорные условия мерчанта
- Регистрационные данные и банковские реквизиты юридического лица в бренде
info
Знаения ставки НДС должны быть вынесено в конфигурацию системы для взаимодействия и настройкой условий.
Выходные данные
- CSV-файлы (
DETAIL,CORE) - Word-документ (
FORM) - Инструктивный файл (
README)
Последовательность формирования документов
Этап 1. Закрытие отчётного периода
- Фиксируется отчётный период
- Формируется неизменяемый набор операций
Этап 2. Формирование DETAIL-REP
DETAIL-REP является источником истины для всех последующих расчётов.
Процесс:
- Отбираются мерчант
- Отбираются операции по юридическому лицу за период
- Для каждой операции определяется финальный статус
- Рассчитываются:
- цена
- комиссия
- НДС
- сумма к выплате
- Операции с неподходящими статусами исключаются из выплаты
Этап 3. Формирование CORE-REP
Процесс:
- Агрегация данных из DETAIL-REP
- Подтягивание реквизитов мерчанта
- Расчёт итоговых сумм и дат
Этап 4. Формирование FORM-REP
Процесс:
- Используется утверждённый шаблон Word
- Вставляются:
- реквизиты
- итоговая таблица
CORE-REP - детализация
DETAIL-REP
Этап 5. Формирование README
Процесс:
- Генерируется автоматически
- Используется для информирования мерчанта
- Содержит сроки, расшифровки и контакты
Данные и структура в файла и документах
Детализация операций DETAIL-REP
- Название файла: DETAIL-REP-2025-10-001.csv |
DETAIL-+ГГГГ-ММ-ДД+{№ отчёта} - Расширение файла: CSV
- Кодировка файла: UTF-8 с BOM
| Колонка | Источник данных | Формат | Описание | Правила формирования |
|---|---|---|---|---|
| Номер отчёта | Ссылка на сводку | REP-{год}-{месяц}-{последовательность} | Уникальный идентификатор отчёта | Берется из сводной таблицы |
| Услуга | Бронирования | Строка | Наименование услуги/билета | Из данных бронирования |
| Кол-во | Бронирования | Число | Количество проданных единиц | Из данных бронирования |
| Цена | Бронирования | ₽ | Цена на момент брони | Цена за 1 еденицу × Кол-во |
| Комиссия | Рассчитывается | ₽ | Сумма комиссии платформы | Цена - Комиссия (База мерчантов) |
| НДС | Рассчитывается | ₽ | Сумма НДС | Цена × Ставка НДС |
| Статус | История операций | Код | Текущий статус операции | Из истории изменения статусов |
| Итого | Рассчитывается | ₽ | Сумма к выплате по операции | (Цена - Комиссия) × Кол-во (только для завершённых) |
Статусы операций
| Статус | Когда применяется | Финансовый результат |
|---|---|---|
| Завершено | Оплата получена, услуга оказана | Включается в выплату |
| Завершено (Подтверждён) | Оплата получена, услуга оказана, мерчант подтвердил посещение пользователя | Включается в выплату |
| Отмена (мерчант) | Отменено мерчантом до оказания услуги | Не включается в выплату |
| Отмена (клиент) | Отменено клиентом до оказания услуги | Не включается в выплату |
| Ожидает подтверждения | Бронь создана, ждёт подтверждения | Не включается в выплату |
Формулы расчёта
| Строка | Как формируется |
|---|---|
| Комиссия за операцию | Цена × % комиссии × Кол-во |
| Итого к выплате (за операцию) | (Цена - Комиссия) × Кол-во |
| Общая сумма к выплате | Σ(Итого завершённых операций) |
| Общая комиссия платформы | Σ(Комиссия всех операций) |
| Эффективная комиссия | Общая комиссия / Σ(Цена завершённых) × 100% |
Периоды и даты
| Параметр | Как рассчитывается |
|---|---|
| Отчётный период | 1-е число месяца 00:00 - последний день 23:59:59 |
| Дата формирования | 1-й рабочий день следующего месяца |
| Период обжалования | 5 рабочих дней после формирования |
| Планируемая выплата | 5 банковских дней после обжалования |
Пример заполнения
| № отчёта | ID клиента | Услуга | Кол-во | Цена | Комиссия | НДС | Статус | Итого |
|---|---|---|---|---|---|---|---|---|
| REP-2025-10-001 | 0000 | Профессиональная гигиена полости рта | 1 | 1 000 ₽ | 100 ₽ | 0 ₽ | Завершено | +900 ₽ |
| REP-2025-10-001 | 0000 | Отбеливание зубов | 1 | 2 000 ₽ | 200 ₽ | 0 ₽ | Завершено (Подтверждён) | +1 800 ₽ |
| REP-2025-10-001 | 0000 | Консультация стоматолога | 1 | 3 000 ₽ | 300 ₽ | 0 ₽ | Отмена (мерчант) | 0 ₽ |
| REP-2025-10-001 | 0000 | Имплантация | 1 | 4 000 ₽ | 400 ₽ | 0 ₽ | Отмена (клиент) | 0 ₽ |
| Итого по завершённым: | 2 | 3 000 ₽ | 300 ₽ | 0 ₽ | 2 700 ₽ | |||
| Итого по отменам: | 2 | 7 000 ₽ | 700 ₽ | 0 ₽ | 0 ₽ | |||
| Общий итог: | 4 | 10 000 ₽ | 1 000 ₽ | 0 ₽ | 2 700 ₽ |
Сводная информация по отчёту CORE-REP
- Название файла: CORE-REP-2025-10-001.csv |
CORE-+ГГГГ-ММ-ДД+{№ отчёта} - Расширение файла: CSV
- Кодировка файла: UTF-8 с BOM
| Колонка | Источник данных | Формат | Описание |
|---|---|---|---|
| Номер отчёта | Формируется системой | REP-{год}-{месяц}-{последовательность} | Уникальный идентификатор отчёта |
| Принципал | База мерчантов | Строка | Полное наименование мерчанта {legalFace} |
| ID системы | База мерчантов | Число | Внутренний ID мерчанта в системе {id} |
| Дата формирования | Рассчитывается | ДД.ММ.ГГГГ | 1-й рабочий день следующего месяца |
| Отчётный период | Рассчитывается | ДД.ММ.ГГГГ - ДД.ММ.ГГГГ | С 1 по последнее число месяца |
| Период обжалования | Рассчитывается | ДД.ММ.ГГГГ - ДД.ММ.ГГГГ | 5 рабочих дней после формирования |
| Комиссия | База мерчантов | % (₽) | % указаный для мерчанта в договоре Нет такого поля |
| НДС | База мерчантов | % | если значение nds: true то 22%, если значение nds: false то 0%. Стоит вынести 22% как значение в системе |
| Успешные | Рассчитывается | Число | Количество завершённых операций |
| Отмены | Рассчитывается | Число | Количество отменённых операций |
| К выплате | Рассчитывается | ₽ | Сумма к перечислению мерчанту |
| ИНН | База мерчантов | 10/12 цифр | ИНН мерчант {inn} |
| БИК | База мерчантов | 9 цифр | БИК банка мерчанта нет в системе |
| Расчётный счет | База мерчантов | 20 цифр | Расчётный счёт мерчанта нет в системе |
| Корреспондентский счет | База мерчантов | 20 цифр | Корреспондентский счёт мерчанта нет в системе |
Пример заполнения
| Номер отчёта | Принципал | ID системы | Дата формирования | Отчётный период | Период обжалования | Комиссия | НДС | Успешные | Отмены | К выплате | ИНН | БИК | Счёт |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| REP-2025-10-001 | ИП Овакимян А. М. | 09677acd-b50f-4e84-b15e-4eb1d0343c7d | 03.11.2025 | 01.10.2025 - 31.10.2025 | 04.11.2025 - 10.11.2025 | 10% (450 ₽) | 0% | 2 | 2 | 2 700 ₽ | 621303026859 | 044525974 | 40802810300000739773 |
Полученные данные после формирования CSV
info
Полученные данные после заврешения генерации и формирования csv файлов должны передаваться в FORM-REP-2025-10-001.doc и README.txt для корректного оторажения информации
| Переменная | Пример | Источник |
|---|---|---|
{reportNumber} | REP-2025-10-001 | report.number |
{reportDate} | 03.11.2025 | report.createdAt |
{dateStartReport} | 01.10.2025 | report.periodStart |
{dateEndReport} | 31.10.2025 | report.periodEnd |
{appealStartDate} | 04.11.2025 | report.appealStart |
{appealEndDate} | 10.11.2025 | report.appealEnd |
{merchantPactNumber} | 10.11.2025 | report.merchantPactNumber |
danger
merchantPactNumber - порядковй номер отчета по юридическому лицу. Необходимо указывать корректный порядковый номер отчета после каждого формирования, а значит его нужно хранить по кажому юридическому лицу
Форма отчета FORM-REP
- Название файла: FORM-REP-2025-10-001.csv |
FORM-+ГГГГ-ММ-ДД+{№ отчёта} - Расширение файла: doc
СТРАНИЦА № 1
ФОРМА ОТЧЁТА ПАРТНЁРА
Принципал: “{legalFace}”
Агент: “ООО «СЕРВИСНЫЙ ДИЗАЙН»”
Отчет № {report-number} об услугах, оказанных клиентам, привлеченным через платформу «Appoint» за период с {date-start-report} по {date-end-report}
К Агентскому договору № {merchant-pact-number} от {merchant-pact-date} (заключенному путем присоединения к публичной оферте о заключении агентского договора по использованию платформы «Appoint» от 25.06.2025)
Итоговые расчеты за отчетный период:
<!-- Вставка таблицы: CORE-REP-2025-10-001.csv -->
Детализация оказанных услуг:
<!-- Вставка таблицы: DETAIL-REP-2025-10-001.csv -->
СТРАНИЦА № 2
Настоящий отчет является основанием для составления и подписания акта об оказанных агентских услугах и выставления счета. Отчет составлен в двух экземплярах, по одному для каждой из сторон
<!-- Компания -->
Компания: ООО «СЕРВИСНЫЙ ДИЗАЙН»
ИНН/КПП: 7707789632 / 770701001
ОГРН: 1127747137110
Юридический адрес: 101000, г. Москва, Покровский б-р, д. 4/17, стр. 1, подв/помещ. II, ком. 2
Р/С: 40702810400000032116
К/С: 301018100000000000201
БИК: 044525201
E-mail: finance@appoint.ru
Телефон: +7 800 600-21-74, +7 495 275-27-73
<!-- Партнер -->
Партнер: {legalFace}
ИНН/КПП: {inn} / {kpp}
ОГРН: {ogrn}
Юридический адрес: {legalAddress}
Р/С: {settlementAccount}
К/С: {correspondentAccount}
БИК: {bic}
E-mail представителя: {representativeEmail}
Телефон представителя: {representativePhone}
<!-- Подписи -->
Генеральный директор
____________________ / Ефанов Е.В
{legalFace}
____________________ / ФИО
Инструкция и контакты README
===============================================================================
ОТЧЁТ ДЛЯ МЕРЧАНТА ЗА [МЕСЯЦ ГГГГ]
===============================================================================
Отчёт сформирован автоматически. Пожалуйста, проверьте данные в течение периода обжалования.
Отчётный период: 01.10.2025 - 31.10.2025
Дата формирования: 03.11.2025
Период обжалования: 04.11.2025 - 10.11.2025
Планируемая выплата: Не позднее 17.11.2025
Статусы:
- Завершено / Подтверждён → включено в выплату
- Отмена (мерчант/клиент) → не включено
- Ожидает подтверждения → не учитывается
Контакты:
- Выплаты и расчёты: finance@appoint.ru
- Технические вопросы: support@appoint.ru
- Горячая линия: +7 800 600-21-74, +7 495 275-27-73
===============================================================================
© appoint, 2026
===============================================================================