Upravljanje porudžbinama
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žbinapayment_verified: trgovac je potvrdio uplatupayment_overdue: faktura je prošla rok plaćanjacart_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