Generované XML soubory pro import položek do tisku složenek si můžete vytvořit sami, nebo za pomoci Vašich webmasterů podle níže uvedeného návodu a specifikace XML pro přenos dat.
Vzorový soubor pro XML přenos ke stažení
zde.
1. řádek musí vždy obsahovat hlaviščku a kódování dokumentu XML
<?xml version="1.0" encoding="UTF-8" ?>
nebo
<?xml version="1.0" encoding="windows-1250" ?>
2. řádek musí obsahovat <objednavky ExpDate="2008-09-26" ExpTime="18:02:45">
nebo <objednavky>
3. řádek musí obsahovat </objednavky>
4. mezi řádky <objednavky> ... </objednavky> vložte jednotlivé položky pro tisk
<faktura>
<dodaci_adresa>
<firma>název firmy</firma>
<jmeno>Jméno příjemce</jmeno>
<prijmeni>Příjmení příjemce</prijmeni>
<ulice>Ulice příjemce</ulice>
<psc>psč příjemce</psc>
<mesto>město příjemce</mesto>
<email>e-mail příjemce (nepovinný údaj)</email>
<telefon>telefon příjemce (nepovinný údaj)</telefon>
</dodaci_adresa>
<doklad>
<cislo_obj>číslo objednávky </cislo_obj>
<c_baliku>číslo balíku</c_baliku>
<v_symbol>variabilní symbol platby</v_symbol>
<s_symbol>specifický symbol platby</s_symbol>
<k_symbol>konstantní symbol platby</k_symbol>
</doklad>
<uhrada>
<dobirka>dobírka</dobirka>
<castka>částka pojištění zásilky</castka>
</uhrada>
<skupina>1</skupina>
<poznamka>poznámka doplňkové služby</poznamka>
<ucel>účel platby (nepovinný údaj)</ucel>
<vaha>váha zásilky v gramech (nepovinný údaj)</vaha>
</faktura>
<faktura>
......
</faktura>
5. takto vytvořený soubor můžete uložit na serveru a automaticky jen importovat do aplikace tisku složenek, nebo si ho ukládat na diisk ze kterého následně soubor nahrajete pro import přímo do aplikace.
POPIS JEDNOTLIVÝCH ZNAČEK:
objednavky - kořenová značka dokumentu pro import, musí být vždy uzavřena její párovou značkou
faktura - v jejím rámci jsou informace týkající se jednoho kontaktu
dodaci_adresa - párová značka označující kontaktní údaje příjemce
firma - název společnosti
jmeno - jméno příjemce
prijmení - příjmení příjemce
ulice - doručovací adresa příjemce
mesto - doručovací město příjemce
psc - poštovní směrovací číslo příjemce
email - e-mail příjemce, tato položka je nepovinná pro základní variantu, pro využití mail info systému je tato položka povinná
telefon - telefonní číslo příjemce, tato položka není povinná, vyžadují ji pouze některé přepravní služby
doklad - párová značka označující údaje o platbě
cislo_obj - číslo objednávky zpravidla stejný jako variabilní symbol
c_baliku - číslo zásilky, hodnota podle specifikace a označení přepravní služby
v_symbol - variabilní symbol, identifikátor vaší platby
s_symbol - specifický symbol
k_symbol - konstatntní symbol
uhrada - párová značka označující údaje o částce a pojištění
dobirka - dobírková částka
castka - částka pojištění zásilky
vaha - váha zásilky udávána v gramech
skupina - číselné označení pro výběr skupiny tisku a info e-mailu
1 = česká pošta
2 = General partner
3 = DPD
4 = PPL
poznamka - poznámka pro podací arch české pošty, uvedení doplňkové služby
ucel - textový identifikátor platby na složenky
PŘÍKLAD KONEČNÉHO SOUBORU PRO IMPORT
<?xml version="1.0" encoding="windows-1250"?>
<objednavky ExpDate="2008-09-26" ExpTime="18:02:45">
<faktura>
<dodaci_adresa>
<firma>rimado</firma>
<jmeno>Roman</jmeno>
<prijmeni>Vlach</prijmeni>
<ulice>Činšalová 15</ulice>
<psc>36951</psc>
<mesto>Aš</mesto>
<email>muj@email.cz</email>
<telefon>744568978</telefon>
</dodaci_adresa>
<doklad>
<cislo_obj>2009847</cislo_obj>
<c_baliku>2009847</c_baliku>
<v_symbol>1220250597</v_symbol>
<s_symbol>0400</s_symbol>
<k_symbol>0379</k_symbol>
</doklad>
<uhrada>
<dobirka>550</dobirka>
<castka>800</castka>
</uhrada>
<skupina>1</skupina>
<poznamka>R</poznamka>
<ucel>eshop</ucel>
<vaha>1256</vaha>
</faktura>
</objednavky>