Новое в API: метод генерации GenerateTitleXml

23 августа 2019 2

В Диадоке появился новый метод генерации GenerateTitleXml. Это универсальный метод, который создает xml-файл любого титула любого типа документа.

В Диадоке появился новый метод генерации GenerateTitleXml. Это универсальный метод, который создает xml-файл любого титула любого типа документа. 

На вход метода нужно передать параметры — идентификатор ящика, тип, версию, функцию документа, номер (индекс) титула. В теле запроса должен быть  передан соответствующий usedatacontract.xml. Описание xsd-схемы файла UserDataContract можно получить из ответа метода GetDocumentTypes. Подробнее о работе метода GenerateTitleXml можно узнать из документации.

Зачем еще один метод?

В Диадоке уже есть методы генерации:

  • “универсальные”, предназначенные для генерации титулов отправителя GenerateSenderTitleXml и получателя GenerateRecipientTitleXml любого типа документа,

  • старые методы  для генерации титулов определенных типов.

Появление универсальных методов генерации обусловлено созданием новых типов документов с разным количеством титулов (более двух), а также регулярными обновлениями форматов документов ФНС. Универсальные методы позволяют не изменять API (обновлять и создавать контракты, повышать версии отдельных методов) при появлении новых типов или изменениях форматов документов. Как следствие, интеграторам теперь проще обновлять интеграционные решения.

Какие методы использовать?

Рекомендуем использовать новый метод генерации GenerateTitleXml, если Вы:

  • только начинаете интеграцию с Диадоком;

  • реализуете поддержку нового формата 820 (подробно), но еще не перешли на использование универсальных методов GenerateRecipientTitleXml и GenerateSenderTitleXml

  • работаете с формализованными документами не в формате ФНС.

Если вы уже поддержали в интеграции методы  GenerateSenderTitleXml  и GenerateRecipientTitleXml - переходить на использование нового метода необязательно. Эти методы будут поддерживаться. 

Если в будущем возникнет потребность работать с документами, у которых более двух титулов — генерировать их следует только новым методом GenerateTitleXml.

Мы рекомендуем отказаться от старых методов генерации:

Эти методы не будут дорабатываться и в будущем могут быть сняты с поддержки — об этом будет сообщено дополнительно. 


Обязательный ЭДО и объемно‑сортовой учет (ОСУ) в работе с молочной продукцией с 1 сентября

Передавать сведения по маркировке молочной продукции в Честный ЗНАК можно будет только через оператора ЭДО в виде объемно-сортового учета (ОСУ). В статье отвечаем на популярные вопросы и объясняем, какие решения подойдут пользователям Диадока. 

1 октября прекращается поддержка модуля «Стандарт» для 1С 8. Что это значит?

В статье рассказываем, как быстро перейти на обновленное решение, чем оно отличается и что будет с модулем «Стандарт». Всех пользователей «Стандарта» приглашаем на обучающий вебинар 7 сентября. Покажем, как запустить новый модуль и начать в нем работать.

Попробуйте работу с МХ‑1 и МХ‑3 в Диадоке

Диадок запускает акцию для пользователей и открывает возможность работы с актами МХ-1 и МХ-3 в формате XML с визуализацией. Принять участие могут все клиенты, которые раньше не пользовались функциональностью.