Checkout i fakture
5 minPoslednja izmena: 2026-03-31
Atomski checkout tok
Ceo checkout se izvršava u jednoj transakciji baze podataka. Ako bilo koji korak ne uspe, sve se poništava, nema delimičnih porudžbina:
- Provera korpe: proverava da su svi artikli i dalje dostupni i da se cene poklapaju
- Provera stanja: proverava da ima dovoljno zaliha za sve artikle
- Adrese: proverava adresu za naplatu i adresu za dostavu
- Dostava: računa cenu dostave na osnovu zone i težine
- Rezervacija robe: atomski umanjuje zalihe (SELECT...FOR UPDATE)
- Kreiranje porudžbine: pravi porudžbinu sa stavkama i iznosima
- Generisanje fakture: pravi fakturu sa jedinstvenim rednim brojem
- Generisanje PDF-a: pravi fakturu kao PDF za preuzimanje
- Primena popusta: beleži korišćenje koda za popust, ako postoji
- Pražnjenje korpe: prazni kupčevu korpu
- Obaveštenja: šalje mejl sa potvrdom porudžbine (fire-and-forget)
Generisanje faktura
Svaka faktura dobija jedinstven redni broj pomoću atomskog SELECT...FOR UPDATE nad brojačem faktura. Faktura sadrži: podatke o prodavnici, podatke o kupcu, stavke sa cenama, međuzbir, dostavu, popust i ukupan iznos.
Iznosi se prikazuju po balkanskom standardu: tačka za hiljade, zarez za decimale (npr. 7.457,00 RSD).
Potvrda uplate
Kod plaćanja bankovnim prenosom trgovac potvrđuje uplatu:
POST /api/v1/storefront/merchant/invoices/:id/verify
{
"verified": true,
"notes": "Payment received via bank statement"
}
Potvrda okida workflow događaj payment_verified i prebacuje porudžbinu u status confirmed.
Kupovina bez naloga ili sa nalogom
- Gost: koristi zaglavlje
X-Cart-Session. Nalog nije potreban. Ostavlja mejl za obaveštenja o porudžbini. - Kupac sa nalogom: autentifikovan JWT-om kupca. Sačuvane adrese se automatski popunjavaju. Istorija porudžbina je dostupna na nalogu.