§ 22. srpna 2026 - E-commerce

Během srpna se modul sparrow_ecommerce posunul z „košíku, který mluví se Stripem“ na obchod, který se dá reálně provozovat: dopravci a výdejní místa, čtyři platební metody, e-maily k objednávkám, pořádný pult pro objednávky v administraci a fakturační vrstva s číslovanými fakturami. Vše je součástí základního image od Sparrow 7.4.22; weby si jednotlivé části zapínají v nastavení.

Doprava jsou teď data, ne kód. Editoři zakládají dopravní metody v administraci - paušál, zdarma nad limit, dostupnost podle země - a pokladna je nabízí automaticky. Tři čeští dopravci mají vestavěné widgety výdejních míst: Packeta (Zásilkovna), PPL ParcelShop a Balíkovna. Zákazník vybere pobočku na mapě, volba se uloží k objednávce i s metadaty dopravce a tiskne se na dodací list.

Dobírka je platební backend s vlastními pravidly: poplatek za metodu, maximální hodnota objednávky a možnost ji vypnout pro vybrané země nebo dopravce.

Platební backendy se registrují pro web a zapínají per právní subjekt z administrace, takže obchod nabídne jinou kombinaci bez nasazení nové verze:

• Bankovní převod - potvrzovací stránka i e-mail nesou český SPAYD QR kód (účet, částka, variabilní symbol), platba z bankovní aplikace je jedno naskenování.
• Stripe - karty, Google Pay a Apple Pay, potvrzení přes webhook.
• PayPal - hostovaná pokladna s webhookem.
• Comgate - česká brána pro karty a bankovní tlačítka.

Zapojení je slovník v nastavení; tajemství zůstávají v namespace, nikdy v image:

SPARROW_ECOMMERCE_PAYMENT_BACKENDS = {
    "bank_transfer": {
        "class": "sparrow_ecommerce.payments_bank_transfer.backend.BankTransferBackend",
        "label": "Bankovní převod",
    },
    "stripe": {
        "class": "sparrow_ecommerce.payments_stripe.backend.StripeBackend",
        "label": "Karta / Google Pay (Stripe)",
        "api_key": os.environ.get("STRIPE_SECRET_KEY", ""),
        "webhook_secret": os.environ.get("STRIPE_WEBHOOK_SECRET", ""),
    },
    "comgate": {
        "class": "sparrow_ecommerce.payments_comgate.backend.ComgateBackend",
        "label": "Comgate",
        "merchant": os.environ.get("COMGATE_MERCHANT", ""),
        "secret": os.environ.get("COMGATE_SECRET", ""),
    },
}

Objednávky mají pořadová čísla místo náhodných tokenů a každá změna stavu odešle e-mail - potvrzení, zaplaceno, odesláno - ze šablon, které si web může přepsat. Seznam objednávek v administraci dostal náhled a akce na jedno kliknutí: označit jako zaplaceno, odesláno (se sledovacím číslem), stornovat, vrátit peníze. Zásilky a interní poznámky jsou u objednávky; zákazník poznámky nikdy nevidí.

Ceny konečně vypadají jako ceny: nový filtr money formátuje částky s měnou (79 Kč, 1 234,50 Kč), košík ukazuje formátované součty a tlačítko Pokračovat k pokladně.

Stejný modul teď nese i back-office fakturaci, kterou používáme pro hosting: trvalé zákazníky s IČO/DIČ, předplatná a jejich obnovovací faktury, registrace domén, jednorázové faktury za projektovou práci a identity obchodu - více právních subjektů, každý s vlastní číselnou řadou faktur a bankovními údaji. Faktury se renderují do PDF se SPAYD QR kódem a vystavují se z nabídky „Nová faktura“ přímo v administraci.

Provoz popisují dvě nové stránky dokumentace: Provoz e-shopu a Platební a dopravní integrace.