1.) Základní vzor xml s objednávkou přijatou bez vazby na adresář (tzv. Vzor 1).
Schéma XSD pro objekt Objednávka přijatá ke stažení zde. Pro konkrétní import je vždy nutné mít nastavenou odpovídající importní konfiguraci.
<?xml version="1.0" encoding="utf-8"?>
<S5Data>
<ObjednavkaPrijataList>
<ObjednavkaPrijata>
<Group ID="c2b0081d-bda0-4c6e-b85a-48a4ac62b52c" Kod="eshop" />
<!-- NEPOVINNÉ - pouze mustr pro případ potřeby třídění do více skupin například MO a VO nebo pro potřeby OSS pro skupiny dle států CZ, SK, PL atd. Další možností jsou 2 různé konfigurace importu. ID a kod vždy individuální. -->
<Odkaz>Pole Přijatý doklad</Odkaz>
<!-- NEPOVINNÉ/POVINNÉ - nutné rozhodnout na jaký element bude párování (Odkaz nebo VS, nebo CisloDokladu?), ObjednavkyPrijata - Odkaz -->
<CisloDokladu>1201412412</CisloDokladu>
<!-- NEPOVINNÉ/POVINNÉ - nutné rozhodnout na jaký element bude párování, ObjednavkyPrijata - CisloDokladu. Možnost nechat doplňovat číslo dle číselné řady v Money .. tím element nazasílat. -->
<VariabilniSymbol>1201412412</VariabilniSymbol>
<!-- NEPOVINNÉ/POVINNÉ - nutné rozhodnout na jaký element bude párování, ObjednavkyPrijata - VariabilniSymbol. Tento element DOPORUČENO vyplňovat číslem objednávky pro přenos do faktur vydaných a na toto pole párovat. -->
<Nazev>Objednávka z eshopu č. 1201412412</Nazev>
<!-- NEPOVINNÉ, ale vhodné vyplňovat. Import převezme to co je zasláno v tomto elementu. Pokud element není zaslán, tak si import do tohoto pole doplní název z první položky dokladu. -->
<DatumVystaveni>2020-08-2015T00:00:00</DatumVystaveni>
<!-- POVINNÉ -->
<Sleva />
<!-- NEPOVINNÉ - sleva na celý doklad, procentní hodnota slevy třeba číslo 5. Propíše se na všechny položky kromě těch, které mají True u elementu NepodlehatSleveDokladu. -->
<Poznamka>Poznámka zákazníka k celé objednávce</Poznamka>
<!-- NEPOVINNÉ -->
<Zaplaceno_UserData>True</Zaplaceno_UserData>
<!-- NEPOVINNÉ - Formát zápisu, pokud využívají nějaký vlastní uživatelský sloupec například s názvem Zaplaceno (pro GoPay). True/False. -->
<IC />
<!-- NEPOVINNÉ -->
<DIC />
<!-- NEPOVINNÉ -->
<!-- Zápis adres v tomto formátu nezakládá adresní karty do adresáře ani nevytváří vazbu na adresní kartu. Je to základní zápis pro případ neregistrovaného zákazníka pro jednorázový nákup. -->
<Vystavil>Administrátor</Vystavil>
<!-- NEPOVINNÉ -->
<Adresa>
<Nazev>Stanislav Grela</Nazev>
<Ulice>Drobného 49</Ulice>
<Misto>Brno</Misto>
<Stat>Česká republika</Stat>
<!-- Pouze textový zápis -->
<AdresaStat>
<Kod>CZ</Kod>
</AdresaStat>
<!-- Zápis s vazbou na seznam států. Doporučuje se. -->
<PSC>60200</PSC>
</Adresa>
<AdresaKoncovehoPrijemce>
<Nazev>Stanislav Grela</Nazev>
<KontaktniOsobaNazev>Stanislav Grela</KontaktniOsobaNazev>
<!-- NEPOVINNÉ -->
<!-- Pro případ kontaktních údajů Firma a Osoba nebo pro potřeby např. Mobile - Zásilkovna, kdy musí být vyplněné -->
<Ulice>Drobného 49</Ulice>
<Misto>Brno</Misto>
<Stat>Česká republika</Stat>
<AdresaStat>
<Kod>CZ</Kod>
</AdresaStat>
<PSC>60200</PSC>
<Email>stanislav.grela@solitea.cz</Email>
<Telefon>+420549522511</Telefon>
</AdresaKoncovehoPrijemce>
<AdresaPrijemceFaktury>
<Nazev>Stanislav Grela</Nazev>
<Ulice>Drobného 49</Ulice>
<Misto>Brno</Misto>
<Stat>Česká republika</Stat>
<AdresaStat>
<Kod>CZ</Kod>
</AdresaStat>
<PSC>60200</PSC>
</AdresaPrijemceFaktury>
<ZpusobDopravy>
<!-- NEPOVINNÉ - ale doporučuje se vyplňovat -->
<Kod>D</Kod>
<!-- Informace do hlavičky dokladu. Párování, Způsob dopravy - Kod -->
</ZpusobDopravy>
<ZpusobPlatby>
<!-- NEPOVINNÉ - ale doporučuje se vyplňovat -->
<Kod>D</Kod>
<!-- Informace do hlavičky dokladu. Párování, Způsob platby - Kod -->
</ZpusobPlatby>
<!-- V případě domácí měny být nemusí, využití při cizí měně. Pokud je zaslána cizí měna, tak musí být zaslán i odpovídající kurz.
<Mena>
<Kod>EUR</Kod>
</Mena>
<UcetniKurz>
<Kurz>27.440000</Kurz>
</UcetniKurz>
-->
<Polozky>
<PolozkaObjednavkyPrijate GENERATESUBITEMS="1">
<!-- GENERATESUBITEMS.. je volitelné, zajišťuje přidání složení u sady a kompletu -->
<CisloPolozky>1</CisloPolozky>
<!-- POVINNÉ - párování, PolozkaObjednavkyPrijate - CisloPolozky -->
<Mnozstvi>2</Mnozstvi>
<JednCenaCM>1000</JednCenaCM>
<!-- POVINNÉ - CM značí cizí měnu. Pokud není řečeno jinak (element Mena), tak je to v domácí měně.. CZK -->
<TypCeny>1</TypCeny>
<!-- POVINNÉ - hodnoty 0-bezDPH, 1-sDPH, 2-PouzeZaklad, 3-PouzeDan -->
<DPH>
<Sazba>10</Sazba>
<!-- POVINNÉ -->
</DPH>
<TypObsahu>1</TypObsahu>
<!-- POVINNÉ - Vyjadřuje, že je vazbová položka a bude se koukat do ObsahPolozky. 0 je textová položka. -->
<Nazev>MERCURIAL LITE</Nazev>
<!-- NEPOVINNÉ Pokud je zaslán element Název, tak si do položky zapíšeme přesně to co bylo zasláno. Pokud element není zaslán vůbec, tak u textových položek bude pole prázdné a u vazbových položek si import dosadí ten název, který je v Money na katalogové kartě na záložce obecné ([dbo].[CSW_EObchod_Artikl].[Nazev]). -->
<Katalog>SP0269-730-6</Katalog>
<!-- NEPOVINNÉ, ale doporučuje se vyplňovat, příp. element <Kod>SP0269-730-6<Kod> -->
<Sleva>5</Sleva>
<!-- NEPOVINNÉ - Procentní hodnota slevy -->
<ObsahPolozky GENERATEZASOBA="1">
<Artikl>
<CarovyKod>883418592202</CarovyKod>
<!-- POVINNÉ v případě skladové položky - Párování, Položka katalogu - CarovyKod, možnost využít jiný prvek například Katalog nebo Kod. Párování musí být následně stejné pro všechny položky. -->
</Artikl>
<Sklad>
<!-- POVINNÉ v případě skladové položky -->
<Kod>01</Kod>
<!-- Párování, Sklad - Kod -->
</Sklad>
</ObsahPolozky>
</PolozkaObjednavkyPrijate>
<PolozkaObjednavkyPrijate GENERATESUBITEMS="1">
<CisloPolozky>2</CisloPolozky>
<Mnozstvi>1</Mnozstvi>
<JednCenaCM>3000</JednCenaCM>
<TypCeny>1</TypCeny>
<DPH>
<Sazba>21</Sazba>
</DPH>
<TypObsahu>1</TypObsahu>
<Nazev>NEYMAR MERCURIAL LITE</Nazev>
<Katalog>SP0281-077-4</Katalog>
<ObsahPolozky GENERATEZASOBA="1" GROUPZASOBAKOD="Z001">
<!-- GENERATE.. je volitelné, zajišťuje vytvoření skladové karty na zadaný sklad (musí být kat. karta) včetně možnosti zařazení do konkrétní skupiny -->
<Artikl>
<CarovyKod>887230429289</CarovyKod>
</Artikl>
<Sklad>
<Kod>01</Kod>
</Sklad>
</ObsahPolozky>
</PolozkaObjednavkyPrijate>
<PolozkaObjednavkyPrijate GENERATESUBITEMS="1">
<CisloPolozky>3</CisloPolozky>
<Mnozstvi>1</Mnozstvi>
<JednCenaCM>30</JednCenaCM>
<TypCeny>1</TypCeny>
<DPH>
<Sazba>0</Sazba>
</DPH>
<TypObsahu>1</TypObsahu>
<Nazev>Dobírka</Nazev>
<!-- Položky pro platbu a dopravu musí být jako samostatná běžná katalogová položka (mají množství, cenu, katalogové číslo). Lze využít i pro Slevové položky nebo položku Zaokrouhlení. -->
<Katalog>dobirka_pl</Katalog>
<ObsahPolozky GENERATEZASOBA="1">
<Artikl>
<CarovyKod>887230421234</CarovyKod>
</Artikl>
<Sklad>
<Kod>01</Kod>
</Sklad>
</ObsahPolozky>
</PolozkaObjednavkyPrijate>
<PolozkaObjednavkyPrijate>
<CisloPolozky>4</CisloPolozky>
<Mnozstvi>1</Mnozstvi>
<JednCenaCM>300</JednCenaCM>
<TypCeny>1</TypCeny>
<DPH>
<Sazba>21</Sazba>
</DPH>
<TypObsahu>0</TypObsahu>
<!-- Není vhodné v jednom dokladu kombinovat vazbové a nevazbové položky. Nevazbové položky nelze vložit do skladových dokladů (dodací list, prodejka). I slevová položka typu kupón může být vazbová karta typu Služba.-->
<Nazev>Slevový poukaz</Nazev>
<Katalog>slpoukaz</Katalog>
<Vratka>True</Vratka>
<!-- True pro vyjádření záporné částky. Obvyklé pro zápis odečítací položky - slevy vyjádřené hodnotou. -->
<NepodlehatSleveDokladu>True</NepodlehatSleveDokladu>
<!-- NEPOVINNÉ - True/False vyjadřuje jestli se na položky vztahuje sleva na doklad. Pokud je True, tak se na tuto položku neuplatňuje žádná automatická sleva zaslaná do hlavičky dokladu. -->
</PolozkaObjednavkyPrijate>
</Polozky>
</ObjednavkaPrijata>
</ObjednavkaPrijataList>
</S5Data>
2.) Zápis dokladu s párováním na ID adresní karty. Párovat lze i na jiný prvek IC, DIC nebo často používaný Kod.
Pro párování například na e-mail v adresní kartě firmy je potřeba předřadit v nastavení importu XSLT transformační šablonu (viz např. řešení Shoptet), která zajistí vyhledání a porovnání informací a potom případně napáruje, edituje nebo založí celou adresní kartu. Tyto úpravy jsou obvykle řešeny individuálním nastavením dle potřeb klienta, ale obecně je to realizovatelné.
<?xml version="1.0" encoding="UTF-8"?>
<S5Data>
<ObjednavkaPrijataList>
<ObjednavkaPrijata>
<CisloDokladu>OP00001</CisloDokladu>
<Adresa>
<Firma ID="684c0264-c4c2-43cf-a236-0578cdcf46fc" />
</Adresa>
<AdresaKoncovehoPrijemce>
<Firma ID="684c0264-c4c2-43cf-a236-0578cdcf46fc" />
</AdresaKoncovehoPrijemce>
<AdresaPrijemceFaktury>
<Firma ID="684c0264-c4c2-43cf-a236-0578cdcf46fc" />
</AdresaPrijemceFaktury>
<Polozky>
<PolozkaObjednavkyPrijate>
<CisloPolozky>1</CisloPolozky>
</PolozkaObjednavkyPrijate>
</Polozky>
</ObjednavkaPrijata>
</ObjednavkaPrijataList>
</S5Data>
Výchozí konfigurace párování každého objectu je na ID. Pokud je potřeba párovat na jiné elementy, tak se musí změnit nastavení pro daný uzel. Více viz popis Import z XML.
<?xml version="1.0" encoding="UTF-8"?>
<S5Data>
<ObjednavkaPrijataList>
<ObjednavkaPrijata>
<CisloDokladu>OP00001</CisloDokladu>
<Adresa>
<Firma>
<Kod>ADR0001</Kod>
</Firma>
</Adresa>
<AdresaKoncovehoPrijemce>
<Firma>
<Kod>ADR0001</Kod>
</Firma>
</AdresaKoncovehoPrijemce>
<AdresaPrijemceFaktury>
<Firma>
<Kod>ADR0001</Kod>
</Firma>
</AdresaPrijemceFaktury>
<Polozky>
<PolozkaObjednavkyPrijate>
<CisloPolozky>1</CisloPolozky>
</PolozkaObjednavkyPrijate>
</Polozky>
</ObjednavkaPrijata>
</ObjednavkaPrijataList>
</S5Data>
3.) Zápis dle adresních karet mimo oblast elementu Adresa je pevný bez možnosti volby chování v konfiguraci xml. Není tedy možné na základě tohoto zápisu rozhodnout o chování při zpracování (přidat, editovat, chyba). Tento zápis se používá například pro pevné dosazení Obchodní a Fakturační adresy dle ID a pro Dodací adresu se použije rozpis s párováním na Kod firmy a zbytek na pevno přes ID.
<?xml version="1.0" encoding="UTF-8"?>
<S5Data>
<ObjednavkaPrijataList>
<ObjednavkaPrijata>
<CisloDokladu>OP00001</CisloDokladu>
<Firma_ID>684c0264-c4c2-43cf-a236-0578cdcf46fc</Firma_ID>
<!-- <DodaciAdresaFirma_ID>684c0264-c4c2-43cf-a236-0578cdcf46fc</DodaciAdresaFirma_ID> -->
<FakturacniAdresaFirma_ID>684c0264-c4c2-43cf-a236-0578cdcf46fc</FakturacniAdresaFirma_ID>
<AdresaKoncovehoPrijemce>
<Misto>Brno</Misto>
<Nazev>CZBRN1035</Nazev>
<PSC>635 00</PSC>
<Stat>Česká republika</Stat>
<AdresaStat>
<Kod>CZ</Kod>
</AdresaStat>
<Firma>
<Kod>Intime_CZBRN1035</Kod>
</Firma>
<Ulice>Kubíčkova 1115/8</Ulice>
<Email>stanislav.grela@csw.cz</Email>
<Telefon>+420549522511</Telefon>
</AdresaKoncovehoPrijemce>
</ObjednavkaPrijata>
</ObjednavkaPrijataList>
</S5Data>
4.) Pro zápis objednávky ve vztahu k různým přepravcům a jejich odběrným místům/boxům, se používá buď zápis z bodu 2 nebo 3, dle konkrétních podmínek agendy a přepravce.
Obecně lze říci, že výsledný zápis objednávky přijaté musí být ve tvaru, kdy Obchodní adresa (s nebo bez vazby na adresář) je adresa zákazníka a Konečný příjemce (vždy s vazbou na adresář) je adresa výdejního místa. Nejčastěji aplikované řešení je viz bod 2, kdy všechny adresy jsou párované na adresní karty dle pole Kód (zasílá e-shop). Takové řešení umožňuje plně využít další vazby na služby typu Chameleoon, modul Expedice či vlastní řešení (tiskovky, exporty xml/csv).
Pro správnou funkčnost odběrných míst, je nutné zapsat do pole Kód u adresní karty správný tvar, který se skládá z určeného prefixu firmy a čísla pobočky.
InTime_číslo pobočky = InTime_CZBRN1035
Zásilkovna(neboli Packeta)_číslo pobočky = PacketaID_15456
PPL_ID(ParcelSHopy)_číslo pobočky = PPL_ID_KM10261900
Objednávka přijatá