Ferwer - produtos orgânicos com uma história

Vyhledání produktů

Fulltextové hledání v katalogu Ferwer (parfémy, kosmetika, drogerie). Vrací seznam produktů s aktuální cenou, měnou a dostupností pro doménu/trh, na které server běží. Ceny jsou real-time z databáze obchodu – necachovat déle než pár minut. item_id z výsledku použij v get_product_offer nebo create_checkout.

Detail produktu

Kompletní detail produktu podle číselného product_id: popis, značka, EAN, obrázky, aktuální cena a akční cena, dostupnost a všechny varianty (objemy ml / velikosti). U variant použij item_id konkrétní varianty pro nákup – nikdy nekupuj produkt vyžadující velikost bez item_id varianty.

Aktuální nabídka položky

Aktuální cena, akční cena, měna a dostupnost pro konkrétní prodejní položku (item_id). item_id je buď product_id, nebo "{productId}-{sizeId}" u velikostních variant. Vždy volej před vložením do košíku – ceny se mohou měnit.

Dostupnost položky

Rychlá kontrola, zda je položka (item_id) dostupná v požadovaném množství. Real-time stav skladu.

Možnosti dopravy

Dostupné dopravy pro zemi (ISO 3166-1 alpha-2, např. CZ/SK/DE) s cenou a limitem dopravy zdarma. S checkout_id vrací možnosti pro konkrétní košík (váha, hodnota). Dopravy s requires_pickup_point=true vyžadují při výběru ID výdejního místa.

Založení checkoutu

Založí checkout session s položkami (item_id + quantity), volitelně rovnou s dodací adresou a kontaktem. Ceny, doprava i celková částka se počítají server-side z aktuální databáze – cenu nelze zadat. Session platí 24 hodin. Vrácené checkout_id použij pro update/complete.

Úprava checkoutu

Upraví checkout session: položky (items = kompletní náhrada), adresu, kontakt, výběr dopravy (delivery_id z shipping_options; u výdejních míst přidej pickup_point). Po každé změně vrací přepočítané totals.

Slevový kód

Aplikuje slevový kód na checkout session. Platnost ověřuje obchod – neplatný kód vrátí chybu a checkout zůstane beze změny. Prázdný kód slevu odebere.

Stav checkoutu

Aktuální stav checkout session včetně přepočítaných cen a dostupnosti položek. status=ready_for_payment znamená, že lze volat complete_checkout.

Dokončení objednávky

ZÁVAZNĚ vytvoří objednávku z checkout session. VOLEJ POUZE s výslovným souhlasem uživatele po zobrazení kompletní rekapitulace (položky, ceny, doprava, celková částka). Vyžaduje confirm=true jako potvrzení souhlasu. Operace je idempotentní – opakované volání vrátí tutéž objednávku. Platba probíhá přes payment_url v odpovědi (uživatel ji dokončí v prohlížeči) – žádné platební údaje se nepředávají.

Stav objednávky

Stav existující objednávky podle order_id nebo order_hash: zaplacení, stav vyřízení, položky, odkaz.