Dokumentace k API

Poskytujeme 4 dokumenty pro přístup ke všem potřebným datům. Jmenovitě dokument s cenami a provizemi, s informacemi o výrobcích, s kategoriemi a dokument s dodacími metodami.

Aktuálně poskytujeme exporty ve formátech XML a CSV

Pokud vám námi poskytované formáty nevyhovují, kontaktujte nás.

Poskytujeme také formáty pro některé poskytovatele E-shopů. Jejich seznam naleznete v sekci podporované systémy

Dokumenty jsou generovány s kódováním UTF-8, CSV dokumenty používají , (čárku) jako oddělovače a " (rovné uvozovky) jako uzavírací znak.


Stuktura XML s cenami:

<ceny>
    <produkt>
        <id>1478</id>
        <sklad>7</sklad>
        <sklad_txt>Skladem</sklad_txt>
        <doporucena_cena>599</doporucena_cena>
        <vase_nakupni_cena>442</vase_nakupni_cena>
    </produkt>
    <produkt>
        <id>2297</id>
        <sku>ero*d00044</sku>
        <sklad/>
        <sklad_txt>Externí sklad</sklad_txt>
        <doporucena_cena>1099</doporucena_cena>
        <vase_nakupni_cena>816</vase_nakupni_cena>
    </produkt>
    ...
</ceny>

Struktura CSV s cenami:

  • CSV má na prvním řádku názvy sloupců.
  • Záhlaví je pevně dané, nemění se dynamicky.

Poznámky pro výpočet zisku:

  • Doporučená cena není nijak závazná, klidně prodávejte výrobky za vaši cenu (dráž, nebo levněji). Pokud však nechcete výrobek doplácet, logicky nesmíte jít pod vaši nákupní cenu.
  • Vaše provize se počítá z rozdílu mezi vaší nákupní cenou a vaší prodejní cenou. Pokud budete tedy prodávat výrobky dráže, přímo stoupá i váš zisk. Platí, že každá koruna nad vaší nákupní cenou je vaše (mínus DPH pochopitelně).

Poznámky pro programátory:

  • Odkaz pro stažení dokumentu bude vygenerován po registraci.
  • Tento dokument má nastavenu minutovou platnost, doporučujeme však nastavit váš systém tak, aby dokument stahoval méně často (například jednou za hodinu) a byl schopen provozu i když bude dokument nedostupný (například výpadek služby).
  • Pokud výrobek z tohoto dokumentu zmizí, měl by zmizet i ve vašem systému (například se přestal prodávat).
  • Pokud je sklad roven nule, bude výrobek naskladněnen v blízké době. V případě objednávky voláme objednavateli a nabízíme alternativy.
  • Pokud by došlo k objednání výrobku který již není k dispozici (například jej sekundu před vámi nekdo koupil), nestresujte se, není to žádný problém: voláme objednavateli a domlouváme se jak situaci vyřešit.