Do polí vlastní šablony Shoptetu vložte odpovídající bloky níže a vyberte proměnné přesně podle jejich názvů.
Bloky šablony
Složte export z hlavičky, bloku objednávky, opakovaného bloku položky a patičky.
Vložte ukázky do polí šablony exportu. Blok hlavičky a patičky obalí opakující se objednávky a jejich položky.
Začátek souboru
<?xml version="1.0" encoding="UTF-8"?>
<ORDERS>Opakovaný blok objednávky
<ORDER>
<ORDER_ID>#id#</ORDER_ID>
<CODE>#code#</CODE>
<DATE>#date#</DATE>
<STATUS>#statusName#</STATUS>
<REFERER><![CDATA[#referer#]]></REFERER>
<ANONYMIZED_MAIL>#anonymizedEmail#</ANONYMIZED_MAIL>
<CURRENCY><CODE>#currencyCode#</CODE></CURRENCY>
<CUSTOMER><BILLING_ADDRESS><COUNTRY>#billCountryName#</COUNTRY></BILLING_ADDRESS></CUSTOMER>
<TOTAL_PRICE>
<WITHOUT_VAT>#totalPriceWithoutVat#</WITHOUT_VAT>
<WITH_VAT>#totalPriceWithVat#</WITH_VAT>
</TOTAL_PRICE>
<ORDER_ITEMS>#orderItems#</ORDER_ITEMS>
</ORDER>ORDER_ITEMS je povinný. V nastavení Shoptetu zapněte Exportovat jednotlivé položky objednávky; proměnná #orderItems# vloží opakující se blok ITEM právě do tohoto místa. Každý export musí obsahovat celkovou cenu objednávky v obou základech. REFERER a ANONYMIZED_MAIL jsou volitelné: REFERER obsahuje zdrojovou informaci o odkazující stránce, ANONYMIZED_MAIL pouze neprůhledný pseudonym zákazníka, nikdy skutečný e-mail.
Opakovaný blok položky
<ITEM>
<TYPE>#orderItemType#</TYPE>
<NAME>#orderItemName#</NAME>
<AMOUNT>#orderItemAmount#</AMOUNT>
<CODE>#orderItemCode#</CODE>
<UNIT_PRICE>
<WITHOUT_VAT>#orderItemUnitPriceWithoutVat#</WITHOUT_VAT>
<WITH_VAT>#orderItemUnitPriceWithVat#</WITH_VAT>
<VAT_RATE>#orderItemUnitPriceVatRate#</VAT_RATE>
<PURCHASE_WITHOUT_VAT>#orderItemUnitPurchasePrice#</PURCHASE_WITHOUT_VAT>
<PURCHASE_WITH_VAT>#orderItemUnitPurchasePriceWithVat#</PURCHASE_WITH_VAT>
<PURCHASE_VAT>#orderItemUnitPurchasePriceVat#</PURCHASE_VAT>
<PURCHASE_VAT_RATE>#orderItemUnitPurchasePriceVatRate#</PURCHASE_VAT_RATE>
</UNIT_PRICE>
<TOTAL_PRICE>
<WITHOUT_VAT>#orderItemTotalPriceWithoutVat#</WITHOUT_VAT>
<WITH_VAT>#orderItemTotalPriceWithVat#</WITH_VAT>
<VAT_RATE>#orderItemTotalPriceVatRate#</VAT_RATE>
</TOTAL_PRICE>
</ITEM>Konec souboru
</ORDERS>Exportujte každou položku jako opakovaný ITEM uvnitř ORDER_ITEMS. Ověřte, že zkušební výstup obsahuje všechny objednávky i položky a tvoří validní XML; porovnejte jej s kompletním příkladem.
Nákupní ceny a DPH
Vyplňte všechna dostupná pole: jednotkovou nákupní cenu bez DPH, s DPH, částku DPH a sazbu DPH. Na zkušebním exportu porovnejte tyto hodnoty s položkou, jejíž nákupní cenu znáte; ověřte také, že neznámá cena zůstane prázdná a nezmění se na nulu.
Nákupní údaje uvnitř UNIT_PRICE
Cesty v této tabulce začínají uvnitř UNIT_PRICE, který je uvnitř ITEM. Uveďte dostupné údaje o jednotkové nákupní ceně.
| Pole XML | Význam |
|---|---|
PURCHASE_WITHOUT_VAT | Jednotková nákupní cena bez DPH. |
PURCHASE_WITH_VAT | Jednotková nákupní cena s DPH. |
PURCHASE_VAT | Daň z nákupní ceny za jednotku. |
PURCHASE_VAT_RATE | Sazba DPH použita na nákupní cenu. |
Typy řádků
TYPE označuje typ položky ve zdrojovém systému. Níže jsou příklady běžných hodnot; exportujte také další hodnoty, které zdroj používá.
| TYPE | Význam | Započítání do tržeb z položek |
|---|---|---|
product, set, bazaar, service | Produkt, sada, bazarové zboží nebo služba; každý řádek se započítává podle své ceny. | Započítává se do tržeb z položek. |
discount, discount-coupon, volume-discount | Sleva, kupón nebo množstevní sleva. | Záporná cena; její dopad v objednávce uveďte pouze jednou. |
other, a další zdrojové hodnoty | Jiná položka. Zachovejte TYPE ze zdrojového systému. | Započítává se do tržeb z položek. |
shipping | Doprava účtovaná zákazníkovi. | Do tržeb z položek se nezahrnuje. |
billing | Platba nebo poplatek za platbu účtovaný zákazníkovi. | Do tržeb z položek se nezahrnuje. |
Kontrola exportu
Ukázkové objednávky ukazují, jak mají součty sedět. Stáhnout kompletní XML příklad
- ORDER_ID zůstává stabilní při dalších exportech.
- Hlavička a všechny řádky obsahují částky bez DPH i s DPH.
- Sleva se promítne do celkové ceny pouze jednou.
- Ověřte nákupní ceny na zkušebním exportu proti známé položce; neznámá cena má zůstat prázdná, nula znamená skutečnou nulovou cenu.
Pro export ze Shoptetu použijte tyto bloky. Pro XML exporty z jiných systémů přejděte na obecnou specifikaci.