- Table of contents
- Docura XML – TELLIMUS
Docura XML – TELLIMUS¶
Ostutellimus Docura XML-is (juurelement Document-Order). Ostja saadab tarnijale. UTF-8, üks tellimus faili kohta. Kuupäevad AAAA-KK-PP, kümnendkoht ".".
Faili nimi: <Ostja>-ORDER_<Tellimuse number>.xml
Näidisfail: FristarSIA-ORDER_0000001.xml (vt ka 05 Näide)
01 Struktuur¶
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 Väljad¶
M = kohustuslik, O = valikuline. Struktuur järgib alltoodud näidet.
| Element | M/O | Formaat | Kirjeldus |
|---|---|---|---|
| Document-Order | M | Juurelement | |
| Order-Header | M | ||
| OrderNumber | M | X(35) | Tellimuse number |
| OrderDate | M | CCYY-MM-DD | Tellimuse kuupäev |
| ExpectedDeliveryDate | O | CCYY-MM-DD | Eeldatav tarnekuupäev |
| DocumentFunctionCode | M | 9/4/3 | 9 - algne (vaikimisi), 4 - muudatus, 3 - kustutamine |
| Remarks | O | X(250) | Tellimuse märkused |
| Reference | O | ||
| ContractNumber | O | X(175) | Lepingu number |
| ContractDate | O | CCYY-MM-DD | Lepingu kuupäev |
| Document-Parties | M | ||
| Sender | M | Dokumendi saatja (ostja) | |
| ILN | M | [0-9](13) | Saatja ILN |
| Name | O | X(175) | Saatja nimi |
| Receiver | M | Dokumendi vastuvõtja (tarnija) | |
| ILN | M | [0-9](13) | Vastuvõtja ILN |
| Name | O | X(175) | Vastuvõtja nimi |
| Creator | O | Tellimuse loonud isik | |
| Name | O | X(175) | Nimi |
| TelephoneNumber | O | X(35) | Telefon |
| O | X(175) | E-post | |
| Order-Parties | M | ||
| Buyer | M | Ostja | |
| ILN | M | [0-9](13) | Ostja ILN |
| Name | O | X(175) | Ostja nimi |
| TaxID | O | X(35) | KMKR-number |
| UtilizationRegisterNumber | O | X(35) | Registreerimisnumber |
| StreetAndNumber | O | X(140) | Tänav ja number |
| CityName | O | X(140) | Linn |
| PostalCode | O | X(9) | Postiindeks |
| Country | O | X(2) | Riigi kood (ISO 3166) |
| Seller | M | Tarnija | |
| ILN | M | [0-9](13) | Müüja ILN |
| Name | O | X(175) | Müüja nimi |
| TaxID | O | X(35) | KMKR-number |
| UtilizationRegisterNumber | O | X(35) | Registreerimisnumber |
| StreetAndNumber | O | X(140) | Tänav ja number |
| CityName | O | X(140) | Linn |
| PostalCode | O | X(9) | Postiindeks |
| Country | O | X(2) | Riigi kood (ISO 3166) |
| DeliveryPoint | M | Tarnekoht | |
| ILN | M | [0-9](13) | Tarnekoha ILN |
| Name | O | X(175) | Tarnekoha nimi |
| TaxID | O | X(35) | KMKR-number |
| UtilizationRegisterNumber | O | X(35) | Registreerimisnumber |
| StreetAndNumber | O | X(140) | Tänav ja number |
| CityName | O | X(140) | Linn |
| PostalCode | O | X(9) | Postiindeks |
| Country | O | X(2) | Riigi kood (ISO 3166) |
| UltimateCustomer | O | Lõpptarbija | |
| ILN | M | [0-9](13) | Lõpptarbija ILN |
| Name | O | X(175) | Lõpptarbija nimi |
| TaxID | O | X(35) | KMKR-number |
| UtilizationRegisterNumber | O | X(35) | Registreerimisnumber |
| StreetAndNumber | O | X(140) | Tänav ja number |
| CityName | O | X(140) | Linn |
| PostalCode | O | X(9) | Postiindeks |
| Country | O | X(2) | Riigi kood (ISO 3166) |
| Order-Lines | M | ||
| Line | M | 1-n | |
| Line-Item | M | ||
| LineNumber | M | N0 | Rea number |
| EAN | O | [0-9](14) | EAN-kood |
| SupplierItemCode | O | X(70) | Tarnija kauba kood |
| BuyerItemCode | O | X(70) | Ostja kauba kood |
| ItemDescription | O | X(250) | Kauba kirjeldus |
| OrderedQuantity | M | R4 | Tellitud kogus |
| OrderedBoxes | O | R3 | Tellitud karbid |
| UnitOfMeasure | O | PCE/KGM/DPA | PCE - tükid, KGM - kilogrammid, DPA - karbid |
| OrderedUnitNetPrice | O | R4 | Ühiku netohind, ilma KM-ta |
| OrderedNetAmount | O | R4 | Rea netosumma, ilma KM-ta |
| NetWeight | O | R3 | Netokaal |
| Order-Summary | M | ||
| TotalLines | M | N0 | Ridade arv |
| TotalOrderedAmount | M | R4 | Tellitud koguhulk |
| TotalNetAmount | O | R4 | Netosumma kokku |
| TotalTaxAmount | O | R4 | KM summa kokku |
| TotalGrossAmount | O | R4 | Brutosumma kokku |
| TotalNetWeight | O | R3 | Netokaal kokku |
03 Kuidas Te tellimuse vastu võtate¶
- EDI-Web – tellimus ilmub Docura.net-i; Teie kontaktaadressile saadetakse e-posti teel teavitus. Vt EDI-Web_registration.
- ERP-integratsioon – XML toimetatakse kohale Partner_API, Docudrive või SFTP_FTP kaudu. Docura saab teisendada tellimuse Teie ERP-i vormingusse (EDIFACT, Telema/Edisoft XML, CSV, muu).
- E-post – XML-manus Teie e-posti aadressile.
04 XSD¶
Automaatseks valideerimiseks kasutage lisatud XML skeemi: Docura_XML_ORDER.xsd
xmllint --noout --schema Docura_XML_ORDER.xsd your_order.xml
05 Näide¶
<?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