elektroninių sąskaitų sistema metodiniai ir techniniai ... metodiniai ir... · 17. integracijos...

Akcinė bendrovė Lietuvos paštas, J. Jasinskio g. 16, 03500 Vilnius

Tel. (8 700) 55 400, Faks. (8 5) 216 3204, El. p. [email protected]

Duomenys kaupiami ir saugomi Juridinių asmenų registre, kodas 121215587

PVM mokėtojo kodas LT212155811

Elektroninių sąskaitų sistema

Metodiniai ir techniniai nurodymai dėl integracijos su e. sąskaita sistema





Duomenys kaupiami ir saugomi Juridinių asmenų registre, kodas 121215587 2013-01-30


2/87

Turinys

1. Naudojami terminai ir santrumpos ................................................................................................................. 4 2. Bendra informacija ......................................................................................................................................... 5 3. E_Invoice ....................................................................................................................................................... 6 4. Header ........................................................................................................................................................... 6 5. Invoice ........................................................................................................................................................... 8 6. InvoiceParties ................................................................................................................................................ 9 7. InvoiceInformation ....................................................................................................................................... 10 8. InvoiceSumGroup ........................................................................................................................................ 12 9. InvoiceItem .................................................................................................................................................. 14

9.1. ItemEntry ........................................................................................................................................... 15 9.2. GroupEntry ........................................................................................................................................ 18

10. AdditionalInformation ................................................................................................................................... 20 11. PaymentInfo ................................................................................................................................................ 20 12. Footer .......................................................................................................................................................... 21 13. Kompleksinių tipų aprašymai ....................................................................................................................... 23

13.1. AccountDataRecord .......................................................................................................................... 23 13.2. AccountingRecord ............................................................................................................................. 23 13.3. AdditionRecord .................................................................................................................................. 24 13.4. AddressRecord .................................................................................................................................. 26 13.5. BillPartyRecord .................................................................................................................................. 26 13.6. ContactDataRecord ........................................................................................................................... 27 13.7. ExtensionRecord ............................................................................................................................... 28 13.8. VATRecord ........................................................................................................................................ 30

14. Paprastų tipų apibrėţimai ............................................................................................................................ 30 15. Pavyzdiniai failai .......................................................................................................................................... 33

15.1. Tik privalomi laikai ............................................................................................................................. 33 15.2. Visi laukai .......................................................................................................................................... 34

16. Priedas nr. 1 – XML schema ....................................................................................................................... 49 17. Integracijos architektūra .............................................................................................................................. 61

17.1 Ţiniatinklio paslaugų aprašas ............................................................................................................ 61 17.2 Ţiniatinklio paslaugos autentifikacija ................................................................................................. 61 17.3 Integracijos modulio komponentai ..................................................................................................... 62

18. Pardavimo sąskaitų integracija .................................................................................................................... 64 19. Pirkimo sąskaitų integracija ......................................................................................................................... 65 20. Registro duomenų integracija ...................................................................................................................... 70

20.1 Dimensijų registro integracija ............................................................................................................ 70 20.2 Sąskaitų plano registro integracija .................................................................................................... 74 20.3 Tiekėjų / klientų registro integracija ................................................................................................... 74 20.4 Atsakingų asmenų ir skyrių registro integracija ................................................................................. 77 20.5 Išteklių registro integracija ................................................................................................................. 78

21 Kitos integracijos ......................................................................................................................................... 82

21.1 Pirkimo sąskaitos faktūros PDF gavimas .......................................................................................... 82 21.2 Duomenų siuntimas iš ERP į e. sąskaitų sistemą ............................................................................. 82







3/87

21.3 Įmonės būsenos uţklausa ................................................................................................................. 83 21.4 Pirkimo sąskaitos faktūros priedų gavimas ....................................................................................... 84 21.5 Patvirtinimo atšaukimas .................................................................................................................... 85

22 Priedai.......................................................................................................................................................... 87







4/87

1. Naudojami terminai ir santrumpos

Santrumpa / terminas Paaiškinimas

E. sąskaita Elektroninių sąskaitų formatas naudojamas integracijoje

E. sąskaitų sistema Elektroninių sąskaitų centro sistema

Sistema Elektroninių sąskaitų centro sistema

Uţsakovas Juridinis asmuo pasirašęs E. sąskaita sistemos paslaugų teikimo sutartį

ERP Verslo valdymo sistema arba kitokia informacinė sistema.

Integracinis modulis E.sąskaita sistemos integracinis modulis

process_quarz E. sąskaita sistemos integracinis modulis

Ţiniatinklio paslauga Tai bendra Ţiniatinklio konsorciumo (W3C) pateikta apibrėţtis, apimanti įvairias sistemas, tačiau daţnai ţiniatinklio paslaugos terminas vartojamas įvardijant klientų ir serverių sąveiką, siunčiant XML pranešimus, atitinkančius tokių pranešimų mainų kompiuterių tinkluose standartą SOAP (angl. web service).







5/87

2. Bendra informacija XML failai koduojami UTF-8 standartu.

Nenaudokite specifinių XML simbolių:

& &

’ ' > > < < “ "

Pavyzdţiui vardas “Isad & Pojad OÜ” turi būti perduodamas: <Name>Isad & Pojad OÜ</Name>







6/87

3. E_Invoice E_Invoice yra pagrindinis elektroninės sąskaitos faktūros elementas.

Struktūra Pavyzdys

<E_Invoice> <Header>

… </Header> <Invoice invoiceId="09200303961940"

regNumber="10004252" channelId="EA" channelAddress="10002028538005">

… </Invoice> <Invoice invoiceId="09200303961941" regNumber="10007545" channelId="EA" channelAddress="10002028538005">

… </Invoice> <Footer>

<TotalNumberInvoi-ces>2</TotalNumberInvoices> <TotalAmount>29768.04</TotalAmount>

</Footer> </E_Invoice>

Aprašymas

Elementas Aprašymas Tipas Privalomas Pastabos

Header Nurodo konkrečius failo elementus

(ţr. 4 Header)

Taip

Invoice Turi informaciją apie vieną sąskaitą

faktūrą. Šis elementas kartojamas

kiekvienai sąskaitai faktūra (ţr. 5

Invoice)

Taip 1-n

Footer Rodo perduodamų sąskaitų faktūrų

skaičių bei jų mokėtinas sumas (ţr.

12 Footer)

Taip

4. Header Header lauke talpinami specifiniai elementai







7/87

Struktūra Pavyzdys

<Header> <Test>YES</Test> <Date>2009-12-01</Date> <FileId>66488</FileId> <Version>1.1</Version> <SenderId>SWEDB</SenderId> <ReceiverId>ITEE</ReceiverId> <ContractId>EA1245</ContractId> <PayeeAccountNumber>10022056127002 </PayeeAccountNumber>

</Header>

Aprašymas


Test Nusako ar tai yra bandomasis failas ar ne

YesNoType Ne

Date Nusako datą kada sukurtas failas DateType Taip

Field Unikalus sistemos suteikiamas failo identifikacijos numeris. Nau-dojamas siekiant išvengti dvigubo to paties failo apdorojimo.

ShortTextType Taip

Version Šio standarto versija ShortTextType Taip

SenderId Failo siuntėjo ID ShortTextType Ne Suderinama su esama failų mainų sistema.

ReceiverId Failo gavėjo ID ShortTextType Ne

ContractId Kontrakto ID tarp siuntėjo ir gavė-jo

ShortTextType Ne

PayeeAccountNumber Gavėjo sąskaitos numeris. Są-skaita neturi būti tokia pati kaip PayToAccount ir PaymentInfo elementuose

AccountType Ne







8/87

5. Invoice Invoice elementas saugo duomenis apie vieną sąskaitą faktūrą

Struktūra Pavyzdys

<Invoice invoiceId="A9200303961942" regNumber="10004252">

<InvoiceParties>…</InvoiceParties> <InvoiceInformation>…</InvoiceInformation> <InvoiceSumGroup>…</InvoiceSumGroup> <InvoiceItem>…</InvoiceItem> <AdditionalInformation>…</AdditionalInformation> <PaymentInfo>…</PaymentInfo>

</Invoice>

Aprašymas


invoiceId Unikalus sąskaitos faktūros ID (vieno failo apimtyje).

NormalTextType Taip Atributas

serviceId Kliento identifikavimo numeris pardavėjo sistemoje / faktoringo sutarties numeris.

ShortTextType Ne Atributas

regNumber Asmens / įmonės kodas sąskai-tos faktūros gavėjui.

RegType Taip Atributas

channelId Kanalo ID į kurį turi būti nukreipta sąskaita faktūra, ţr. 14 Paprastų tipų apibrėţimai

EncodingType Ne Atributas

channelAddress Sąskaitos faktūros gavėjo kanalo adresas.

NormalTextType Ne Atributas

factoring Nurodo ar tai faktoringo sąskaita faktūra ar ne.

YesNoType Ne Atributas

templateId Sąskaitos faktūros dizaino šab-lono ID

NormalTextType Ne Atributas

languageId Sąskaitos faktūros kalbos ID LanguageType Ne Atributas

InvoiceParties Nurodo sąskaitos faktūros siun-tėją ir gavėją, ţr. 6 InvoiceParties

Taip

InvoiceInformation Pateikiama bendra sąskaitos faktūros informacija, ţr. 7 Invoi-ceInformation

Taip

InvoiceSumGroup Pateikiamos bendros sąskaitos faktūros sumos, ţr. 8 Invoice-SumGroup

Taip 1-2

InvoiceItem Pateikiam išsami informacija apie sąskaitos faktūros eilutes,

Taip







9/87

ţr. 9 InvoiceItem

AdditionalInformation Pateikiama papildoma informaci-ja, kuri rodoma sąskaitoje faktū-roje (pvz., rinkodaros informacija ir kt.), ţr. 10 AdditionalInforma-tion

Ne 0-n

PaymentInfo Informacija reikalinga mokėjimo tvarkos nurodymui, ţr. 11 Pay-mentInfo

Taip

6. InvoiceParties InvoiceParties apibrėţia skirtingas įmones/asmenis susijusius su sąskaita faktūra (pardavėjas ir pirkėjas, sąskaitos

faktūros gavėjas, prekių / paslaugų gavėjas ir sąskaitos faktūros mokėtojas).

Struktūra Pavyzdys

<InvoiceParties> <SellerParty> … </SellerParty> <BuyerParty> … </BuyerParty> <RecipientParty> … </RecipientParty> <DeliveryParty> … </DeliveryParty> <PayerParty> … </PayerParty>

</InvoiceParties>

Aprašymas


SellerParty Apibūdina pardavėją sąskaitoje faktūroje (pavadinimas, adresas ir kt.), ţr. 13.5 BillPartyRecord

BillPartyRecord Taip

BuyerParty Apibūdina pirkėją sąskaitoje fak-tūroje (pavadinimas, tapatybės ID ir kt.)

BillPartyRecord Taip

RecipientParty Ši grupė naudojama tada, kai sąskaitos faktūros gavėjas nėra pirkėjas, bet, pavyzdţiui apskai-tos įmonė ar kitas asmuo vei-kiantis pirkėjo vardu, ţr. 13.5 BillPartyRecord

BillPartyRecord Ne

DeliveryParty Pristatymo šalių duomenys yra naudojami kada pristatymas yra kitam asmeniui nei pirkėjas, ţr. 13.5 BillPartyRecord

BillPartyRecord Ne

PayerParty Ši grupė naudojama kada są-skaitos faktūros mokėtojas yra ne pirkėjas, ţr. 13.5 BillPartyRe-cord

BillPartyRecord Ne







10/87

7. InvoiceInformation Šioje grupėje pateikiama bendra informacija apie konkrečią sąskaitą faktūrą.

Struktūra Pavyzdys

<InvoiceInformation> <Type type="DEB">

<SourceInvoice>440</SourceInvoice> </Type> <FactorContractNumber>

L8574-14 </FactorContractNumber> <ContractNumber>15-58/2</ContractNumber> <DocumentName>PVM sąskaita faktū-ra</DocumentName> <InvoiceNumber>129592-2</InvoiceNumber> <InvoiceContentCode>

SPO5 </InvoiceContentCode> <InvoiceContentText>

Sporto paslaugos </InvoiceContentText> <PaymentReferenceNumber>30253234017 </PaymentReferenceNumber> <PaymentMethod>Pavedimas </PaymentMethod> <InvoiceDate>2009-12-01</InvoiceDate> <DueDate>2009-12-15</DueDate> <PaymentTerm>Terminas14 dienų </PaymentTerm> <FineRatePerDay>0.2</FineRatePerDay> <Period>

<PeriodName>Teenuse osutamise periood </PeriodName> <StartDate>2009-11-01</StartDate> <EndDate>2009-11-30</EndDate>

</Period> <InvoiceDeliverer>

<ContactName>Tadas Lingė</ContactName> </InvoiceDeliverer> <Extension id="GymName">

<InformationName>Salė </InformationName> <InformationContent/>Ţaidimų kambarys </InformationContent>

</Extension> </InvoiceInformation>

Aprašymas


Type Sąskaitos faktūros tipas Taip

type DEB – paprasta sąskaita faktū-ra, CRE – kreditinė sąskaita faktū-ra

xs:NMTOKEN DEB / CRE

Taip Atributas

SourceInvoice Susijusi sąskaita faktūra NormalTextType Ne

FactorContractNumber Faktoringo sutarties numeris (sutarties tarp kliento ir kredita-vimo institucijos).

NormalTextType Ne

ContractNumber Sutarties numeris tarp pirkėjo ir pardavėjo. Sąskaitos faktūros

NormalTextType Ne







11/87

pagrindas.

DocumentName Dokumento pavadinimas (pvz., PVM sąskaita faktūra, Kreditinė sąskaita faktūra).

NormalTextType Taip

InvoiceNumber Sąskaitos faktūros serija ir nu-meris

NormalTextType Taip

InvoiceContentCode Sąskaitos faktūros turinio ko-das, dėl kurio susitaria šalys, siekiant pagerinti proceso au-tomatizavimą.

ShortTextType Ne

InvoiceContentText Sąskaitos faktūros turinio apra-šymas

NormalTextType Ne

PaymentReference-Number

Mokėjimo nurodymo numeris. Tas pats kaip PaymentIn-fo/PaymentRefId.

ReferenceType Ne

PaymentMethod Laisvas tekstas apibūdinantis mokėjimo būdą ir sąlygas. Naudojamas tik tada kai sąskai-ta faktūra bus spausdinama ant popieriaus (pvz., sąskaita faktū-ra mokama tiesioginiu debetu).

NormalTextType Ne

InvoiceDate Sąskaitos faktūros data DateType Taip

DueDate Sąskaitos faktūros apmokėjimo terminas

DateType Ne

PaymentTerm Laisvas tekstas aprašantis mo-kėjimo terminus (pvz., mokėji-mo terminas yra 14 dienų).

NormalTextType Ne

FineRatePerDay Delspinigių uţ dieną tarifas, rodomas procentais.

Deci-mal2FractionDigitsType

Ne

Period Nurodomas terminas jeigu są-skaitoje faktūroje įvestos pa-slaugos skaičiuojamos uţ tam tikrus laikotarpius.

Ne

PeriodName Laikotarpio pavadinimas NormalTextType Ne

StartDate Laikotarpio pradţios data DateType Ne

EndDate Laikotarpio pabaigos data DateType Ne

InvoiceDeliverer Sąskaita faktūrą išrašiusio as-mens kontaktinė informacija (telefono numeris, adresas, el. paštas, vardas ir kt., ţr. 13.6 ContactDataRecord.

ContactDataRe-cord

Ne

Extension Apibūdina papildomus elemen-tus, kuriuos norima pateikti šio-je grupėje, ţr. 13.7 ExtensionRecord.

ExtensionRecord Ne 0-n







12/87

8. InvoiceSumGroup Ši grupė apibrėţia mokėtinos sumos ir balanso informaciją.

Struktūra Pavyzdys

<InvoiceSumGroup> <Balance>

<BalanceDate>2009-12-01</BalanceDate> <BalanceBegin>3.14</BalanceBegin> <Inbound>3.14</Inbound> <Outbound>3.14</Outbound> <BalanceEnd>3.14</BalanceEnd>

</Balance> <InvoiceSum>1277.5678</InvoiceSum> <PenaltySum>0</PenaltySum> <Addition addCode="DSC">

<AddContent> Lojalumo nuolaida </AddContent> <AddRate>-5</AddRate> <AddSum>-6,3878</AddSum>

</Addition> <Rounding>0.01</Rounding> <VAT>

<SumBeforeVAT>1271.19</SumBeforeVAT> <VATRate>21</VATRate> <VATSum>266.95</VATSum> <Currency>LTL</Currency>

</VAT> <TotalSum>1538.14</TotalSum> <Currency>LTL</Currency> <Accounting> … </Accounting> <Extension extensionId=" "> … </Extension>

</InvoiceSumGroup>

Aprašymas


Balance Apibūdina balansą sąskaitos faktūros išrašymo laikotarpyje.

Ne

BalanceDate Balanso skaičiavimo data. DateType Ne

BalanceBegin Likučio pradinė reikšmė. Deci-mal2FractionDigitsType

Ne







13/87

Inbound Sąskaitos faktūros gavėjo su-mokėta suma siuntėjui balanso laikotarpyje.


Ne 0-n

Outbound Sąskaitos faktūros siuntėjo su-mokėta suma gavėjui balanso laikotarpyje.


Ne 0-n

BalanceEnd Likučio pabaigos reikšmė Deci-mal2FractionDigitsType

Ne

InvoiceSum Sąskaitos faktūros suma be mokesčių. ItemSum elementų suma.


Ne

PenaltySum Baudos suma Deci-mal4FractionDigitsType

Ne

Addition Apibūdiną papilomas sumas (pvz., nuolaidos ar rinkliavos), ţr. 13.3 AdditionRecord.

AdditionRecord Ne 0-n

Rounding Sąskaitos faktūros apvalinimo suma


Ne

VAT Apibūdina pridėtinės vertės mokestį (PVM), ţr. 13.8 VAT-Record.

VATRecord Ne 0-n

TotalVATSum Apibūdina bendrą visų mokes-čių sumą


Ne

TotalSum Sąskaitos faktūros suma su mokesčiais


Taip

TotalToPay Iš viso mokėtina suma. Krediti-nės sąskaitos faktūros suma tu būti 0.00.


Ne

Currency Trijų simbolių valiutos kodas, kaip nurodyta ISO 4217 stan-darte.

CurrencyType Ne

Accounting Elementas apibūdinantis infor-maciją reikalingą apskaitos veiksmų automatizavimui, ţr. 13.2 AccountingRecord.

AccountingRe-cord

Ne









14/87

9. InvoiceItem Ši grupė pateikia sąskaitos faktūros eilučių informaciją.

Struktūra Pavyzdys

<InvoiceItem> <InvoiceTotalGroup groupId="Santrauka">

<ItemEntry> ...

</ItemEntry> <GroupEntry> ... </GroupEntry>

</InvoiceTotalGroup> <InvoiceItemGroup groupId="Rašikliai">

<ItemEntry> ...

</ItemEntry> <GroupEntry>

... </GroupEntry>

</InvoiceItemGroup> <InvoiceItemGroup groupId="Popierius">

<ItemEntry> ...

</ItemEntry> <ItemEntry>

... </ItemEntry> <GroupEntry>

... </GroupEntry>

</InvoiceItemGroup> <InvoiceItemTotalGroup>

<InvoiceItemTotalDescription> ...

</InvoiceItemTotalDescription> <InvoiceItemTotalSum>

... </InvoiceItemTotalSum>

</InvoiceItemTotalGroup> </InvoiceItem>

Aprašymas


InvoiceTotalGroup Sąskaitos faktūros eilučių gru-pės suma (pagal eilutes)

Ne

groupId Sąskaitos faktūros eilučių gru-pės ID


ItemEntry Apibūdina vieną konkrečią są-skaitos faktūros eilutę, ţr. 9.1 ItemEntry.

Ne 0-n

GroupEntry Apibūdina grupės sumą, ţr. 9.2 GroupEntry.

Ne

InvoiceItemGroup Pagrindinė sąskaitos faktūros eilučių grupė.

Taip 1-n

groupId Sąskaitos faktūros eilučių gru-pės ID


ItemEntry Apibūdina vieną konkrečią są-skaitos faktūros eilutę, ţr. 9.1

Ne 0-n







15/87

ItemEntry.

GroupEntry Apibūdina grupės sumą, ţr. 9.2 GroupEntry.

Ne

InvoiceItemTotalGroup Visų sąskaitos faktūros eilučių suma.

Ne

InvoiceItemTotal-Description

Sumos aprašymas NormalTextType Ne




AccountingRe-cord

Ne

InvoiceItemTotalA-mount

Visų sąskaitos faktūros eilučių suma.


Ne

InvoiceItemTotal-Sum

Visų sąskaitos faktūros eilučių suma be mokesčių.


Ne

Addition Apibūdiną papilomas sumas (pvz., nuolaidos ar rinkliavos), ţr. 13.3 AdditionRecord



VATRecord Ne 0-n

InvoiceItemTotal Visų sąskaitos faktūros eilučių suma su mokesčiais


Ne

9.1. ItemEntry Ši grupė pateikia sąskaitos faktūros eilučių informaciją.

Struktūra Pavyzdys







16/87

<ItemEntry> <RowNo>1</RowNo> <SerialNumber>A74875547751124</SerialNumber> <SellerProductId>abc123</SellerProductId> <BuyerProductId>321cba</BuyerProductId> <TaricCode>CODE123456</TaricCode> <Accounting>

... </Accounting> <CustomerRef>Prenumerata 457</CustomerRef> <Description>Kamuoliai</Description> <EAN>3272513030707</EAN> <InitialReading>0</InitialReading> <FinalReading>2</FinalReading> <ItemReserve extensionId="Shipment">

<InformationName>Partija</InformationName> <InformationContent>L5870</InformationContent> </ItemReserve> <ItemDetailInfo>

<ItemUnit>vnt</ItemUnit> <ItemAmount>2</ItemAmount> <ItemPrice>467.36</ItemPrice>

</ItemDetailInfo> <ItemSum>934.72</ItemSum> <Addition addCode="DSC">

<AddContent>Pirmenybė 10%</AddContent> <AddRate>-10</AddRate> <AddSum>-93.472</AddSum>

</Addition> <VAT>

<SumBeforeVAT>841.248</SumBeforeVAT> <VATRate>21</VATRate> <VATSum>176.66</VATSum> <Currency>LTL</Currency>

</VAT> <ItemTotal>1017.91</ItemTotal>

</ItemEntry>

Aprašymas


RowNo Prekės eilutės numeris NormalTextType Ne

SerialNumber Prekės serijos numeris ShortTextType Ne

SellerProductId Tiekėjo paslaugos/prekės ko-das

ShortTextType Ne

BuyerProductId Pirkėjo paslaugos/prekės kodas ShortTextType Ne

TaricCode TARIC kodas, ţr. 14 Paprastų tipų apibrėţimai.

EncodingType Ne


AccountingRe-cord

Ne

CustomerRef Nuoroda susijusi su konkrečia preke / paslauga nurodyta šioje eilutėje. Nuoroda į uţsakymą, pirkėjo sudarytą sutartį.

NormalTextType Ne

Description Eilutės identifikatorius, aprašy-mas

LongTextType Ne

EAN Bar kodas NormalTextType Ne

InitialReading Informacija susijusi su periodine sąskaita faktūra. Padėtis laiko-

ShortTextType Ne







17/87

tarpio pradţioje, pvz., vandens suvartojimas.

FinalReading Informacija susijusi su periodine sąskaita faktūra. Padėtis laiko-tarpio pabaigoje, pvz., vandens suvartojimas.

ShortTextType Ne

ItemReserve Papildoma prekės/paslaugos informacija, ţr. 13.7 ExtensionRecord.


ItemDetailInfo Sąskaitos faktūros detali infor-macija.

Ne 0-n

ItemUnit Matavimo vienetai (pvz., kg, sec, kWh).

ShortTextType Ne

ItemAmount Prekės/paslaugos kiekis Deci-mal4FractionDigitsType

Ne

ItemPrice Prekės/paslaugos vieneto kaina (be mokesčių)


Ne

ItemSum Viso suma be nuolaidos ir mo-kesčių


Ne




VATRecord Ne

ItemTotal Iš viso eilutės suma (ItemSum minus nuolaida plius mokes-čiai).


Ne







18/87

9.2. GroupEntry GroupEntry grupė apjungia skirtingas Item eilutes į vieną loginę grupę.

Struktūra Pavyzdys

<GroupEntry> <GroupDescription>Popierius</GroupDescription> <Extension extensionId=" ">

… </Extension> <Accounting>

… </Accounting> <GroupAmount>4.5</GroupAmount> <GroupSum>6355.8667</GroupSum> <Addition addCode="DSC">

<AddContent>Nuolaida</AddContent> <AddRate>-40</AddRate> <AddSum>-2542.3467</AddSum>

</Addition> <VAT>

<SumBeforeVAT>3813.52</SumBeforeVAT> <VATRate>21</VATRate> <VATSum>800,84</VATSum> <Currency>LTL</Currency>

</VAT> <GroupTotal>4614.36</GroupTotal>

</GroupEntry>

Aprašymas


GroupDescription Laisvas tekstas apbidūdinantis grupę

NormalTextType Ne




AccountingRe-cord

Ne

GroupAmount Visas kiekis prekių/paslaugų esančių šioje grupėje (ItemA-mount elementų suma).


Ne

GroupSum Prekių/paslaugų esančių grupė-je suma (ItemSum elementų suma).


Ne




VATRecord Ne

GroupTotal Grupė suma iš viso (ItemTotal elementų suma).


Ne







19/87







20/87

10. AdditionalInformation AdditionalInformation elementas apibūdina papildomą tekstinę informaciją sąskaitoje faktūroje. Pavyzdţiui informa-

cija susijusi su rinkodaros pranešimais.

Struktūra Pavyzdys

<AdditionalInformation id="Note"> <InformationName>

Svarbu </InformationName> <InformationContent>

Sąskaitą faktūrą apmokėdami pavedimu nuro-dykite jos seriją ir numerį.

</InformationContent> </AdditionalInformation>

Aprašymas


AdditionalInformation Papildoma informacija rodoma sąskaitoje faktūroje, ţr. 13.7 ExtensionRecord.

ExtensionRecord Ne

11. PaymentInfo PaymentInfo elementas apibūdina informaciją, kuri naudojama generuojant mokėjimo uţsakymo formą iš sąskaitos

faktūros.

Struktūra Pavyzdys

<PaymentInfo> <Currency>LTL</Currency> <PaymentDescription>Sąskaitos faktūros nr. 340925 </PaymentDescription> <PaymentRefId>30253234017</PaymentRefId> <Payable>YES</Payable> <PayDueDate>2009-12-15</PayDueDate> <PaymentTotalSum>5925.21</PaymentTotalSum> <PayerName>BANDOMAISIS PIRKĖJAS UAB</PayerName> <PaymentId>340925</PaymentId> <PayToAccount>10002028538006</PayToAccount> <PayToName> BANDOMAISIS PARDAVĖJAS UAB</PayToName> <DirectDebitPayeeContractNumber>61 </DirectDebitPayeeContractNumber> <DirectDebitPayerNumber>30253234017 </DirectDebitPayerNumber>

</PaymentInfo>

Aprašymas








21/87


CurrencyType Taip

PaymentDescription Mokėjimo aprašymas PaymentDescrip-tionType

Turi būti uţpildytas mokėjimo aprašymas arba mokė-jimo nume-ris.

PaymentRefId Mokėjimo numeris ReferenceType

Payable Sąskaita faktūra turi būti sumo-kėta ar ne. Taip – sąskaita fak-tūra turi būti apmokėta (PayDu-eDate yra privalomas). Ne – sąskaita faktūra yra informaci-nio pobūdţio ir neturi būti ap-mokėta (PayDueDate – nepri-valomas).

YesNoType Taip

PayDueDate Apmokėjimo diena DateType

PaymentTotalSum Iš viso mokėjimo suma. Deci-mal2FractionDigitsType

Taip

PayerName Pirkėjo pavadinimas NormalTextType Taip

PaymentId Toks pat kaip sąskaitos faktū-ros serija ir numeris.

NormalTextType Taip

PayToAccount Gavėjo sąskaitos numeris. AccountType Taip

PayToName Gavėjo pavadinimas NormalTextType Taip

DirectDebitPayeeCont-ractNumber

Tiesioginio debeto sutarties numeris tarp banko ir mokėjimo gavėjo.

ShortTextType Ne

DirectDebitPayerNum-ber

Mokėtojo identifikacija tiesiogi-nio debeto sutartyje (pvz., klien-to numeris).

ReferenceType Ne

12. Footer Footer elementas rodo bendrą sąskaitų faktūrų skaičių ir bendrą visų faile esančių sąskaitų faktūrų sumą.

Struktūra Pavyzdys

<Footer> <TotalNumberInvoices>1</TotalNumberInvoices> <TotalAmount>29768.04</TotalAmount>

</Footer>







22/87

Aprašymas


TotalNumberInvoices Faile esančių sąskaitų faktūrų skaičius. Naudojama klaidų aptikimui. Skaičiuoja faile esan-čius Invoice elementus.

xs:positiveInteger

Taip

TotalAmount Visoje faile esančių sąskaitų faktūrų PaymentTotalSum ele-mentų suma. Neatsiţvelgiama į skirtingas valiutas. Naudojama klaidų aptikimui.


Taip







23/87

13. Kompleksinių tipų aprašymai

13.1. AccountDataRecord AccountDataRecord apibrėţia elementus naudojamus apibūdinant banko sąskaitos informaciją.

Struktūra Pavyzdys

<AccountInfo> <AccountNumber>10002028538005 </AccountNumber> <IBAN>EE241010002028538005</IBAN> <BIC>EEUHEE2X</BIC> <BankName>SEB</BankName>

</AccountInfo>

Aprašymas


AccountNumber Vietinės bankų sistemos są-skaitos numeris

AccountType Taip

IBAN Tarptautinis banko sąskaitos numeris

AccountType Ne

BIC Banko identifikavimo kodas (SWIFT kodas)

xs:string (Max: 11)

Ne

BankName Banko pavadinimas NormalTextType Ne

13.2. AccountingRecord Elementas apibūdinantis informaciją reikalingą apskaitos veiksmų automatizavimui. Pardavėjas ir pirkėjas gali susi-

tarti dėl reikalingos informacijos siekiant automatizuoti sąskaitos faktūros eilutės apdorojimą pirkėjo apskaitos sis-

temoje. Ši informacija gali būti naudojama kaip pardavėjo pusės pasiūlymas kaip sąskaita faktūra turi būti aprašyta

pirkėjo apskaitos sistemoje.

Struktūra Pavyzdys

<Accounting> <Description>

Sąskaita faktūra uţ elektrą nr. 345 </Description> <JournalEntry>

<GeneralLedger>4106</GeneralLedger> <GeneralLedgerDetail> </GeneralLedgerDetail> <CostObjective></CostObjective> <Sum>5000</Sum> <VatSum>900</VatSum> <VatRate>20</VatRate>

</JournalEntry> <PartnerCode></PartnerCode> <BusinessCode></BusinessCode> <SourceCode></SourceCode> <CashFlowCode></CashFlowCode> <ClassificatorCode></ClassificatorCode>

</Accounting>







24/87

Aprašymas


Description Ţurnalo įrašo aprašymas NormalTextType Ne

JournalEntry Apibūdina viena ţurnalo įrašą Taip 1-n

GeneralLedger Pagrindinis didţiosios knygos numeris (atitinka trumpą sąskai-tų planą)

ShortTextType Ne

GeneralLedgerDe-tail

Pagrindinis didţiosios knygos numeris (atitinka išsamų są-skaitų planą)

ShortTextType Ne

CostObjective Kaštų centras/dimensijos identi-fikatorius (neprivaloma informa-cija, pardavėjas gali nustatyti dimensiją, kuri gali būti kaštų centras, pelno centras, projekto kodas ir pan.)

ShortTextType Ne

Sum Suma, kuri bus įskaityta / nu-skaityta į didţiąją knygą. Teigiama suma – debetas Neigiama suma – kreditas


Ne

VatSum Pridėtinės vertės mokestis (0, jeigu jo nėra).


Ne

VatRate Pridėtinės vertės mokesčio tarifas


Ne

PartnerCode Partnerio kodas, ţr. 14 Papras-tų tipų apibrėţimai.

EncodingType Ne

BusinessCode Verslo srities kodas EncodingType Ne

SourceCode Šaltinio kodas EncodingType Ne

CashFlowCode Grynųjų pinigų srauto kodas EncodingType Ne

ClassificatorCode Valstybės biudţeto klasifikacija NormalTextType Ne

13.3. AdditionRecord AdditionRecord elementas aprašo pridėjimus ir atėmimus iš konkrečios sumos. Šis elementas naudojamas apibū-

dinti mokesčius ir nuolaidas.

Struktūra Pavyzdys

<Addition addCode="DSC"> <AddContent>Lojalumo nuolaida </AddContent> <AddRate>-5</AddRate> <AddSum>-6.3878</AddSum>

</Addition>

Aprašymas


addCode DSC – nuolaida. CHR – mokesčiai.

xs:NMTOKEN DSC / CHR

Taip Atributas

AddContent Pridėjimo pavadinimas (pvz., NormalTextType Taip







25/87

Lojalumo programa).

AddRate Mokesčio / nuolaidos tarifas Deci-mal2FractionDigitsType

Ne

AddSum Mokesčio / nuolaidos suma Deci-mal4FractionDigitsType

Ne







26/87

13.4. AddressRecord AddressRecord apibūdina elementus naudojamus aprašyti adresus.

Struktūra Pavyzdys

<MailAddress> <PostalAddress1> B. Radvilaitės g. 1</PostalAddress1> <PostalAddress2>

Centras </PostalAddress2> <City>Vilnius</City> <PostalCode> 01124 </PostalCode> <Country>Lietuva</Country> <Extension id="RoomNumber">

<InformationName> Kambario nr.

</InformationName> <InformationContent>

17 </InformationContent> </Extension>

</MailAddress>

Aprašymas


PostalAddress1 Gatvė, namas, butas NormalTextType Taip

PostalAddress2 Kaimas, pašto skyrius ir kt. NormalTextType Ne

City Miestas NormalTextType Taip

PostalCode Pašto kodas xs:string (Max: 10)

Ne

Country Šalis NormalTextType Ne



13.5. BillPartyRecord BillPartyRecord apibrėţia įvairias, su sąskaita faktūra, susijusias šalis (pardavėjas ir pirkėjas, sąskaitos faktūros

gavėjas, perkių / paslaugų gavėjas).

Struktūra Pavyzdys







27/87

<SellerParty> <UniqueCode>348149</UniqueCode> <Name>NORTAL UAB</Name> <DepId>Pardavimai</DepId> <RegNumber>300118279</RegNumber> <VATRegNnumber>LT100001793518 </VATRegNumber> <ContactData>

… </ContactData> <AccountInfo>

… </AccountInfo> <Extension id="LicenceNumber">

<InformationName> Licenzija </InformationName> <InformationContent> MAM118045A </InformationContent>

</Extension> </SellerParty>

Aprašymas


UniqueCode Unikalus šalies kodas (pvz., kliento numeris siuntėjo apskai-tos sistemoje).

ShortTextType Ne

Name Sąskaitos faktūros šalies pava-dinimas.

NormalTextType Taip

DepId Departamento identifikatorius (pvz., Pardavimai).

NormalTextType Ne

RegNumber Šalies registracijos numeris RegType Ne

VATRegNumber Šalies PVM mokėtojo kodas RegType Ne

ContactData Šalie kontaktinė informacija (telefono numeris, adresas, el. paštas, vardas ir kt.), ţr. 13.6 ContactDataRecord

ContactDataRe-cord

Ne

AccountInfo Nurodo šalies atsikaitomąsias sąskaitas, ţr. 13.1 AccountDa-taRecord

AccountDataRe-cord

Ne



13.6. ContactDataRecord ContactDataRecord apibrėţia elementus naudojamus apibūdinant sąskaitos faktūros gavėją ir siuntėja.

Struktūra Pavyzdys







28/87

<ContactData> <ContactName>Kati Karu</ContactName> <ContactPersonCode>47606140231 </ContactPersonCode> <PhoneNumber>6655501</PhoneNumber> <FaxNumber>6655104</FaxNumber> <URL>www.test.ee</URL> <EmailAddress>

[email protected] </EmailAddress> <LegalAddress>

… </LegalAddress> <MailAddress>

… </MailAddress> <ContactInformation id="AgentName">

<InformationName> Agendi nimi </InformationName> <InformationContent> Tiiu Tamm </InformationContent>

</ContactInformation> </ContactData>

Aprašymas


ContactName Kontaktinio asmens vardas, pavardė

NormalTextType Ne

ContactPersonCode Kontaktinio asmens kodas RegType Ne

PhoneNumber Šalies kontaktinis telefono nu-meris

NormalTextType Ne

FaxNumber Šalie fakso numeris NormalTextType Ne

URL Svetainės adresas NormalTextType Ne

EmailAddress Šalies elektroninio pašto adre-sas

xs:string pattern: .+@.+

Ne

LegalAddress Apibūdina šalies registracijos adresą, ţr. 13.4 AddressRecord

AddressRecord Ne

MailAddress Apibūdina popierinės sąskaitos faktūros pristatymo adresą, ţr. 13.4 AddressRecord

AddressRecord Ne

ContactInformation Apibūdina papildomus elemen-tus kurie reikalingi šiai sričiai, ţr. 13.7 ExtensionRecord.


13.7. ExtensionRecord ExtensionRecord tipas leidţia pridėti papildomą informaciją, kuri nėra apibrėţta e-invoice struktūroje, bet tai yra

svarbi informacija, kuri turi būti perkeliama.

Struktūra Pavyzdys







29/87

<Extension extensionId="LicenceNumber"> <InformationName>

Licenzija </InformationName> <InformationContent>

MAM118045A </InformationContent>

</Extension>

Aprašymas


extensionId ExtensionRecord elemento identifikacijos kodas.


InformationName Pateikiamos informacijos pava-dinimas.

NormalTextType Ne

InformationContent Perduodama informacija LongType Taip

CustomContent <Bet koks> elementas. <Bet koks> elementas leidţia išplėsti XML dokumentą papil-domais elementais nenurody-tais schemoje.

Ne

XML pavadinimų susitarimai

Siekiant uţtikrinti vienodą įvardijimo ir kapitalizacijos susitarimą visose XML specifikacijose turi būti naudojami „Up-

per Camel Case" (UCC) ir „Lower Camel Case" (LCC) stiliai. UCC stilius padidina kiekvieno ţodţio arba junginio

simbolį. LCC – padidina kiekvieno ţodţio pirmą simbolį išskyrus pirmąjį ţodį.

Visi vardai yra angliški.

Elementų vardai turi būti rašomi UCC susitarimu (pvz., <UpperCamelCaseElement/>).

Atributų vardai turi būti rašomi LCC susitarimu (pvz., <UpperCamelCaseElement lowerCamelCaseAttribute="Whatever"/>).

Venkite sutrumpinimų, tačiau jeigu reikia naudoti juos rašykit naudodami kapitalizaciją (pvz., XMLSignature).

Nenaudokite pabraukimo ( _ ), taško ( . ) ar brūkšnelio ( - ). Nenaudokite: „header.manifest“, stock_quote_5, commercial-transaction. Naudokite : HeaderManifest, stockQuote5, CommercialTransac-tion.

Visus „complextype“ apibrėţimus naudoti su priesaga „Record“.

Visus „simpletype“ apibrėţimus naudoti su priesaga „Type“.







30/87

13.8. VATRecord Šis elementas naudojamas pridėtinės vertės mokesčiui aprašyti.

Struktūra Pavyzdys

<VAT vatId="TAX"> <SumBeforeVAT>112.34</SumBeforeVAT> <VATRate>20</VATRate> <VATSum>22.47</VATSum> <Currency>EEK</Currency> <SumAfterVAT>134.81</SumAfterVAT> <Reference extensionId="String">

<InformationName>String</InformationName> <InformationCon-tent>String</InformationContent> <CustomContent> <any/> </CustomContent>

</Reference> </VAT>

Aprašymas


vatId PVM tipas. NOTTAX – neapmokestinamas. TAXEX – mokesčių lengvata. TAX – apmokestinamas.

VatCodeType Ne Atributas

SumBeforeVAT Suma nuo kurios skaičiuojamas PVM.

Decimal4Fractio nDigitsType

Ne

VATRate PVM tarifas Decimal2Fractio nDigitsType

Ne

VATSum PVM suma Decimal4Fractio nDigitsType

Ne


CurrencyType Ne

SumAfterVAT Suma nuo kurios skaičiuojamas PVM plius apskaičiuota PVM suma.

Decimal4Fractio nDigitsType

Ne

Reference Apibūdina papildomus elemen-tus, kurie reikalingi šioje srityje, ţr. 13.7 ExtensionRecord.

ExtensionRecor D

Ne

14. Paprastų tipų apibrėžimai AccountType

Tipas xs:string Eilutės duomenų tipas apima simbolius, eilutės patraukimą, grįţimą į eilutės pradţią, tabuliacijos simbolius.

Apribojimai maxLength 35 Maksimalus simbolių skaičius yra 35.

pattern ([0-9|A-Z])* Leidţiama naudoti tik skaičius nuo 0 iki 9 ir didţiąsias raides nuo A iki Z.







31/87

CurrencyType


Apribojimai pattern [A-Z][A-Z][A-Z] Tris didţiąsias raides nuo A iki Z.

DateType

Tipas xs:date Data duomenų tipas naudojamas datos nurodymui. Data nurodoma formatu „CCYY-MM-DD“, kai: CC – nurodo amţių. YY – nurodo metus. MM – nurodo mėnesį. DD – nurodo dieną.

Decimal2FractionDigitsType

Tipas xs:decimal Dešimtainis duomenų tipas naudojamas nurodyti skaitinę reikšmę. Pvz., 999,50 arba +999,54 arba -999,52 arba 0,00.

Apribojimai fractionDigits 2 Galima nurodyti 2 skaičius po kablelio.

Decimal4FractionDigitsType

Tipas xs:decimal Dešimtainis duomenų tipas naudojamas nurodyti skaitinę reikšmę. Pvz., 999,5854 arba +999,5854 arba -999,5217 arba 0,0000.

Apribojimai fractionDigits 4 Galima nurodyti 4 skaičius po kablelio.

EncodingType



LanguageType

Tipas xs:string Eilutės duomenų tipas apima simbolius, eilutės patraukimą, grįţimą į eilutės pradţią, tabuliacijos simbolius. Kalbų kodai iš dviejų raidţių pagal ISO 639-1. 136 standartą.

Apribojimai pattern [a-z][a-z] Dvi maţosios raidės nuo a iki z.

LongTextType



NormalTextType



PaymentDescriptionType







32/87



pattern [ - ÿ&#x0 160;š Ž&#x0 17E;]*

Leidţia naudoti beveik visus įmanomus simbolius.

RegType



ReferenceType



pattern ([0-9])* Leidţiama naudoti tik skaičius nuo 0 iki 9.

ShortTextType



VatCodeType

Tipas xs:NMTOKEN Eilutės duomenų tipas, kuriame nėra eilutės patraukimo, grįţimo į eilutės pradţią, tabuliacijos, priekinio arba galinio tarpo arba dvigubo tarpo. Naudojamas tik su schemos atri-butais.

Apribojimai pattern NOTTAX Neapmokestinamas.

pattern TAXEX Mokesčių lengvata

pattern TAX Apmokestinamas

YesNoType

Tipas xs:NMTOKEN Eilutės duomenų tipas, kuriame nėra eilutės patraukimo, grįţimo į eilutės pradţią, tabuliacijos, priekinio arba galinio tarpo arba dvigubo tarpo. Naudojamas tik su schemos atri-butais.

Apribojimai pattern YES Galimos reikšmės yra TAIP arba NE

pattern NO

Įtaisyti duomenų tipai

xs:integer Sveikas duomenų tipas naudojamas nurodyti skaitinei vertei be trupmeninės dalies

xs:positiveInteger Sveikų, teigiamų skaičių tipas (1, 2, 3...).

xs:string Eilutės duomenų tipas apima simbolius, eilutės patraukimą, grįţimą į eilutės pradţią, ta-buliacijos simbolius.

xs:NMTOKEN Eilutės duomenų tipas, kuriame nėra eilutės patraukimo, grįţimo į eilutės pradţią, tabu-







33/87

liacijos, priekinio arba galinio tarpo arba dvigubo tarpo. Naudojamas tik su schemos atri-butais.

15. Pavyzdiniai failai

15.1. Tik privalomi laikai <?xml version="1.0" encoding="UTF-8"?>

<E_Invoice>

<Header>

<Date>2009-12-01</Date>

<FileId>123456</FileId>

<Version>1.1</Version>

</Header>

<Invoice invoiceId="45678" regNumber="12345678">

<InvoiceParties>

<SellerParty>

<Name>BANDOMASIS PARDAVĖJAS UAB</Name>

</SellerParty>

<BuyerParty>

<Name>BANDOMASISI PIRKĖJAS UAB</Name>

</BuyerParty>

</InvoiceParties>

<InvoiceInformation>

<Type type="DEB"/>

<DocumentName>PVM sąskaita faktūra</DocumentName>

<InvoiceNumber>45678</InvoiceNumber>

<InvoiceDate>2009-12-01</InvoiceDate>

</InvoiceInformation>

<InvoiceSumGroup>

<TotalSum>1.12</TotalSum>

</InvoiceSumGroup>

<InvoiceItem>

<InvoiceItemGroup>

<ItemEntry>

<Description>Pirktos paslaugos</Description>

</ItemEntry>

</InvoiceItemGroup>

</InvoiceItem>

<PaymentInfo>

<Currency>LTL</Currency>

<PaymentDescription>PVM sąskaita faktūra nr. 45678</PaymentDescription>

<Payable>NO</Payable>

<PaymentTotalSum>1.12</PaymentTotalSum>

<PayerName>BANDOMASISI PIRKĖJAS UAB</PayerName>

<PaymentId>45678</PaymentId>

<PayToAccount>987654321</PayToAccount>

<PayToName>BANDOMASIS PARDAVĖJAS UAB</PayToName>







34/87

</PaymentInfo>

</Invoice>

<Footer>

<TotalNumberInvoices>1</TotalNumberInvoices>

<TotalAmount>1.12</TotalAmount>

</Footer>

</E_Invoice>

15.2. Visi laukai <?xml version="1.0" encoding="UTF-8"?>

<E_Invoice>

<Header>

<Test>YES</Test>

<Date>1967-08-13</Date>

<FileId>String</FileId>

<Version>String</Version>

<SenderId>String</SenderId>

<ReceiverId>String</ReceiverId>

<ContractId>String</ContractId>

<PayeeAccountNumber/>

</Header>

<Invoice invoiceId="String" languageId="aa" templateId="String" channelId="String" factoring="NO" regNumber="String" service-

Id="String" channelAddress="String">

<InvoiceParties>

<SellerParty>

<UniqueCode>String</UniqueCode>

<Name> </Name>

<DepId>String</DepId>

<RegNumber>String</RegNumber>

<VATRegNumber>String</VATRegNumber>

<ContactData>

<ContactName> </ContactName>

<ContactPersonCode>String</ContactPersonCode>

<PhoneNumber>String</PhoneNumber>

<FaxNumber>String</FaxNumber>

<URL>String</URL>

<E-mailAddress> @ </E-mailAddress>

<LegalAddress>

<PostalAddress1>String</PostalAddress1>


<City>String</City>

<PostalCode>String</PostalCode>

<Country>String</Country>

<Extension extensionId="String">

<InformationName>String</InformationName>

<InformationContent>String</InformationContent>

<CustomContent>

<any/>







35/87

</CustomContent>

</Extension>

</LegalAddress>

<MailAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</MailAddress>

<ContactInformation extensionId="String">



<CustomContent>

<any/>

</CustomContent>

</ContactInformation>

</ContactData>

<AccountInfo>

<AccountNumber/>

<IBAN/>

<BIC>Stringa</BIC>

<BankName> </BankName>

</AccountInfo>




<CustomContent>

<any/>

</CustomContent>

</Extension>

</SellerParty>

<BuyerParty>


<Name> </Name>




<ContactData>










36/87


<URL>String</URL>


<LegalAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</LegalAddress>

<MailAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</MailAddress>




<CustomContent>

<any/>

</CustomContent>


</ContactData>

<AccountInfo>

<AccountNumber/>

<IBAN/>

<BIC>Stringa</BIC>


</AccountInfo>




<CustomContent>







37/87

<any/>

</CustomContent>

</Extension>

</BuyerParty>

<RecipientParty>


<Name> </Name>




<ContactData>



<PhoneNumber>String</PhoneNumbe


<URL>String</URL>


<LegalAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</LegalAddress>

<MailAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</MailAddress>




<CustomContent>







38/87

<any/>

</CustomContent>


</ContactData>

<AccountInfo>

<AccountNumber/>

<IBAN/>

<BIC>String</BIC>


</AccountInfo>




<CustomContent>

<any/>

</CustomContent>

</Extension>

</RecipientParty>

<DeliveryParty>


<Name> </Name>




<ContactData>





<URL>String</URL>


<LegalAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</LegalAddress>

<MailAddress>



<City>String</City>







39/87






<CustomContent>

<any/>

</CustomContent>

</Extension>

</MailAddress>




<CustomContent>

<any/>

</CustomContent>


</ContactData>

<AccountInfo>

<AccountNumber/>

<IBAN/>

<BIC>Stringa</BIC>


</AccountInfo>




<CustomContent>

<any/>

</CustomContent>

</Extension>

</DeliveryParty>

<PayerParty>


<Name> </Name>




<ContactData>





<URL>String</URL>


<LegalAddress>



<City>String</City>







40/87






<CustomContent>

<any/>

</CustomContent>

</Extension>

</LegalAddress>

<MailAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</MailAddress>




<CustomContent>

<any/>

</CustomContent>


</ContactData>

<AccountInfo>

<AccountNumber/>

<IBAN/>

<BIC>Stringa</BIC>


</AccountInfo>




<CustomContent>

<any/>

</CustomContent>

</Extension>

</PayerParty>

</InvoiceParties>

<InvoiceInformation>

<Type type="DEB">







41/87

<SourceInvoice>String</SourceInvoice>

</Type>

<FactorContractNumber>String</FactorContractNumber>

<ContractNumber>String</ContractNumber>

<DocumentName>String</DocumentName>

<InvoiceNumber>String</InvoiceNumber>

<InvoiceContentCode>String</InvoiceContentCode>

<InvoiceContentText>String</InvoiceContentText>

<PaymentReferenceNumber/>

<PaymentMethod>String</PaymentMethod>

<InvoiceDate>1967-08-13</InvoiceDate>

<DueDate>1967-08-13</DueDate>

<PaymentTerm>String</PaymentTerm>

<FineRatePerDay>1.12</FineRatePerDay>

<Period>

<PeriodName>String</PeriodName>

<StartDate>1967-08-13</StartDate>

<EndDate>1967-08-13</EndDate>

</Period>

<InvoiceDeliverer>





<URL>String</URL>


<LegalAddress>



<City>String</City>






<CustomContent>

<any/>

</CustomContent>

</Extension>

</LegalAddress>

<MailAddress>



<City>String</City>












42/87

<CustomContent>

<any/>

</CustomContent>

</Extension>

</MailAddress>




<CustomContent>

<any/>

</CustomContent>


</InvoiceDeliverer>




<CustomContent>

<any/>

</CustomContent>

</Extension>

</InvoiceInformation>

<InvoiceSumGroup>

<Balance>

<BalanceDate>1967-08-13</BalanceDate>

<BalanceBegin>1.12</BalanceBegin>

<Inbound>1.12</Inbound>

<Outbound>1.12</Outbound>

<BalanceEnd>1.12</BalanceEnd>

</Balance>

<InvoiceSum>1.1234</InvoiceSum>

<PenaltySum>1.1234</PenaltySum>

<Addition addCode="DSC">

<AddContent>String</AddContent>

<AddRate>1.12</AddRate>

<AddSum>1.1234</AddSum>

</Addition>

<Rounding>1.1234</Rounding>

<VAT vatId="TAX">

<SumBeforeVAT>1.1234</SumBeforeVAT>

<VATRate>1.12</VATRate>

<VATSum>1.1234</VATSum>

<Currency>AAA</Currency>

<SumAfterVAT>1.1234</SumAfterVAT>

<Reference extensionId="String">



<CustomContent>

<any/>

</CustomContent>







43/87

</Reference>

</VAT>

<TotalVATSum>1.12</TotalVATSum>

<TotalSum>1.12</TotalSum>

<TotalToPay>1.12</TotalToPay>


<Accounting>

<Description>String</Description>

<JournalEntry>

<GeneralLedger>String</GeneralLedger>

<GeneralLedgerDetail>String</GeneralLedgerDetail>

<CostObjective>String</CostObjective>

<Sum>1.1234</Sum>

<VatSum>1.1234</VatSum>

<VatRate>1.12</VatRate>

</JournalEntry>

<PartnerCode>String</PartnerCode>

<BusinessCode>String</BusinessCode>

<SourceCode>String</SourceCode>

<CashFlowCode>String</CashFlowCode>

<ClassificatorCode>String</ClassificatorCode>

</Accounting>




<CustomContent>

<any/>

</CustomContent>

</Extension>

</InvoiceSumGroup>

<InvoiceItem>

<InvoiceTotalGroup groupId="String">

<ItemEntry>

<RowNo>String</RowNo>

<SerialNumber>String</SerialNumber>

<SellerProductId>String</SellerProductId>

<BuyerProductId>String</BuyerProductId>

<TaricCode>String</TaricCode>

<Accounting>


<JournalEntry>




<Sum>1.1234</Sum>



</JournalEntry>








44/87





</Accounting>

<CustomerRef>String</CustomerRef>


<EAN>String</EAN>

<InitialReading>String</InitialReading>

<FinalReading>String</FinalReading>

<ItemReserve extensionId="String">



<CustomContent>

<any/>

</CustomContent>

</ItemReserve>

<ItemDetailInfo>

<ItemUnit>String</ItemUnit>

<ItemAmount>1.1234</ItemAmount>

<ItemPrice>1.1234</ItemPrice>

</ItemDetailInfo>

<ItemSum>1.1234</ItemSum>





</Addition>

<VAT vatId="TAX">









<CustomContent>

<any/>

</CustomContent>

</Reference>

</VAT>

<ItemTotal>1.1234</ItemTotal>

</ItemEntry>

<GroupEntry>

<GroupDescription>String</GroupDescription>










45/87

<CustomContent>

<any/>

</CustomContent>

</Extension>

<Accounting>


<JournalEntry>




<Sum>1.1234</Sum>



</JournalEntry>






</Accounting>

<GroupAmount>1.1234</GroupAmount>

<GroupSum>1.1234</GroupSum>





</Addition>

<VAT vatId="TAX">









<CustomContent>

<any/>

</CustomContent>

</Reference>

</VAT>

<GroupTotal>1.1234</GroupTotal>

</GroupEntry>

</InvoiceTotalGroup>

<InvoiceItemGroup groupId="String">

<ItemEntry>

<RowNo>String</RowNo>

<SerialNumber>String</SerialNumber>

<SellerProductId>String</SellerProductId>







46/87

<BuyerProductId>String</BuyerProductId>

<TaricCode>String</TaricCode>

<Accounting>


<JournalEntry>




<Sum>1.1234</Sum>



</JournalEntry>






</Accounting>

<CustomerRef>String</CustomerRef>


<EAN>String</EAN>

<InitialReading>String</InitialReading>

<FinalReading>String</FinalReading>

<ItemReserve extensionId="String">



<CustomContent>

<any/>

</CustomContent>

</ItemReserve>

<ItemDetailInfo>

<ItemUnit>String</ItemUnit>

<ItemAmount>1.1234</ItemAmount>

<ItemPrice>1.1234</ItemPrice>

</ItemDetailInfo>

<ItemSum>1.1234</ItemSum>





</Addition>

<VAT vatId="TAX">














47/87


<CustomContent>

<any/>

</CustomContent>

</Reference>

</VAT>

<ItemTotal>1.1234</ItemTotal>

</ItemEntry>

<GroupEntry>

<GroupDescription>String</GroupDescription>




<CustomContent>

<any/>

</CustomContent>

</Extension>

<Accounting>


<JournalEntry>




<Sum>1.1234</Sum>



</JournalEntry>






</Accounting>

<GroupAmount>1.1234</GroupAmount>

<GroupSum>1.1234</GroupSum>





</Addition>

<VAT vatId="TAX">















48/87

<CustomContent>

<any/>

</CustomContent>

</Reference>

</VAT>

<GroupTotal>1.1234</GroupTotal>

</GroupEntry>

</InvoiceItemGroup>

<InvoiceItemTotalGroup>

<InvoiceItemTotalDescription>String</InvoiceItemTotalDescription>




<CustomContent>

<any/>

</CustomContent>

</Extension>

<Accounting>


<JournalEntry>



<Sum>1.1234</Sum>



</JournalEntry>






</Accounting>

<InvoiceItemTotalAmount>1.1234</InvoiceItemTotalAmount>

<InvoiceItemTotalSum>1.1234</InvoiceItemTotalSum>





</Addition>

<VAT vatId="TAX">









<CustomContent>

49/87

<any/>

</CustomContent>

</Reference>

</VAT>

<InvoiceItemTotal>1.1234</InvoiceItemTotal>

</InvoiceItemTotalGroup>

</InvoiceItem>

<AdditionalInformation extensionId="String">



<CustomContent>

<any/>

</CustomContent>

</AdditionalInformation>

<PaymentInfo>


<PaymentDescription/>

<Payable>NO</Payable>

<PayDueDate>1967-08-13</PayDueDate>

<PaymentTotalSum>1.12</PaymentTotalSum>

<PayerName> </PayerName>

<PaymentId>String</PaymentId>

<PayToAccount/>

<PayToName> </PayToName>

<DirectDebitPayeeContractNumber>String</DirectDebitPayeeContractNumber>

<DirectDebitPayerNumber/>

</PaymentInfo>

</Invoice>

<Footer>

<TotalNumberInvoices>1</TotalNumberInvoices>

<TotalAmount>1.12</TotalAmount>

</Footer>

</E_Invoice>

16. Priedas nr. 1 – XML schema Schemoje aprašoma kaip atrodo vienas ar daugiau XML dokumentų bei apibrėţia:

Kokia tvarka išdėstyti elementai dokumente ir kada jie rodomi

Elementų turinį ir jų atributus Schemos tikslas yra leisti sistemai patikrinti dokumento struktūrą.

<?xml version="1.0" encoding="UTF-8"?>







<!--

Schema version: 1.1

Schema date: 01.12.2009

50/87

License rules: no

-->

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">



<xs:element name="E_Invoice">

<xs:annotation>

<xs:documentation>root element</xs:documentation>

</xs:annotation>



<xs:complexType>

<xs:sequence>



<xs:element ref="Header"/>



<xs:element ref="Invoice" maxOccurs="unbounded"/>



<xs:element ref="Footer"/>

</xs:sequence>

</xs:complexType>

</xs:element>



<xs:element name="Header">

<xs:complexType>

<xs:sequence>

<xs:element name="Test" type="YesNoType" minOccurs="0"/>

<xs:element name="Date" type="DateType"/>

<xs:element name="FileId" type="ShortTextType"/>

<xs:element name="Version" type="ShortTextType"/>

<xs:element name="SenderId" type="ShortTextType" minOccurs="0"/>

<xs:element name="ReceiverId" type="ShortTextType" minOccurs="0"/>

<xs:element name="ContractId" type="ShortTextType" minOccurs="0"/>

<xs:element name="PayeeAccountNumber" type="AccountType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>



<xs:element name="Invoice">

<xs:complexType>

<xs:sequence>

<xs:element ref="InvoiceParties"/>

<xs:element ref="InvoiceInformation"/>

<xs:element ref="InvoiceSumGroup" maxOccurs="2"/>

<xs:element ref="InvoiceItem"/>

<xs:element ref="AdditionalInformation" minOccurs="0" maxOccurs="unbounded"/>

<xs:element ref="PaymentInfo"/>

</xs:sequence>

<xs:attribute name="invoiceId" type="NormalTextType" use="required"/>

<xs:attribute name="serviceId" type="ShortTextType" use="optional"/>

<xs:attribute name="regNumber" type="RegType" use="required"/>

51/87

<xs:attribute name="channelId" type="EncodingType" use="optional"/>

<xs:attribute name="channelAddress" type="NormalTextType" use="optional"/>

<xs:attribute name="factoring" type="YesNoType" use="optional"/>

<xs:attribute name="templateId" type="NormalTextType" use="optional"/>

<xs:attribute name="languageId" type="LanguageType" use="optional"/>

</xs:complexType>

</xs:element>



<xs:element name="InvoiceParties">

<xs:complexType>

<xs:sequence>

<xs:element name="SellerParty" type="BillPartyRecord"/>

<xs:element name="BuyerParty" type="BillPartyRecord"/>

<xs:element name="RecipientParty" type="BillPartyRecord" minOccurs="0"/>

<xs:element name="DeliveryParty" type="BillPartyRecord" minOccurs="0"/>

<xs:element name="PayerParty" type="BillPartyRecord" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>



<xs:element name="InvoiceInformation">

<xs:complexType>

<xs:sequence>

<xs:element name="Type">

<xs:complexType>

<xs:sequence>

<xs:element name="SourceInvoice" type="ShortTextType"

minOccurs="0"/>

</xs:sequence>

<xs:attribute name="type" use="required">

<xs:simpleType>

<xs:restriction base="xs:NMTOKEN">

<xs:pattern value="DEB"/>

<xs:pattern value="CRE"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

</xs:complexType>

</xs:element>

<xs:element name="FactorContractNumber" type="NormalTextType" minOccurs="0"/>

<xs:element name="ContractNumber" type="NormalTextType" minOccurs="0"/>

<xs:element name="DocumentName" type="NormalTextType"/>

<xs:element name="InvoiceNumber" type="NormalTextType"/>

<xs:element name="InvoiceContentCode" type="ShortTextType" minOccurs="0"/>

<xs:element name="InvoiceContentText" type="NormalTextType" minOccurs="0"/>

<xs:element name="PaymentReferenceNumber" type="ReferenceType"

minOccurs="0"/>

<xs:element name="PaymentMethod" type="NormalTextType" minOccurs="0"/>

<xs:element name="InvoiceDate" type="DateType"/>

52/87

<xs:element name="DueDate" type="DateType" minOccurs="0"/>

<xs:element name="PaymentTerm" type="NormalTextType" minOccurs="0"/>

<xs:element name="FineRatePerDay" type="Decimal2FractionDigitsType"

minOccurs="0"/>

<xs:element name="Period" minOccurs="0">

<xs:complexType>

<xs:sequence>

<xs:element name="PeriodName" type="NormalTextType"

minOccurs="0"/>

<xs:element name="StartDate" type="DateType"

minOccurs="0"/>

<xs:element name="EndDate" type="DateType"

minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="InvoiceDeliverer" type="ContactDataRecord" minOccurs="0"/>

<xs:element name="Extension" type="ExtensionRecord" minOccurs="0"

maxOccurs="unbounded"/>

</xs:sequence>

</xs:complexType>

</xs:element>



<xs:element name="InvoiceSumGroup">

<xs:complexType>

<xs:sequence>

<xs:element name="Balance" minOccurs="0">

<xs:complexType>

<xs:sequence>

<xs:element name="BalanceDate" type="DateType"

minOccurs="0"/>

<xs:element name="BalanceBegin"

type="Decimal2FractionDigitsType" minOccurs="0"/>

<xs:element name="Inbound"

type="Decimal2FractionDigitsType" minOccurs="0" maxOccurs="unbounded"/>

<xs:element name="Outbound"

type="Decimal2FractionDigitsType" minOccurs="0" maxOccurs="unbounded"/>

<xs:element name="BalanceEnd"


</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="InvoiceSum" type="Decimal4FractionDigitsType" minOccurs="0"/>

<xs:element name="PenaltySum" type="Decimal4FractionDigitsType" minOccurs="0"/>

<xs:element name="Addition" type="AdditionRecord" minOccurs="0"


<xs:element name="Rounding" type="Decimal4FractionDigitsType" minOccurs="0"/>

<xs:element name="VAT" type="VATRecord" minOccurs="0"

53/87

<xs:element name="TotalVATSum" type="Decimal2FractionDigitsType"

minOccurs="0"/>

<xs:element name="TotalSum" type="Decimal2FractionDigitsType"/>

<xs:element name="TotalToPay" type="Decimal2FractionDigitsType" minOccurs="0"/>

<xs:element name="Currency" type="CurrencyType" minOccurs="0"/>

<xs:element name="Accounting" type="AccountingRecord" minOccurs="0"/>



</xs:sequence>

</xs:complexType>

</xs:element>



<xs:element name="InvoiceItem">

<xs:complexType>

<xs:sequence>



<xs:element ref="InvoiceTotalGroup" minOccurs="0"/>



<xs:element ref="InvoiceItemGroup" maxOccurs="unbounded"/>



<xs:element ref="InvoiceItemTotalGroup" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="InvoiceTotalGroup">

<xs:complexType>

<xs:sequence>



<xs:element ref="ItemEntry" minOccurs="0" maxOccurs="unbounded"/>



<xs:element ref="GroupEntry" minOccurs="0"/>

</xs:sequence>

<xs:attribute name="groupId" type="ShortTextType" use="optional"/>

</xs:complexType>

</xs:element>

<xs:element name="InvoiceItemGroup">

<xs:complexType>

<xs:sequence>

<xs:element ref="ItemEntry" maxOccurs="unbounded"/>

<xs:element ref="GroupEntry" minOccurs="0"/>

</xs:sequence>

<xs:attribute name="groupId" type="ShortTextType" use="optional"/>

</xs:complexType>

</xs:element>

<xs:element name="ItemEntry">

<xs:complexType>

<xs:sequence>

<xs:element name="RowNo" type="NormalTextType" minOccurs="0"/>

<xs:element name="SerialNumber" type="ShortTextType" minOccurs="0"/>







54/87

<xs:element name="SellerProductId" type="ShortTextType" minOccurs="0"/>

<xs:element name="BuyerProductId" type="ShortTextType" minOccurs="0"/>

<xs:element name="TaricCode" type="EncodingType" minOccurs="0"/>


<xs:element name="CustomerRef" type="NormalTextType" minOccurs="0"/>

<xs:element name="Description" type="LongTextType"/>

<xs:element name="EAN" type="NormalTextType" minOccurs="0"/>

<xs:element name="InitialReading" type="ShortTextType" minOccurs="0"/>

<xs:element name="FinalReading" type="ShortTextType" minOccurs="0"/>

<xs:element name="ItemReserve" type="ExtensionRecord" minOccurs="0"


<xs:element name="ItemDetailInfo" minOccurs="0" maxOccurs="unbounded">

<xs:complexType>

<xs:sequence>

<xs:element name="ItemUnit" type="ShortTextType"

minOccurs="0"/>

<xs:element name="ItemAmount"


<xs:element name="ItemPrice"


</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="ItemSum" type="Decimal4FractionDigitsType" minOccurs="0"/>



<xs:element name="VAT" type="VATRecord" minOccurs="0"/>

<xs:element name="ItemTotal" type="Decimal4FractionDigitsType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="GroupEntry">

<xs:complexType>

<xs:sequence>

<xs:element name="GroupDescription" type="NormalTextType" minOccurs="0"/>




<xs:element name="GroupAmount" type="Decimal4FractionDigitsType"

minOccurs="0"/>

<xs:element name="GroupSum" type="Decimal4FractionDigitsType" minOccurs="0"/>



<xs:element name="VAT" type="VATRecord" minOccurs="0"/>

<xs:element name="GroupTotal" type="Decimal4FractionDigitsType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="InvoiceItemTotalGroup">

55/87

<xs:complexType>

<xs:sequence>

<xs:element name="InvoiceItemTotalDescription" type="NormalTextType"

minOccurs="0"/>




<xs:element name=" InvoiceItemTotalAmount " type="Decimal4FractionDigitsType"

minOccurs="0"/>

<xs:element name="InvoiceItemTotalSum" type="Decimal4FractionDigitsType"

minOccurs="0"/>



<xs:element name="VAT" type="otal" type="Decimal4FractionDigitsType"

minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>



<xs:element name="AdditionalInformation" type="ExtensionRecord"/>



<xs:element name="PaymentInfo">

<xs:complexType>

<xs:sequence>

<xs:element name="Currency" type="CurrencyType"/>

<xs:choice>

<xs:sequence>

<xs:element name="PaymentDescription"

type="PaymentDescriptionType"/>

</xs:sequence>

<xs:sequence>

<xs:element name="PaymentRefId" type="ReferenceType"/>

<xs:element name="PaymentDescription"

type="PaymentDescriptionType" minOccurs="0"/>

</xs:sequence>

</xs:choice>

<xs:element name="Payable" type="YesNoType"/>

<xs:element name="PayDueDate" type="DateType" minOccurs="0"/>

<xs:element name="PaymentTotalSum" type="Decimal2FractionDigitsType"/>

<xs:element name="PayerName" type="NormalTextType"/>

<xs:element name="PaymentId" type="NormalTextType"/>

<xs:element name="PayToAccount" type="AccountType"/>

<xs:element name="PayToName" type="NormalTextType"/>

<xs:element name="DirectDebitPayeeContractNumber" type="ShortTextType"

minOccurs="0"/>

<xs:element name="DirectDebitPayerNumber" type="ReferenceType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>

56/87



<xs:element name="Footer">

<xs:complexType>

<xs:sequence>

<xs:element name="TotalNumberInvoices" type="xs:positiveInteger"/>

<xs:element name="TotalAmount" type="Decimal2FractionDigitsType"/>

</xs:sequence>

</xs:complexType>

</xs:element>





<xs:complexType name="AccountDataRecord">

<xs:sequence>

<xs:element name="AccountNumber" type="AccountType"/>

<xs:element name="IBAN" type="AccountType" minOccurs="0"/>



<xs:element name="BIC" minOccurs="0">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:maxLength value="11"/>

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="BankName" minOccurs="0">

<xs:simpleType>

<xs:restriction base="NormalTextType"/>

</xs:simpleType>

</xs:element>

</xs:sequence>

</xs:complexType>



<xs:complexType name="AccountingRecord">

<xs:sequence>

<xs:element name="Description" type="NormalTextType" minOccurs="0"/>

<xs:element name="JournalEntry" maxOccurs="unbounded">

<xs:complexType>

<xs:sequence>

<xs:element name="GeneralLedger" type="ShortTextType"

minOccurs="0"/>

<xs:element name="GeneralLedgerDetail" type="ShortTextType"

minOccurs="0"/>

<xs:element name="CostObjective" type="ShortTextType"

minOccurs="0"/>

<xs:element name="Sum" type="Decimal4FractionDigitsType"

minOccurs="0"/>

<xs:element name="VatSum" type="Decimal4FractionDigitsType"

minOccurs="0"/>

<xs:element name="VatRate" type="Decimal2FractionDigitsType"

minOccurs="0"/>

57/87

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="PartnerCode" type="EncodingType" minOccurs="0"/>

<xs:element name="BusinessCode" type="EncodingType" minOccurs="0"/>

<xs:element name="SourceCode" type="EncodingType" minOccurs="0"/>

<xs:element name="CashFlowCode" type="EncodingType" minOccurs="0"/>

<xs:element name="ClassificatorCode" type="NormalTextType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>



<xs:complexType name="AdditionRecord">

<xs:sequence>

<xs:element name="AddContent" type="NormalTextType"/>

<xs:element name="AddRate" type="Decimal2FractionDigitsType" minOccurs="0"/>

<xs:element name="AddSum" type="Decimal4FractionDigitsType" minOccurs="0"/>

</xs:sequence>

<xs:attribute name="addCode" use="required">

<xs:simpleType>


<xs:pattern value="DSC"/>

<xs:pattern value="CHR"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

</xs:complexType>



<xs:complexType name="AddressRecord">

<xs:sequence>

<xs:element name="PostalAddress1" type="NormalTextType"/>

<xs:element name="PostalAddress2" type="NormalTextType" minOccurs="0"/>

<xs:element name="City" type="NormalTextType"/>

<xs:element name="PostalCode" minOccurs="0">

<xs:simpleType>



</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="Country" type="NormalTextType" minOccurs="0"/>



</xs:sequence>

</xs:complexType>



<xs:complexType name="BillPartyRecord">

<xs:sequence>

<xs:element name="UniqueCode" type="ShortTextType" minOccurs="0"/>

<xs:element name="Name" type="NormalTextType"/>

58/87

<xs:element name="DepId" type="NormalTextType" minOccurs="0"/>

<xs:element name="RegNumber" type="RegType" minOccurs="0"/>

<xs:element name="VATRegNumber" type="RegType" minOccurs="0"/>

<xs:element name="ContactData" type="ContactDataRecord" minOccurs="0"/>

<xs:element name="AccountInfo" type="AccountDataRecord" minOccurs="0"




</xs:sequence>

</xs:complexType>



<xs:complexType name="ContactDataRecord">

<xs:sequence>

<xs:element name="ContactName" type="NormalTextType" minOccurs="0"/>

<xs:element name="ContactPersonCode" type="RegType" minOccurs="0"/>

<xs:element name="PhoneNumber" type="NormalTextType" minOccurs="0"/>

<xs:element name="FaxNumber" type="NormalTextType" minOccurs="0"/>

<xs:element name="URL" type="NormalTextType" minOccurs="0"/>

<xs:element name="E-mailAddress" minOccurs="0">

<xs:simpleType>


<xs:pattern value=".+@+.+"/>

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="LegalAddress" type="AddressRecord" minOccurs="0"/>

<xs:element name="MailAddress" type="AddressRecord" minOccurs="0"/>

<xs:element name="ContactInformation" type="ExtensionRecord" minOccurs="0"


</xs:sequence>

</xs:complexType>



<xs:complexType name="ExtensionRecord">

<xs:sequence>

<xs:element name="InformationName" type="NormalTextType" minOccurs="0"/>

<xs:element name="InformationContent" type="LongTextType"/>

<xs:element name="CustomContent" minOccurs="0">

<xs:complexType>

<xs:sequence>

<xs:any processContents="skip"/>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:sequence>

<xs:attribute name="extensionId" type="ShortTextType" use="optional"/>

</xs:complexType>



<xs:complexType name="VATRecord">

<xs:sequence>

59/87

<xs:element name="SumBeforeVAT" type="Decimal4FractionDigitsType" minOccurs="0"/>

<xs:element name="VATRate" type="Decimal2FractionDigitsType" minOccurs="0"/>

<xs:element name="VATSum" type="Decimal4FractionDigitsType" minOccurs="0"/>

<xs:element name="Currency" type="CurrencyType" minOccurs="0"/>

<xs:element name="SumAfterVAT" type="Decimal4FractionDigitsType" minOccurs="0"/>

<xs:element name="Reference" type="ExtensionRecord" minOccurs="0"/>

</xs:sequence>

<xs:attribute name="vatId" type="VatCodeType" use="optional"/>

</xs:complexType>



<xs:simpleType name="AccountType">



<xs:pattern value="([0-9|A-Z])*"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="CurrencyType">


<xs:pattern value="[A-Z][A-Z][A-Z]"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="DateType">

<xs:restriction base="xs:date"/>

</xs:simpleType>

<xs:simpleType name="Decimal2FractionDigitsType">

<xs:restriction base="xs:decimal">

<xs:fractionDigits value="2"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Decimal4FractionDigitsType">

<xs:restriction base="xs:decimal">

<xs:fractionDigits value="4"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="EncodingType">



</xs:restriction>

</xs:simpleType>

<xs:simpleType name="LanguageType">


<xs:pattern value="[a-z][a-z]"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="LongTextType">



</xs:restriction>

</xs:simpleType>







60/87

<xs:simpleType name="NormalTextType">



</xs:restriction>

</xs:simpleType>

<xs:simpleType name="PaymentDescriptionType">



<xs:pattern value="[ -ÿŠšŽž]*"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="RegType">



</xs:restriction>

</xs:simpleType>

<xs:simpleType name="ReferenceType">



<xs:pattern value="([0-9])*"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="ShortTextType">



</xs:restriction>

</xs:simpleType>

<xs:simpleType name="VatCodeType">


<xs:pattern value="NOTTAX"/>

<xs:pattern value="TAXEX"/>

<xs:pattern value="TAX"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="YesNoType">


<xs:pattern value="YES"/>

<xs:pattern value="NO"/>

</xs:restriction>

</xs:simpleType>

</xs:schema>







61/87

17. Integracijos architektūra E. sąskaita sistemos integracija su ERP/įmonių verslo valdymo ar kita informacine sistema realizuota SOAP ţi-

niatinklio paslauga arba CSV failų pagalba. E. sąskaita sistemoje yra ţiniatinklio paslaugos skirtos importuo-

ti/eksportuoti e. sąskaitas, bei importuoti registrus. Kai kurie registrai gali būti importuojami iš CSV failo, naudojant

e-SąskaitųE.sąskaita sistemos vartotojo naudotojo sąsają pasiekiama per interneto naršyklę

E. sąskaita sistemos ţiniatinklio paslaugos naudoja standartizuotą e. sąskaitos XML formatą.

Visų importavimų istoriją, būklę ir klaidas galima perţiūrėti per E. sąskaitų sistemos vartotojo sąsają.

Importavimas turi realizuotą saugumo mechanizmą, kuris uţtikrina, kad įmonė galėtų importuoti tik savo sąskaitas.

Visi integracijos darbai yra asinchroniški, t. y. duomenys sistemoje atsiras tik praėjus tam tikram laikui (įvykus peri-

odiniams duomenų transformavimo ir importavimo darbams)

17.1 Žiniatinklio paslaugų aprašas

Pilną E. sąskaita sistemos ţiniatinklio paslaugų aprašą (wsdl) galite rasti adresu:

https://esaskaitos.post.lt/erp/erpServices.wsdl

Žiniatinklio paslaugų prieigos taškai (endpoint)

Aprašymas

AccountPlanRegistry Sąskaitų plano registro importas iš ERP į E. sąskaitų sistemą

BuyInvoice Graţina pirkimo sąskaitų faktūrų sąrašą e. sąskaitų formatu

BuyInvoicePdf Graţina pirkimo sąskaitos faktūros priedus (PDF)

BuyInvoices Pirkimo sąskaitos eksportas iš ERP į E. sąskaitų sistemą

SupplierRegistry Tiekėjų / Klientų registro importas iš ERP į E. sąskaitų sistemą

CompanyStatus Graţina įmonės statusą

DimensionRegistry Dimensijų registro importas iš ERP į E. sąskaitų sistemą

Einvoice Pardavimo sąskaitos eksportas iš ERP į E. sąskaitų sistemą

HasBuyInvoice Leidţia patikrinti ar E. sąskaitų sistemoje yra pirkimo sąskaitų

InvoiceAttachment Graţina sąskaitos faktūros priedus

SaleInvoiceExport Graţina pardavimo sąskaitų faktūrų sąrašą e. sąskaitų formatu

17.2 Žiniatinklio paslaugos autentifikacija

Prieš kviečiant ţiniatinklio paslaugą būtina įjungti duomenų apsikeitimą su ERP sistema:

1. Prisijunkite prie E. sąskaitų sistemos su įmonės administratoriaus role

2. „Bendra informacija“ → „Duomenų apsikeitimas su ERP“

3. Paţymėkite „*Prisijungimas prie ERP leidţiamas“

https://esaskaitos.post.lt/erp/erpServices.wsdl







62/87

4. Spauskite „Sukurti naują autentifikavimo kodą“

5. Sukurtą kodą naudokite kviesdami ţiniatinklio paslaugos „authPhrase“ atribute.

Pvz: authPhrase="2:uogvedprsdhimkixodemwaidimpnzvvkohzdnpgionppmmgwdv"

17.3 Integracijos modulio komponentai

Pagrindiniai E. sąskaitų komponentai dalyvaujantys duomenų apsikeitimo procese:

Verslo valdymo sistemos/kitos informacinės sistemos

E. sąskaitų sistema

Ţiniatinklio paslaugos

E. sąskaita sistemos naudotojo sąsaja

Duomenų lygis

Duomenų bazė

Failų repozitorija

process_quarz integracijos modulis

Failų serveris

Periodiniai darbai (jobs)







63/87

Integracijos ţingsniai:

1. Išorinė sistema pateikia integracijos duomenis

2. Suformuojamas XML duomenų failas kuris perduodamas failų serveriui

3. Failų serveris įrašo duomenis į failų repozitoriją

4. Procesas „Periodiniai darbai“ pasiima failą iš repozitorijos, transformuoja duomenis

Duomenys įrašo į duomenų bazę







64/87

18. Pardavimo sąskaitų integracija

1. Uţsakovo darbuotojas įveda sąskaitą į ERP.

2. ERP formuoja sąskaitą / sąskaitas e. sąskaitų formatu

3. ERP kviečia E. sąskaitų ţiniatinklio paslaugą ir importuoja sąskaitą į E. sąskaitų sistemą.

4. Kviečiama Einvoice ţiniatinklio paslauga

Papildomi pakeitimai:

<erp:PdfAttachment invoiceId="?" isInvoice="?" description="?"></erp:PdfAttachment>







65/87

19. Pirkimo sąskaitų integracija

1. Uţsakovo darbuotojas gautą sąskaitą įveda į E. sąskaita sistemą. Jeigu reikia, atlieka eilučių

grupavimą/dalinimą.

2. E. sąskaita sistemoje įvykdomas sąskaitos patvirtinimo procesas (sąskaitą patvirtina atsakingi darbuotojai)

3. ERP iškviečia E. sąskaita sistemos ţiniatinklio paslaugą ir uţklausia naujų pirkimo sąskaitų. Gautas sąskaitas

e. sąskaitos formatu importuoja į savo sistemą. Naudojamos ţiniatinklio paslaugos:

◦ HasBuyInvoiceRequest

◦ BuyInvoiceRequest

Detalų BuyInvoiceRequest ţiniatinklio paslaugų aprašą su pavyzdţiais galite rasti dokumente:

eArvekeskus_Integration_Specification_ver2_2_15.pdf.

Detalų e. sąskaitos struktūros aprašą rasite dokumente:

e-invoice_ver1_1_eng.pdf.

Buvo įvykdyti pakeitimai (BuyInvoices Response):

Laukas Aprašymas

PaymentInfo.PayToAccount.PayToAccountCode Tiekėjo banko sąskaitos kodą - banko sąskaitos kodą, kurį importuoja iš

ERP

ItemEntry.ItemDimensionInfo Kiekvienai sąskaitos faktūros eilutei - vartotojo pasirinktų dimensijų

reikšmės

ItemEntry.ItemDimensionInfo.DimensionName Dimensijos pavadinimas

ItemEntry.ItemDimensionInfo.ValueCode Dimensijos reikšmės kodas

BillPartyRecord.ContactDataRecord.ContactCode Pirkėjo kontaktinis asmuo - vartotojo pasirinkto kontaktinio asmens ERP kodas (tai nėra "asmens kodas").

<xs:element name="PaymentInfo">

<xs:complexType>

<xs:sequence>

<xs:element name="Currency" type="CurrencyType" />

<xs:choice>

<xs:sequence>

<xs:element name="PaymentDescription" type="PaymentDescriptionType" />

</xs:sequence>

<xs:sequence>

<xs:element name="PaymentRefId" type="ReferenceType" />

<xs:element minOccurs="0" name="PaymentDescription" type="PaymentDescriptionType" />

</xs:sequence>

</xs:choice>

<xs:element name="Payable" type="YesNoType" />

<xs:element minOccurs="0" name="PayDueDate" type="DateType" />

<xs:element name="PaymentTotalSum" type="Decimal2FractionDigitsType" />

<xs:element name="PayerName" type="NormalTextType" />







66/87

<xs:element name="PaymentId" type="NormalTextType" />

<xs:element name="PayToAccount" type="AccountType" />

<xs:element name="PayToAccountCode" type="NormalTextType" />

<xs:element name="PayToName" type="NormalTextType" />

<xs:element minOccurs="0" name="DirectDebitPayeeContractNumber" type="ShortTextType" />

<xs:element minOccurs="0" name="DirectDebitPayerNumber" type="ReferenceType" />

</xs:sequence>

</xs:complexType>

</xs:element>

...

<xs:element name="ItemEntry">

<xs:complexType>

<xs:sequence>

<xs:element minOccurs="0" name="RowNo" type="NormalTextType" />

<xs:element minOccurs="0" name="SerialNumber" type="ShortTextType" />

<xs:element minOccurs="0" name="SellerProductId" type="ShortTextType" />

<xs:element minOccurs="0" name="BuyerProductId" type="ShortTextType" />

<xs:element minOccurs="0" name="TaricCode" type="EncodingType" />

<xs:element minOccurs="0" name="Accounting" type="AccountingRecord" />

<xs:element minOccurs="0" name="CustomerRef" type="NormalTextType" />

<xs:element name="Description" type="LongTextType" />

<xs:element minOccurs="0" name="EAN" type="NormalTextType" />

<xs:element minOccurs="0" name="InitialReading" type="ShortTextType" />

<xs:element minOccurs="0" name="FinalReading" type="ShortTextType" />

<xs:element maxOccurs="unbounded" minOccurs="0" name="ItemReserve" type="ExtensionRecord" />

<xs:element maxOccurs="unbounded" minOccurs="0" name="ItemDetailInfo">

<xs:complexType>

<xs:sequence>

<xs:element minOccurs="0" name="ItemUnit" type="ShortTextType" />

<xs:element minOccurs="0" name="ItemAmount" type="Decimal4FractionDigitsType" />

<xs:element minOccurs="0" name="ItemPrice" type="Decimal4FractionDigitsType" />

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element maxOccurs="unbounded" minOccurs="0" name="ItemDimensionInfo">

<xs:complexType>

<xs:sequence>

<xs:element minOccurs="0" name="DimensionName" type="NormalTextType"/>

<xs:element minOccurs="0" name="ValueCode" type="NormalTextType" />

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element minOccurs="0" name="ItemSum" type="Decimal4FractionDigitsType" />

<xs:element maxOccurs="unbounded" minOccurs="0" name="Addition" type="AdditionRecord" />

<xs:element minOccurs="0" name="VAT" type="VATRecord" />

<xs:element minOccurs="0" name="ItemTotal" type="Decimal4FractionDigitsType" />

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:complexType name="ContactDataRecord">

<xs:sequence>

<xs:element minOccurs="0" name="ContactName" type="NormalTextType" />

<xs:element minOccurs="0" name="ContactCode" type="NormalTextType" />

<xs:element minOccurs="0" name="ContactPersonCode" type="RegType" />

<xs:element minOccurs="0" name="PhoneNumber" type="NormalTextType" />

<xs:element minOccurs="0" name="FaxNumber" type="NormalTextType" />







67/87

<xs:element minOccurs="0" name="URL" type="NormalTextType" />

<xs:element minOccurs="0" name="E-mailAddress">

<xs:simpleType>


<xs:pattern value=".+@+.+" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element minOccurs="0" name="LegalAddress" type="AddressRecord" />

<xs:element minOccurs="0" name="MailAddress" type="AddressRecord" />

<xs:element maxOccurs="unbounded" minOccurs="0"

name="ContactInformation" type="ExtensionRecord" />

</xs:sequence>

</xs:complexType>







68/87







69/87

70/87

20. Registro duomenų integracija

20.1 Dimensijų registro integracija

Dimensijų registrą importuoti galima naudojant ţiniatinklio paslaugą: DimensionRegistry

Užklausos (Request) formatas:

Uţklausos turinys yra specifinio ERP formato, kurį palaiko E. sąskaita sistema.

Uţklausos atributai:

authPhrase – autentikacijos frazė, privalomas.

replace – [YES/NO] ar pilnai pakeisti e. sąskaitų registro duomenis, neprivalomas.

format – duomenų formatas, šiai integracijai = AXAPTA, privalomas.

DimensionRegistry įrašo laukai:

Laukas Privalomas Aprašymas

Dimension Taip Dimensija, Dimensijos pavadinimas.

DimensionValue Taip [1..n] Dimensijos reikšmės.

DimensionValue.Code Taip Dimensijos reikšmės kodas

DimensionValue.Value Taip Dimensijos reikšmė

DimensionValue.RefDimension Ne Susijusi (tėvinė) dimensijos reikšmė

DimensionValue.RefDimension.DimensionName Taip Susijusios (tėvinės) dimensijos pavadinimas

DimensionValue.RefDimension.DimensionValueCode Taip [0..n] Susijusios (tėvinės) dimensijos reikšmės kodas

Default Ne Ar tai pagrindinė dimensija. [YES/NO]

Uţklausos pavyzdys:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:erp="http://esaskaitos.post.lt/erp">

<soapenv:Header/>

<soapenv:Body>

<erp:DimensionRegistryRequest format="?" replace="?" authPhrase="?">



<erp:DimensionRegistry>

<erp:Dimension>?</erp:Dimension>


<erp:DimensionValue>

<erp:Code>?</erp:Code>

<erp:Value>?</erp:Value>



<erp:RefDimension>

<erp:DimensionName>?</erp:DimensionName>

<erp:DimensionValueCode>?</erp:DimensionValueCode>

</erp:RefDimension>

</erp:DimensionValue>

71/87



<erp:Default>?</erp:Default>

</erp:DimensionRegistry>

</erp:DimensionRegistryRequest>

</soapenv:Body>

</soapenv:Envelope>

Atsakymo (Response) formatas:

Atsakymo pavyzdys:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp: DimensionRegistryResponce xmlns:erp="http://esaskaitos.post.lt/erp">

<erp:ResultCode>0</erp:ResultCode>

<erp:ResultMessage>Success! Transfer OK.</erp:ResultMessage>

</erp:DimensionRegistryResponce>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Galimos klaidos:

Klaidos kodas

Klaidos tekstas Aprašymas

59 Duplicate found for unique field Įrašas paţeidţia unikalumo taisyklę.

60 Illegal authentication phrase Blogas authCode autentifikacijos kodas.

80 Unknown error has occurred Neţinoma sistemos klaida

100 Could not import all dimension connections Susijusių dimensijų priskyrimo klaida

210 Referenced object does not exists Susijęs įrašas nerastas

TBD TBD TBD

Klaidos atsakymo pavyzdys:


<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:DimensionRegistryResponce xmlns:erp="http://esaskaitos.post.lt/erp">


<erp:ResultMessage>One or more errors has occurred.</erp:ResultMessage>

<erp:ImportError>

<erp:ErrorCode>210</erp:ErrorCode>

<erp:Message>Referenced object does not exists</erp:Message>

<erp:ObjectIdentifier>38303261028, RefDimension.code=123</erp:ObjectIdentifier>

</erp:ImportError>

</erp:DimensionRegistryResponce>

</SOAP-ENV:Body>


Hierarchinės dimensijų struktūros pavyzdys







72/87

Jei naudojama hierarchinė dimensijų struktūra, siunčiant duomenis ţiniatinklio paslauga reikia „vaikinėms“ dimensi-

joms nurodyti jų „tėvinių“ dimensijų reikšmes. Pavyzdţiui, jei įmonė naudoja paveiksle „Paveikslas 1. Įmonės nau-

dojamos hierarchinės dimensijos pavyzdys“ pavaizduotą dimensijų struktūrą, tai kiekvienai dimensijos „Vietos ko-

das“ reikšmei reikia nurodyti kuriai „Kaštų centro“ dimensijos reikšmei ji priklauso. Taip „surišus“ dimensijų reikš-

mes įtraukiant prekę į apskaitą vartotojas gali pasirinkti vaikinės dimensijos reikšmę, o sistema automatiškai pa-

rinks teisingą tėvinės dimensijos reikšmę.

Ţiniatinklio paslaugos uţklausos fragmentas: ....


<erp:Dimension>Kaštų centras</erp:Dimension>


<erp:Code>VIL</erp:Code>

<erp:Value>Vilniaus kaštų centras</erp:Value>



<erp:Code>KAU</erp:Code>

<erp:Value>Kauno kaštų centras</erp:Value>




<erp:Dimension>Vietos kodas</erp:Dimension>


<erp:Code>VIL_P</erp:Code>

<erp:Value>Vilniaus paštas</erp:Value>

<erp:RefDimension>

<erp:DimensionName>Kaštų centras</erp:DimensionName>

<erp:DimensionValueCode>VIL</erp:DimensionValueCode>

</erp:RefDimension>



<erp:Code>SIR_P</erp:Code>

<erp:Value>Širvintų paštas</erp:Value>

<erp:RefDimension>



</erp:RefDimension>



<erp:Code>SAL_P</erp:Code>

<erp:Value>Šalčininkų paštas</erp:Value>

<erp:RefDimension>



</erp:RefDimension>



<erp:Code>KAU_P</erp:Code>

<erp:Value>Kauno paštas</erp:Value>

<erp:RefDimension>


<erp:DimensionValueCode>KAU</erp:DimensionValueCode>

</erp:RefDimension>







73/87



<erp:Code>JUR_P</erp:Code>

<erp:Value>Jurbarko paštas</erp:Value>

<erp:RefDimension>



</erp:RefDimension>



<erp:Code>SAK_P</erp:Code>

<erp:Value>Šakių paštas</erp:Value>

<erp:RefDimension>



</erp:RefDimension>



...

Paveikslas 1. Įmonės naudojamos hierarchinės dimensijos pavyzdys

Paveikslas 2. E.sąskaitos sistemoje suimportuotos dimensijos ir jų reikšmės

74/87

20.2 Sąskaitų plano registro integracija Uţklausos (Request) formatas:






AccountPlanRegistry įrašo laukai:


AccountNum Taip Sąskaitos numeris

AccountName Taip Sąskaitos pavadinimas

Description Taip Sąskaitos paaiškinimas

RefDimensionName Ne Susieta dimensija



<soapenv:Header/>

<soapenv:Body>

<erp:AccountPlanRegistryRequest format="?" authPhrase="?">


<erp:AccountPlanRegistry>

<erp:AccountNum>?</erp:AccountNum>

<erp:AccountName>?</erp:AccountName>

<erp:Description>?</erp:Description>



<erp:RefDimensionName>?</erp:RefDimensionName>

</erp:AccountPlanRegistry>

</erp:AccountPlanRegistryRequest>

</soapenv:Body>

</soapenv:Envelope>

20.3 Tiekėjų / klientų registro integracija

Tiekėjų registrą importuoti galima naudojant ţiniatinklio paslaugą : SupplierRegistry

75/87

SupplierRegistry įrašo laukai:


CoRegNum Taip Tiekėjo / kliento kodas

AccountNum Ne, jei uţpildytas ClientCode Buhalterinis kodas

ClientCode Ne, jei uţpildytas AccountNum Kliento kodas

Name Taip Tiekėjo / kliento pavadinimas

BankAccounts Ne Tiekėjo / kliento sąskaitos

BankAccounts.BankAccount Ne [0..n] Tiekėjo / kliento sąskaitos eilutė

BankAccounts.BankAccount.Name Taip Sąskaitos pavadinimas

BankAccounts.BankAccount.AccountNum

Taip Sąskaitos NR.

BankAccounts.BankAccount.AccountCode

Ne Sąskaitos kodas (NAV).

Contacts Ne Tiekėjo / kliento kontaktai

Contacts.Email Ne [0..n] Tiekėjo / kliento el. pašto adresas

LegalAddress Ne Apibūdina tiekėjo / kliento registracijos adreso elementus

MailAddress Ne Apibūdina tiekėjo / kliento popierinės sąskaitos faktūros pristatymo adreso elementus

PostalAddress1 Ne Gatvė, namas, butas

PostalAddress2 Ne Kaimas, pašto skyrius ir kt.

City Ne Miestas

PostalCode Ne Pašto kodas

Country Ne Šalis



<soapenv:Header/>

<soapenv:Body>

<erp:SupplierRegistryRequest format="?" replace="?" authPhrase="?">


<erp:SupplierRegistry>

<erp:CoRegNum>?</erp:CoRegNum>






<erp:ClientCode>?</erp:ClientCode>

<erp:Name>?</erp:Name>



<erp:VatCode>?</erp:VatCode>



<erp:ContactPerson>?</erp:ContactPerson>



<erp:Department>?</erp:Department>



<erp:BankAccounts>

76/87


<erp:BankAccount>







<erp:AccountCode>?</erp:AccountCode>

</erp:BankAccount>

</erp:BankAccounts>



<erp:Contacts>

<erp:Email>?</erp:Email>

</erp:Contacts>



<erp:LegalAddress>

<erp:PostalAddress1>?</erp:PostalAddress1>




<erp:City>?</erp:City>

<erp:PostalCode>?</erp:PostalCode>



<erp:Country>?</erp:Country>

</erp:LegalAddress>



<erp:MailAddress>





<erp:City>?</erp:City>

<erp:PostalCode>?</erp:PostalCode>



<erp:Country>?</erp:Country>

</erp:MailAddress>

</erp:SupplierRegistry>

</erp:SupplierRegistryRequest>

</soapenv:Body>

</soapenv:Envelope>


Atsakymo pavyzdys:


<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:SupplierRegistryRequest xmlns:erp="http://esaskaitos.post.lt/erp">




</SOAP-ENV:Body>


Galimos klaidos:







77/87





<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:SupplierRegistryRequest xmlns:erp="http://esaskaitos.post.lt/erp">



<erp:ImportError>


<erp:Message>Duplicate found for unique field</erp:Message>

<erp:ObjectIdentifier>38303261028</erp:ObjectIdentifier>

</erp:ImportError>


</SOAP-ENV:Body>


20.4 Atsakingų asmenų ir skyrių registro integracija

Atsakingų asmenų ir skyrių registrą importuoti galima naudojant ţiniatinklio paslaugą : ResponsiblePersonRegistry.


Uţklausos turinys yra specifinio ERP formato, kurį palaiko E.sąskaita sistema.





ResponsiblePersonRegistry įrašo laukai:


Code Taip Atsakingo asmens unikalus kodas

Name Taip Atsakingo asmens vardas / pavardė

DeparmentName Taip Skyriaus pavadinimas


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:erp="http://esaskaitos.post.lt/erp">

<soapenv:Header/>

<soapenv:Body>

<erp:ResponsiblePersonRegistryRequest format="?" authPhrase="?" replace=“?“ >








78/87

<erp:ResponsiblePersonRegistry>



<erp:DeparmentName>?</erp:DeparmentName>

</erp:ResponsiblePersonRegistry>

</erp:ResponsiblePersonRegistryRequest>

</soapenv:Body>

</soapenv:Envelope>


Atsakymo pavyzdys:


<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:ResponsiblePersonRegistryResponse xmlns:erp="http://esaskaitos.post.lt/erp">



</erp:ResponsiblePersonRegistryResponse>

</SOAP-ENV:Body>


Galimos klaidos:

Klaidos kodas Klaidos tekstas Aprašymas





TBD TBD TBD



<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:ResponsiblePersonRegistryResponse xmlns:erp="http://esaskaitos.post.lt/erp">



<erp:ImportError>




</erp:ImportError>

</erp:ResponsiblePersonRegistryResponse>

</SOAP-ENV:Body>


20.5 Išteklių registro integracija

Išteklių registrą importuoti galima dvejais būdais:

1. Naudojant E. sąskaita sistemą, importuojant CSV failą.

Bendra informacija → Registrai → Paslaugų ir prekių registras → Importuoti paslaugas/prekes

79/87

2. Naudojant ţiniatinklio paslaugą : GoodsRegistry







GoodsRegistry įrašo laukai:


Code Taip Paslaugos / prekės kodas

Name Taip Paslaugos / prekės pavadinimas

ItemUnit Ne [0..n] Matas vienetas

ItemUnit.Name Taip Mato pavadinimas

ItemUnit.Code Taip Mato kodas

ItemPrice Ne Vieneto kaina

ErpCode Ne PVM kodas

AccountingAccountCode Ne Sąskaita

ProjectInfo Ne Projektas

ItemComment Ne Komentaras

Info Ne Kita informacija

PaymentRefId Ne Mokėjimo paskirties kodas (diezas)

RefDimensionName Ne [0..n] Priskirtos privalomos dimensijos


<soapenv:Envelope

xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:erp="http://esaskaitos.post.lt/erp">

<soapenv:Header/>

<soapenv:Body>

<erp:GoodsRegistryRequest format="?" authPhrase="?" >


<erp:GoodsRegistry operation=“INSERT“>






<erp:ItemUnit>



</erp:ItemUnit>

<erp:ItemUnit>?</erp:ItemUnit>



<erp:ItemPrice>?</erp:ItemPrice>

80/87



<erp:ErpCode>?</erp:ErpCode>



<erp:AccountingAccountCode>?</erp:AccountingAccountCode>



<erp:ProjectInfo>?</erp:ProjectInfo>



<erp:ItemComment>?</erp:ItemComment>



<erp:Info>?</erp:Info>



<erp:PaymentRefId>?</erp:PaymentRefId>


<erp:ReferencedDimensionName>?</erp:ReferencedDimensionName>

</erp:GoodsRegistry>

</erp:GoodsRegistryRequest>

</soapenv:Body>

</soapenv:Envelope>


Atsakymo pavyzdys:


<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:GoodsRegistryResponse xmlns:erp="http://esaskaitos.post.lt/erp">



</erp:GoodsRegistryResponse>

</SOAP-ENV:Body>


Galimos klaidos:

Klaidos kodas Klaidos tekstas Aprašymas





TBD TBD TBD



<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:GoodsRegistryResponse xmlns:erp="http://esaskaitos.post.lt/erp">



<erp:ImportError>




</erp:ImportError>

<erp:ImportError>







81/87


<erp:Message>Referenced object does not exists</erp:Message>

<erp:ObjectIdentifier>123 DimName:1112121212</erp:ObjectIdentifier>

</erp:ImportError>

</erp:GoodsRegistryResponse>

</SOAP-ENV:Body>








82/87

21 Kitos integracijos

21.1 Pirkimo sąskaitos faktūros PDF gavimas

BuyInvoicePdf siunčia tik pirkimo sąskaitų faktūrų PDF failus. Failai prie sąskaitos faktūros pridėti

kaip priedai – nesiunčiami.





invoiceid – pirkimo sąskaitos faktūros ID, kurios PDF sąskaitą faktūrą norima gauti.

Užklausos pavyzdys: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:erp="http://esaskaitos.post.lt/erp">

<soapenv:Header/>

<soapenv:Body>

<erp:BuyInvoicePdfRequest authPhrase="85327:oszpjkuzsuakab..." invoiceId="232916"/>

</soapenv:Body>

</soapenv:Envelope>

21.2 Duomenų siuntimas iš ERP į e. sąskaitų sistemą

BuyInvoiceRegistered ţiniatinklio paslaugos funkcionalumas leidţia parsisiųsti duomenis iš ERP sistemos į E. są-

skaita sistemą. Jis gali būti naudojamas norint atvaizduoti kai kurias sąskaitos faktūros detales E. sąskaita sistemo-

je. Tai atvirkštinis duomenų sinchronizacijos būdas reikalaujantis invoiceId atributo, kurį E. sąskaita sistema siunčia

kartu su sąskaita faktūra. Šis atributas identifikuoja sąskaitą faktūrą E.sąskaita sistemoje.

BuyInvoiceRegisteredRequest uţklausa gali būti naudojama parsisiųsti atgal ERP sistemoje uţregistruotų sąskaitų

faktūrų duomenis.





RegisteredInvoice – elementas gali būti naudojamas iki 1000 kartų.

invoiceId – siunčiama į ERP kaip Invoice.invoiceId atributo reikšmė per BuyInvoiceRequest atsakymą


<soapenv:Header/>

<soapenv:Body>

<erp:BuyInvoiceRegisteredRequest authPhrase="85327:oszpjkuzsuakab...">







83/87

<erp:RegisteredInvoice invoiceId="232916">

<erp:ErpDocumentNumber>ABC112</erp:ErpDocumentNumber>

</erp:RegisteredInvoice>

</erp:BuyInvoiceRegisteredRequest>

</soapenv:Body>

</soapenv:Envelope>


BuyInvoiceRegistered atsakymas yra SimpleResponseType tipo, kuriame pateikiama ErrorCode =0, jei duomenų

perdavimas buvo sėkmingas.

21.3 Įmonės būsenos užklausa

Su šia uţklausa galima gauti kitų E. sąskaita sistemos įmonių būseną sistemoje. Ši informacija gali būti naudojama

norint suţinoti ar sąskaitos faktūros gavėjas gali gauti ją per E.sąskaita sistemą.





RegNumber– ieškomos įmonės registracijos kodas. Galima naudoti 0 – n elementų. Jeigu uţklausoje ne-

naudojamas RegNumber elementas ţiniatinklio paslauga pateikia visas aktyvias E. sąskaita sistemos įmo-

nes.


<soapenv:Header/>

<soapenv:Body>

<erp:CompanyStatusRequest authPhrase="85327:oszpjkuzsuakab...">

<erp:RegNumber>1234567</erp:RegNumber>



</erp:CompanyStatusRequest>

</soapenv:Body>

</soapenv:Envelope>

Atsakymo (Response) formatas: <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:CompanyStatusResponse xmlns:erp="http://esaskaitos.post.lt/erp">

<erp:CompanyActive regNumber="1234567">YES</erp:CompanyActive>

<erp:CompanyActive regNumber="123546">NO</erp:CompanyActive>

<erp:CompanyActive regNumber="247452060">YES</erp:CompanyActive>

</erp:CompanyStatusResponse>

</SOAP-ENV:Body>








84/87

21.4 Pirkimo sąskaitos faktūros priedų gavimas

Visi pirkimo sąskaitų faktūrų priedai atsiunčiami naudojantis InvoiceAttachment ţiniatinklio paslauga. Priedai gau-

nami tik tų pirkimo sąskaitų faktūrų, kuriose pirkėjo dalis (BuyerParty) atitinka savininko atpaţinimo kodą.





onlyInvoice – parsiunčiamas tik pagrindinis sąskaitos faktūros priedas. Neprivalomas laukas, YesNoType

tipas. Pagal nutylėjimą naudojama reikšmė „No“.

startIndex – naudojama gauti priedus, kurie nebuvo įtraukti į praėjusį atsakymą kadangi buvo pasiekta

maksimali pateikiamų rezultatų riba. Privalomas atributas, maţiausia reikšmė – 1.

invoiceId – unikalus sąskaitos faktūros identifikatorius E.sąskaita sistemoje, kuris grąţinamas per BuyIn-

voiceResponse. Tai yra BuyInvoiceResponse -> E_Invoice -> Invoice @invoiceId atributo reikšmė.


<soapenv:Header/>

<soapenv:Body>

<erp:InvoiceAttachmentRequest authPhrase="85327:oszpjkuzsuakab..." startIndex="1" onlyInvoice="NO">

<erp:invoiceId>232950</erp:invoiceId>

</erp:InvoiceAttachmentRequest>

</soapenv:Body>

</soapenv:Envelope>


Atsakymas sudarytas iš riboto kiekio priedų pagal uţklausoje aprašytas sąskaitas faktūras. Atsakymo atributas

nextAttachmentIndex naudojamas nustatyti ar atsakyme pateikti visi galimi priedai ar reikia naudoti papildomas

uţklausas norint gauti likusius priedus. Iš viso gautų priedų skaičiavimas: totalResultCount = startIndex + esamas

rezultatas -1.

Jeigu nextAttachmentIndex <= totalResultCount, tai atsakyme pateikti visų uţklausoje aprašytų sąskaitų

faktūrų priedai.

Jeigu nextAttachmentIndex > totalResultCount, tai reiškia jog yra daugiau priedų nei pateikta šiame atsa-

kyme bei reikalinga papildoma uţklausa norint gauti likusius priedus. Sekančioje uţklausoje startIndex atri-

buto reikšmė turi būti nustatyta nextAttachmentIndex atributo reikšmė iš prieš tai buvusios uţklausos atsa-

kymo.

InvoiceAttachment elementas turi nuorodos atributą į sąskaitą faktūrą, failo pavadinimą, failo tipą bei origi-

nalaus failo dydţio atributą.

o fileName – pridėto failo pavadinimas.

o fileType – pridėto failo plėtinys.







85/87

o length – failo dydis baitais.

o invoiceId – nuoroda į sąskaitą faktūrą.

o isMain – YES jeigu tai yra pagrindinis sąskaitos faktūros PDF failas, NO – reikšmę turi visi kiti sąskaitos faktūros priedai.

InvoiceAttachment -> AttachmentContent turi base64 kodavimo standartu uţkoduotą failą.


<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<erp:InvoiceAttachmentResponse nextAttachmentIndex="21" xmlns:erp="http://esaskaitos.post.lt/erp">

<InvoiceAttachment fileName="Akcinė bendrovė Lietuvos Paštas SF102.pdf" fileType="application/pdf" invoiceId="232950" isMain="NO" length="74920">

<AttachmentContent>Uţkoduotas failas</AttachmentContent> </InvoiceAttachment>

</erp:InvoiceAttachmentResponse>

</SOAP-ENV:Body>


21.5 Patvirtinimo atšaukimas

Ţiniatinklio paslauga gali būti naudojamas patvirtinimo atšaukimui per ERP sistemą, jeigu pirkimo sąskaita faktūra

yra būsenoje „Patvirtinta“ (verified). Patvirtinimo atšaukimas gali būti vykdomas naudojant

RejectConfirmationRequest uţklausą.

Palaikomi keli atšaukimo tipai:

REJECT – sąskaitos faktūros tvirtinimas yra atšauktas ir sąskaita faktūra įgauna būseną „Atšaukta“ (Rejec-

ted).

REJECT_AND_RESEND – sąskaitos faktūros tvirtinimas yra atšauktas, tačiau naudojant tuos pačius tvir-

tintojus pradedamas naujas patvirtinimo ciklas. Sąskaita faktūra įgauna būseną „Tvirtinama“ (Awaiting con-

firamtion).

REJECT_AND_RESEND_TO_LAST – sąskaita faktūra nusiunčiama tvirtinimui paskutiniam tvirtinimo

grandinėlės tvirtintojui.

o Jeigu naudojamas lygiagretus tvirtinimo tipas tai šis atšaukimo tipas veikia taip pat kaip REJECT_AND_RESEND.

o Paskutinis tvirtintojas nustatoma pagal tvirtinimo eilės nr.

o Visi tvirtintojai informuojami el. paštu.



Uţklausos atributai identifikuojantys klientą:


regNumber – vartotojo registracijos nr. kuris vykdo patvirtinimo atšaukimą, neprivalomas.

name – vartotojo vardas, kuris vykdo patvirtinimo atšaukimą, privalomas.

Uţklausos turinys apibūdinantis atmetimo prieţastį. Jame yra RejectContent elementas su šiais atributais:

86/87

rejectType – vienas iš palaikomų atmetimo tipų (REJECT, REJECT_AND_RESEND arba RE-

JECT_AND_RESEND_TO_LAST), privalomas.

invoiceId - unikalus sąskaitos faktūros identifikatorius eSąskaitų sistemoje, privalomas.

Šio elemento turinyje perduodamas komentaras, privalomas.


<soapenv:Header/>

<soapenv:Body>

<erp:RejectConfirmationRequest name="Tadas Lingė" regNumber="47501011234" authPhrase="1234:xcasdasfs...">



<erp:RejectContent rejectType="REJECT" invoiceId="125494">Klaida sąskaitoje faktūroje</erp:RejectContent>

</erp:RejectConfirmationRequest>

</soapenv:Body>

</soapenv:Envelope>

Galimos klaidos:

Jeigu pagal nurodytą invoiceId surastos sąskaitos faktūros būsena nėra „Patvirtinta“ (Verified), tai grąţinama klaida

„90 - Invoice in wrong state“ ir neatliekami jokie veiksmai su sąskaita faktūra.







87/87

22 Priedai

Failas Aprašymas

eArvekeskus Integration

Specification_ver2_2_15.pdf

E. sąskaita sistemos integracijos su ERP sistemomis

dokumentas.

e-invoice_ver1_1_eng.pdf E. sąskaitos struktūros aprašas su paaiškinimais.

elektroninių sąskaitų sistema metodiniai ir techniniai ... metodiniai ir... · 17. integracijos...

Documents