Typy objednávek

​

Definice

Typ objednávky určuje typ nákupu jejích řádkových položek. Každá položka objednávky nese pole purchaseType a jedna objednávka může kombinovat položky různých typů – například zapůjčené kolo vedle rovnou prodaného příslušenství. Typ nákupu řídí, jak se počítá cena, jaká pravidla vyřízení platí a které přechody životního cyklu jsou možné.

​

Kde to použiji?

• Konfigurace pravidel automatického vyřízení podle typu nákupu
• Nastavení inzerátů tak, aby je bylo možné rezervovat, koupit, nebo obojí
• Filtrování reportů podle typu nákupu
• Budování workflows, které se větví podle typu objednávky
• API integrace, které potřebují odlišné chování pro rezervace oproti prodejům

​

Klíčové vlastnosti

Podporované typy nákupu jsou definovány v OrderItem.purchaseType: Každá řádková položka má:

• startDate a endDate – vymezují rentální období u rezervací; u prodejů volitelné
• duration a durationLabel – délku rentálního období a jeho zobrazovaný popisek
• pricing – vypočtenou z cenové tabulky, která odpovídá purchaseType a datům položky
• capturedTotal a refundedTotal – agregaci plateb na úrovni řádku
• depositAuthorisedTotal, depositCapturedTotal, depositRefundedTotal, depositCancelledTotal – součty kaucí na úrovni řádku, běžné u rezervací
• fulfillmentState – vlastní stav vyřízení řádku; skladové položky zavázané k řádku nesou svůj vlastní stav

​

Vztahy

• Každá položka objednávky odkazuje na inzerát a dědí jeho způsobilé typy nákupu.
• Odpovídající cenová tabulka určuje, jak je řádková položka oceněna (za den, paušálně, s ohledem na odpisy u výkupů atd.).
• Místa definují samostatná pravidla vyřízení a vrácení podle typu nákupu – viz automatické vyřízení.
• Skladové položky zavázané k rentální řádkové položce odcházejí při vyzvednutí a vrací se na konci rentálního období; prodejní řádky se nevrací.

​

Životní cyklus

​

Rentální objednávky

Výchozí případ použití cirkulární komerce. Zákazník přebírá položky na vymezené období a poté je vrací.

• Cena: sazby za období z rentální cenové tabulky inzerátu (za hodinu, za den, za týden, vlastní).
• Vyřízení: vyzvednutí (v prodejně, zasláním nebo místním doručením) v startDate, vrácení v endDate.
• Kauce: běžně vyžadována. Držena jako samostatná autorizace nebo strhnutí a uvolněna či vrácena při vrácení.
• Životní cyklus: Otevřeno → Probíhá → Dokončeno.
• Storno: řídí se storno politikou objednávky.
• Úpravy: rentální data lze obvykle prodloužit, dokud objednávka Probíhá.

​

Prodejní objednávky

Trvalý převod vlastnictví – typický pro příslušenství, prodej použitého zboží nebo prodej nového zboží vedle rentálního katalogu.

• Cena: paušální prodejní cena z prodejní cenové tabulky inzerátu.
• Vyřízení: jednorázová dodávka. Vrácení se neočekává.
• Kauce: neuplatňuje se.
• Životní cyklus: Otevřeno → Probíhá (předáno / odesláno) → Dokončeno. Neexistuje krok předání/vrácení jako u rezervace.
• Storno: po vyřízení musí následovat tok vrácení peněz – viz platby.
• Úpravy: položky lze přidávat nebo odebírat, dokud je objednávka Otevřeno, ne po vyřízení.

​

Objednávky s předplatným

Opakovaná fakturace za trvající přístup k produktu nebo službě – používá se pro členství, pronájmy leasingového typu a vybavení jako službu.

• Cena: sazba za cyklus z předplatitelské cenové tabulky inzerátu. Každý plán definuje fakturační cyklus (např. měsíčně), délku závazku a volitelnou cenu obnovení.
• Vyřízení: typicky jedna počáteční dodávka, s obdobím předplatného sledovaným na objednávce.
• Fakturace: vyžaduje platebního poskytovatele s podporou opakovaných plateb (kartové platby Stripe nebo Adyen).
• Životní cyklus: zůstává Probíhá po dobu trvání předplatného. Uzavírá se, když předplatné skončí nebo je zrušeno.
• Storno: ukončí předplatné a zastaví budoucí fakturaci. Podle dohody může být nutné položky vrátit.
• Zákaznický portál: zákazníci spravují svá předplatná přes samoobslužný portál pro předplatné – dostupný přes zabezpečený odkaz v e-mailech o předplatném.

​

Výkupní objednávky

Obchodník získává položku od zákazníka – klíčová součást cirkulární komerce. Používá se, když zákazníci vyměňují nebo prodávají zpět použité položky.

• Cena: obchodník platí zákazníkovi. Často počítána z odpisové sazby nebo vzorce podle stavu.
• Vyřízení: zákazník předá položku; obchodník ji přijme do zásob jako novou skladovou položku.
• Směr platby: obrácený – obchodník dluží zákazníkovi. Výplaty probíhají přes nastavenou platební metodu.
• Životní cyklus: Otevřeno (nabídka čeká) → Probíhá (položka přijata) → Dokončeno (výplata dokončena).
• Kde se objevuje: místa mají ve svých pravidlech vyřízení a vrácení vyhrazenou kartu Výkup.

​

Smíšené objednávky

Jedna objednávka může obsahovat řádkové položky různých typů nákupu – například týdenní pronájem lyží (booking) plus pár ponožek (sale). Každá řádková položka nese svůj vlastní purchaseType, data a cenu a vyřizuje se podle pravidel daného typu.

​

Časté dotazy

​

Vývojářská reference

Typ objednávky se nastavuje přes purchaseType na endpointech orders.

​

Související články