2026-09-24 — Иностранный контрагент: реквизиты без российского ИНН (v1)
Статус: Реализовано
Источник: Олег Сосунов
Эпик: ITR-3119
Связанные задачи: ITR-3128 / ITR-3174 (бек), ITR-3129 (фронт).
Связано: partner.md, НДС для иностранного покупателя в заказе покупателя.
Цель
Дать возможность завести иностранного контрагента (в первую очередь из Беларуси) с настоящим налоговым номером страны (для Беларуси — УНП в поле ИНН), без подгонки под российский ИНН 10/12 цифр.
Российские контрагенты и проверки реквизитов для них не ослаблены.
Контекст (как было)
- Форма и проверки были рассчитаны только на российские реквизиты: ИНН 10 или 12 цифр, для организаций — КПП, ОКПО обязателен.
- Автозаполнение по ИНН/ОГРН через DaData — только для российских организаций.
- Поле «Реквизиты иностранного юридического лица» уже было; по нему контрагент считался иностранным для НДС в заказе.
- Белорусского контрагента с УНП (9 цифр) завести было нельзя.
Поведение (как сейчас)
Режим иностранного контрагента
Режим включается, если выполняется хотя бы одно:
- правовая форма «Иностранная организация»;
- заполнены «Реквизиты иностранного юридического лица»;
- в Стране указано значение не Россия / РФ / Российская Федерация.
Пустая страна без foreign-маркеров — российская логика реквизитов.
Конфликт: если страна явно Россия (или РФ / Российская Федерация), а при этом выбрана форма «Иностранная организация» или заполнены foreign-реквизиты — сохранение отклоняется с ошибкой о конфликте данных.
Реквизиты в foreign-режиме
- Налоговый номер страны вводится в поле ИНН / УНП (цифры, до 20 символов; для Беларуси обычно УНП из 9 цифр).
- КПП, ОГРН, ОКПО не обязательны и на форме скрыты.
- Автозаполнение по налоговому номеру для РФ, Беларуси и Казахстана доступно (после v1 эпика доработано: УНП / БИН). Для прочих иностранных стран — вручную.
Российский контрагент
Без foreign-режима — прежние проверки ИНН 10/12, КПП, ОКПО, DaData.
НДС в заказе покупателя
Признак иностранца для НДС совпадает с foreign-режимом: НДС по умолчанию 0% (с возможностью поставить НДС нашей организации — как раньше).
Права
Те же, что на создание и редактирование контрагента.
Пользовательские сценарии
- Белорусский покупатель. Страна «Беларусь», УНП в поле ИНН, foreign-реквизиты и/или форма «Иностранная организация» — сохранение проходит; в заказе НДС по умолчанию 0%.
- Российский контрагент. Без foreign-маркеров — прежние проверки и автозаполнение.
- Дубль по номеру. Повтор с тем же налоговым номером (без КПП) отклоняется.
- Конфликт. Страна «Россия» + foreign-форма или foreign-текст — ошибка, сохранение невозможно.
Принятые решения (итог реализации)
| Тема | Решение |
|---|---|
| Объём v1 | Вариант A: мягкая валидация для иностранца, без справочника стран и без смены лейбла поля на «УНП» |
| Когда foreign | Форма «Иностранная организация» или foreign-текст или непустая страна не Россия; явная Россия побеждает (конфликт с foreign-маркерами) |
| Налоговый номер | Поле ИНН / УНП; цифры до 20 символов |
| КПП, ОГРН, ОКПО | В foreign скрыты и не обязательны |
| Правовая форма | В справочнике есть «Иностранная организация» |
| DaData | РФ / Беларусь / Казахстан — да; прочие foreign — вручную (доработано после v1) |
| НДС | Тот же критерий, что foreign-режим |
| Отдельный переключатель «иностранец» | Не делали — достаточно страны / формы / foreign-блока |
Критерии приёмки
- Можно создать контрагента-покупателя со страной «Беларусь», УНП в поле ИНН и foreign-маркерами — форма и сохранение принимают данные.
- Для контрагента без foreign-режима проверки российского ИНН и связанных реквизитов не ослаблены.
- В заказе покупателя для иностранца НДС по умолчанию 0%.
- Модалка/автозаполнение по ИНН не мешает созданию иностранного контрагента.
- Повторное создание с тем же налоговым номером (без КПП) отклоняется как дубль.
- Редактирование иностранного контрагента не требует КПП/ОКПО «как у РФ».
- Конфликт «страна Россия + foreign-форма/реквизиты» блокирует сохранение.
Вне scope (не входило в v1)
- Справочник стран с отдельными правилами и лейблами (УНП, БИН и т.д.).
- Интеграции с реестрами Беларуси / других стран.
- Буквенно-цифровые УНП физлиц.
- Отдельная переработка печатных форм и импорта под иностранные номера.
Задачи эпика
| # | Задача | Смысл |
|---|---|---|
| 1 | Задача 1. Бек. Мягкая валидация реквизитов для иностранца | Foreign-режим, конфликт с Россией, форма «Иностранная организация», НДС |
| 2 | Задача 2. Фронт. Режим иностранного контрагента на форме | UI и валидация, скрытие КПП/ОГРН/ОКПО, DaData |
| 3 | Задача 3. Документация. User docs по иностранному контрагенту | Раздел в partner.md |