Project

General

Profile

View source (English) EN RU ET LT LV Eesti
English Русский Lietuvių Latviešu

Wiki » 05 Document formats » Docura XML »

Docura XML - ARVE

Arve Docura XML-is (juurelement Document-Invoice). Saadetakse tarnija poolt ostjale. UTF-8, üks arve faili kohta. Kuupäevad AAAA-KK-PP, kümnendkoht ".".

Failinimi: <Müüja>-INVOICE_<Arvenumber>.xml

Näidisfail: CidoGrupaSIA-INVOICE_0000013.xml, skeem: Docura_XML_INVOICE.xsd (vt ka 04 Näide)

01 Struktuur 

Document-Invoice
├── Invoice-Header          (invoice number, dates, function code, order/contract refs, delivery)
├── Document-Parties        (Sender, Receiver, Creator)
├── Invoice-Parties         (Buyer, Seller)
├── Invoice-Lines
│   └── Line
│       └── Line-Item
└── Invoice-Summary
    └── Tax-Summary

02 Väljad

M = kohustuslik, O = valikuline. Struktuur järgib allolevat näidet.

Element M/O Formaat Kirjeldus
Document-Invoice M Juurelement
Invoice-Header M
InvoiceNumber M X(35) Arve number
InvoiceDate M AAAA-KK-PP Arve kuupäev
InvoiceCurrency M [A-Z](3) Arve valuuta
InvoicePaymentDueDate O AAAA-KK-PP Maksetähtaeg
DocumentFunctionCode M 9/4/3 9 - algne (vaikimisi), 4 - muutus, 3 - kustutamine
Remarks O X(250) Märkused arve kohta
Order O
BuyerOrderNumber O X(35) Tellimuse number, millele see arve viitab
Reference O
ContractNumber O X(175) Lepingu number
Delivery O
DeliveryLocationNumber O [0-9](13) Tarnekoha ILN
Name O X(175) Tarnekoha nimi
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)
DeliveryDate O AAAA-KK-PP Tarnekuupäev
Document-Parties M
Sender M Dokumendi saatja (tarnija)
ILN M [0-9](13) Saatja ILN
Name O X(175) Saatja nimi
Receiver M Dokumendi saaja (ostja)
ILN M [0-9](13) Saaja ILN
Name O X(175) Saaja nimi
Creator O Isik, kes koostas arve
Name O X(175) Nimi
TelephoneNumber O X(35) Telefon
E-mail O X(175) E-post
Invoice-Parties M
Buyer M Ostja
ILN M [0-9](13) Ostja ILN
TaxID O X(35) Käibemaksukohustuslase number
Name O X(175) Ostja nimi
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)
BankInfo O
BankName O X(70) Panga nimi
Swift O X(11) SWIFT/BIC kood
BankAccNumber O X(35) IBAN / kontonumber
Seller M Tarnija. Samad väljad nagu ostjal
ILN M [0-9](13) Müüja ILN
Invoice-Lines M
Line M 1-n
Line-Item M
LineNumber M N0 Rea number
EAN O [0-9](13-14) EAN-kood
SupplierItemCode O X(70) Tarnija tootekood
ItemDescription O X(250) Toote kirjeldus
ItemType O X(2) "CU" - kaup, "RC" - tagastatav pakend
InvoiceQuantity M R4 Arvel olev kogus
InvoiceUnitNetPrice O R4 Ühiku netohind, ilma KM-ta
UnitOfMeasure O X(10) Mõõtühik
TaxRate O R2 KM määr, nt LV: 21, 12, 5, 0
TaxCategoryCode O S/Z/E/O S - standardmäär, Z - nullmäär, E - vabastus, O - väljaspool reguleerimisala
TaxAmount O R4 KM summa rea kohta
NetAmount O R4 Rea summa, ilma KM-ta
GrossAmount O R4 Rea summa, koos KM-ga
ExpirationDate O AAAA-KK-PP Parim enne kuupäev
Invoice-Summary M
TotalLines M N0 Ridade arv
TotalNetAmount M R4 Kogusumma, ilma KM-ta
TotalTaxAmount O R4 Kogu KM summa
TotalGrossAmount O R4 Kogusumma, koos KM-ga
Tax-Summary O
Tax-Summary-Line M 1-n
TaxRate M R2 KM määr
TaxCategoryCode M S/Z/E/O KM kategooria
TaxAmount M R4 KM summa selle määra kohta
TaxableAmount M R4 Maksustatav summa selle määra kohta

03 Kuidas arve teieni jõuab

  • EDI-Web – arve ilmub Docura.neti; teie kontaktmeiliaadressile saadetakse teavitus. Vaata EDI-Web_registration.
  • ERP-integratsioon – XML tarnitakse Partner_API, Docudrive või SFTP_FTP kaudu. Docura saab arve teisendada teie ERP-süsteemi formaati (EDIFACT, Telema/Edisoft XML, CSV, muu).
  • E-post – XML-manus teie e-posti aadressile.

04 Näide

CidoGrupaSIA-INVOICE_0000013.xml

<?xml version="1.0" encoding="UTF-8"?>
<Document-Invoice>
    <Invoice-Header>
        <InvoiceNumber>0000013</InvoiceNumber>
        <InvoiceDate>2026-09-02</InvoiceDate>
        <InvoiceCurrency>EUR</InvoiceCurrency>
        <InvoicePaymentDueDate>2026-10-02</InvoicePaymentDueDate>
        <DocumentFunctionCode>9</DocumentFunctionCode>
        <Remarks>R-1</Remarks>
        <Order>
            <BuyerOrderNumber>FRI-000022</BuyerOrderNumber>
        </Order>
        <Reference>
            <ContractNumber>R-1/1</ContractNumber>
        </Reference>
        <Delivery>
            <DeliveryLocationNumber>9973658250282</DeliveryLocationNumber>
            <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>
            <DeliveryDate>2026-08-31</DeliveryDate>
        </Delivery>
    </Invoice-Header>
    <Document-Parties>
        <Sender>
            <ILN>4750042000006</ILN>
            <Name>Cido Grupa SIA</Name>
        </Sender>
        <Receiver>
            <ILN>9973658250008</ILN>
            <Name>Fristar SIA</Name>
        </Receiver>
        <Creator>
            <Name>Startsev Roman</Name>
            <TelephoneNumber>+3725640620</TelephoneNumber>
            <E-mail>roman@cido.lv</E-mail>
        </Creator>
    </Document-Parties>
    <Invoice-Parties>
        <Buyer>
            <ILN>9973658250008</ILN>
            <TaxID>LV40003658252</TaxID>
            <Name>Fristar SIA</Name>
            <StreetAndNumber>Elizabetes iela 20</StreetAndNumber>
            <CityName>Riga</CityName>
            <PostalCode>LV-1050</PostalCode>
            <Country>LV</Country>
            <BankInfo>
                <BankName>SWEDBANK AS</BankName>
                <Swift>HABALV22</Swift>
                <BankAccNumber>LV12HABA0001234567890</BankAccNumber>
            </BankInfo>
        </Buyer>
        <Seller>
            <ILN>4750042000006</ILN>
            <TaxID>LV40003176944</TaxID>
            <Name>Cido Grupa SIA</Name>
            <StreetAndNumber>Ostas iela 4</StreetAndNumber>
            <CityName>Riga</CityName>
            <PostalCode>LV-1034</PostalCode>
            <Country>LV</Country>
            <BankInfo>
                <BankName>SEB BANKA AS</BankName>
                <Swift>UNLALV2X</Swift>
                <BankAccNumber>LV34UNLA0009876543210</BankAccNumber>
            </BankInfo>
        </Seller>
    </Invoice-Parties>
    <Invoice-Lines>
        <Line>
            <Line-Item>
                <LineNumber>1</LineNumber>
                <EAN>4750042002352</EAN>
                <SupplierItemCode>24600</SupplierItemCode>
                <ItemDescription>CIDO Ābolu sula (PET) 0,3L</ItemDescription>
                <ItemType>CU</ItemType>
                <InvoiceQuantity>6.000</InvoiceQuantity>
                <InvoiceUnitNetPrice>0.5080</InvoiceUnitNetPrice>
                <UnitOfMeasure>PCE</UnitOfMeasure>
                <TaxRate>21.00</TaxRate>
                <TaxCategoryCode>S</TaxCategoryCode>
                <TaxAmount>0.6405</TaxAmount>
                <NetAmount>3.0500</NetAmount>
                <GrossAmount>3.6905</GrossAmount>
                <ExpirationDate>2026-09-25</ExpirationDate>
            </Line-Item>
        </Line>
        <Line>
            <Line-Item>
                <LineNumber>2</LineNumber>
                <EAN>4751000791875</EAN>
                <SupplierItemCode>24411</SupplierItemCode>
                <ItemDescription>Bauskas Gaišais speciālais 4,8% 50cl</ItemDescription>
                <ItemType>CU</ItemType>
                <InvoiceQuantity>40.000</InvoiceQuantity>
                <InvoiceUnitNetPrice>1.1100</InvoiceUnitNetPrice>
                <UnitOfMeasure>PCE</UnitOfMeasure>
                <TaxRate>21.00</TaxRate>
                <TaxCategoryCode>S</TaxCategoryCode>
                <TaxAmount>9.3240</TaxAmount>
                <NetAmount>44.4000</NetAmount>
                <GrossAmount>53.7240</GrossAmount>
                <ExpirationDate>2026-10-29</ExpirationDate>
            </Line-Item>
        </Line>
    </Invoice-Lines>
    <Invoice-Summary>
        <TotalLines>2</TotalLines>
        <TotalNetAmount>47.4500</TotalNetAmount>
        <TotalTaxAmount>9.9645</TotalTaxAmount>
        <TotalGrossAmount>57.4145</TotalGrossAmount>
        <Tax-Summary>
            <Tax-Summary-Line>
                <TaxRate>21.00</TaxRate>
                <TaxCategoryCode>S</TaxCategoryCode>
                <TaxAmount>9.9645</TaxAmount>
                <TaxableAmount>47.4500</TaxableAmount>
            </Tax-Summary-Line>
        </Tax-Summary>
    </Invoice-Summary>
</Document-Invoice>

05 XSD

Automatiseeritud valideerimiseks kasutage lisatud XML skeemi: Docura_XML_INVOICE.xsd

xmllint --noout --schema Docura_XML_INVOICE.xsd your_invoice.xml

Source version: 5 · Status: fresh · Roman Startsev