Наблюдатель в ЭТрН в Диадоке: где взять ID

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

В ЭТрН такая организация может выступать наблюдателем.

На практике именно здесь часто возникает вопрос:

что вводить в поле «ИдПолИной», можно ли использовать ИНН и где взять длинный идентификатор вида 2BM-...?

Короткий ответ: ИНН и FnsParticipantId — не одно и то же.

Содержание

Кто такой наблюдатель в ЭТрН

В документации Диадока наблюдатель определяется как организация, которая получает титулы ЭТрН для просмотра и контроля перевозки, но сама не формирует и не подписывает эти титулы. developer.kontur.ru

Например, наблюдателем может быть:

заказчик перевозки;
экспедитор;
логистическая компания;
организация, контролирующая исполнение перевозки;
другой участник процесса, которому необходимо видеть ЭТрН, но который не является подписантом конкретного титула.

То есть наблюдатель — это не ещё один грузополучатель и не перевозчик.

Он получает доступ к документу именно как дополнительный получатель информации.

Как наблюдатель записывается в титул Т1

Если титул Т1 формируется как готовый XML, идентификаторы наблюдателей передаются в элементе:

ИдПолИной

Для каждого наблюдателя создаётся отдельный элемент. Диадок приводит такую схему для Т1:

<ИдПолИной>2BM-...</ИдПолИной>
<ИдПолИной>2BM-...</ИдПолИной>

Если используется упрощённый UserDataXml, соответствующие идентификаторы передаются через OtherRecipientIds. developer.kontur.ru

Именно поэтому в готовом XML недостаточно написать название организации или её ИНН.

Нужен идентификатор участника ЭДО.

Что такое FnsParticipantId

FnsParticipantId — это идентификатор участника электронного документооборота.

Диадок отдельно хранит его в данных организации наряду с ИНН, КПП, названием и другими реквизитами. developer.kontur.ru

Он может выглядеть примерно так:

2BM-7700000000-770001001-202401010101010000000

Это пример формата. Использовать выдуманный идентификатор нельзя.

Первые три символа идентификатора содержат код оператора ЭДО, к которому подключена организация. Для организаций Диадока часто встречается префикс 2BM. developer.kontur.ru

ИдПолИной, FnsParticipantId и 2BM — это одно и то же?

Не совсем.

ИдПолИной — название элемента в XML ЭТрН.

FnsParticipantId — технический идентификатор участника ЭДО, который помещается в этот элемент.

2BM — начало конкретного идентификатора, связанное с оператором ЭДО.

Поэтому пользователь обычно видит примерно такую цепочку:

организация → FnsParticipantId → значение 2BM-... → поле <ИдПолИной> в XML.

Почему нельзя определить 2BM только по ИНН

Это особенно важно.

ИНН идентифицирует налогоплательщика.

FnsParticipantId идентифицирует участника электронного документооборота.

У организации в Диадоке эти значения существуют отдельно. API Диадока при поиске организации возвращает одновременно ИНН, КПП и FnsParticipantId. developer.kontur.ru

Поэтому нельзя просто взять ИНН и самостоятельно дописать к нему 2BM-.

Такой идентификатор может выглядеть правдоподобно, но не существовать в системе ЭДО.

Результатом может стать ошибка маршрутизации документа или невозможность определить получателя.

Где посмотреть FnsParticipantId своей организации в Диадоке

В веб-интерфейсе Диадока идентификатор участника ЭДО можно посмотреть в настройках организации.

Контур указывает два варианта:

Настройки — идентификатор отображается в данных организации;

или

Реквизиты организации — там также показывается идентификатор участника ЭДО. Контур

Обычно он выглядит как длинная строка, начинающаяся с кода оператора.

Как узнать идентификатор наблюдателя-контрагента

Если нужно добавить наблюдателем другую организацию, удобнее всего искать её через Диадок.

В веб-интерфейсе:

Контрагенты → найти организацию по ИНН или названию → открыть карточку организации → посмотреть ID.

В справке Диадока указано, что идентификатор контрагента можно посмотреть из его карточки после поиска во вкладке «Контрагенты». Контур

Для интеграционных решений есть и API. Диадок позволяет искать организацию по:

ИНН;
КПП;
идентификатору участника ЭДО;
идентификатору ящика;
другим реквизитам. developer.kontur.ru

В ответе API возвращается в том числе FnsParticipantId. developer.kontur.ru

Чем FnsParticipantId отличается от BoxId

Это ещё одна частая путаница.

У организации в Диадоке может одновременно быть:

BoxId — идентификатор ящика Диадока;

FnsParticipantId — идентификатор участника ЭДО.

Это разные поля. В данных организации Диадок показывает их отдельно. developer.kontur.ru

Для наблюдателя в XML ЭТрН нужен именно тот идентификатор, который предусмотрен форматом ЭТрН для ИдПолИной.

Не следует автоматически подставлять туда адрес ящика вида ...@diadoc.ru.

Что делать, если организация работает через роуминг

Если контрагент подключён к другому оператору ЭДО, ситуация может быть сложнее.

Диадок поддерживает поиск участников ЭДО в роуминге по ИНН, КПП или идентификатору участника ЭДО через специальные методы API. developer.kontur.ru

Поэтому отсутствие организации среди обычных контрагентов Диадока ещё не означает, что её нельзя добавить как наблюдателя.

Главное — получить реальный идентификатор участника ЭДО, через которого организация участвует в обмене.

Как добавить наблюдателя в нашем генераторе ЭТрН

В сервисе «Создать и проверить ЭТрН» есть отдельный раздел «Наблюдатели».

Сначала можно найти организацию по ИНН или названию.

После выбора организации указываются:

наименование;
ИНН;
КПП;
ИдПолИной / FnsParticipantId / 2BM.

Если с этой организацией вы работаете регулярно, можно сохранить соответствие:

ИНН ↔ идентификатор участника ЭДО.

При следующем оформлении тот же технический идентификатор можно подставить автоматически.

Открыть генератор ЭТрН →

Можно ли автоматически получить FnsParticipantId по ИНН

Технически — да, если система интегрирована с API оператора ЭДО и имеет необходимую авторизацию.

Например, Диадок позволяет получить сведения об организации по ИНН, а в результатах присутствует FnsParticipantId. developer.kontur.ru

Но простой веб-сервис без авторизованного доступа к Диадоку не должен придумывать этот идентификатор самостоятельно.

Поэтому безопасная логика такая:

ИНН используем для поиска организации;
FnsParticipantId получаем от оператора ЭДО или из карточки организации;
после получения сохраняем соответствие для будущих документов.

Почему возникает ошибка «Unable to resolve recipient box»

Одна из причин подобных ошибок — система не смогла определить ящик или участника ЭДО по переданному идентификатору.

Это может произойти, если:

указан ИНН вместо FnsParticipantId;
идентификатор введён с ошибкой;
используется идентификатор не того участника;
контрагент работает через другого оператора и требуется роуминг;
организация не подключена к необходимому обмену.

Поэтому при такой ошибке первым делом нужно проверить не название организации, а именно технический идентификатор участника ЭДО.

Отдельно эту ошибку разберём в следующей инструкции.

Пример XML с наблюдателем

Фрагмент может выглядеть так:

<Файл ...>
    <СвУчДокОбор ... />

    <ИдПолИной>
        2BM-XXXXXXXXXXXXXXXXXXXXXXXX
    </ИдПолИной>

    <Документ ...>
        ...
    </Документ>
</Файл>

Точная структура зависит от действующего формата документа и способа его формирования, поэтому при редактировании готового XML лучше ориентироваться на формат оператора и официальную схему.

Для Т1 Диадок прямо указывает использование элемента ИдПолИной для наблюдателей. developer.kontur.ru

Если наблюдателей несколько

Можно добавить несколько организаций.

Каждый идентификатор передаётся отдельно.

Например:

<ИдПолИной>2BM-...</ИдПолИной>
<ИдПолИной>2BM-...</ИдПолИной>

Для Т3 Диадок указывает, что список наблюдателей переносится из Т1 автоматически. developer.kontur.ru

То есть повторно формировать тот же список для Т3 обычно не требуется.

Основные ошибки при заполнении наблюдателя

Перед выгрузкой XML проверьте:

выбран ли нужный контрагент;
совпадает ли его ИНН;
не перепутан ли BoxId с FnsParticipantId;
не введён ли просто ИНН вместо 2BM-...;
нет ли лишних пробелов;
действительно ли организация подключена к ЭДО;
работает ли она напрямую через вашего оператора или через роуминг.

Особенно внимательно проверяйте идентификатор, если документ передаётся через интеграцию или загружается готовым XML.

Наблюдатель не обязан подписывать ЭТрН

Это принципиальное отличие наблюдателя от участника, который формирует титул.

Наблюдатель получает документ для просмотра и контроля, но сам не формирует и не подписывает титулы ЭТрН. developer.kontur.ru

Поэтому добавление наблюдателя не создаёт нового этапа подписания документа.

Что делать, если идентификатор неизвестен

Если известен только ИНН:

сначала найдите организацию у оператора ЭДО, затем получите её идентификатор участника.

Если контрагент не находится, уточните у него:

каким оператором ЭДО он пользуется и какой у него идентификатор участника ЭДО.

Самостоятельно генерировать 2BM-... из ИНН не нужно.

Добавить наблюдателя в ЭТрН онлайн

В генераторе buhzlat.ru можно:

найти организацию по ИНН;
добавить её как наблюдателя;
указать FnsParticipantId;
сохранить соответствие ИНН и ID ЭДО;
открыть существующий XML;
сохранить уже находящихся в документе наблюдателей;
сформировать новый XML титула Т1.

Создать и проверить ЭТрН →

Сервис помогает подготовить структуру XML, но не является оператором ИС ЭПД и не заменяет проверку документа в системе оператора.