# Справочник по формату пакета закрытия

Пакет закрытия — два файла: xlsx-книга и PDF-сводка на одну страницу.

## Именование файлов

```
close-packet-2026-03.xlsx
close-packet-2026-03-summary.pdf
```

Используй год-месяц в формате ISO 8601 (`ГГГГ-ММ`) в имени файла. Расположение
по умолчанию — Рабочий стол; используй предпочитаемый путь собственника, если
он указал.

---

## xlsx-книга — три листа

### Лист 1: ОПиУ

Отформатированная копия ОПиУ из бухгалтерии за закрываемый месяц. Раскладка в
два столбца: **Статья** и **Сумма**.

Обязательные строки (по порядку):
1. Итого выручка
2. Итого себестоимость
3. **Валовая прибыль** (жирным)
4. **Валовая маржа %** (жирным, в формате %)
5. Операционные расходы по статьям (каждая на своей строке)
6. Итого операционные расходы
7. **Чистая прибыль** (жирным)

Включи столбец сравнения м/м (месяц к месяцу), если данные прошлого месяца
доступны. Форматируй суммы как валюту (`# ##0,00 ₽`). Отрицательные значения —
красным.

### Лист 2: Сверка

Сопоставление поступлений по банку в учёте с зачислениями эквайринга, рядом.

Столбцы:
| Столбец | Источник |
|---|---|
| Дата (учёт) | Дата поступления в учёте |
| Сумма (учёт) | Сумма поступления в учёте |
| Источник | ЮKassa / Тинькофф / банк / СБП |
| Дата (зачисление) | Дата зачисления по эквайрингу/банку |
| Сумма (зачисление) | Сумма зачисления (за вычетом комиссии) |
| Дельта | Сумма в учёте минус сумма зачисления |
| Статус | СВЕРЕНО / НЕТ_В_УЧЁТЕ / ПОСТУПЛЕНИЕ_БЕЗ_ПАРЫ / РАСХОЖДЕНИЕ_ДАТ |

Раскрась столбец «Статус»:
- СВЕРЕНО → зелёная заливка
- РАСХОЖДЕНИЕ_ДАТ → жёлтая заливка
- НЕТ_В_УЧЁТЕ или ПОСТУПЛЕНИЕ_БЕЗ_ПАРЫ → красная заливка

### Лист 3: Задачи

Все открытые флаги из чек-листа. Столбцы:
| Столбец | Примечания |
|---|---|
| Категория | Операция без статьи / Нет первички / Дубль / Флаг сверки |
| Дата | Дата операции |
| Сумма | Сумма в рублях |
| Поставщик / Клиент | Наименование |
| Описание | Что не так и что делать |

Если открытых задач нет — покажи одну строку: «Открытых задач нет — учёт чист.»

---

## PDF-сводка — одна страница

Раскладка (сверху вниз):

```
[Название бизнеса]                  Пакет закрытия — [Месяц Год]
────────────────────────────────────────────────────────────

КЛЮЧЕВЫЕ ЦИФРЫ
Выручка        XX XXX ₽
Валовая маржа  XX%
Чистая прибыль XX XXX ₽

ОПиУ — СВОДКА
[Разбор простым языком на 150–250 слов из Шага 7]

ЗАДАЧИ
X операций без статьи · X нет первички · X открытых флагов
[или «Учёт чист — открытых задач нет.», если всё закрыто]

────────────────────────────────────────────────────────────
Подготовлено [Дата] · Собрано в Claude
```

Используй чистый шрифт без засечек (Helvetica, Inter или аналог). Логотип не
обязателен. Держи поля ≥ 2 см со всех сторон, чтобы печаталось аккуратно.

**Генерация PDF:** Используй библиотеку Python `xlsxwriter` или `reportlab`,
если запускаешь скрипт, либо отрисуй содержимое и экспортируй через печать в PDF
коннектором `~~хранилище` / Desktop. Собственник также может распечатать PDF из
листа ОПиУ в xlsx, если скрипт недоступен.

# Грабли

Частые ошибки и краевые случаи при закрытии месяца. У каждой записи — паттерн,
почему это важно, и пример «Плохо/Хорошо».

---

## Грабли: пометить разбитую операцию как дубль

**Почему важно:** Одна покупка, разнесённая по нескольким статьям учёта,
появляется в выгрузке несколькими строками — тот же поставщик, та же дата,
разные суммы. Если пометить их как дубли, собственник зря погонится за призраком.

### ✗ Плохо

> Помечено как дубль: «Комус» 4 750 ₽ за 12 марта и «Комус» 6 250 ₽ за 12 марта —
> тот же поставщик, та же дата.

Обе строки делят один `номер_документа` — это разбивка покупки на 11 000 ₽ по
статьям «Канцтовары» и «Оборудование».

### ✓ Хорошо

Перед пометкой дублей группируй строки по `номер_документа`. Сравнивай только
операции с разными номерами. Разбивки одной операции дублями не бывают.

---

## Грабли: принять возврат за недостающее зачисление

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

### ✗ Плохо

> Помечено: списание по эквайрингу −8 900 ₽ за 18 марта не имеет парного
> поступления в учёте. Возможна недостающая операция.

Эти −8 900 ₽ — возврат клиенту. Он должен сопоставляться с корректировочным
документом/возвратом в учёте, а не с поступлением.

### ✓ Хорошо

Раздели поступления (положительные) и списания (отрицательные) перед сверкой.
Сопоставляй отрицательные суммы эквайринга с возвратами в учёте, а не с
поступлениями. Помечай непарное отрицательное, только если возврата в учёте нет.

---

## Грабли: сравнивать сумму операции с суммой зачисления за вычетом комиссии

**Почему важно:** В учёте часто фиксируется чистое поступление на счёт (после
комиссии эквайринга), а отчёт эквайринга показывает валовую сумму продажи.
Сравнение валового с чистым всегда покажет расхождение, равное комиссии.

### ✗ Плохо

> Расхождение: зачисление эквайринга 50 000 ₽, поступление в учёте 48 480 ₽ —
> дельта 1 520 ₽. Помечено как ошибка сверки.

Эти 1 520 ₽ — комиссия эквайринга 3,04%. Это ожидаемо и верно.

### ✓ Хорошо

Используй поле **чистого зачисления на счёт** (сумма операции минус комиссия)
из отчёта эквайринга при сравнении с поступлением по банку. Если дельта < 0,50 ₽
после поправки на комиссию — отмечай как СВЕРЕНО.

---

## Грабли: проскочить Шаг 6 при нерешённых флагах

**Почему важно:** Пакет закрытия — это финальный документ, который собственник
сдаёт или показывает бухгалтеру. Выгрузить его с открытыми флагами — значит
запечь ошибки в запись.

### ✗ Плохо

> Собственник не ответил по 3 операциям без статьи. Генерирую пакет закрытия
> сейчас, чтобы было на что посмотреть.

### ✓ Хорошо

Держись на точке подтверждения Шага 6, пока собственник не подтвердит каждый
флаг — либо решив его («разнеси это на канцтовары»), либо явно отложив
(«пометь на потом»). Только тогда выгружай. Отложенные собственником пункты
должны попасть в лист «Задачи», а не молча исчезнуть.

# Справочник по зачислениям эквайринга и банковским выпискам

> Имя файла оставлено прежним (`paypal-settlements.md`), чтобы не ломать ссылки
> из SKILL.md. Содержание — РФ-эквиваленты: зачисления эквайринга и выписки банка.

## Содержание

- [ЮKassa](#юkassa)
- [Тинькофф Касса](#тинькофф-касса)
- [Банк-выписка (СБП / расчётный счёт)](#банк-выписка-сбп--расчётный-счёт)
- [Логика сверки (все источники)](#логика-сверки-все-источники)

---

## ЮKassa

### Структура отчёта по зачислениям

Коннектор `~~платежи` (ЮKassa) отдаёт отчёт «История операций» или «Реестр
платежей». Ключевые поля:

| Поле | Примечания |
|---|---|
| `payment_id` | Идентификатор платежа в ЮKassa |
| `created_at` | Когда прошла операция |
| `amount.value` | Валовая сумма (положительная = деньги пришли) |
| `income_amount.value` | Сумма за вычетом комиссии ЮKassa (чистое зачисление) |
| `status` | Бери только `succeeded` (успешно) и `pending` (в ожидании) |
| `metadata` / `description` | Привязка к заказу/клиенту — полезно для сопоставления |

**Дата зачисления vs дата операции:** ЮKassa перечисляет деньги пакетами.
Продажа 28 апреля может зачислиться на расчётный счёт только 2 мая. Сопоставляй
по **дате зачисления** при сверке с поступлениями в учёте, а не по дате операции.

**Возвраты:** Проходят отрицательными суммами (`refund`). Они должны гасить
исходную продажу — не помечай возврат расхождением против учёта, если в учёте
есть соответствующий корректировочный документ.

**Заблокированные средства:** Операции в статусе `waiting_for_capture` или
зависшие в холде ещё не зачислены. Отметь их отдельно — попадут в зачисления
следующего месяца.

---

## Тинькофф Касса

### Структура отчёта по зачислениям

Тинькофф называет это **реестром платежей / выгрузкой по эквайрингу**. Каждое
зачисление покрывает 1–2 рабочих дня продаж.

Ключевые поля выгрузки:

| Поле | Примечания |
|---|---|
| `PaymentId` | Идентификатор платежа |
| `SettlementDate` | Дата зачисления средств на счёт |
| `Amount` | Чистое зачисление (уже минус комиссия Тинькофф), в копейках |
| `Status` | Для сверки бери только `CONFIRMED` |

**Комиссия:** Тинькофф удерживает комиссию до зачисления — значит `Amount` уже
чистый. При сверке с учётом сравнивай с чистым поступлением, а не с валовой
суммой продажи.

**Зачисление день в день:** Если у собственника подключено мгновенное
зачисление, средства могут прийти в дату операции. По умолчанию — следующий
рабочий день.

---

## Банк-выписка (СБП / расчётный счёт)

### Структура выписки

Выписка из банк-клиента (1С-совместимая выгрузка или CSV) — основной источник,
когда эквайринг не подключён или платежи идут через СБП напрямую на счёт.

Ключевые поля:

| Поле | Примечания |
|---|---|
| `Дата проводки` | Дата зачисления/списания по счёту |
| `Сумма` | Сумма по дебету (приход) или кредиту (расход) |
| `Назначение платежа` | Текст основания — для привязки к счёту/клиенту |
| `ИНН плательщика` | Идентификация контрагента |

**СБП:** Поступления по СБП обычно приходят на счёт почти моментально и уже
чистыми (комиссия эквайера СБП удерживается отдельным списанием — учитывай её,
если она проходит отдельной строкой).

**Эквайринг общим платежом:** Банк может зачислять выручку эквайринга одной
суммой за день/период — тогда одно поступление в выписке соответствует пачке
операций в отчёте эквайринга. Сопоставляй пачку, а не строку-в-строку.

---

## Логика сверки (все источники)

Используй эту логику для сопоставления зачислений с поступлениями в учёте:

```
для каждого зачисления за закрываемый месяц:
    найди поступление в учёте, где:
        abs(учёт.сумма - зачисление.чистая_сумма) < 0,50 ₽
        И abs(учёт.дата - зачисление.дата_поступления) <= 2 дня

    если совпадение найдено:
        отметь СВЕРЕНО
    иначе если abs(учёт.сумма - зачисление.чистая_сумма) < 0,50 ₽ (расходятся только даты):
        пометь РАСХОЖДЕНИЕ_ДАТ (обычно разница в сроках — низкий приоритет)
    иначе если зачисление не сопоставлено вообще:
        пометь НЕТ_В_УЧЁТЕ
    иначе если поступление в учёте не сопоставлено ни с одним зачислением:
        пометь ПОСТУПЛЕНИЕ_БЕЗ_ПАРЫ (может быть наличные, перевод по реквизитам или ошибка статьи)
```

**Несколько источников платежей:** Прогоняй логику отдельно по каждому источнику
(`~~платежи`), затем агрегируй флаги. Поступление в учёте, не совпавшее с ЮKassa,
может законно оказаться зачислением Тинькофф или СБП — не помечай его, пока не
проверил все подключённые источники.

# Сверка с данными бухгалтерии (1С и др.) — справочник

> Имя файла оставлено прежним (`quickbooks-reconcile.md`), чтобы не ломать
> ссылки из SKILL.md. Содержание — сверка по данным учёта в 1С / МойСклад.

## Какие отчёты подтянуть

### Отчёт о прибылях и убытках (ОПиУ)

Используй отчёт **«Прибыли и убытки» / финрезультат** через коннектор
`~~бухгалтерия` (1С, МойСклад):
- Период: с первого по последний день закрываемого месяца
- Метод учёта: **начисление**, если собственник не сказал, что ведёт по оплате
  (кассовый метод)
- Включай все статьи

Ключевые поля для дальнейшей работы:
| Поле | Примечания |
|---|---|
| `Итого выручка` | Выручка верхней строкой |
| `Валовая прибыль` | Выручка минус себестоимость |
| `Валовая маржа` | Считай как Валовая прибыль / Итого выручка |
| `Чистая прибыль` | Итог |
| `Итого расходы` | Подытог операционных расходов |

### Реестр операций

Подтяни отчёт **«Список операций по датам»** или эквивалент за закрываемый
месяц. Это построчная детализация для пометки операций без статьи и поиска
дублей.

Ключевые поля:
| Поле | Примечания |
|---|---|
| `Дата документа` | Дата операции (не дата проводки) |
| `Вид операции` | Счёт, Оплата, Расход, Поступление и т.д. |
| `Сумма` | Положительная = доход, отрицательная = расход в большинстве выгрузок |
| `Статья` | Статья доходов/расходов в учёте |
| `Контрагент` | Поставщик или клиент |
| `Назначение` | Свободное описание |
| `Документов приложено` | > 0 означает, что первичка прикреплена в учёте |

## Как определить операции без статьи

Помечай операцию как «без статьи», если поле `Статья` одно из:
- «Без статьи» / «Не распределено»
- «Прочие доходы» / «Прочие расходы» (когда используется как свалка)
- пусто / null
- «Уточнить у бухгалтера» (встроенная категория «не знаю»)

## Пагинация

Выгрузки из учёта могут возвращать максимум 1 000 строк за запрос. Для бизнесов
с большим объёмом операций разбивай постранично (`startPosition` и `maxResults`
или аналог). Запрашивай пачками по 500 строк, чтобы надёжно держаться под
лимитом.

## Частые проблемы с данными

**Разбитые операции** — одна покупка, разнесённая по нескольким статьям,
появляется несколькими строками с той же датой и контрагентом, но разными
суммами. Это НЕ дубли. Перед пометкой дублей группируй строки по
`номер_документа` — строки с общим номером это разбивки одной операции.

**Банковский импорт vs ручной ввод** — операции из импорта банк-выписки имеют
в назначении/примечании метку «банк-клиент» или похожую. Ручной ввод часто без
примечания. Само по себе ни то ни другое не сигнал проблемы, но помогает понять,
почему у операции может не быть первички.

**Операции эквайринга, уже попавшие в учёт** — если у собственника настроена
автозагрузка из `~~платежи` (ЮKassa/Тинькофф) в учёт, операции эквайринга уже
будут в реестре. Не считай их дважды при сверке (Шаг 3). Проверь, есть ли в
поступлениях в учёте метка эквайринга в статье или назначении, прежде чем
сопоставлять.

**Авансы / предоплаты** — предоплата клиента не выручка, пока работа не сдана.
Если собственник ведёт учёт по оплате (кассовый метод), различие менее важно,
но всё равно помечай крупные операции вида «Поступление/Аванс» без сопоставленного
счёта-реализации — чтобы собственник о них знал. На УСН доход признаётся по
оплате, поэтому аванс попадает в налоговую базу сразу — отметь это собственнику.