Siparişler nasıl işler

Era'da bir sipariş (sales_order, orders kaynağı) ya ödeme adımındaki bir sepetten ya da birinin elle hazırladığı bir taslaktan doğar. Sonra gönderilmeyi bekler, bir ya da birkaç gönderiyle çıkar ve bir iade olarak geri dönebilir — ya da yolda iptal edilir veya süresi dolar. Ödeme ve stok elle girilen alanlar değildir; aşağıdaki işlemlerle siparişi izlerler.

                       complete_draft_order
   draft ─────────────────────────────────────┐
     │  (automatically_confirm_orders kapalı) │ (açık)
     ▼                                        ▼
 unconfirmed ──── confirm_order ──────────► unfulfilled ◄──── complete_checkout / site_place_order
     │                                        │
     └── expire_order ──► expired             │ fulfil_order (bir kısmı)      fulfil_order (kalanı)
                                              ├──────────► partially fulfilled ──────────► fulfilled
     cancel_order (açık her durumdan) ──► canceled                                         │
                                                                     return_products / receive_return
                                                                                            ▼
                                                                         partially_returned · returned

Durumlar

Siparişin bir de origin alanı vardır: checkout (sepetten) ya da draft (elle hazırlanmış); pazaryerinden aktarılanlar marketplace olur.

Siparişi ilerleten işlemler

Her işlem mağaza başvurusunda yer alır; bölümü bütün ön koşul kodlarını listeler.

Satırlar, teslimat yöntemi ve müşteri retail.update_order ile yalnız sipariş hâlâ draft ya da unconfirmed iken değiştirilebilir (müşteri ayrıca hiçbir şey gönderilmemişken).

Ödeme: charge_status

Ödemeler siparişin üzerinde tutulmaz. Sipariş verildiğinde finans onun için bir anlaşma açar; bu anlaşmaya kaydedilen ödemeler (bir ödeme uygulaması, havale ya da Finans → Tahsilatlar'da bir kişi tarafından) siparişin tahsil ettiği tutardır. Her ödeme, eşleştirme, iade ya da ödeme sağlayıcısı olayından sonra Era siparişin charge_status değerini yeniden hesaplar:

Ödenmesi gereken tutar; toplam artı hediye kartları, eksi verilmiş iadelerdir. Bütün tutarlar en küçük para biriminin tam sayısıdır (kuruş) — total_amount: 125000, 1.250,00 demektir.

Bilinmesi gerekenler:

• Gönderim ödemeyi beklemez. fulfil_order, charge_status'a bakmaz; yalnız ödenmiş siparişleri gönderiyorsan onları süz: GET /api/v1/orders?status=unfulfilled&charge_status=full.
• İptal iade başlatır. Sipariş iptal edildiğinde finansa, onun için tahsil edileni iade etmesi söylenir.
• Kısmi iadeler retail.grant_refund ile verilir (retail:manage ister; siparişin satış tutarını asla aşmaz). Finans sonra iadeyi tutarı karşılayabilen ödemeden yapar — tek bir ödeme karşılamıyorsa iadeyi bir kişinin göndermesine bırakır.
• authorize_status modelde var ama henüz kullanılmıyor: Era kart provizyonlarını tahsilattan ayrı tutmaz.

Stok

Siparişi yöneten ayarlar

Ayarlar → Mağaza (/settings/shop) altında:

Siparişlere tepki vermek

Her adım bir olay yayımlar — retail.order_placed, retail.order_confirmed, retail.fulfilment_created, retail.order_canceled, retail.order_expired, retail.order_returned, retail.order_charge_status_changed, retail.stock_low ve dahası (tam liste). Bunlara bir webhook ya da iş akışı bağla.

era orders list --status unfulfilled --charge-status full --json
era orders fulfil_order ORDER_ID --data '{"lines":[{"orderLineId":"LINE_ID","warehouseId":"WAREHOUSE_ID","quantity":1}],"notifyCustomer":true}'