Zakázky

Vrací stránkovaný seznam zakázek. Seznam je možné filtrovat podle níže uvedených parametrů.

⚠️ Zdrojová tabulka „Query parametry pro filtrování" nebyla při tvorbě této specifikace čitelná. Níže uvedené parametry jsou pouze ty, které se objevují v ukázkových dotazech ve zdrojové dokumentaci — tabulka pravděpodobně obsahuje další filtry (např. rozsah dat do, servisní středisko, typ/model výrobku). Parametry page a page_size jsou odvozeny z názvů polí v odpovědi (meta.page_current, meta.page_size), jejich přesný název na vstupu nebyl ověřen.

Vrací detail jedné zakázky podle jejího interního ID.

Vytvoří novou zakázku a případně objedná dopravu od zákazníka do servisu.

Zakázku lze vytvořit i bez objednávky dopravy (shipment_from_customer: false) — jde potom o jednosměrnou zakázku, sloužící pouze k zaslání výrobku zákazníkovi zpět. Obousměrná zakázka obsahuje na konci servisního procesu jak dopravu od zákazníka, tak dopravu zpět k zákazníkovi.

Při vytvoření zakázky včetně dopravy (shipment_from_customer: true) je zakázka po doručení zásilky do servisu automaticky přepnuta do stavu processing. V době od vytvoření do doručení je zakázka ve stavu incoming — zakázky vytvořené servisním střediskem přes API jsou totiž automaticky schválené (na rozdíl od zakázek zadaných koncovým zákazníkem přes frontend, které čekají ve stavu pending na schválení).

Slouží ke změně údajů zakázky a k objednání dopravy ze servisu zpět k zákazníkovi.

Pokud je objednávána doprava zpět k zákazníkovi (shipment_to_customer: true), zakázka se po doručení zásilky zpět zákazníkovi automaticky uzavře a vygenerují se příslušné notifikace. Bez zásilky zákazníkovi zůstává zakázka otevřená až do ručního uzavření (servisním střediskem, nebo nastavením status přes toto API).

Objednaná odchozí zásilka se vytvoří na nejbližší termín svozu; zakázka musí být ve stavu outgoing (lze nastavit současně s objektem shipment) a automaticky se exportuje dopravci.

⚠️ Zdrojová tabulka „BODY" pro tento endpoint nebyla při tvorbě této specifikace čitelná. Pole požadavku níže byla rekonstruována z ukázkových JSON požadavků v dokumentaci — doporučujeme ověřit proti zdrojové tabulce, zejména u pole product_model (v ukázce se objevuje jako vstupní pole, ačkoli se stejnojmenné pole jinak jeví jako odvozené z product_id/external_key).

Slouží k nahrání souboru potřebného u záručních oprav, zejména dokladu o nákupu výrobku. Vrácený token se následně použije v poli invoice_file_token při vytvoření zakázky. Povolené koncovky: PDF, JPG, JPEG. Maximální velikost souboru je 2 MB.