Tato sekce popisuje, jak pracovat s objednávkami mezi vaším systémem a Base.com přes API. Naprostá většina integrací funguje směrem z Base ven — stahujete objednávky, které vznikly z e-shopu, marketplace nebo ručně v panelu, do vlastního ERP/skladu/účetnictví.
Odkud objednávka pochází
Každá objednávka má pole order_source — typicky "shop" (e-shop napojený na Base), "personal" (ručně založená v panelu), "order_return", nebo kód konkrétního marketplace kanálu ("allegro", "amazon", "ebay", "ceneo", "emag" atd.). Seznam všech zdrojů a jejich ID vrací getOrderSources.
Potvrzené a nepotvrzené objednávky
Toto je nejdůležitější koncept celého objednávkového API. Base rozlišuje:
- Nepotvrzenou objednávku (
confirmed: false) — u některých marketplace kanálů (typicky Alza, Allegro) vzniká nejprve jen jakási neúplná „kostra” objednávky (u Alzy např. Order Insert). Vidíte položky, ale ne nutně kompletní adresu, cenu nebo způsob dopravy — data se ještě mohou měnit.
- Potvrzenou objednávku (
confirmed: true, vyplněné date_confirmed) — marketplace poslal potvrzení (Order Confirm u Alzy), Base doplnil zbývající údaje. Od tohoto okamžiku by se objednávka již neměla zásadně měnit a je bezpečné ji natrvalo uložit do externího systému.
Tento koncept je zásadní pro to, jak správně stahovat objednávky — viz Stahování objednávek.
Stavy objednávek
Nezávisle na potvrzení má každá objednávka i uživatelsky definovaný stav (order_status_id) — např. Nové objednávky, Poslat, Odesláno, Doručeno, Zrušeno. Stavy si každý účet nastavuje sám a jejich chování se řídí Automatickými akcemi. Detailně v Statusy.
Struktura tohoto oddílu
Pokud si nejste jistí, kde v této struktuře hledat konkrétní scénář, klidně se zeptejte implementačního oddělení — rádi poradí, než začnete stavět integraci.