DokumentacijaCheckout i fakture

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:

  1. Provera korpe: proverava da su svi artikli i dalje dostupni i da se cene poklapaju
  2. Provera stanja: proverava da ima dovoljno zaliha za sve artikle
  3. Adrese: proverava adresu za naplatu i adresu za dostavu
  4. Dostava: računa cenu dostave na osnovu zone i težine
  5. Rezervacija robe: atomski umanjuje zalihe (SELECT...FOR UPDATE)
  6. Kreiranje porudžbine: pravi porudžbinu sa stavkama i iznosima
  7. Generisanje fakture: pravi fakturu sa jedinstvenim rednim brojem
  8. Generisanje PDF-a: pravi fakturu kao PDF za preuzimanje
  9. Primena popusta: beleži korišćenje koda za popust, ako postoji
  10. Pražnjenje korpe: prazni kupčevu korpu
  11. 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.

Da li vam je ovaj članak pomogao?