Dokumentace k XML exportům/importům dokladů verze 2.0 - agenda Skladové pohyby ---------------------------------------------------------------------------------------------------- (vytvořeno ve verzi MRP-K/S 6.65(004), 14.05.2024) Popis elementů ============== ==================================================================================================== Hlavičkové údaje dokladu. Cesta (XPath uzel): WarehouseTransactions/WarehouseTransaction ==================================================================================================== WarehouseDocumentValid string (1) Platný nebo rozpracovaný doklad (T platný, F rozpracovaný, R rozpracovaný s rezervací, O maloobchod archiv). DocumentNumber string (9) Základní číslo skladového pohybu OriginalOrderNumber string (50) Původní číslo objednávky (číslo v evidenci vystavitele dokladu) OriginalDocumentNumber string (50) Původní číslo dokladu (číslo v evidenci vystavitele dokladu). WarehouseNumber integer Číslo skladu DestinationWarehouseNumber integer Číslo skladu pro příjem při převodu WarehouseIncomeDocument boolean Skladový příjem (T) nebo výdej (F) WarehouseTransactionType2 integer Číslo druhu pohybu ze seznamu druhů WarehouseTransactionType string (1) Druh skladového dokladu (P běžný, M převod ve skladových cenách, C převod s prodejní cenou ve výdejce, O převod (nepoužívat), V maloobchod, I inventura) IssueDate date Datum skladového dokladu CostCentre string (6) Středisko. Povinné pole, musí odpovídat uživatelskému číselníku Střediska. Výchozí hodnota "0" ContractNumber string (15) Zakázka. Povinné pole, musí odpovídat uživatelskému číselníku Zakázky. Výchozí hodnota "0" 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 CurrencyCode string (3) Měna dokladu. Odpovídá číselníku měn. Např. "CZK", "EUR", "USD" apod. 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 VariableSymbol string (10) Variabilní symbol PaymentMeansCode string (10) Forma úhrady DeliveryTypeCode string (10) Způsob dopravy Note string (1024) Poznámka 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 TaxCode integer Typ DPH, odpovídá číselníku Typy DPH. Např. Tuzemské uskut. pln. - 41 (pro SK verzi 10) , Tuzemské přij.pln. - 71 (pro SK verzi 40), Nedaňový doklad uskutečněný - 19 , Nedaňový doklad přijatý - 39 VatRegime integer Režim DPH:0-Běžný tuzemský,1-Registrace v EU,2-OSS(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 plátců v zemích EU". CalcParams string (200) Parametry výpočtu dokladu - počet.des.míst, způsob zaokrouhlení, atd... Pokud daňový doklad obsahuje více základních či více snížených sazeb dph, musí XML obsahovat jejich podrobný rozpis v uzlu WarehouseTransactions/WarehouseTransaction/SumValues 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): WarehouseTransactions/WarehouseTransaction ==================================================================================================== 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é - krátká poznámka k adrese 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/AddressFormationDate date Datum zařazení/zaevidování/vzniku záznamu 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 Company required ==================================================================================================== Položky(řádky) dokladu. Cesta (XPath uzel): WarehouseTransactions/WarehouseTransaction/Items/Item ==================================================================================================== StockCardNumber decimal (15,2) Číslo karty Quantity decimal (15,6) Počet MJ UnitPrice decimal (15,6) Základ prodejní ceny za MJ v měně dokladu UnitDiscount decimal (15,6) Sleva částkou za MJ v měně dokladu, musí být v korelaci s ZLAVA DiscountPercent decimal (15,2) Sleva za MJ v procentech, musí být v korelaci se SLEVAMJ, SLEVAMJZ TaxPercent decimal (15,2) Procentuální výše sazby DPH (0 = Osvobozeno, 99 = MimoDPH) TaxAmount decimal (15,6) DPH k prodejní ceně za MJ v účetní měně ItemType string (10) Typ položky, odpovídá uživatelskému číselníku Typy položek. Nepovinné. StockCardId string (36) Jedinečný identifikátor karty pro e-shop StockCardEAN string (25) EAN kód karty StockCardCode string (50) Uživatelský kód karty ==================================================================================================== Celkové součty dokladu. Cesta (XPath uzel): WarehouseTransactions/WarehouseTransaction/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ř. Tuzemské uskut. pln. - 41 (pro SK verzi 10) , Tuzemské přij.pln. - 71 (pro SK verzi 40), Nedaňový doklad uskutečněný - 19 , Nedaňový doklad přijatý - 39 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 (nároku na odpočet) u přijatého plnění. Zpravidla shodné s částkou DPH/vypočítané DPH na dokladu. 0=bez nároku na odpočet. Důležité pro Přiznání k DPH, Kontrolní hlášení. ==================================================================================================== Přílohy - dokumenty. Cesta (XPath uzel): WarehouseTransactions/WarehouseTransaction/Attachments/Attachment Nepovinný uzel ==================================================================================================== FileName string (50) Jméno souboru přílohy - např. FV0001.PDF apod. FileContent blob Binární obsah souboru přílohy Description string (100) Poznámka