- Table of contents
- Docura XML - ORDER
Docura XML - ORDER¶
Заказ на покупку в формате Docura XML (корневой элемент Document-Order). Отправляется покупателем поставщику. Кодировка UTF-8, один заказ на файл. Даты в формате ГГГГ-ММ-ДД, десятичный разделитель «.».
Имя файла: -ORDER_.xml
Пример файла: FristarSIA-ORDER_0000001.xml (см. также 05 Пример)
01 Структура¶
Document-Order ├── Order-Header (order number, date, function code, references) ├── Document-Parties (Sender, Receiver, Creator) ├── Order-Parties (Buyer, Seller, DeliveryPoint, UltimateCustomer) ├── Order-Lines │ └── Line │ └── Line-Item └── Order-Summary
02 Поля¶
M = обязательное, O = необязательное. Структура соответствует приведенному ниже примеру.
| Элемент | M/O | Формат | Описание |
|---|---|---|---|
| Document-Order | M | Корневой элемент | |
| Order-Header | M | ||
| OrderNumber | M | X(35) | Номер заказа |
| OrderDate | M | CCYY-MM-DD | Дата заказа |
| ExpectedDeliveryDate | O | CCYY-MM-DD | Ожидаемая дата доставки |
| DocumentFunctionCode | M | 9/4/3 | 9 — оригинал (по умолчанию), 4 — изменение, 3 — удаление |
| Remarks | O | X(250) | Примечания к заказу |
| Reference | O | ||
| ContractNumber | O | X(175) | Номер контракта |
| ContractDate | O | CCYY-MM-DD | Дата контракта |
| Document-Parties | M | ||
| Sender | M | Отправитель документа (покупатель) | |
| ILN | M | [0-9](13) | GLN отправителя |
| Name | O | X(175) | Имя отправителя |
| Receiver | M | Получатель документа (поставщик) | |
| ILN | M | [0-9](13) | GLN получателя |
| Name | O | X(175) | Имя получателя |
| Creator | O | Лицо, создавшее заказ | |
| Name | O | X(175) | Имя |
| TelephoneNumber | O | X(35) | Телефон |
| O | X(175) | Электронная почта | |
| Order-Parties | M | ||
| Buyer | M | Покупатель | |
| ILN | M | [0-9](13) | GLN покупателя |
| Name | O | X(175) | Имя покупателя |
| TaxID | O | X(35) | ИНН |
| UtilizationRegisterNumber | O | X(35) | Регистрационный номер |
| StreetAndNumber | O | X(140) | Улица и номер |
| CityName | O | X(140) | Город |
| PostalCode | O | X(9) | Почтовый индекс |
| Country | O | X(2) | Код страны (ISO 3166) |
| Seller | M | Поставщик | |
| ILN | M | [0-9](13) | GLN поставщика |
| Name | O | X(175) | Имя поставщика |
| TaxID | O | X(35) | ИНН |
| UtilizationRegisterNumber | O | X(35) | Регистрационный номер |
| StreetAndNumber | O | X(140) | Улица и номер |
| CityName | O | X(140) | Город |
| PostalCode | O | X(9) | Почтовый индекс |
| Country | O | X(2) | Код страны (ISO 3166) |
| DeliveryPoint | M | Место доставки | |
| ILN | M | [0-9](13) | GLN места доставки |
| Name | O | X(175) | Название места доставки |
| TaxID | O | X(35) | ИНН |
| UtilizationRegisterNumber | O | X(35) | Регистрационный номер |
| StreetAndNumber | O | X(140) | Улица и номер |
| CityName | O | X(140) | Город |
| PostalCode | O | X(9) | Почтовый индекс |
| Country | O | X(2) | Код страны (ISO 3166) |
| UltimateCustomer | O | Конечный получатель | |
| ILN | M | [0-9](13) | GLN конечного получателя |
| Name | O | X(175) | Имя конечного получателя |
| TaxID | O | X(35) | ИНН |
| UtilizationRegisterNumber | O | X(35) | Регистрационный номер |
| StreetAndNumber | O | X(140) | Улица и номер |
| CityName | O | X(140) | Город |
| PostalCode | O | X(9) | Почтовый индекс |
| Country | O | X(2) | Код страны (ISO 3166) |
| Order-Lines | M | ||
| Line | M | 1-n | |
| Line-Item | M | ||
| LineNumber | M | N0 | Номер строки |
| EAN | O | [0-9](14) | Код EAN |
| SupplierItemCode | O | X(70) | Код товара поставщика |
| BuyerItemCode | O | X(70) | Код товара покупателя |
| ItemDescription | O | X(250) | Описание товара |
| OrderedQuantity | M | R4 | Заказанное количество |
| OrderedBoxes | O | R3 | Заказанное количество коробок |
| UnitOfMeasure | O | PCE/KGM/DPA | PCE — штуки, KGM — килограммы, DPA — коробки |
| OrderedUnitNetPrice | O | R4 | Цена за единицу без НДС |
| OrderedNetAmount | O | R4 | Сумма строки без НДС |
| NetWeight | O | R3 | Вес нетто |
| Order-Summary | M | ||
| TotalLines | M | N0 | Количество строк |
| TotalOrderedAmount | M | R4 | Общее заказанное количество |
| TotalNetAmount | O | R4 | Общая сумма без НДС |
| TotalTaxAmount | O | R4 | Общая сумма НДС |
| TotalGrossAmount | O | R4 | Общая сумма с НДС |
| TotalNetWeight | O | R3 | Общий вес нетто |
03 Как вы получаете ЗАКАЗ¶
- EDI-Web — заказ появляется в Docura.net; уведомление по электронной почте отправляется на ваш контактный адрес. См. EDI-Web_registration.
- Интеграция с ERP — XML доставляется через Partner_API, Docudrive или SFTP_FTP. Docura может конвертировать ЗАКАЗ в формат вашей ERP (EDIFACT, Telema/Edisoft XML, CSV, другие).
- Электронная почта — XML-вложение на ваш адрес электронной почты.
04 XSD¶
Для автоматизированной валидации используйте приложенную XML-схему: Docura_XML_ORDER.xsd
xmllint --noout --schema Docura_XML_ORDER.xsd your_order.xml
05 Пример¶
<?xml version="1.0" encoding="UTF-8"?>
<Document-Order>
<Order-Header>
<OrderNumber>0000001</OrderNumber>
<OrderDate>2026-09-01</OrderDate>
<ExpectedDeliveryDate>2026-09-02</ExpectedDeliveryDate>
<DocumentFunctionCode>9</DocumentFunctionCode>
<Remarks>TEST</Remarks>
<Reference>
<ContractDate>2026-09-01</ContractDate>
</Reference>
</Order-Header>
<Document-Parties>
<Sender>
<ILN>9973658250008</ILN>
<Name>Fristar SIA</Name>
</Sender>
<Receiver>
<ILN>4750192000000</ILN>
<Name>Latvijas Maiznieks AS</Name>
</Receiver>
<Creator>
<Name>Rita Dakule</Name>
<TelephoneNumber>+371 20299222</TelephoneNumber>
<E-mail>rita.dakule@fristar.lv</E-mail>
</Creator>
</Document-Parties>
<Order-Parties>
<Buyer>
<ILN>9973658250008</ILN>
<Name>Fristar SIA</Name>
<StreetAndNumber>Elizabetes iela 20</StreetAndNumber>
<CityName>Riga</CityName>
<PostalCode>LV-1050</PostalCode>
<Country>LV</Country>
</Buyer>
<Seller>
<ILN>4750192000000</ILN>
<Name>Latvijas Maiznieks AS</Name>
<StreetAndNumber>Mazā Viļņas iela 9</StreetAndNumber>
<CityName>Daugavpils</CityName>
<PostalCode>LV-5404</PostalCode>
<Country>LV</Country>
</Seller>
<DeliveryPoint>
<ILN>9973658250282</ILN>
<Name>Fristar SIA - Babītes vidusskola [7440]</Name>
<StreetAndNumber>Jūrmalas iela 17</StreetAndNumber>
<CityName>Piņķi</CityName>
<PostalCode>LV-2107</PostalCode>
<Country>LV</Country>
</DeliveryPoint>
<UltimateCustomer>
<ILN>9973658250282</ILN>
</UltimateCustomer>
</Order-Parties>
<Order-Lines>
<Line>
<Line-Item>
<LineNumber>1</LineNumber>
<EAN>4750192741644</EAN>
<SupplierItemCode>174</SupplierItemCode>
<ItemDescription>Zeltene Dienišķā baltmaize 0.350g</ItemDescription>
<OrderedQuantity>3.0000</OrderedQuantity>
<UnitOfMeasure>PCE</UnitOfMeasure>
<OrderedUnitNetPrice>0.7200</OrderedUnitNetPrice>
<OrderedNetAmount>2.1600</OrderedNetAmount>
<NetWeight>0.700</NetWeight>
</Line-Item>
</Line>
<Line>
<Line-Item>
<LineNumber>2</LineNumber>
<EAN>4750192730709</EAN>
<SupplierItemCode>143</SupplierItemCode>
<ItemDescription>Rīgas klaips formas maize 0.600g</ItemDescription>
<OrderedQuantity>2.0000</OrderedQuantity>
<OrderedBoxes>0.000</OrderedBoxes>
<UnitOfMeasure>PCE</UnitOfMeasure>
<OrderedUnitNetPrice>0.7500</OrderedUnitNetPrice>
<OrderedNetAmount>1.5000</OrderedNetAmount>
<NetWeight>1.200</NetWeight>
</Line-Item>
</Line>
</Order-Lines>
<Order-Summary>
<TotalLines>2</TotalLines>
<TotalOrderedAmount>5.0000</TotalOrderedAmount>
<TotalNetAmount>3.6600</TotalNetAmount>
<TotalTaxAmount>0.0000</TotalTaxAmount>
<TotalGrossAmount>3.6600</TotalGrossAmount>
<TotalNetWeight>0.000</TotalNetWeight>
</Order-Summary>
</Document-Order>
Source version: 12 · Status: fresh · Roman Startsev