Formát a struktura Rocketoo XML

Export ve formátu Rocketoo XML slouží pro vlastní integrace a zpracování fakturačních dat mimo běžné účetní systémy. Tento formát poskytuje kompletní strukturu faktur včetně položek, sazeb DPH a údajů

Základní struktura

rocketoo.xml

<?xml version="1.0" encoding="UTF-8"?>
<rocketoo version="1.0">
    <invoices>
        <invoice>
            <!-- Data faktury -->
        </invoice>
    </invoices>
    <proformas>
        <proforma>
            <!-- Data zálohové faktury -->
        </proforma>
    </proformas>
</rocketoo>

Detailní popis struktury faktury

invoice (příklad)

<invoice>
    <!-- Základní identifikace -->
    <id>70</id>
    <proforma>false</proforma>
    <!-- true pro zálohovou fakturu, false pro fakturu -->
    
    <number>2025000001</number>
    <variable_symbol>2025000002</variable_symbol>
    <token>f7078267</token>
    <!-- Token pro generování unikátních odkazů -->
    
    <!-- Informace o dodavateli (e-shop) -->
    <your_name>Moje firma s.r.o.</your_name>
    <your_street>Spojů 835/2</your_street>
    <your_city>Ostrava - Poruba</your_city>
    <your_zip>70800</your_zip>
    <your_country>Česká republika</your_country>
    <your_country_code>CZ</your_country_code>
    <your_registration_no>123456789</your_registration_no>
    <your_vat_no>CZ123456789</your_vat_no>
    <!-- Prázdné, pokud není plátce DPH -->
    <your_tax_no>CZ123456789</your_tax_no>
    
    <!-- Fakturační adresa zákazníka (client) -->
    <client_company>Jan Novák s.r.o.</client_company>
    <!-- Prázdné pro fyzické osoby -->
    <client_name>Jan Novák</client_name>
    <!-- Jméno a příjmení -->
    <client_street>Jiná ulice 67</client_street>
    <client_city>Ostrava</client_city>
    <client_zip>70200</client_zip>
    <client_country>Česká republika</client_country>
    <client_country_code>CZ</client_country_code>
    <client_registration_no>12345678</client_registration_no>
    <!-- IČO - prázdné pro fyzické osoby -->
    <client_vat_no>CZ12345678</client_vat_no>
    <!-- DIČ - prázdné pokud není plátce DPH -->
    <client_tax_no></client_tax_no>
    <client_email>[email protected]</client_email>
    <client_id>256</client_id>
    <!-- ID fakturační adresy v databázi -->
    
    <!-- Dodací adresa (address) -->
    <address_company></address_company>
    <address_name></address_name>
    <!-- Jméno a příjmení -->
    <address_street></address_street>
    <address_city></address_city>
    <address_zip></address_zip>
    <address_country></address_country>
    <address_country_code></address_country_code>
    <address_registration_no></address_registration_no>
    <address_vat_no></address_vat_no>
    <address_tax_no></address_tax_no>
    <address_id></address_id>
    <!-- ID dodací adresy - prázdné, pokud je shodná s fakturační -->
    
    <!-- ID zákazníka -->
    <subject_id>13</subject_id>
    <!-- ID zákazníka v databázi -->
    
    <!-- Dobropis/Storno -->
    <correction>false</correction>
    <!-- true pokud je to dobropis -->
    <correction_id></correction_id>
    <!-- ID původní faktury, ke které je dobropis -->
    
    <!-- Stav faktury -->
    <status>open</status>
    <!-- Možné hodnoty: paid (zaplaceno), open (nezaplaceno) -->
    
    <!-- Vazba na objednávku -->
    <order_number>2025000002</order_number>
    
    <!-- Data -->
    <issued_on>2025-01-09</issued_on>
    <taxable_fulfillment_due>2025-01-09</taxable_fulfillment_due>
    <!-- Datum zdanitelného plnění (DUZP) -->
    <due>14</due>
    <!-- Splatnost ve dnech -->
    <due_on>2025-01-23</due_on>
    <!-- Datum splatnosti -->
    <paid_on></paid_on>
    <!-- Datum zaplacení - prázdné pokud není zaplaceno -->
    
    <!-- Storno -->
    <cancelled>0</cancelled>
    <!-- 0 = aktivní, 1 = stornováno -->
    <cancelled_at></cancelled_at>
    <!-- Datum stornování -->
    
    <!-- Poznámky -->
    <note>Poznamaka v paticce</note>
    <!-- Poznámka specifická pro tuto fakturu -->
    <footer_note>Poznamaka v paticce</footer_note>
    <!-- Globální patička z nastavení -->
    
    <!-- Bankovní spojení -->
    <bank_account>12345678/2010</bank_account>
    <iban></iban>
    <swift_bic></swift_bic>
    
    <!-- Platební metoda -->
    <payment_method>transfer</payment_method>
    <!-- Možné hodnoty: transfer, cash, card, cod (dobírka) -->
    
    <!-- Měna a kurz -->
    <currency>CZK</currency>
    <exchange_rate>1</exchange_rate>
    <!-- Zaokrouhleno na 2 desetinná místa -->
    <subtotal>1556.3600000</subtotal>
    <!-- Celkem bez DPH -->
    <total>1883.2000000</total>
    <!-- Celkem s DPH -->
    
    <!-- Položky faktury -->
    <lines>
        <!-- Položka produktu (variant) -->
        <line>
            <id>141</id>
            <!-- ID varianty produktu pro item_type='variant' -->
            <!-- ID dopravy pro item_type='shipping' -->
            <!-- ID platby pro item_type='payment' -->
            <name>Krajkové společenské šaty - Červená, XS</name>
            <quantity>1.00</quantity>
            <unit_name>ks</unit_name>
            <vat_rate>21.00</vat_rate>
            <!-- Sazba DPH v % -->
            <unit_price_without_vat>1556.3600000</unit_price_without_vat>
            <!-- Cena za jednotku bez DPH -->
            <unit_price_with_vat>1883.2000000</unit_price_with_vat>
            <!-- Cena za jednotku s DPH -->
        </line>
        
        <!-- Položka dopravy (shipping) -->
        <line>
            <id>19</id>
            <name>PPL</name>
            <quantity>1.00</quantity>
            <unit_name>ks</unit_name>
            <vat_rate>21.00</vat_rate>
            <unit_price_without_vat>0.0000000</unit_price_without_vat>
            <unit_price_with_vat>0.0000000</unit_price_with_vat>
        </line>
        
        <!-- Položka platby (payment) -->
        <line>
            <id>1</id>
            <name>Bankovní převod</name>
            <quantity>1.00</quantity>
            <unit_name>ks</unit_name>
            <vat_rate>0.00</vat_rate>
            <unit_price_without_vat>0.0000000</unit_price_without_vat>
            <unit_price_with_vat>0.0000000</unit_price_with_vat>
        </line>
    </lines>
</invoice>

Typy položek

V elementu se ukládají různé typy položek. Typ položky není explicitně uveden v XML, ale lze ho poznat podle toho, jaké ID obsahuje element :

Produkt (variant)	ID varianty produktu	Standardní produkty z katalogu
Doprava (shipping)	ID dopravy	Poplatek za dopravu
Platba (payment)	ID platební metody	Poplatek za platební metodu

Stavy faktur

Element <status>

Hodnota	Popis
paid	Uhrazená faktura (paid=1)
open	Neuhrazená faktura (paid=0)

Poznámka: Stav cancelled není v elementu <status>. Pro stornované faktury se používá samostatný element <cancelled> (viz níže).

Element <cancelled>

Hodnota	Popis
0	Aktivní faktura
1	Stornovaná faktura

Element <proforma>

Hodnota	Popis
true	Zálohová faktura (proforma)
false	Daňový doklad (faktura)

Element <correction>

Hodnota	Popis
true	Dobropis k jiné faktuře
false	Standardní faktura

Pokud je <correction> = true, element <correction_id> obsahuje ID původní faktury.

Platební metody (payment_method)

Hodnota	Popis
transfer	Bankovní převod
cash	Hotově
card	Kartou
cod	Dobírka
online	Online platba (platební brána)