- Table of contents
- Docura XML – UŽSAKYMAS
Docura XML – UŽSAKYMAS¶
Pirkimo užsakymas Docura XML formatu (šakninis elementas Document-Order). Siunčiamas pirkėjo tiekėjui. UTF-8, vienas užsakymas faile. Datos CCYY-MM-DD, dešimtainis skyriklis „.“.
Failo pavadinimas: <Pirkėjas>-ORDER_<UžsakymoNumeris>.xml
Pavyzdinis failas: FristarSIA-ORDER_0000001.xml (taip pat žr. 05 Pavyzdys)
01 Struktūra¶
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 Laukai¶
M = privalomas, O = pasirenkamas. Struktūra pateikiama pagal toliau esantį pavyzdį.
| Elementas | P/N | Formatas | Aprašymas |
|---|---|---|---|
| Document-Order | M | Šakninis elementas | |
| Order-Header | M | ||
| OrderNumber | M | X(35) | Užsakymo numeris |
| OrderDate | M | CCYY-MM-DD | Užsakymo data |
| ExpectedDeliveryDate | O | CCYY-MM-DD | Numatoma pristatymo data |
| DocumentFunctionCode | M | 9/4/3 | 9 – originalas (numatytasis), 4 – pakeitimas, 3 – ištrynimas |
| Remarks | O | X(250) | Pastabos užsakymui |
| Reference | O | ||
| ContractNumber | O | X(175) | Sutarties numeris |
| ContractDate | O | CCYY-MM-DD | Sutarties data |
| Document-Parties | M | ||
| Sender | M | Dokumento siuntėjas (pirkėjas) | |
| ILN | M | [0-9](13) | Siuntėjo ILN |
| Name | O | X(175) | Siuntėjo pavadinimas |
| Receiver | M | Dokumento gavėjas (tiekėjas) | |
| ILN | M | [0-9](13) | Gavėjo ILN |
| Name | O | X(175) | Gavėjo pavadinimas |
| Creator | O | Asmuo, sukūręs užsakymą | |
| Name | O | X(175) | Pavadinimas |
| TelephoneNumber | O | X(35) | Telefono numeris |
| O | X(175) | El. paštas | |
| Order-Parties | M | ||
| Buyer | M | Pirkėjas | |
| ILN | M | [0-9](13) | Pirkėjo ILN |
| Name | O | X(175) | Pirkėjo pavadinimas |
| TaxID | O | X(35) | PVM mokėtojo kodas |
| UtilizationRegisterNumber | O | X(35) | Registracijos numeris |
| StreetAndNumber | O | X(140) | Gatvė ir numeris |
| CityName | O | X(140) | Miestas |
| PostalCode | O | X(9) | Pašto kodas |
| Country | O | X(2) | Šalies kodas (ISO 3166) |
| Seller | M | Tiekėjas | |
| ILN | M | [0-9](13) | Pardavėjo ILN |
| Name | O | X(175) | Pardavėjo pavadinimas |
| TaxID | O | X(35) | PVM mokėtojo kodas |
| UtilizationRegisterNumber | O | X(35) | Registracijos numeris |
| StreetAndNumber | O | X(140) | Gatvė ir numeris |
| CityName | O | X(140) | Miestas |
| PostalCode | O | X(9) | Pašto kodas |
| Country | O | X(2) | Šalies kodas (ISO 3166) |
| DeliveryPoint | M | Pristatymo vieta | |
| ILN | M | [0-9](13) | Pristatymo vietos ILN |
| Name | O | X(175) | Pristatymo vietos pavadinimas |
| TaxID | O | X(35) | PVM mokėtojo kodas |
| UtilizationRegisterNumber | O | X(35) | Registracijos numeris |
| StreetAndNumber | O | X(140) | Gatvė ir numeris |
| CityName | O | X(140) | Miestas |
| PostalCode | O | X(9) | Pašto kodas |
| Country | O | X(2) | Šalies kodas (ISO 3166) |
| UltimateCustomer | O | Galutinis gavėjas | |
| ILN | M | [0-9](13) | Galutinio kliento ILN |
| Name | O | X(175) | Galutinio kliento pavadinimas |
| TaxID | O | X(35) | PVM mokėtojo kodas |
| UtilizationRegisterNumber | O | X(35) | Registracijos numeris |
| StreetAndNumber | O | X(140) | Gatvė ir numeris |
| CityName | O | X(140) | Miestas |
| PostalCode | O | X(9) | Pašto kodas |
| Country | O | X(2) | Šalies kodas (ISO 3166) |
| Order-Lines | M | ||
| Line | M | 1-n | |
| Line-Item | M | ||
| LineNumber | M | N0 | Eilutės numeris |
| EAN | O | [0-9](14) | EAN kodas |
| SupplierItemCode | O | X(70) | Tiekėjo prekės kodas |
| BuyerItemCode | O | X(70) | Pirkėjo prekės kodas |
| ItemDescription | O | X(250) | Prekės aprašymas |
| OrderedQuantity | M | R4 | Užsakytas kiekis |
| OrderedBoxes | O | R3 | Užsakytos dėžės |
| UnitOfMeasure | O | PCE/KGM/DPA | PCE – vienetai, KGM – kilogramai, DPA – dėžės |
| OrderedUnitNetPrice | O | R4 | Vieneto grynasis kaina be PVM |
| OrderedNetAmount | O | R4 | Eilutės grynasis suma be PVM |
| NetWeight | O | R3 | Grynasis svoris |
| Order-Summary | M | ||
| TotalLines | M | N0 | Eilučių skaičius |
| TotalOrderedAmount | M | R4 | Bendras užsakytas kiekis |
| TotalNetAmount | O | R4 | Bendra grynasis suma |
| TotalTaxAmount | O | R4 | Bendra PVM suma |
| TotalGrossAmount | O | R4 | Bendra bruto suma |
| TotalNetWeight | O | R3 | Bendras grynasis svoris |
03 Kaip gaunate UŽSAKYMĄ¶
- EDI-Web – užsakymas atsiranda Docura.net, į jūsų kontaktinį el. paštą ateina pranešimas. Žr. EDI-Web_registration.
- ERP integracija – XML pristatomas per Partner_API, Docudrive arba SFTP_FTP. Docura gali konvertuoti UŽSAKYMĄ į jūsų ERP formatą (EDIFACT, Telema/Edisoft XML, CSV, kita).
- El. paštas – XML priedas į jūsų el. pašto adresą.
04 XSD¶
Automatiniam tikrinimui naudokite pridėtą XML schemą: Docura_XML_ORDER.xsd
xmllint --noout --schema Docura_XML_ORDER.xsd your_order.xml
05 Pavyzdys¶
<?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