DokumentacijaUpravljanje porudžbinama

Upravljanje porudžbinama

4 minPoslednja izmena: 2026-03-31

Stanja porudžbine

Svaka porudžbina prolazi kroz definisan niz stanja (state machine):

pending → confirmed → preparing → shipped → delivered
   ↓                                         ↓
cancelled                              return_requested → returned → refunded

Svaki prelaz se proverava, porudžbina može da pređe samo u dozvoljeno sledeće stanje. Nedozvoljeni prelazi se odbijaju.

Događaji porudžbine

Svaka promena statusa pravi zapis događaja porudžbine sa vremenom, prethodnim statusom, novim statusom i opcionim beleškama. Tako za svaku porudžbinu imate potpun revizioni trag.

Integracija sa workflowom

Porudžbine okidaju workflow triggere u ključnim trenucima:

  • storefront_order_placed: kreirana nova porudžbina
  • payment_verified: trgovac je potvrdio uplatu
  • payment_overdue: faktura je prošla rok plaćanja
  • cart_abandoned: kupac je ostavio artikle u korpi

Koristite ove triggere da automatizujete obaveštenja, ažurirate zalihe ili obavestite svoj sistem za ispunjenje porudžbina.

Otkazivanje i povraćaj

Porudžbina može da se otkaže pre slanja (status prelazi u cancelled, roba se oslobađa). Posle isporuke kupac može da zatraži povraćaj. Trgovac pregleda zahtev i može da odobri povraćaj, čime se pokreće tok returned → refunded.

API endpointi

GET    /api/v1/commerce/orders         - Lista porudžbina (sa filterima)
GET    /api/v1/commerce/orders/:id     - Detalji porudžbine sa događajima
PUT    /api/v1/commerce/orders/:id/status: Izmena statusa porudžbine
GET    /api/v1/commerce/orders/stats   - Statistika porudžbina

Da li vam je ovaj članak pomogao?