RSHB/arm-ka-docs
9
0
Fork 0
Code Issues 12 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

КПП ЮЛ возвращается: DBML v5.17 (legal_entity.kpp), пересмотр OQ-31 #53

New Issue
Closed
opened 2026-10-07 17:17:07 +03:00 by aep · 1 comment
aep commented 2026-10-07 17:17:07 +03:00
Owner
Copy Link

Решение владельца (07.10.2026)

КПП у ЮЛ нужен — пересмотр решения по OQ-31 от 04.10.2026 («КПП не нужен», DBML v5.14 без поля). Повод: макет (экраны 50, 61 — колонка «КПП»; 51-02, 79 — поле формы) и комментарий фронтенда: «в ручке получения ЮЛ не приходит КПП».

Что сделать (arm-ka-docs)

  1. DBML v5.17 (новая версия, запись в changelog шапки; v5.16 не трогать): legal_entity.kpp varchar (nullable — у ИП КПП нет) и то же поле в legal_entity_history (SCD4: снимок хранит все атрибуты).
  2. entities-v5.17.md: смысл поля, источник (макет, решение владельца).
  3. 07-open-questions.md: OQ-31 — новое решение с датой; вопросы ниже — новыми OQ, если владелец не ответит до дизайна.
  4. 05-domain-rules.md §валидации справочника (таблица рядом с INVALID_INN): правило для КПП.
  5. 04-data-model-guide.md, mockup/INDEX.md (51-02: убрать «kpp в DBML нет — OQ-31»), 10-user-journey.md при необходимости.

Вопросы к владельцу (решить до DBML)

  • Формат и проверка: 9 символов; по приказу ФНС 5–6 позиции могут быть буквами A–Z — принимать цифры и буквы или только цифры? Код ошибки (INVALID_KPP)?
  • ИП: КПП запрещён (ошибка) или просто игнорируется?
  • Обязательность для ЮЛ: обязателен или nullable (старые записи и импорт без колонки)?
  • Уникальность: остаётся inn unique (КПП — атрибут) или ключ (inn, kpp) — обособленные подразделения с одним ИНН как разные ЮЛ? Второе меняет сопоставление контрагентов ОСВ по ИНН — рекомендация: оставить inn unique.
  • Изменение КПП (смена адреса/постановки на учёт) — обычный PATCH со снимком в legal_entity_history?

Порядок

Сначала этот PR (DBML v5.17), затем реализация в arm-core (отдельная issue там). Брать после завершения агента arm-core#42.

## Решение владельца (07.10.2026) КПП у ЮЛ **нужен** — пересмотр решения по OQ-31 от 04.10.2026 («КПП не нужен», DBML v5.14 без поля). Повод: макет (экраны `50`, `61` — колонка «КПП»; `51-02`, `79` — поле формы) и комментарий фронтенда: «в ручке получения ЮЛ не приходит КПП». ## Что сделать (arm-ka-docs) 1. **DBML v5.17** (новая версия, запись в changelog шапки; v5.16 не трогать): `legal_entity.kpp varchar` (nullable — у ИП КПП нет) и то же поле в `legal_entity_history` (SCD4: снимок хранит все атрибуты). 2. `entities-v5.17.md`: смысл поля, источник (макет, решение владельца). 3. `07-open-questions.md`: OQ-31 — новое решение с датой; вопросы ниже — новыми OQ, если владелец не ответит до дизайна. 4. `05-domain-rules.md` §валидации справочника (таблица рядом с `INVALID_INN`): правило для КПП. 5. `04-data-model-guide.md`, `mockup/INDEX.md` (`51-02`: убрать «`kpp` в DBML нет — OQ-31»), `10-user-journey.md` при необходимости. ## Вопросы к владельцу (решить до DBML) - **Формат и проверка:** 9 символов; по приказу ФНС 5–6 позиции могут быть буквами `A–Z` — принимать цифры и буквы или только цифры? Код ошибки (`INVALID_KPP`)? - **ИП:** КПП запрещён (ошибка) или просто игнорируется? - **Обязательность для ЮЛ:** обязателен или nullable (старые записи и импорт без колонки)? - **Уникальность:** остаётся `inn` unique (КПП — атрибут) или ключ `(inn, kpp)` — обособленные подразделения с одним ИНН как разные ЮЛ? Второе меняет сопоставление контрагентов ОСВ по ИНН — **рекомендация: оставить `inn` unique**. - **Изменение КПП** (смена адреса/постановки на учёт) — обычный PATCH со снимком в `legal_entity_history`? ## Порядок Сначала этот PR (DBML v5.17), затем реализация в arm-core (отдельная issue там). Брать после завершения агента arm-core#42.
aep commented 2026-10-07 17:27:11 +03:00
Author
Owner
Copy Link

Решения владельца (07.10.2026)

  • Формат: 9 символов — 4 цифры, 2 символа (цифры или латинские буквы A–Z), 3 цифры (как у ФНС). Иначе ошибка INVALID_KPP.
  • ИП: КПП запрещён — 422 INVALID_KPP; при импорте строка пропускается с предупреждением.
  • Обязательность для ЮЛ: необязателен (nullable); уже заведённые ЮЛ и импорт без колонки КПП остаются валидными.
  • Уникальность: только inn unique; КПП — атрибут, сопоставление контрагентов ОСВ по ИНН не меняется.
  • Изменение КПП: обычный PATCH со снимком в legal_entity_history (как прочие атрибуты).
## Решения владельца (07.10.2026) - **Формат:** 9 символов — 4 цифры, 2 символа (цифры или латинские буквы A–Z), 3 цифры (как у ФНС). Иначе ошибка `INVALID_KPP`. - **ИП:** КПП запрещён — 422 `INVALID_KPP`; при импорте строка пропускается с предупреждением. - **Обязательность для ЮЛ:** необязателен (nullable); уже заведённые ЮЛ и импорт без колонки КПП остаются валидными. - **Уникальность:** только `inn` unique; КПП — атрибут, сопоставление контрагентов ОСВ по ИНН не меняется. - **Изменение КПП:** обычный PATCH со снимком в `legal_entity_history` (как прочие атрибуты).
aep closed this issue 2026-10-07 18:01:24 +03:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
PotapovaA Raykov-MS SalminMP Veronika Yashin1994 aep grog maxim tsygankoviva
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: RSHB/arm-ka-docs#53
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?