Dokumentácia k XML exportom/importom dokladov verzie 2.0 - agenda Faktúry vydané ---------------------------------------------------------------------------------------------------- Štruktúra XML verzie 2.0 je tvorená obálkou nasledovanou hlavným uzlom podla agendy (napr. , , ...) Príklad : ... ... ... ... Kódová stránka dát je Windows-1250. Keďže je XML vačšinou kódované v UTF-8, elementy by nemaly obsahovat znaky, ktoré sa v kódování Windows-1250 nevyskytujú. Popis elementů ============== Identiofikácia firmy (adresa firmy z nastavenia programu). Cesta (XPath uzol): Identification ==================================================================================================== CompanyId string (12) IČO - jednoznačný identifikátor adresy Name string (50) Firma Name2 string (50) Firma 2 CustomerName string (30) Meno Street string (30) Ulica City string (30) Mesto Country string (30) Štát CountryCode string (2) Kód štátu podľa číselníka štátu. Napr. CZ - Česká republika, SK - Slovensko ShortNote string (30) Iné ZipCode string (15) PSČ VatNumber string (17) DIČ (VAT identification number), formát čísla napr. CZ99999999, SK9999999999, DE999999999. Viz: http://ec.europa.eu/taxation_customs/vies/faq.html?locale=en#item_11. SK verze: DIČ dle SK legislativy, např. 1999999999, 2999999999 Phone string (30) Telefón Phone2 string (30) Telefón 2 Phone3 string (30) Telefón 3 Fax string (30) Fax Email string (256) Email NaturalPerson boolean Príznak typu firmy - "T" - fyzická osoba, "F" - právnická osoba ==================================================================================================== Identiofikácia firmy - bankové účty. Cesta (XPath uzol): Identification/BankAccounts/BankAccount Nepovinný uzol ==================================================================================================== Name string (100) Názov banky AccountNumber string (18) Číslo účtu vo formáte 6+10. Vyplňuje sa iba pre CZ alebo SK BankCode string (12) Numerický kód banky. Vyplňuje se iba pre CZ nebo SK SWIFT string (11) SWIFT kód IBAN string (34) číslo účtu v medzinárodnom tvare ==================================================================================================== Hlavička dokladov. Cesta (XPath uzel): IssuedInvoices/Invoice ==================================================================================================== DocumentNumber string (10) Číslo dokladu, jednoznačný identifikátor, niesu povolené duplicity. IssueDate date Dat.vystavenia CurrencyCode string (3) Mena dokladu. Odpovedá číselníku mien. Napr. "EUR", "CZK", "USD" a pod. ValuesWithTax boolean Spôsob zadávania čiastok (CENAMJ) v položkách dokladu. "T" - čiastky zadávané v cenách s DPH, "F" - čiastky zadávané v cenách BEZ DPH TaxCode integer Typ DPH, odpovedá číselniku Typov DPH. Napr. Tuzemské zdaniteľné obchody §8,9. - 10 (pro CZ verzi 41) , Tuzemská daň z tovarov a služieb plnný nárok na odpočet. - 40 (pro CZ verzi 71), Neovplyvňujúce DPH - 19 , Neovplyvňujúce DPH - 39 DocType string (2) Typ dokladu, odpovedá číselníku Typy dokladov. Napr. " "- běžný daňový doklad, "D"-dobropis, "V"-vrubopis,.. ZeroTaxRateAmount decimal (15,2) Čiastka Oslobodené - hodnota osvobodené od DPH (v lokálnej mene) ReducedTaxRateAmount decimal (15,2) Suma čiastok základov dph pre znížené sadzby (v lokálnej mene) BaseTaxRateAmount decimal (15,2) Suma čiastok základov dph pre základné sadzby (v lokálnej mene) RoundingAmount decimal (15,2) Čiastka MIMODPH - hodnota nedanená (v lokálnej mene) ReducedTaxRateTax decimal (15,2) Suma čiastok DPH pre znížené sadzby (v lokálnwj mene) BaseTaxRateTax decimal (15,2) Suma čiastok DPH pre základní sadzby (v lokálnej mene) TotalWithTaxCurr decimal (15,2) Celková čiastka v zahr.mene TaxPointDate date Dan.povinnost DeliveryDate date Dátum dodania /Dátum pre Kontrólne hlášenie ControlStatement_Leasing boolean Príznak leasingu TotalWeight decimal (15,6) Hmotnosť tovaru za doklad celkom CostCentre string (6) Nákladové stredisko. ContractNumber string (15) Zákazka. V prípade vyplnenia, musí odpovedať uživateľskému číselníku Zakaziek. Výchozia hodnota "0" VatRegime integer Režim DPH:0-Bežný tuzemský,1-Registrace v EU,2-OSS(MOSS) VatCountry string (2) Štát DPH - kód členskej krajiny EU. Pre režim DPH=0(bežný tuzemský) vždy "SK" pro slovenskou verzi programu alebo "CZ" pro českou verzi VatNumber string (17) DIČ (VAT identification number), formát čísla napr. CZ99999999, SK9999999999, DE999999999. Viz: http://ec.europa.eu/taxation_customs/vies/faq.html?locale=en#item_11. SK verze: DIČ dle SK legislativy, např. 1999999999, 2999999999 ImportParams decimal (1,0) Volitelný parameter pre nastavenie prepočtu celkových čiastok po naimportování. 0 - Nespecifikované , 1 - Neprepočítať, 2 - Prepočítať CalcParams string (200) Parametre výpočtu dokladu - počet.des.míst, způsob zaokrouhlení, atd... VariableSymbol string (10) Variabilný symbol ConstantSymbol string (8) Konšt.symbol PaymentDueDate date Dat.splatnosti CurrRateAmount decimal (15,6) Kurz - počet jednotiek. Pri dokladoch v lokálnej(domácej) mene = 1.0000 CurrRate decimal (15,6) Kurz. pri dokladoch v lokálnej(domácej) mene = 1.0000 SpecificSymbol string (10) Špecif.symb. InvoiceType string (1) Druh faktúry: "F"-bežná, "X"-predfaktúra, "P"-penalizačná DeliveryNoteID string (10) Č.dod.listu ProformaInvoiceID string (10) Číslo predfaktúry PaymentMeansCode string (10) Forma úhrady DeliveryTypeCode string (10) Zpôsob dopravy OrderNumber string (20) Číslo objednávky PaidAmount decimal (15,2) Čiastka reálne zaplatená Poznámka k celkovým čiastkam Elementy , , , obsahujú sumu čiastok vo všetkých úrovniach sadzieb - prvá, druhá snížená apod. (pokud to legislatíva umožňuje) Ak daňový doklad obsahuje viac základných alebo viac znížených sadzieb dph, musí XML obsahovat ich podrobný rozpis v uzlu IssuedInvoices/Invoice/SumValues Rozšírený popis elementu CalcParams Príklad řetězce : UPDP=2; UPDP - UnitPriceDecimalPlaces ... Počet desetinných miest Ceny za mernou jednotku (rozsah 1..6) ==================================================================================================== Firemné údaje obchodného partnera (protistrany). Cesta (XPath uzol): IssuedInvoices/Invoice/Company ==================================================================================================== CompanyId string (12) IČO - jednoznačný identifikátor adresy Name string (50) Firma Name2 string (50) Firma 2 CustomerName string (30) Meno Street string (30) Ulica City string (30) Mesto Country string (30) Štát CountryCode string (2) Kód štátu podľa číselníka štátu. Napr. CZ - Česká republika, SK - Slovensko ShortNote string (30) Iné ZipCode string (15) PSČ VatNumber string (17) DIČ (VAT identification number), formát čísla napr. CZ99999999, SK9999999999, DE999999999. Viz: http://ec.europa.eu/taxation_customs/vies/faq.html?locale=en#item_11. SK verze: DIČ dle SK legislativy, např. 1999999999, 2999999999 Phone string (30) Telefón Phone2 string (30) Telefón 2 Phone3 string (30) Telefón 3 Fax string (30) Fax Email string (256) Email NaturalPerson boolean Príznak typu firmy - "T" - fyzická osoba, "F" - právnická osoba ==================================================================================================== Firemné údaje obchodného partnera (protistrany) - bankové účty. Cesta (XPath uzol): IssuedInvoices/Invoice/Company/BankAccounts/BankAccount Nepovinný uzol ==================================================================================================== Name string (100) Názov banky AccountNumber string (18) Číslo účtu vo formáte 6+10. Vyplňuje sa iba pre CZ alebo SK BankCode string (12) Numerický kód banky. Vyplňuje se iba pre CZ nebo SK SWIFT string (11) SWIFT kód IBAN string (34) číslo účtu v medzinárodnom tvare ==================================================================================================== Položky(riadky) dokladov. Cesta (XPath uzol): IssuedInvoices/Invoice/Items/Item ==================================================================================================== Description string (100) Text TaxCode integer Typ DPH, odpovedá číselniku Typov DPH. Napr. Tuzemské zdaniteľné obchody §8,9. - 10 (pro CZ verzi 41) , Tuzemská daň z tovarov a služieb plnný nárok na odpočet. - 40 (pro CZ verzi 71), Neovplyvňujúce DPH - 19 , Neovplyvňujúce DPH - 39 ItemType string (10) Typ položky, zoodpovedá uživatelskému číselníku Typy položiek. Nepovinné. UnitCode string (3) Merná jednotka - napr. "ks", "kg", "t", "m2" apod. Quantity decimal (15,6) Počet MJ UnitPrice decimal (15,6) Cena MJ v mene dokladu bez DPH. Platí (CenaMJ-SlevaMJ)*PocetMJ=Celkom za ridok dokladu bez DPH TaxPercent decimal (15,2) Percentuálna výška sazby DPH (0 = Oslobodené, 99 = MimoDPH) TaxAmount decimal (15,6) Čiastka DPH za MJ v mene dokladu DiscountPercent decimal (15,2) Percentuálna výška zlavy za položku dokladu. StockCardNumber decimal (15,2) Číslo skladovej karty TotalWeight decimal (15,6) Hmotnosť za MJ ==================================================================================================== Celkové súčty dokladov. Cesta (XPath uzol): IssuedInvoices/Invoice/SumValues/SumValue Nepovinné, pokiaľ daňový doklad obsahuje iba jednu základnú a jednu zníženú sazbu dph ==================================================================================================== TaxCode integer Typ DPH, odpovedá číselniku Typov DPH. Napr. Tuzemské zdaniteľné obchody §8,9. - 10 (pro CZ verzi 41) , Tuzemská daň z tovarov a služieb plnný nárok na odpočet. - 40 (pro CZ verzi 71), Neovplyvňujúce DPH - 19 , Neovplyvňujúce DPH - 39 TaxType integer Typ sazby: 0-Nedefinovaná, 1-Základná, 2-Znížená, 3-oslobodené od DPH, 4-MimoDph TaxTypeSTR integer Pre SK sa preberie celý typ sazby: A1- základná ,B1 - znížená , M- mimo (4), O- oslobodené od DPH (3) TaxPercent decimal (15,2) Percentuálna výška sazby DPH (0 = Oslobodené, 99 = MimoDPH) Amount decimal (15,2) Čiastka základu Tax decimal (15,2) Čiastka DPH TaxCurrRateReverseChargeTax decimal (15,2) Čiastka DPH - Reverse Charge - vypočítaná DPH TaxApplied decimal (15,2) Čiastka odpočtu DPH (nárok na odpočet) CurrencyCode string (3) Mena úhrady ==================================================================================================== Úhrady dokladov. Cesta (XPath uzll): IssuedInvoices/Invoice/Payments/Payment Nepovinný uzol ==================================================================================================== PaymentDate date Datum DocumentNumber string (10) Doklad Amount decimal (15,2) Čiastka úhrady v lokálnej mene AmountCurr decimal (15,2) Čiastka úhrady v zahraničnej mene AmountPaidDocumentCurr decimal (15,2) Částka úhrady v mene dokladu(faktury) CurrencyCode string (3) Mena úhrady CurrRate decimal (15,6) Kurz. U dokladov v lokálnej(domácej) mene = 1.0000 CurrRateAmount decimal (15,6) Kurz - počet jednotiek. U dokladov v lokálnej(domácej) mene = 1.0000 OldDocumentNumber string (10) Číslo dokladu v ktorm bola uhrada ==================================================================================================== Adresa konečného príjemcu. Cesta (XPath uzel): IssuedInvoices/Invoice/DeliveryAddress Nepovinný uzol ==================================================================================================== CompanyId string (12) IČO AddressId string (50) ID adresy - jednoznačný identifikátor adresy. Pro výměnu dat s externím systémem (např. eshop) Name string (50) Firma Name2 string (50) Firma 2 CustomerName string (30) Jméno Street string (30) Ulice City string (30) Město Country string (30) Stát CountryCode string (2) Kód státu dle číselníku států. Např. CZ - Česká republika, SK - Slovensko ShortNote string (30) Jiné ZipCode string (15) PSČ VatNumber string (17) CZ verze: DIČ dle CZ legislativy (VAT identification number), formát čísla např. CZ99999999, SK9999999999, DE999999999. Viz: http://ec.europa.eu/taxation_customs/vies/faq.html?locale=en#item_11. SK verze: DIČ dle SK legislativy, např. 1999999999, 2999999999 VatNumberSK string (14) CZ verze: nepoužívá se. SK verze: IČ DPH (VAT identification number). Formát čísla např. CZ99999999, SK9999999999, DE999999999. Viz: http://ec.europa.eu/taxation_customs/vies/faq.html?locale=en#item_11 Phone string (30) Telefon Phone2 string (30) Telefon 2 Phone3 string (30) Telefon 3 Fax string (30) Fax Email string (256) Email NaturalPerson boolean Příznak typu firmy - "T" - fyzická osoba, "F" - právnická osoba ===================================================================================================================== Adresa konečného príjemcu - bankové účty. Cesta (XPath uzol): IssuedInvoices/Invoice/Company/BankAccounts/BankAccount Nepovinný uzol ===================================================================================================================== Name string (100) Názov banky AccountNumber string (18) Číslo účtu vo formáte 6+10. Vyplňuje sa iba pre CZ alebo SK BankCode string (12) Numerický kód banky. Vyplňuje se iba pre CZ nebo SK SWIFT string (11) SWIFT kód IBAN string (34) číslo účtu v medzinárodnom tvare