Rehberler

Sipariş Akışı

Platformda oluşan bir siparişin posentegra üzerinden POS'a ve oradan müşteriye ulaşana kadar geçtiği durumlar.

Yaşam döngüsü

yaşam döngüsü

platformda oluştu
      │
      ▼
 verify ────────► doğrulandı
      │                │
      │                ▼
      │        change-status ──► hazırlanıyor ──► yolda ──► teslim
      │
      └──► cancel (gerekçe: /web-api/v1/orders/reasons/{orderId})

OpenAPI spec'i durum adları için bir enum tanımlamıyor; kabul edilen değerler platforma göre değişir, kanonik listeyi hesap yöneticinizden alın. (Doğrulandı: spec'teki tek enum dir sorgu parametresidir — [next, prev].)

Siparişi doğrula

POST /web-api/v1/orders/verify/{orderId}. Doğrulanmayan sipariş POS'a düşmez.

cURL

bash

curl -X POST https://api.v1.fastsiparis.com/web-api/v1/orders/verify/{orderId} \
  -H "Authorization: Bearer POSENTEGRA_API_KEY"

Durumu ilerlet

POST /web-api/v1/orders/change-status/{orderId} gövde almaz; siparişi sıradaki duruma taşır ve yanıtta oldStatus ile newStatus döner. Sipariş detayı için GET /web-api/v1/orders/{orderId} ucunu kullanın.

cURL

bash

curl -X POST https://api.v1.fastsiparis.com/web-api/v1/orders/change-status/{orderId} \
  -H "Authorization: Bearer POSENTEGRA_API_KEY"

İptal

Önce GET /web-api/v1/orders/reasons/{orderId} ile kabul edilen gerekçeleri çekin, sonra POST /web-api/v1/orders/cancel/{orderId} ile siparişi iptal edin.

cURL

bash

curl https://api.v1.fastsiparis.com/web-api/v1/orders/reasons/{orderId} \
  -H "Authorization: Bearer POSENTEGRA_API_KEY"

curl -X POST https://api.v1.fastsiparis.com/web-api/v1/orders/cancel/{orderId} \
  -H "Authorization: Bearer POSENTEGRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "TEST_REASON_CODE" }'

Raporlama ve yeniden deneme

GET /web-api/v1/orders/reports/pending işlenmemiş kayıtları listeler, POST /web-api/v1/orders/reports/mark bir kaydı işlendi olarak işaretler, POST /web-api/v1/orders/retry-webhook düşmeyen bir webhook'u yeniden gönderir, GET /web-api/v1/orders/grouped-payments ödeme kırılımını döndürür.

cURL

bash

curl https://api.v1.fastsiparis.com/web-api/v1/orders/reports/pending \
  -H "Authorization: Bearer POSENTEGRA_API_KEY"

curl -X POST https://api.v1.fastsiparis.com/web-api/v1/orders/reports/mark \
  -H "Authorization: Bearer POSENTEGRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "providerOrderId": "{providerOrderId}" }'

curl https://api.v1.fastsiparis.com/web-api/v1/orders/grouped-payments \
  -H "Authorization: Bearer POSENTEGRA_API_KEY"