Public release from ruodoo-project: 19.0 - 2026-11-01 22:52:25 UTC

rsbu_mapping/DEVELOPER.md

@@ -0,0 +1,50 @@
+# РСБУ — Шаблоны типовых операций (маппинг)
+
+Гибридный маппинг: декларативные шаблоны операций + матрица связности
+(данные в БД) и Python-резолверы в коде модуля (`resolvers/`).
+
+## Резолверы коммерческого цикла
+
+| Резолвер | Операция | Проводки |
+| --- | --- | --- |
+| `advance_received` | получение аванса от покупателя | Дт 51 — Кт 62.АВ; Дт 76.АВ — Кт 68 |
+| `advance_refund` | возврат аванса покупателю | Дт 62.АВ — Кт 51; Дт 68 — Кт 76.АВ |
+| `shipment_upd` | отгрузка / УПД (+зачёт аванса) | Дт 62.01 — Кт 90.01; Дт 90.03 — Кт 68; Дт 62.АВ — Кт 62.01; Дт 68 — Кт 76.АВ |
+| `sale_credit_note` | возврат от клиента | сторно реализации + НДС |
+| `payment_after_shipment` | постоплата | Дт 51 — Кт 62.01 |
+| `purchase_bill` | счёт поставщика | Дт 44/expense — Кт 60 |
+| `purchase_credit_note` | возврат поставщику | Дт 60 — Кт 44/expense |
+| `supplier_payment` | оплата поставщику | Дт 60 — Кт 51 |
+| `supplier_refund` | возврат от поставщика | Дт 51 — Кт 60 |
+
+Реализация выручки — по **брутто-схеме** (90-1 с НДС, НДС отдельно на 90-3),
+как в типовой 1С и по Инструкции 94н (см. `docs/research/09`).
+
+Зачёт аванса при отгрузке определяется по **кредитовому остатку 62.АВ у
+контрагента** в РСБУ-журнале (`advance.get_balance(subconto={'partner': id})`),
+сумма зачёта = min(остаток аванса, сумма реализации); авансовый НДС
+списывается пропорционально зачтённой части (ограничен остатком 76.АВ).
+
+## Осознанные ограничения (для УСН)
+
+- **Входящий НДС не выделяется (Р3).** В `purchase_bill` полная сумма счёта
+  поставщика (с НДС) относится в затраты (`Дт 44 — Кт 60`). На спецрежиме
+  УСН (ставки 5%/7% без права на вычет) это **корректно**: входящий НДС к
+  вычету не принимается и включается в стоимость. Выделение НДС на счёт 19
+  и вычет `Дт 68 — Кт 19` относятся к общему режиму (ОСНО) и вне области
+  проекта.
+
+- **Себестоимость не списывается (Р2).** Проводка `Дт 90.02 — Кт 41/44`
+  не формируется: для целей УСН учёт себестоимости не требуется (на
+  «Доходы» не влияет на налог; на «Доходы−Расходы» расход признаётся
+  кассово). При необходимости ведётся отдельной ручной операцией.
+
+- **Субконто на денежных строках (Р4).** Строки по денежным счетам (51/50)
+  формируются без субконто-партнёра (в плане 94н у этих счетов субконто не
+  обязательно). При необходимости отчётности по движению денежных средств
+  партнёра на денежной строке можно добавить — это опция, не ограничение.
+
+> Нормативные параметры сверяются со специалистом (см.
+> `docs/research/00-index.md`). Резолверы опираются на регламент
+> `docs/research/08-business-process-usn.md` и справочник корреспонденции
+> `docs/research/09-account-correspondence.md`.