Перейти к основному содержимому

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% (с возможностью поставить НДС нашей организации — как раньше).

Права​

Те же, что на создание и редактирование контрагента.

Пользовательские сценарии​

  1. Белорусский покупатель. Страна «Беларусь», УНП в поле ИНН, foreign-реквизиты и/или форма «Иностранная организация» — сохранение проходит; в заказе НДС по умолчанию 0%.
  2. Российский контрагент. Без foreign-маркеров — прежние проверки и автозаполнение.
  3. Дубль по номеру. Повтор с тем же налоговым номером (без КПП) отклоняется.
  4. Конфликт. Страна «Россия» + 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