код boxid и код guid
Как получить GUID предприятия?
Распространенным проявлением этой проблемы является ситуация когда поставщик отправляет ВСД на одну площадку, а покупатель ждет входящий ВСД на предприятии-дублере и ВСД не получает. Решить проблему можно после обмена GUID площадок. GUID — уникальный идентификатор предприятия. С помощью него покупатель будет точно легко найти нужную площадку в системе Меркурий.
Как узнать GUID своей площадки
В веб-сервисе от СКБ Контур легко найти, где расположен GUID.
Шаг 1. Зайдите в систему и перейдите на вкладку «Меркурий/Настройки»: вы увидите перечень подключенных предприятий.
Шаг 2. Нажмите кнопку «Редактировать»: откроется экран со списком площадок, рядом с каждой площадкой вы увидите ее GUID-код.
Шаг 3. Скопируйте GUID и отправьте его поставщикам, чтобы они могли правильно оформлять ВСД.
Если вы используете государственный «Меркурий», чтобы получить GUID предприятия, вам надо:
Шаг 1. Перейти во вкладку «Сменить предприятие», где вы увидите все зарегистрированные площадки.
Шаг 2. Нажать на кнопку «Скачать» рядом с разделом «Выбор обслуживаемого предприятия».
Шаг 3. Открыть скачанный текстовый файл, в котором будет перечень ваших площадок с номерами GUID для каждой из них.
Что делать, если в Меркурии нет нужной площадки
Существует два способа зарегистрировать новую площадку:
Идентификатор участника ЭДО
Что такое идентификатор
Идентификатор участника ЭДО состоит из комбинации цифр и латинских букв разного регистра.
Первые три символа в номере — это ID оператора электронного документооборота. Набор последующих знаков помогает распознавать пользователей ЭДО.
Как определить оператора ЭДО по идентификатору? Если вы хотите узнать, какой провайдер у контрагента, обратите внимание на первую часть идентификационного номера. Найдите на сайте ФНС России список доверенных операторов юридически значимого электронного документооборота. В списке приведены основные сведения об операторах, в том числе идентификаторы ОЭД. Зная идентификатор участника ЭДО, вы легко определите оператора по первым трем символам.
Так, ID участника ЭДО для клиентов оператора СКБ Контур будет начинаться с 2ВМ.
Зачем нужен идентификатор
Для обмена счетами-фактурами и другими формализованными документами организации необходимо получить идентификатор участника ЭДО. В xml-файлах электронных документов должны быть заполнены поля с номерами отправителя и получателя. Использование уникальных кодов дает возможность ФНС и операторам ЭДО определить организацию в своих системах.
Также идентификаторы участников нужны для настройки роуминга между организациями — клиентами разных операторов ЭДО. В процессе подключения оператору понадобится узнать идентификатор контрагента, с которым абонент хочет наладить связь.
Как получить идентификатор
При регистрации в системе ЭДО новый пользователь подписывает заявление об участии в электронном документообороте. В Контур.Диадоке оно создается, когда организация отправляет первый формализованный документ. Пользователю достаточно проверить реквизиты и подтвердить свое намерение подать заявление.
На основе заявления об ЭДО оператор формирует информационное сообщение, в котором и указывает уникальный код участника — идентификатор ЭДО. Вместе с реквизитами организации данные передаются в налоговую, и новый пользователь может начать работу с электронными формализованными документами.
Где посмотреть в Диадоке
Чтобы узнать идентификатор участника ЭДО в Контур.Диадоке, зайдите в веб-интерфейс сервиса. Откройте меню «Настройки». Вы сразу же увидите идентификатор участника ЭДО (GUID).
Если вы перейдете в раздел «Реквизиты организации», тоже сможете посмотреть идентификационный номер своей организации.
Как узнать идентификатор ЭДО контрагента
Откройте вкладку «Контрагенты» в веб-интерфейсе Контур.Диадока. Через поиск найдите бизнес-партнера, идентификатор которого вы хотите узнать. Нажмите на активную ссылку в наименовании организации. Откроется новое окно в виде карточки контрагента. Кликните на ссылку со словом ID в первой строчке.
Подключиться к Диадоку, чтобы использовать все преимущества ЭДО
Где взять 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
Ваш запрос в бэклоге. Если вы хотите поднять приоритет, обратитесь к вашему менеджеру, он сможет это сделать
Простыми словами: GUID в системе «Меркурий»
Производители молока уже давно начали работу с системой «Меркурий», однако на форумах Россельхознадзора фермеры не прекращают задавать технические вопросы по работе с ней. Многие спрашивают, что такое «гуиды», которые у них уточняют заказчики, и где их найти. Milknews объясняет, что такое GUID и как не запутаться в похожих записях.
Для того чтобы правильно оформлять и гасить ветеринарные документы на молочную продукцию, компании обмениваются информацией об организациях и продукции. Эти данные вносятся в систему «Меркурий», по которой Россельхознадзор прослеживает путь подконтрольной продукции по российскому рынку.
Если бы производители и поставщики записывали данные только словами, то это бы неизбежно привело к путанице. В частности, лишняя точка или сокращение может превратить один и тот же товар в два разных. Именно для того, чтобы не допустить ошибок, в компьютерных базах данных – в том числе и в «Меркурии» – существуют «гуиды».
Что такое GUID?
Глобальный уникальный идентификатор, или GUID – это код, состоящий из 32 цифр и букв, разделённых дефисами. Программисты используют коды вместо словесных наименований для того, чтобы однотипные записи не дублировались друг с другом.
В системе «Меркурий» существуют несколько типов GUID. Обычно контрагенты, работающие с производителями подконтрольной продукции, запрашивают у них GUID 3 уровня, 4 уровня, хозяйствующего субъекта (ХС) и площадки.
Как узнать GUID 3 уровня?
Когда компания говорит об «уровнях», она имеет в виду уровни в справочнике номенклатуры ФГИС «Меркурий», в который записаны все наименования поднадзорных товаров.
Первые три уровня основаны на сведениях из Товарной номенклатуры ВЭД ЕЭС и указывают место продукции в её иерархии. Уровни описывают тип продукции (1 уровень; «пищевая продукция»), продукцию (2 уровень, «молоко и молочная продукция») и вид продукции (3 уровень, «творог»).
Четвёртый же уровень справочника предназначен для товарного наименования конкретной выпускаемой продукции. Подробней об уровнях справочника можно почитать в разборе, подготовленном Milknews ранее.
Чтобы узнать GUID 3 уровня в государственной системе, нужно:
Что делать, если контрагент просит GUID 4 уровня?
С юридической точки зрения, ничто не обязывает производителей молочной продукции работать со справочником 4 уровня. Однако многие торговые сети на практике настаивают на его использовании – как для готовности к будущему, так и для того, чтобы препятствовать появления разных GUID на одну и ту же продукцию.
Если вы договорились с контрагентом на обмен GUID 4 уровня, то в этом случае производителю стоит вести справочник готовой продукции, указывая при этом конкретное наименование товара (без «в ассортименте»). При подготовке к его ведению стоит открыть журнал продукции и проверить, есть ли у записей GUID. Если вы используете не государственный интерфейс, а интеграционное решение, то возможно, что оно уже составило справочник и назначило идентификаторы.
После перехода на новый уровень справочника GUID 4 уровня можно будет посмотреть таким же способом, как и третьего – через загрузку «Списка наименований продукции». В файле GUID 4 уровня будет записан как «наименование номенклатуры продукции».
Как узнать GUID предприятия?
В интерфейсе «Меркурия» можно узнать и GUID предприятия. Для этого нужно просто зайти в систему и, не выбирая предприятие, нажать кнопку с зелёной стрелкой рядом с заголовком «Выбор обслуживаемого предприятия».
Как узнать GUID хозяйствующего субъекта и площадки?
Помимо данных о товаре и предприятии, поставщики запрашивают у производителей идентификаторы ХС и площадки. Использование GUID позволяет избежать путаницы при нахождении нескольких юридических лиц – например, магазина, кафе и склада – по одному адресу.
Чтобы найти GUID, необходимо войти в личный кабинет «Цербер» в системе «Ветис» с данными, используемыми при входе в «Меркурий». После этого стоит выбрать из меню пункт «Хозяйствующий субъект» или «Площадка» – в зависимости от того, какой конкретно GUID вам нужен. В строке «Глобальный идентификатор в системе» будет указан нужный вам код.
Если вы ведёте документооборот через интеграционные решения, то вы можете узнать идентификаторы площадок, не заходя в государственную систему. Подробную информацию вы можете узнать в справочной системе или службе поддержки вашего поставщика интеграционного решения.
Также рекомендуем:
ПОПУЛЯРНОЕ
© Информационное агентство «Milknews» (2015-2019). Свидетельство о регистрации СМИ от 5 марта 2015г. ИА № ФC 77-60961, выдано Федеральной службой по надзору в сфере связи, информационных технологий и массовых коммуникаций (Роскомнадзор).
107078, г. Москва, Докучаев пер., дом 6, стр. 2
Тел. +7 (495) 114-51-29
E-mail:info@milknews.ru
Все права на любые материалы, опубликованные на сайте, защищены в соответствии с российским и международным законодательством об интеллектуальной собственности. Правообладатель допускает частичное цитирование информации и информационных материалов, в объеме, не превышающем 30%, с обязательным указанием имени автора (при наличии), наименования правообладателя (ИА «Milknews») и гиперссылки на источник заимствования. Без письменного разрешения правообладателя не допускается копирование и последующее распространение размещенных на сайте материалов в полном объеме.
Как получить счет-фактуру¶
Рассмотрим последовательность действий к функциям интеграторского интерфейса Диадока, которые требуется совершить покупателю при получении счета-фактуры (СФ), корректировочного счета-фактуры (КСФ), исправления счета-фактуры (ИСФ).
Порядок согласно приказу 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# для отправки уведомления об уточнении счета-фактуры: