Integrace objednávek XML

Shoptet: šablona XML exportu objednávek

Nastavte export objednávek ze Shoptetu podle připravené šablony XML pro Datixo.

Než začnete

Do polí vlastní šablony Shoptetu vložte odpovídající bloky níže a vyberte proměnné přesně podle jejich názvů.

01

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.

02

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 XMLVýznam
PURCHASE_WITHOUT_VATJednotková nákupní cena bez DPH.
PURCHASE_WITH_VATJednotková nákupní cena s DPH.
PURCHASE_VATDaň z nákupní ceny za jednotku.
PURCHASE_VAT_RATESazba DPH použita na nákupní cenu.
03

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á.

TYPEVýznamZapočítání do tržeb z položek
product, set, bazaar, serviceProdukt, 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-discountSleva, kupón nebo množstevní sleva.Záporná cena; její dopad v objednávce uveďte pouze jednou.
other, a další zdrojové hodnotyJiná položka. Zachovejte TYPE ze zdrojového systému.Započítává se do tržeb z položek.
shippingDoprava účtovaná zákazníkovi.Do tržeb z položek se nezahrnuje.
billingPlatba nebo poplatek za platbu účtovaný zákazníkovi.Do tržeb z položek se nezahrnuje.
04

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.

Dokumentace Shoptetu k exportu objednávek

Doporučení

Pro export ze Shoptetu použijte tyto bloky. Pro XML exporty z jiných systémů přejděte na obecnou specifikaci.