код boxid что это
Как узнать идентификатор в Диадоке?
Как узнать идентификатор участника Эдо диадок?
Чтобы узнать ваш идентификатор участника электронного документооборота, зайдите в веб-интерфейс Диадока diadoc.kontur.ru, нажмите на кнопку «Настройки и оплата» в правом верхнем углу и перейдите в раздел «Реквизиты организации». В строке «Идентификатор участника ЭДО» будет указан уникальный код вашей организации.
Что такое идентификатор участника электронного документооборота?
Идентификатор участника электронного документооборота — это уникальный код, который оператор ЭДО присваивает отправителям и получателям электронных документов.
Как посмотреть идентификатор в Сбис?
В СБИС идентификатор ЭДО указан в карточке организации: наведите указатель мыши или нажмите значок подключения к СБИС. Появится информационное окно с кодом — это будет идентификатор. Также посмотреть идентификатор организации можно в разделе «Конфигурация/Наша компания».
Как войти в контур диадок?
Как войти в Диадок
Как установить контур диадок?
Для того чтобы приступить к установке, необходимо зайти на веб-диск по адресу https://install.kontur.ru/diadoc. При первом входе на веб-диск может появиться сообщение о необходимости установить утилиту AddToTrusted (либо Kontur-Install-KE при использовании браузера отличного от Internet Explorer).
Как узнать идентификатор Гугл?
Что такое идентификатор компании?
Уникальный идентификатор организации (англ. … Organizationally Unique Identifier, OUI) — это 24-битный номер, который присваивается регистрационной администрацией IEEE (подразделение IEEE — Института инженеров электротехники и электроники).
Что такое код BoxId?
BoxId — это идентификатор ящика отправителя, messageId — идентификатор отправленного сообщения с СФ/ИСФ/КСФ/ИКСФ, attachmentId — идентификатор подтверждение оператора. Их можно взять из структуры Message.
Как посмотреть идентификатор Эдо в 1с?
Идентификатор в «1С»
Как принять приглашение в Сбис?
Примите приглашение одним из способов.
Как в Сбис отправить документы контрагенту?
Создать и отправить письмо контрагенту
Как работать с Диадоком?
Диадок автоматически формирует протокол передачи по каждому циклу документооборота, в котором фиксирует любой действие, произведенное сторонами с документом. … Поставщик формирует документы в редакторе Диадока или загружает их с ПК, при необходимости отправляет на согласование внутри компании.
Как зарегистрироваться в диадок?
1. Как зарегистрироваться с помощью сертификата электронной подписи
Как получить счет-фактуру¶
Рассмотрим последовательность действий к функциям интеграторского интерфейса Диадока, которые требуется совершить покупателю при получении счета-фактуры (СФ), корректировочного счета-фактуры (КСФ), исправления счета-фактуры (ИСФ).
Порядок согласно приказу N 14Н¶
Порядок документооборота со стороны Покупателя:
Более подробно о порядке обмена электронными счетами-фактурами между компаниями можно почитать в соответствующем разделе или на сайте
Поиск счета-фактуры¶
Сначала необходимо найти входящие счета-фактуры, которые требуется обработать, для этого нужно воспользоваться методом GetDocuments :
Пример запроса на получение счета-фактуры выглядит следующим образом:
В теле ответа вернется список документов в виде структуры DocumentList с вложенной структурой Document. Для каждого из этих документов запоминаем: MessageId, EntityId.
Получение счета-фактуры и подтверждения оператора¶
Пример структуры подтверждения оператора InvoiceConfirmation в теле ответа:
Формирование извещения о получении счета-фактуры¶
На полученный счет-фактуру Покупатель должен отправить в ответ подписанное извещение InvoiceReceipt о получении СФ.
Например HTTP-запрос для формирования извещение о получении счета-фактуры выглядит следующим образом:
Пример структуры в теле запроса, содержащей данные о подписанте генерируемого извещения Signer :
Отправка извещения о получении счета-фактуры¶
Для этого нужно подготовить структуру MessagePatchToPost следующим образом:
Пример структуры в теле запроса, содержащей данные о передаваемом извещении MessagePatchToPost :
Подтверждение оператора на извещение о получении счета-фактуры¶
После того, как покупатель сформировал и отправил извещение о получении СФ, оператор в ответ должен сформировать подтверждение оператора о дате получения извещения о получении СФ.
Счет-фактура перейдет в статус InboundFinished. Ответного действия покупателя на полученное подтверждение оператора не предусмотрено.
Запрос на исправление или корректировку по счету-фактуре¶
После того, как будет получен XML-файл, его нужно отправить с помощью метода PostMessagePatch
Для этого нужно подготовить структуру MessageToPost следующим образом:
Пример кода на C# для получения счета фактуры:
Пример кода на C# для отправки уведомления об уточнении счета-фактуры:
Порядок согласно приказу N 174Н (утратил силу с 01.07.2021)¶
Порядок документооборота со стороны Покупателя:
Поиск счета-фактуры¶
Действия аналогичны инструкции для обмена СФ по 14Н (см. Поиск счета-фактуры ).
Получение счета-фактуры и подтверждения оператора¶
Действия аналогичны инструкции для обмена СФ по 14Н (см. Получение счета-фактуры и подтверждения оператора ).
Формирование извещения о получении подтверждения оператора¶
После того, как покупатель получил подтверждение оператора, он должен отправить в ответ подписанное извещение InvoiceReceipt о получении подтверждения.
Последовательность действий для формирования извещения о получении подтверждения оператора аналогична последовательности действий для формирования извещения о получении СФ (см. Формирование извещения о получении счета-фактуры ).
За исключением того, что в attachmentId нужно указать идентификатор полученного подтверждения оператора.
Отправка извещения о получении подтверждения оператора¶
Полученное на предыдущем этапе извещение нужно подписать и отправить.
Последовательность действий для отправки сформированного извещения о получении подтверждения оператора аналогична последовательности действий для отправки сформированного извещения о получении СФ (см. Отправка извещения о получении счета-фактуры ).
За исключением того, что в поле ParentEntityId нужно указать идентификатор (EntityId) подтверждения оператора, полученного на предыдущем шаге.
Формирование извещения о получении счета-фактуры¶
Действия аналогичны инструкции для обмена СФ по 14Н (см. Формирование извещения о получении счета-фактуры ).
Отправка извещения о получении счета-фактуры¶
Полученное на предыдущем этапе извещение нужно подписать и отправить. Действия аналогичны инструкции для обмена СФ по 14Н (см. Отправка извещения о получении счета-фактуры ).
Подтверждение оператора о дате отправки извещения о получении счета-фактуры¶
После того, как покупатель сформировал и отправил извещение о дате получении СФ, оператор в ответ должен сформировать подтверждение оператора о дате отправки извещения о получении СФ.
Это подтверждение покупатель должен получить, затем сформировать извещение о получении подтверждения оператора, подписать его и отправить.
Формирование извещения о получении подтверждения оператора аналогично формированию извещения о получении СФ (см. Формирование извещения о получении счета-фактуры ). За исключением того, что в attachmentId нужно указать идентификатор полученного подтверждения оператора.
Подписание и отправка извещения о получении подтверждения оператора аналогичны действиям по подписанию и отправке извещения о получении СФ (см. Отправка извещения о получении счета-фактуры ). За исключением того, что в поле ParentEntityId нужно указать идентификатор (EntityId) подтверждения оператора.
После того, как покупатель сформировал все необходимые извещения, счет-фактура перейдет в статус InboundFinished
Запрос на исправление или корректировку по счету-фактуре¶
Действия аналогичны инструкции для обмена СФ по 14Н (см. Запрос на исправление или корректировку по счету-фактуре ).
Пример кода на C# для получения счета фактуры:
Пример кода на C# для отправки уведомления об уточнении счета-фактуры:
Где взять BoxId в GUID формате для УПД по 820 приказу? #576
Comments
Edward72 commented Oct 31, 2019
В теле запроса GenerateTitleXml нужно заполнять BoxID продавца и покупателя. Формат требуется GUID. API Диадока позволяет нам получить идентификатор ящика вызовом GetBox. Но в ответе мы получаем идентификатор вида «97be5d3704394d62bf40442dcb2489b8@diadoc.ru», что совсем не похоже на GUID. Вопрос: где брать идентификатор ящика в GUID формате?
The text was updated successfully, but these errors were encountered:
OlgaPetushina commented Nov 1, 2019
Edward72 commented Nov 5, 2019
В части получения идентификатора ящика вы правы. Это я неправильно указал метод, конечно же GetOrganization и далее по списку ящиков получаем их идентификаторы (непонятно только, зачем список, если ящиков всегда один). А вот в части преобразовать самостоятельно можно подискутировать. Да это не сложно, да, я это в итоге так и сделал. Но возникает вопрос о единообразии данных в API Диадока. Почему в одном случае BoxId должен быть такого вида «97be5d3704394d62bf40442dcb2489b8@diadoc.ru», а в другом «97be5d37-0439-4d62-bf40-442dcb2489b8»? Уважаемые разработчики, объясните вашу логику!
OlgaPetushina commented Nov 5, 2019
@Edward72 boxid возвращается в таком виде в целях обратной совместимости. Мы планируем поднять версию метода и возвращать BoxId как guid. Сроков нет пока.
Edward72 commented Nov 5, 2019
Ок. Поясните тогда по списку ящиков. Зачем в структуре Organization ящики представлены в виде списка? Бывают ли ситуации когда их больше одного?
OlgaPetushina commented Nov 5, 2019
Edward72 commented Nov 5, 2019
alogicman commented Nov 5, 2019
Ок. Поясните тогда по списку ящиков. Зачем в структуре Organization ящики представлены в виде списка? Бывают ли ситуации когда их больше одного?
Это опять для обратной совместимости: когда-то давно у одной организации могло быть несколько ящиков. Сейчас понятия организации и ящика фактически смешались, так как их отношение 1:1 — у организации ровно один ящик.
Когда-нибудь мы приведем все в единообразное состояние — везде будет использоваться нормальный boxId, а у организации не будет массива ящиков 🙂
Edward72 commented Nov 6, 2019
никто не ответил. С каким контрагентом мне работать? Если их два, с одинаковым ИНН/КПП?
NataliaShumikhina commented Nov 6, 2019
Никаких противоположных мнений нет. Организация=Ящик=уникальная связка ИНН-КПП-Id участника ЭДО-признак тестовая/роуминговая/реальная
Это всё нормальные ситуации.
Если вы получили в ответе несколько ящиков, то вы сами выбираете, с каким работать:
Edward72 commented Nov 7, 2019
i82 commented Nov 7, 2019
Если вам требуются технические консультации, я могу предложить оплатить платные консультации. Вы будете получать ответ оперативнее с учётом всего вашего контекста от выделенного специалиста. Если это потребуется, обратитесь к вашему менеджеру.
Edward72 commented Feb 13, 2020
Опять про ящики. Есть контрагент. Подразделение ПАО «Ростелеком» ИНН 7707049388 КПП 860143001. GetOrganization ищем по ИНН/КПП, находим, отправляем приглашение. И что? И ничего. А почему? А потому что, этот ящик они когда-то использовали, но потом все поменялось. У них теперь другой ящик. А старый остался висеть, непонятно зачем. А новый ящик где? А внутри ящика другого контрагента, у которого КПП 66854300. Это Макрорегиональный филиал «Урал». Но господа, в договоре с этим контрагентом КПП 66854300 не прописан! У нас есть КПП головы 770545001 и собственно грузополучателя КПП 860143001. Руками конечно все можно настроить, но мы говорим об интеграции. Итак, есть ИНН/КПП головы и грузополучателя. Ищем GetOrganization по ИНН/КПП грузополучателя, находим, приглашаем и тишина. Что дальше? Ок. Ищем только по ИНН. Находим 66 организаций! Куда дальше? Мне что, нужно лепить в программе костыль, где указывать, что в Диадоке работаем через конкретный КПП? Ок. Допустим. Следующий вопрос. В поддержке мне объяснили, что направляя формализованные документы с КПП грузополучателя в ящик филиала «Урал», документы перенаправятся в ящик нашего потребителя. А что делать с неформализованными документами? Куда их слать? На деревню дедушке? Когда наконец логику работы с Диадоком приведут в нормальный вид?
i82 commented Feb 13, 2020
Структуру филиалов каждая компания формирует самостоятельно, как и принимает решения об удалении ящиков. Мы не можем гарантировать работу Ростелекома, информация о том, куда следует отправлять документы вам необходимо согласовать с контрагентом.
Маршрутизация неформализованных документов не производится т.к. Диадок не может определить из контента, куда его требуется смаршрутизировать. Для маршрутизации таких документов нужно явно указывать подразделение получателя при отправке.
Edward72 commented Feb 13, 2020
Речь идет не о структуре филиалов. А о том, что Диадок не позволяет работать с филиалами, не заморачиваясь с той самой структурой филиалов. Мне то какое должно быть дело до их структуры? Сегодня она одна, завтра другая. Есть ИНН/КПП получателя. Все. Больше ничего не должно быть нужно. И слова «Диадок не может», которые звучат из уст разработчиков того самого Диадока, выглядят как минимум неубедительно. Как максисмум: типа, мы тут сделали кое как, пользуйте как хотите и как можете, мы ничего переделывать не будем.
i82 commented Feb 13, 2020
ToDepartmentId в методе отправки.
В апи Диадок предоставляет данные как есть, без дополнительной логической обработки, для более предсказуемого поведения и вашей возможности для гибкой настройки интеграции. Компания Ростелеком проинформирована о том, что выбранное ими решение может быть неудобным для их контрагентов без относительно интерфейса работы с ними.
Edward72 commented Feb 13, 2020
Что еще можно было услышать? Виноваты не мы, виноваты сами пользователи. А наша система самая офигенская, что-то допиливать, изменять в ней нет необходимости. Платите деньги за использование и пользуйте как есть. А сделать элементарное, поиск по ИНН/КПП в своей базе (базе Диадока) в том числе и подразделений ну никак. Еще расскажите мне про «техническую невозможность».
i82 commented Feb 13, 2020
Попрошу вас воздержаться от оценочных суждений.
Это пожелание по доработке тоже зафиксировал, но в ближайшие задачи она не попадёт
Edward72 commented Feb 13, 2020
Ваш запрос в бэклоге. Если вы хотите поднять приоритет, обратитесь к вашему менеджеру, он сможет это сделать
GenerateTitleXml¶
Обобщённый метод генерации. Позволяет изготовить xml-файл любого титула любого типа документа.
В теле ответа содержится сгенерированный XML-файл титула, построенный на основании данных из запроса. Файл изготавливается в соответствии с XSD-схемой соответствующего титула документа.
Имя файла сгенерированного титула возвращается в стандартном HTTP-заголовке Content-Disposition.
Как использовать. Генерация титула отправителя (первого титула документа):
В качестве примера рассмотрим генерацию счёта-фактуры формата приказа ФНС №820. Для этого с помощью метода GetDocumentTypes найдем интересующий тип и версию:
Для простоты примера из ответа убраны другие типы, функции, версии, и информация о метаданных. Главное, что нужно взять из этой информации:
Теперь нужно подготовить контент для титула. Титул — это xml-файл, соответствующий xsd-схеме. Часть данных в титуле может быть заполнена только пользователем — это информация о товарах, услугах и т.д. А часть данных может быть заполнена автоматически на основании формата и информации в Диадоке. Например, заполнить реквизиты организации продавца и покупателя по идентификатору ящика, установить значения КНД, версии формата, версии программы и т.д. Для упрощения генерации, Диадок позволяет заполнить только «пользовательский» xml-файл, он же UserDataXml. На базе UserDataXml метод генерации сформирует основной титул, дополнив его всеми необходимыми данными согласно xsd-схеме.
Общая схема работы:
Выбор, как формировать UserDataXml, остаётся за разработчиком интеграционного решения.
Один из путей — это кодогенерация из xsd-схемы упрощённого титула. Ссылка на схему находится в поле UserDataXsdUrl из выдачи GetDocumentTypes выше.
В качестве примера, в C# SDK для всех версий формата приказа №820 есть пример кодогенерации.
Чтобы воспользоваться ей в C#-клиенте, достаточно заполнить объект UniversalTransferDocument для титула отправителя (или UniversalTransferDocumentBuyerTitle для титула получателя) и затем сериализовать в XML.
Итого, имея идентификаторы типа, функции, версии, порядкового номера титула, а также пользовательский контент, можем получить сам титул счёта-фактуры.
Пример UserDataXml (тело запроса):
Выгрузка
Фильтры для поиска документа
Подразделение. Текущее местоположение документа в ящике Диадока. Можно настроить выгрузку документов как из конкретного подразделения, так и из множества. Если у подразделения есть дочерние, то можно организовать выгрузку сразу по всем.
Список контрагентов. Используется для получения документов только от определенных организаций.
Счет-фактура и корректировки
УПД и корректировки
Первичный документ (акт выполненных работ/оказанных услуг и накладная ТОРГ-12)
Протокол согласования цен
Дополнительное соглашение к договору
и другие типы документов.
Данные для выгрузки
Список файлов, доступных для выгрузки:
Для двусторонних документов:
Коннектор позволяет выгружать метаданные (статус) по документу в отдельный файл формата TXT с использованием специальных макроподстановок.
Например, необходимо выгружать данные в виде ключ-значение:
В результате выгрузки метаданных (статуса) Коннектором будет сформирован файл вида:
Путь выгрузки
Документы могут быть выгружены на следующие файловые ресурсы:
Внутри корневой папки выгрузки можно задать структура подпапкок на основе макроподстановок.
Макрос
Расшифровка
Формат
Дата и время выгрузки документа из Диадока (часовой пояс МСК)
Год дня выгрузки в формате четырьмя цифрами
Месяц дня выгрузки
День месяца выгрузки
Время дня выгрузки (часы)
Время дня выгрузки (минуты)
Время дня выгрузки (секунды)
Дата и время загрузки документа в Диадок (часовой пояс МСК)
Дата и время загрузки документа
Год дня загрузки документа
Месяц дня загрузки документа
День загрузки документа
Время загрузки документа (часы)
Время загрузки документа (минуты)
Время загрузки документа (секунды)
Реквизиты участников ЭДО
Идентификатор участника ЭДО
Строка, 36 символов
Идентификатор ящика в Диадоке
Строка, 32 или 36 символов
Идентификатор ФНС контрагента
Строка, 36 символов
Идентификатор ящика контрагента
Строка, 32 или 36 символов
Строка, 10 или 12 символов
Строка, 9 символов. Может отсутствовать
Наименование организации контрагента
Строка, 10 или 12 символов
Строка, 9 символов. Может отсутствовать
Наименование организации отправителя
Строка, 10 или 12 символов
Строка, 9 символов. Может отсутствовать
Наименование организации получателя
Идентификатор подразделения документа
Строка, 32 или 36 символов
Наименование подразделения документа
Строка, до 128 символов
Краткое наименование подразделения документа
Для головного подразделения пишется «головное подразделение»
Макросы пакетов с документами и сообщений (часовой пояс МСК)
Номер документа, где Key – тип документа
Диадоковский идентификатор пакета с документами
Строка, 36 символов
Макросы сущностей
Случайный уникальный идентификатор сущности
Строка, 36 символов
Макросы документов
ДД.ММ.ГГГГ в часовом поясе МСК.
День месяца документа
Идентификатор документа, определяемый внешней системой
Диадоковский идентификатор сообщения
Строка, 36 символов
Диадоковский идентификатор документа
Строка, 36 символов
Имя документа, отображаемое в ящике Диадока
Тип документа (на русском)
Имя файла документа
Строка, до 1024 символов
Комментарий контрагента к документу при подписании или отказе в подписи
Значения макросов различаются в зависимости от направления ЭДО.
Если имя макроса содержит префикс Packet, то будет выгружен статус по пакету.
Подробнее см. в таблице 3.
Значения макросов различаются в зависимости от направления ЭДО.
Если имя макроса содержит префикс Packet, то будет выгружен статус по пакету.
Подробнее см. в таблице 3.
Таблица 2. Примеры значений макроса
Тип документа / Тип сущности
Примеры значений макроса
Извещение о получении подтверждения
Извещение о получении СФ
Уведомление об уточнении СФ
Извещение о получении уведомления
Акт (Титул исполнителя)
Акт (Титул заказчика)
ТОРГ-12 (Титул продавца)
ТОРГ-12 (Титул покупателя)
Имя файла совпадает с именем файла при скачивании из ящика ДД.
где ИдОтпр – идентификатор отправителя, ИдПол – идентификатор получателя, GGGGMMDD – год – 4 цифры, месяц – 2 цифры, день – 2 цифры, N – уникальны идентификатор, 36 символов.
Таблица 3 – Значения макросов со статусами
Направление
Статус в веб-интерфейсе ящика ДД
Значение макросов
Значение макросов
Направление: Исходящие
Значение макросов
Направление: Входящие и Внутренние
Исходящие / Входящие /Внутренние
7 — если Входящие и Внутренние
9 — если Входящие и Внутренние
8 — если Входящие и Внутренние
16 — если Исходящие
Приоритет статуса в пакете определяется максимальным числовым значением статуса из таблицы 3.
Например, в пакете три документа и у каждого свой статус («Получатель подписал документ», «Документооборот завершен», «Аннулирован»). Итоговым статусом пакета будет статус «Аннулирован», т.к. у него приоритет 18.