Základní principy

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

• Stahování objednávek — jak periodicky stahovat objednávky metodou getOrders.
• Statusy — čtení i zápis stavů, typický setup, storna.
• Přepravní štítky — čísla zásilek a štítky od dopravců.
• Faktury — vystavení faktury v Base nebo napojení faktury z ERP.
• Extra pole — vlastní pole napojená na objednávku.
• Automatizace a webhooky — jak zachytávat události (storno, změna stavu) v reálném čase.