administrační a publikační systémy

Specifikace importu XML

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>