Документы с маркированными товарами
С 1 января 2019 года действует Федеральный закон от 25.12.2018 N 488-ФЗ, который определяет требования к работе с маркированными товарами. Все участники оборота маркированных товаров должны передавать сведения о переходе права собственности на товар в информационную систему оператора маркировки ГИС МТ «Честный ЗНАК». С 1 января 2022 года передавать сведения о движении продукции — вводе в оборот, продаже, выводе из оборота — можно только через оператора ЭДО. Это требование закреплено в постановлениях Правительства N 2464 от 31.12.2020 и N 64 от 28.01.2021.
Сведения о маркированных товарах передаются в универсальных передаточных документах (УПД).
Порядок работы
Сценарий работы с документами с маркированными товарами включает следующие шаги:
Продавец:
- генерирует титул продавца с маркированными товарами,
- отправляет его покупателю.
Покупатель:
- получает титул продавца с маркированными товарами,
- генерирует титул покупателя,
- отправляет его продавцу.
Оператор ЭДО:
- отправляет документ с маркированными товарами в ГИС МТ «Честный ЗНАК»,
- получает промежуточные и конечный статусы обработки документа в ГИС МТ «Честный ЗНАК».
Продавец и покупатель:
- узнают статус обработки документа в ГИС МТ «Честный ЗНАК»,
- если необходимо, получают контент квитанции ГИС МТ «Честный ЗНАК» с помощью метода GetEntityContent (V4).
Генерация, подписание и отправка документов с маркированными товарами выполняются аналогично документам без маркированных товаров. Подробнее на странице Работа с УПД. Правила заполнения кодов маркировки в UserDataXml приведены в разделе Титул с маркированными товарами.
Передача документов в ГИС МТ «Честный ЗНАК»
Диадок автоматически передает сведения в ГИС МТ «Честный ЗНАК» в следующих случаях:
- после подписания документа обеими сторонами,
- после аннулирования подписанного документа.
Типы документов, по которым Диадок передает сведения в ГИС МТ «Честный ЗНАК», приведены в таблице ниже.
Типы документов
| Тип документа | Функция | Версия | Формат | Дополнительные условия |
|---|---|---|---|---|
| UniversalTransferDocument | СЧФДОП, ДОП | utd970_05_03_01 | приказ №970 | В документах должны быть данные по маркированным товарам: - ИдФайл имеет формат R_T_A_O_GGGGMMDD_N1_N2_N3_N4_N5_N6_N7, где N3 = 1, - внутри элемента Документ/ТаблСчФакт/СведТов/ДопСведТов/НомСредИдентТов указаны коды маркировки. |
| UniversalTransferDocumentRevision | СЧФДОП, ДОП | utd970_05_03_01 | приказ №970 | |
| XmlTorg12 | default | utd970_05_03_01 | приказ №970 | |
| UniversalCorrectionDocument | КСЧФДИС, ДИС | ucd736_05_01_02, ucd736_05_01_01 | приказ №736 | В документах должны быть данные по маркированным товарам: - префикс в ИдФайл равен ON_NKORSCHFDOPPRMARK в 1 титуле и ON_NKORSCHFDOPPRMARK во 2 титуле - внутри элементов Документ.ТаблКСчФ.СведТов.НомСредИдентТовДо и Документ.ТаблКСчФ.СведТов.НомСредИдентТовПосле указаны коды маркировки |
| UniversalCorrectionDocumentRevision | КСЧФДИС, ДИС | ucd736_05_01_02, ucd736_05_01_01 | приказ №736 |
Отмена сведений об отгрузке
В некоторых ситуациях может потребоваться отменить сведения об отгрузке маркированных товаров, переданные в ГИС МТ «Честный ЗНАК», когда их статус уже перешел в значение «Отгружен». Например, это возможно, если получатель отказался принимать маркированные товары или отправитель аннулировал документ со сведениями о маркированных товарах до подписи получателя.
На текущий момент возможность отменить сведения об отгрузке доступна только для документов, содержащих информацию об алкогольной продукции, — то есть для УПД, у которых в ИдФайл N3 = 1 и N4 = 1.
Для отмены сведений об отгрузке маркированных товаров отправителю нужно подготовить и подписать специальный служебный документ, который содержит:
- ИНН организации-отправителя,
- ИдФайл документа с маркированными товарами, сведения об отгрузке которых нужно отменить.
При наличии в сообщении такого подписанного служебного документа Диадок автоматически передаст в ГИС МТ «Честный ЗНАК» запрос на отмену сведений об отгрузке, когда документооборот УПД будет завершен отказом в подписи или аннулированием.
Чтобы отменить сведения об отгрузке маркированных товаров:
- Найдите УПД, сведения об отгрузке товаров из которого нужно отменить. Сделать это можно с помощью метода GetDocuments (V3), указав фильтр
DocumentStatus = HaveToCancelTtGisFixation. - Сгенерируйте к нему служебный документ для отмены сведений об отгрузке методом GenerateTtGisFixationCancellationRequest. Инструкция о генерации документа приведена в разделе Генерация документа для отмены сведений об отгрузке маркированных товаров.
- Подпишите документ и отправьте его методом PostMessagePatch (V4). Инструкция по отправке приведена в разделе Отправка документа для отмены сведений об отгрузке маркированных товаров.
Чтобы получить информацию о документе для отмены сведений об отгрузке, используйте методы для работы с документооборотом или с документами, сообщениями, событиями. Инструкция по получению документа приведена в разделе Получение документа для отмены сведений об отгрузке маркированных товаров.
Обратите внимание, что служебный документ для отмены сведений об отгрузке не будет включен в архив с файлами документооборота, полученный методом GenerateDocumentZip.
Статусы обработки
Статус обработки документа с маркированными товарами можно получить с помощью методов для работы с событиями, документами и сообщениями или с помощью методов для работы с документооборотом.
Получение через методы для работы с событиями, документами и сообщениями
- Методы работы с сообщениями и событиями возвращают все полученные статусы:
- Методы работы с документами возвращают последний полученный статус:
Информация о статусах возвращается в структуре OuterDocflowInfo.
Пример структуры OuterDocflowInfo:
"OuterDocflow":
{
"DocflowNamedId": "TtGis",
"DocflowFriendlyName":"ГИС МТ",
"Status":{
"NamedId":"ProcessingError",
"FriendlyName":"Ошибка в ГИС МТ ""Честный ЗНАК""",
"Type":"Error",
"Details": [
{
"Code":"4",
"Text":"Документ с таким номером уже зарегистрирован в ГИС МТ"
},
{
"Code":"24",
"Text":"Статус кода маркировки {КМ} не соответствует выполняемой операции"
}
]
}
}
Получение через методы для работы с документооборотом
-
Методы для работы с документооборотом для одно-, двух- и трехтитульных документов:
Информация о статусах возвращается в структурах:
- OuterDocflow — содержит информацию о последнем полученном статусе,
- OuterDocflowEntities — содержит информацию обо всех полученных статусах; в зависимости от сущности она хранится внутри других структур:
- для документа — в структуре DocflowV4,
- для запроса на аннулирование — в структуре RevocationDocflowV4.
Пример структуры OuterDocflows:
"OuterDocflows": [{"DocflowNamedId": "TtGis","ParentEntityId": "d2cdd36a-a1bc-47a4-a358-3e344dca7bc2","OuterDocflowEntityId": "c75815a2-6dfc-43bb-997a-1dbaba4b08a3"}]Пример структуры OuterDocflowEntities:
"OuterDocflowEntities": [{"DocflowNamedId": "TtGis","DocflowFriendlyName": "ГИС МТ","StatusEntities": [{"Attachment": {"Attachment": {"Entity": {"EntityId": "14aed39d-70e3-49e4-a3e4-c1cde04fd506","CreationTimestamp": {"Ticks": 637359498817771378},"Content": {"Size": 829}},"AttachmentFilename": "TtGis_InProcessing_20200904_145417.xml","DisplayFilename": ""}},"Status": {"NamedId": "InProcessing","FriendlyName": "Обрабатывается в ГИС МТ \"Честный ЗНАК\"","Type": "Normal","Description": "Документ обрабатывается в ГИС МТ \"Честный ЗНАК\".","Details": []}},{"Attachment": {"Attachment": {"Entity": {"EntityId": "c75815a2-6dfc-43bb-997a-1dbaba4b08a3","CreationTimestamp": {"Ticks": 637359499045398064},"Content": {"Size": 1092}},"AttachmentFilename": "TtGis_SuccessProcessed_20200904_145520.json","DisplayFilename": ""}},"Status": {"NamedId": "SuccessProcessed","FriendlyName": "Обработан в ГИС МТ \"Честный ЗНАК\"","Type": "Success","Description": "Документ обработан в ГИС МТ \"Честный ЗНАК\".","Details": []}}]}] -
Методы для работы с документооборотом для любых, в том числе многотитульных документов:
Информация о статусах возвращается в поле
OuterDocflowsв виде списка структур OuterDocflowV5. ПолеLatestStatusEntityIdсодержит идентификатор последнего полученного статуса, полеStatusEntities— список всех полученных статусов.Поле
OuterDocflowsвозвращается:- для документа — в структуре DocflowV5,
- для запроса на аннулирование — в структуре RevocationDocflowV5.
Пример структуры OuterDocflows:
"OuterDocflows": [{"DocflowNamedId": "TtGis","ParentEntityId": "d2cdd36a-a1bc-47a4-a358-3e344dca7bc2","LatestStatusEntityId": "c75815a2-6dfc-43bb-997a-1dbaba4b08a3","DocflowFriendlyName": "ГИС МТ","StatusEntities": [{"Attachment": {"Attachment": {"Entity": {"EntityId": "14aed39d-70e3-49e4-a3e4-c1cde04fd506","CreationTimestamp": {"Ticks": 637359498817771378},"Content": {"Size": 829}},"AttachmentFilename": "TtGis_InProcessing_20200904_145417.xml","DisplayFilename": ""},"ContentTypeId": ""},"Status": {"NamedId": "InProcessing","FriendlyName": "Обрабатывается в ГИС МТ \"Честный ЗНАК\"","Type": "Normal","Description": "Документ обрабатывается в ГИС МТ \"Честный ЗНАК\".","Details": [],"EntityId": "14aed39d-70e3-49e4-a3e4-c1cde04fd506"}},{"Attachment": {"Attachment": {"Entity": {"EntityId": "c75815a2-6dfc-43bb-997a-1dbaba4b08a3","CreationTimestamp": {"Ticks": 637359499045398064},"Content": {"Size": 1092}},"AttachmentFilename": "TtGis_SuccessProcessed_20200904_145520.json","DisplayFilename": ""},"ContentTypeId": ""},"Status": {"NamedId": "SuccessProcessed","FriendlyName": "Обработан в ГИС МТ \"Честный ЗНАК\"","Type": "Success","Description": "Документ обработан в ГИС МТ \"Честный ЗНАК\".","Details": [],"EntityId": "c75815a2-6dfc-43bb-997a-1dbaba4b08a3"}}]}]
Информация о статусе обработки
Обратите внимание, что структуры OuterDocflowInfo, OuterDocflow, OuterDocflowEntities и OuterDocflowV5 могут содержать информацию не только об обработке документов в ГИС МТ «Честный ЗНАК», но и о других внешних документооборотах. Отличить статусы ГИС МТ «Честный ЗНАК» можно по идентификатору DocflowNamedId = TtGis. Другие значения статусов описаны в таблице ниже.
Статусы ГИС МТ
| Status.Type | Status.FriendlyName | Status.NamedId | В ответе возвращается | Причина | Что нужно сделать |
|---|---|---|---|---|---|
| Normal | Передается в ГИС МТ «Честный ЗНАК» |
|
| ГИС МТ «Честный ЗНАК» недоступен: документ передать не удалось, но попытки передачи продолжаются | Дополнительные действия не требуются |
|
| ||||
| Error | Ошибка передачи в ГИС МТ «Честный ЗНАК» |
|
| При передаче документа в ГИС МТ «Честный ЗНАК» получена ошибка 4хх или 500: документ передать не удалось, повторные попытки передачи не выполняются | Дополнительные действия не требуются, после устранения проблем передачи сервис автоматически переотправит документы |
|
| ||||
| Normal | Обрабатывается в ГИС МТ «Честный ЗНАК» |
|
| Успешная передача документа в ГИС МТ «Честный ЗНАК» | Дополнительные действия не требуются |
|
| ||||
| Success | Обработан в ГИС МТ «Честный ЗНАК» |
|
| Успешная обработка документа: товары из документа перешли покупателю | Товары из документа можно реализовывать дальше |
|
| Успешная обработка документа: коды маркировки из документа переведены в состояние «Отгружен» | Товары из документа можно отгружать, отгруженные коды маркировки нельзя передать в другом документе | ||
|
| Успешная отмена документа: коды маркировки из документа сняты с состояния «Отгружен» | Коды маркировки можно передавать в другом документе | ||
| Error | Ошибка в ГИС МТ «Честный ЗНАК» |
|
| В процессе обработки документа в ГИС МТ «Честный ЗНАК» возникли ошибки | Проанализируйте ошибки и исправьте их: аннулируйте текущий документ и выставьте новый или отправьте исправление или корректировку |
|
|