Dokumentace k XML exportům/importům dokladů verze 2.0 ---------------------------------------------------------------------------------------------------- (vytvořeno ve verzi MRP-K/S 5.92(001), 11.06.2019) Agenda Faktury přijaté ==================================================================================================== Hlavičkové údaje dokladu. Cesta (XPath uzel): IncomingInvoices/Invoice ==================================================================================================== DocumentNumber string (10) Číslo dokladu, jednoznačný identifikátor, nejsou povoleny duplicity. IssueDate date Dat.vystavení CurrencyCode string (3) Měna dokladu. Odpovídá číselníku měn. Např. "CZK", "EUR", "USD" apod. ValuesWithTax boolean Způsob zadávání částek (CENAMJ) v položkách dokladu. "T" - částky zadávány v cenách s DPH, "F" - částky zadávány v cenách BEZ DPH TaxCode integer Typ DPH, odpovídá číselníku Typy DPH. Např. 41 - Tuzemské uskut. pln., 71 - Tuzemské přij.pln., 19 - Nedaňový doklad uskutečněný, 39 - Nedaňový doklad přijatý DocType string (2) Typ dokladu, odpovídá číselníku Typy dokladů. Např. " "- běžný daňový doklad, "D"-dobropis, "V"-vrubopis,.. ZeroTaxRateAmount decimal (15,2) Částka Osvobozeno - hodnota plnění osvobozených od DPH (v lokální měně) ReducedTaxRateAmount decimal (15,2) Částka základu dph pro sníženou sazbu (v lokální měně) BaseTaxRateAmount decimal (15,2) Částka zakladu dph pro základní sazbu (v lokální měně) RoundingAmount decimal (15,2) Částka MIMODPH - hodnota nedaněná (v lokální měně) ReducedTaxRateTax decimal (15,2) Částka DPH - snížená sazba (v lokální měně) BaseTaxRateTax decimal (15,2) Částka DPH - základní sazba (v lokální měně) TotalWithTaxCurr decimal (15,2) Celková částka v zahr.měně TaxPointDate date Odpočet daně DeliveryDate date Datum dodání /Datum pro Kontrolní hlášení DoubleEntryBookkeepingCode decimal (15,3) Číslo účetní předkontace, nepovinné. Odkazuje do číselníku "Účetní předkontace". Pro účetnictví (podvojné). SingleEntryBookkeepingCode integer Kód pohybu zaúčtování pro Daňovou evidenci (Syntet.) SingleEntryBookkeepingSubCode integer Kód pohybu zaúčtování pro Daňovou evidenci (analyt.) OriginalDocumentNumber string (50) Původní číslo dokladu/Evidenční číslo daň.dokladu (číslo v evidenci vystavitele dokladu). ControlStatement_Leasing boolean Příznak leasingu nad limit 10.000,- pro Kontrolní hlášení v CZ verzi programu TotalWeight decimal (15,6) Hmotnost zboží za doklad celkem CostCentre string (6) Nákladové středisko. V případě vyplnění musí odpovídat uživatelskému číselníku Střediska. Výchozí hodnota "0" ContractNumber string (15) Zakázka. V případě vyplnění, musí odpovídat uživatelskému číselníku Zakázky. Výchozí hodnota "0" VatRegime integer Režim DPH:0-Běžný tuzemský,1-Registrace v EU,2-MOSS VatCountry string (2) Stát DPH - kód členské země EU. Pro režim DPH=0(běžný tuzemský) vždy "CZ" pro českou verzi nebo "SK" pro slovenskou verzi programu VatNumber string (17) VAT reg.č.(DIČ) pro Režimy DPH 1 (EU) a 2(MOSS). Registrační číslo přidělené k placení DPH v jiném členském státě EU. Pokud je uvedeno, musí odpovídat číselníku "Registrace platců v zemích EU". EURExchangeRate decimal (15,6) Kurz Měna dokladu/EUR. Pro vystavené doklady v režimu MOSS v CZ verzi programu EURExchangeRateAmount decimal (15,6) Kurz Měna dokladu/EUR - počet jednotek. Pro vystavené doklady v režimu MOSS v CZ verzi programu Note string (1024) Poznámka CalcParams string (200) Parametry výpočtu dokladu - počet.des.míst, způsob zaokrouhlení, atd... UserField1 string (40) Uživ.pole 1 UserField2 string (40) Uživ.pole 2 UserField3 string (40) Uživ.pole 3 UserField4 string (40) Uživ.pole 4 UserField5 string (40) Uživ.pole 5 VariableSymbol string (10) Variabilní symbol ConstantSymbol string (8) Konst.symbol CreditNoteOriginalNumber string (50) Původní číslo opravovaného dokladu - číslo dobropisované/vrubopisované faktury . Důležité v SK verzi pro DPH Kontrolný výkaz PaymentDueDate date Dat.splatnosti CurrRateAmount decimal (15,6) Kurz - počet jednotek. U dokladů v lokální(domácí) měně = 1.0000 CurrRate decimal (15,6) Kurz. U dokladů v lokální(domácí) měně = 1.0000 PaidAmount decimal (15,2) Celkem zaplaceno. Pomocná počítaná položka. Suma úhrad v lokální měně PaidAmountCurr decimal (15,2) Celkem zaplaceno v měně dokladu. Pomocná počítaná položka. Suma úhrad v měně, ve které je doklad vystaven SpecificSymbol string (10) Specif.symb. InvoiceType string (1) Druh faktury: "F"-běžná, "X"-předfaktura, "P"-penalizační DeliveryNoteID string (10) Č.dod.listu ProformaInvoiceID string (10) Číslo předfaktury PaymentMeansCode string (10) Forma úhrady DeliveryTypeCode string (10) Způsob dopravy OrderNumber string (20) Číslo objednávky OrderDate date Dat.objednávky PaymentInvoiceID string (10) Příznak zaplacení předfaktury. Číslo daň.dokladu, který vznikl z této předfaktury funkcí "..označit předfakturu za zaplacenou". Z externích systémů neplňte. ReverseChargeReducedTaxRateAmount decimal (15,2) Částka základu, snížená sazba - Reverse Charge - vypočítaná DPH (EU/dovoz/celnice) (v lokální měně) ReverseChargeBaseTaxRateAmount decimal (15,2) Částka základu, základní sazba - Reverse Charge - vypočítaná DPH (EU/dovoz/celnice) (v lokální měně) ReverseChargeReducedTaxRateTax decimal (15,2) Částka DPH, snížená sazba - Reverse Charge - vypočítaná DPH(EU/dovoz/celnice) (v lokální měně) ReverseChargeBaseTaxRateTax decimal (15,2) Částka DPH, základní sazba - Reverse Charge - vypočítaná DPH(EU/dovoz/celnice) (v lokální měně) TaxPointDate2 date Daň.povinnost TaxCurrRate decimal (15,6) Kurz - počet jednotek. U dokladů v lokální(domácí) měně = 1.0000 TaxCurrRateAmount decimal (15,6) Kurz. U dokladů v lokální(domácí) měně = 1.0000 TaxCurrRateZeroTaxRateAmount decimal (15,2) Částka Osvobozeno pro daňový kurz (v lokální měně) TaxCurrRateReducedTaxRateAmount decimal (15,2) Částka základu pro daňový kurz - snížená sazba (v lokální měně) TaxCurrRateBaseTaxRateAmount decimal (15,2) Částka základu pro daňový kurz - základní sazba (v lokální měně) TaxCurrRateRoundingAmount decimal (15,2) Částka Mimo DPH pro daňový kurz (v lokální měně) TaxCurrRateReducedTaxRateTax decimal (15,2) Částka DPH pro daňový kurz - snížená sazba (v lokální měně) TaxCurrRateBaseTaxRateTax decimal (15,2) Částka DPH pro daňový kurz - snížená sazba (v lokální měně) TaxCurrRateReverseChargeReducedTaxRateAmount decimal (15,2) Částka základu pro daňový kurz, snížená sazba - Reverse Charge - vypočítaná DPH (EU/dovoz/celnice) (v lokální měně) TaxCurrRateReverseChargeBaseTaxRateAmount decimal (15,2) Částka základu pro daňový kurz, základní sazba - Reverse Charge - vypočítaná DPH (EU/dovoz/celnice) (v lokální měně) TaxCurrRateReverseChargeReducedTaxRateTax decimal (15,2) Částka DPH pro daňový kurz, snížená sazba - Reverse Charge - vypočítaná DPH(EU/dovoz/celnice) (v lokální měně) TaxCurrRateReverseChargeBaseTaxRateTax decimal (15,2) Částka DPH pro daňový kurz, základní sazba - Reverse Charge - vypočítaná DPH(EU/dovoz/celnice) (v lokální měně) Rozšířený popis elementu CalcParams Parametry výpočtu dokladu jsou řetězec složený z dílčích parametrů ve tvaru [Zkratka_Dílčího_Parametru]=[Hodnota_Dílčího_Parametru] oddělených středníkem. Žádný z dílčích parametrů není povinný a na jejich pořadí uvnitř celého řetězce nezáleží. Příklad řetězce : UPDP=2;VATRU=0.10;VATRM=0;TRU=1.00;TRM=0;VATCA=1;VATCUPA=0;TRD=1;TRDCA=1;VATFRB=0 Jednotlivé dílčí parametry jsou tyto: UPDP - UnitPriceDecimalPlaces ... Počet desetinných míst Ceny za měrnou jednotku (rozsah 1..4, pro SK verzi 1..6) VATRU - VATRoundingUnit ... Zaokrouhlování DPH - jednotky (např. 1.00, 0.10, 0.01). Pouze pro CZ verzi. VATRM - VATRoundingMethod ... Zaokrouhlování DPH - způsob (0 - přirozeně, 1 - dolů, 2 - nahoru, 3 - bankéřské zaokrouhlení). Pouze pro CZ verzi. TRU - TotalRoundingUnit ... Zaokrouhlování celkové částky dokladu - jednotky (např. 1.00, 0.10, 0.01) TRM - TotalRoundingMethod ... Zaokrouhlování celkové částky - způsob (0 - přirozeně, 1 - dolů, 2 - nahoru, 3 - bankéřské zaokrouhlení) VATCA - VATCoefficientApplication - Pro výpočet celkové DPH použít Koeficient DPH (0 - nepoužít, 1 - použít). Pouze pro CZ verzi. VATCUPA - VATCoefficientUnitPriceApplication - Pro výpočet jednotkové DPH použít Koeficient DPH (0 - nepoužít, 1 - použít). Pouze pro CZ verzi. TRD - TotalRoundingDissolving - Rozpuštění celkového zaokrouhlení (0 - rozpustit do částky MIMODPH, 1 - rozpustit do ZAKLAD+DPH) TRDCA - TotalRoundingDissolvingCoefficientApplication - Pro rozpuštění zaokrouhlení použít Koeficient DPH (0 - podle způsobu výpočtu dokladu, 1 - vždy použít koeficient). Pouze pro CZ verzi a TRD=1. VATFRB - VATFromRoundedBase - Celkovou DPH počítat ze zaokrouhleného základu (0 - z nezaokrouhleného, 1 - ze zaokrouhleného). Pouze SK verze. ==================================================================================================== Firemní údaje obchodního partnera (protistrany). Cesta (XPath uzel): IncomingInvoices/Invoice ==================================================================================================== Company/CompanyId string (12) IČO Company/AddressId string (50) ID adresy - jednoznačný identifikátor adresy. Pro výměnu dat s externím systémem (např. eshop) Company/Name string (50) Firma Company/Name2 string (50) Firma 2 Company/CustomerName string (30) Jméno Company/Street string (30) Ulice Company/City string (30) Město Company/Country string (30) Stát Company/CountryCode string (2) Kód státu dle číselníku států. Např. CZ - Česká republika, SK - Slovensko Company/ShortNote string (30) Jiné Company/ZipCode string (15) PSČ Company/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 Company/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 Company/Phone string (30) Telefon Company/Phone2 string (30) Telefon 2 Company/Phone3 string (30) Telefon 3 Company/Fax string (30) Fax Company/Email string (256) Email Company/Note string (1024) Poznámka Company/NaturalPerson boolean Příznak typu firmy - "T" - fyzická osoba, "F" - právnická osoba Company/UserField1 string (40) Uživ.pole 1 Company/UserField2 string (40) Uživ.pole 2 Company/UserField3 string (40) Uživ.pole 3 Company/UserField4 string (40) Uživ.pole 4 Company/UserField5 string (40) Uživ.pole 5 ==================================================================================================== Položky(řádky) dokladu. Cesta (XPath uzel): IncomingInvoices/Invoice/Items/Item ==================================================================================================== Description string (100) Text RowType integer Typ řádku:1-Finanční,2-Textový řádek TaxCode integer Typ DPH, odpovídá číselníku Typy DPH. Např. 41 - Tuzemské uskut. pln., 71 - Tuzemské přij.pln., 19 - Nedaňový doklad uskutečněný, 39 - Nedaňový doklad přijatý ItemType string (2) Typ položky, odpovídá uživatelskému číselníku Typy položek. Nepovinné. UnitCode string (3) Měrná jednotka - např. "ks", "kg", "t", "m2" apod. Quantity decimal (15,6) Počet MJ UnitPrice decimal (15,6) Cena MJ v měně dokladu bez DPH. Platí (CenaMJ-SlevaMJ)*PocetMJ=Celkem za řádek dokladu bez DPH TaxPercent decimal (15,2) Procentuální výše sazby DPH (0 = Osvobozeno, 99 = MimoDPH) TaxAmount decimal (15,6) Částka DPH za MJ v měně dokladu DiscountPercent decimal (15,2) Procentuální výše slevy za položku dokladu. Pomocný údaj, při výpočtu celkové částky dokladu se k němu nepřihlíží. Podstatné je pole SLEVAMJ UnitDiscount decimal (15,6) Sleva MJ v měně dokladu bez DPH. Platí vztah CenaMJ-SlevaMJ=Cena za MJ po slevě bez DPH StockCardNumber decimal (15,2) Číslo skladové karty, odpovídá uživatelskému seznamu skladových karet. Pro import nepovinné. CostCentre string (6) Nákladové středisko. V případě vyplnění musí odpovídat uživatelskému číselníku Střediska. Výchozí hodnota "0" ContractNumber string (15) Zakázka. V případě vyplnění, musí odpovídat uživatelskému číselníku Zakázky. Výchozí hodnota "0" RowSumType integer Typ sumace řádku: 1-běžný, 2-odpočet záloh, 3-ReverseCharge(pouze pro uskutečněná plnění) TotalWeight decimal (15,6) Hmotnost za MJ SubscriptionStartPeriod date Datum od - rozsah období (nájem, předplatné za období apod.). Pro rozúčtování nákladů/výnosů příštích období. SubscriptionEndPeriod date Datum od - rozsah období (nájem, předplatné za období apod.). Pro rozúčtování nákladů/výnosů příštích období. ==================================================================================================== Celkové součty dokladu. Cesta (XPath uzel): IncomingInvoices/Invoice/SumValues/SumValue Nepovinné, pokud daňový doklad obsahuje pouze jednu základní a jednu sníženou sazbu dph ==================================================================================================== TaxCode integer Typ DPH, odpovídá číselníku Typy DPH. Např. 41 - Tuzemské uskut. pln., 71 - Tuzemské přij.pln., 19 - Nedaňový doklad uskutečněný, 39 - Nedaňový doklad přijatý TaxType integer Typ sazby: 0-Nedefinováno, 1-Základní, 2-Snížená, 3-Osvobozeno, 4-MimoDph TaxPercent decimal (15,2) Procentuální výše sazby DPH (0 = Osvobozeno, 99 = MimoDPH) CurrencyCode string (3) Měna aktuálního součtového řádku. Tabulka obsahuje povinně vždy součty pro lokální měnu (CZK) a variantně součty pro zahraniční měnu(pro případ cizoměnových dokladů) Amount decimal (15,2) Částka základu Tax decimal (15,2) Částka DPH TaxCurrRateAmount decimal (15,2) Částka základu - daňový kurz TaxCurrRateTax decimal (15,2) Částka DPH - daňový kurz ReverseChargeAmount decimal (15,2) Částka základu - Reverse Charge - vypočítaná DPH (EU/dovoz/celnice) ReverseChargeTax decimal (15,2) Částka DPH - Reverse Charge - vypočítaná DPH(EU/dovoz/celnice) TaxCurrRateReverseChargeAmount decimal (15,2) Částka základu - Reverse Charge - vypočítaná DPH(EU/dovoz/celnice) - daňový kurz TaxCurrRateReverseChargeTax decimal (15,2) Částka DPH - Reverse Charge - vypočítaná DPH(EU/dovoz/celnice) - daňový kurz TaxApplied decimal (15,2) Částka odpočtu DPH, pokud je nárok na odpočet jiný, než daň na dokladu (poměrný nárok na odpočet) ==================================================================================================== Úhrady dokladu. Cesta (XPath uzel): IncomingInvoices/Invoice/Payments/Payment Nepovinný uzel ==================================================================================================== PaymentType integer Způsob úhrady: 0-neuvedeno, 1 - Bankou(převodem), 2 - Pokladnou, 3 - Kurzový rozdíl, 4 - Zápočet, 5 - Interní doklad PaymentDate date Datum DocumentNumber string (10) Doklad Amount decimal (15,2) Částka úhrady v lokální měně AmountCurr decimal (15,2) Částka úhrady v měně úhrady AmountPaidDocumentCurr decimal (15,2) Částka úhrady v měně dokladu(faktury) CurrencyCode string (3) Měna úhrady CurrRate decimal (15,6) Kurz. U dokladů v lokální(domácí) měně = 1.0000 CurrRateAmount decimal (15,6) Kurz - počet jednotek. U dokladů v lokální(domácí) měně = 1.0000 ==================================================================================================== Splátkový kalendář - předpis úhrad. Cesta (XPath uzel): IncomingInvoices/Invoice/PaymentSchedule/PaymentScheduleItem Nepovinný uzel ==================================================================================================== PaymentMeansCode string (10) Forma úhrady BankAccount string (18) Účet BankCode string (12) Kód banky IBAN string (34) IBAN VariableSymbol string (10) Variabilní symbol ConstantSymbol string (8) Konst.symbol SpecificSymbol string (10) Specif.symb. PaymentDueDate date Datum AmountCurr decimal (15,2) Částka v měně dokl.