Пример XML-счёта: как выглядит машиночитаемый э-счёт?

Что такое XML-счёт?

XML (Extensible Markup Language) — текстовый формат данных, в котором информация разделена на обозначенные элементы. Для счёта это означает, что название продавца, регистрационный код, данные покупателя, дата, строки и суммы находятся не только на визуальном листе, а в отдельных машиночитаемых полях.

Программа может открыть такой файл, проверить его и при совместимом формате импортировать данные без полного ручного ввода. Именно структурированность делает XML полезным для автоматизации расчётов и обмена счётами между системами.

XML не обязан выглядеть красиво для человека. Его основная ценность — в однозначной структуре данных.

Пример XML э-счёта — структура машиночитаемого счёта в браузере.

XML, PDF и э-счёт — в чём разница?

PDF — прежде всего визуальный документ для человека. XML — прежде всего структурированный файл для программы. Э-счёт — электронный структурированный счёт, для которого важны не только данные, но и соответствие требуемому стандарту, схеме и каналу приёма.

Поэтому формулировка «любой XML — это э-счёт» неточна. XML может быть технической основой, но конкретному получателю может требоваться определённая схема, версия, набор обязательных полей и способ передачи.

PDF-счёт
• Оформлен для чтения человеком
• Удобен для визуальной проверки и архива
• Данные не всегда можно напрямую импортировать в другую систему

XML / машиночитаемый счёт
• Данные находятся в отдельных полях
• Подходит для обмена между системами
• Может требовать конкретную схему и валидацию получателя

Визуальный пример PDF-счёта для сравнения с XML-файлом.

Что видно в этом примере XML?

На изображении XML-файл открыт в браузере. Сверху находится технический заголовок документа, затем начинается структура счёта. В примере используется структура E_Invoice с полем версии, после чего идут сам счёт и данные сторон.

Видны элементы Header, Date, FileId, AppId и Version, а в блоке счёта — InvoiceParties. В SellerParty находятся название продавца, регистрационный номер, KMKR, контакты, адрес и AccountInfo с банковскими реквизитами. BuyerParty описывает покупателя.

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

• технические данные документа и версии;
• идентификатор и дата счёта;
• название продавца, регистрационный код, KMKR и контакты;
• данные покупателя;
• IBAN и банковские реквизиты продавца;
• строки счёта, количество и цены;
• ставки и суммы НДС;
• нетто, налог и итог к оплате;
• срок оплаты и другие платёжные данные.

Пример не является универсальным шаблоном
Названия XML-полей и обязательные элементы могут отличаться в разных схемах. Перед реальной отправкой нужно отдельно проверить требования системы получателя.

Как читать XML-файл?

Если открыть XML в обычном браузере, сверху может появиться сообщение, что у файла нет информации о стиле. Это не ошибка. Браузер лишь сообщает, что к файлу не подключено визуальное оформление.

XML читается как дерево: крупный элемент содержит вложенные поля. Например, SellerParty может включать Name, RegNumber, VATRegNumber, ContactData и AccountInfo. Закрывающий тег показывает, где заканчивается конкретный элемент.

Человек может проверить XML как текст, однако практический смысл формата в том, чтобы программа автоматически извлекла нужные значения.

01. Найдите заголовок счёта
Проверьте версию файла, дату и идентификатор счёта.

02. Проверьте стороны
Сверьте продавца и покупателя, регистрационные коды и при необходимости номера KMKR.

03. Проверьте строки и оплату
Убедитесь, что количество, цены, НДС, итог и платёжные реквизиты совпадают с визуальным счётом.

Когда недостаточно просто иметь файл .xml?

Расширение .xml ещё не означает, что система получателя сможет импортировать файл. Компания, бухгалтерская программа или оператор э-счетов могут требовать конкретную схему, набор элементов, версию, кодировку и правила валидации.

Передача э-счёта также может происходить через оператора, сеть или другой технический канал. Тогда кроме содержимого файла важны идентификация адресата, протокол передачи, статусы доставки и обработка ошибок.

Перед первой реальной отправкой полезно провести тест: уточнить требования получателя, проверить валидность файла и убедиться, что другая система принимает счёт без ручной доработки.

Важно: XML-файл и э-счёт, доставленный через оператора, не всегда одно и то же
Совместимость для конкретного клиента всегда проверяйте по требованиям его бухгалтерской системы или оператора э-счетов.

Как XML вписывается в работу Arveteha?

Счёт в Arveteha строится из структурированных данных: сведения о компании и клиенте, строки, цены, НДС, суммы и платёжные реквизиты сохраняются в отдельных полях. Это важная основа для машиночитаемого вывода.

Задача XML-вывода — передать те же данные в форме, которую может обработать другая программа. При этом PDF остаётся удобным визуальным представлением для человека.

При использовании XML для конкретной бухгалтерской программы или канала э-счетов нужно дополнительно проверить требуемый формат и правила валидации. Передача через оператора — отдельный технический этап по сравнению с созданием XML-файла.

Рабочий стол Arveteha, где данные счёта хранятся в структурированном виде.

Что проверить перед отправкой XML-счёта?

Перед отправкой реальному клиенту проверьте как минимум следующее:

• название продавца, регистрационный код и KMKR указаны правильно;
• название и регистрационный код покупателя соответствуют карточке клиента;
• номер и дата счёта совпадают с PDF;
• строки, количество, цены и скидки правильные;
• ставки и суммы НДС рассчитаны корректно;
• нетто и итоговая сумма совпадают;
• IBAN, срок оплаты и другие платёжные данные правильные;
• файл соответствует схеме и версии, которую принимает получатель;
• при необходимости XML прошёл валидацию или тестовую загрузку.