> ## Documentation Index
> Fetch the complete documentation index at: https://api.basetools.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Základní principy

> Co je to objednávka v Base, odkud pochází a jak funguje její životní cyklus

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`](https://api.baselinker.com/index.php?method=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](/cs/objednavky/stahovani-objednavek).

## 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](/cs/objednavky/statusy).

## Struktura tohoto oddílu

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

<Tip>
  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.
</Tip>