Získat časovou tepelnou mapu objednávek
/api/crm/v2/orders_over_timev2ordersOverTime.defaultVrací heatmapu objednávek: hodiny dne podle dnů v týdnu, kalendářních dnů nebo měsíců. Na jeden požadavek lze vrátit až dvě období pro porovnání týdne s týdnem nebo měsíce s měsícem. Objednávky jsou agregovány po hodinách v UTC a vracejí se pouze neprázdné hodiny. Převod do časového pásma uživatele, řádkové seskupení a prázdné buňky jsou na straně klienta.
Autorizace
api-token + language + role
Parametry dotazu
Příklad: 25/04/2024
Příklad: 26/04/2024
Druhé období; prázdné, pokud není s čím porovnávat
Příklad: 25/03/2024
Příklad: 26/03/2024
Řádky mřížky: dny v týdnu, kalendářní dny nebo měsíce. Ovlivňuje pouze zobrazení, nikdy agregaci.
Hodnoty:weekdaydaymonth
Stav objednávky: na cestě, dokončeno, kompletace, v kuchyni, nezpracováno, připraveno k odeslání, čeká na odeslání do kuchyně, čeká na přepracování, zrušeno, potvrzeno, připraveno
Hodnoty:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked
Příklad: confirmed
Objednávková platforma
Hodnoty:androidapifbiosvksite
Způsob doručení: kurýr nebo osobní odběr
Hodnoty:courierpickup
Stav platby: nezaplaceno, čeká, zaplaceno
Hodnoty:not_paidwaitingpaid
Odpovědi
OK
Hodnoty:successerror
Příklad: success
Příklad: 2026-08-01 00:00:00
Příklad: date
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Příklad: 2026-08-31 23:59:59
Příklad: date
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Přednastavená období filtru podle data; dolní hranice je vypočítána v časovém pásmu uživatele. value — období, kterému odpovídají aktuální *_from a *_to; null — vlastní období. default — období, které server nastaví v požadavku bez dat: použije se také při prvním načtení sekce a při resetování. Horní hranice období je vždy rovna aktuálnímu dni uživatele, proto ji option neobsahuje: pro přednastavené období není třeba předávat *_to, server ji nastaví sám. Období delší než jeden rok je zkráceno na straně novější hranice.
Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.
Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear
Příklad: today
Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.
Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear
Příklad: today
Příklad: select
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.
Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear
Příklad: today
Příklad: 25/08/2026
Příklad: 2026-08-01 00:00:00
Příklad: date
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Příklad: 2026-08-31 23:59:59
Příklad: date
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Přednastavená období filtrování dat bez výchozí hodnoty: default je vždy null.
Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.
Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear
Příklad: today
Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.
Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear
Příklad: today
Příklad: select
Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.
Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear
Příklad: today
Příklad: 25/08/2026
Filtr-enum — plochý seznam hodnot výčtu
Příklad: example
Příklad: select
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Příklad: 8920
Příklad: select
Příklad: 8920
Příklad: Green Basket | Kaliningrad
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Příklad: 8920
Příklad: select
Příklad: 8920
Příklad: Green Basket | Kaliningrad
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Filtr-enum — plochý seznam hodnot výčtu
Příklad: example
Příklad: select
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Filtr-enum — plochý seznam hodnot výčtu
Příklad: example
Příklad: select
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Filtr-enum — plochý seznam hodnot výčtu
Příklad: example
Příklad: select
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Filtr-enum — plochý seznam hodnot výčtu
Příklad: example
Příklad: select
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Příklad: 8920
Příklad: select
Příklad: 8920
Příklad: Green Basket | Kaliningrad
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Příklad: 8920
Příklad: select
Příklad: 8920
Příklad: Green Basket | Kaliningrad
Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.
Hodnoty:force_shownvalue_required
Příklad: value_required
Hodnoty:ab
Příklad: a
Příklad: 25/04/2024
Příklad: 26/04/2024
Připravené období, kterému odpovídají hranice; null, pokud je období libovolné
Příklad: week
Příklad: 47
Příklad: 52640
Příklad: 1120
Objednávky seskupené podle hodin; pouze neprázdné hodiny. Nejprve převeďte čas do časového pásma uživatele, poté podle výsledku určete řádek a sloupec a doplňte chybějící hodnoty nulami.
Hodina, ke které se vztahují objednávky, v UTC
Příklad: 2024-04-25 14:00:00
Příklad: 47
Příklad: 52640