Схемы документов

XML и XSD

Оригинальные документы ЕИС, доступ к которым предоставляется через API, имеют формат XML. Документы хранятся на публичном FTP-сервере ftp://ftp.zakupki.gov.ru.

При работе с XML-документами зачастую можно быстро найти информацию. Если в документе извещения имеем поле INN, вложенное в поле responsibleOrganization, то по логике можно догадаться, что это ИНН ответственной организации.

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

Структура XML-документов описывается через файл схемы XSD. Схемы документов публикуются на официальном сайте ЕИС в разделе технической документации. Архив со схемами документов по 44-ФЗ и ПП РФ 615 называется Схемы XX.Y интеграция Z.

Схемы документов по 223-ФЗ расположены на странице https://zakupki.gov.ru/epz/main/public/document/view.html?searchString=&sectionId=386&strictEqual=false , имя архива Интеграционные схемы XX.Y

Просмотр XSD-схемы

XSD-схема определяет структуру соответствующего XML-документа. Технически файл схемы очень похож на XML и содержит описание полей и типов полей документа.

Для просмотра XSD-схемы рекомендуется использоваться специальный просмотрщик, например XSD Diagram.

Порядок работы:

1. Скачиваем архив схем и распаковываем его
2. Открываем XSD Diagram и там через "File -> Open..." открываем соответствующую схему: для 44-ФЗ и ПП РФ 615 все схемы приведены в файле fcsIntegration.xsd; для 223-ФЗ purchase.xsd, contract.xsd, purchasePlan.xsd
3. Находим в списке типов (справа) нужный нам тип документа, например Извещение о проведении электронного аукциона epNotificationEF2020 и перетаскиваем строку на основное поле диаграммы.