SuitablePOS Entegrasyon API

SuitablePOS dokümanı temel yapıyı gösterir; endpoint, alan adları, authentication ve response formatları kurye firmasına göre uyarlanabilir. Aşağıdaki sözleşme KuryeX özelleştirmesidir.

Base URL (canlı): https://kuryex.net/v1/

Auth (inbound): Authorization: Bearer <token>

curl -X POST "https://kuryex.net/v1/orders/external" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -d '{
  "storeId": 12345,
  "paymentType": "cash",
  "price": 85.50,
  "customerFirstName": "Ahmet",
  "customerLastName": "Yılmaz",
  "customerPhone": "905551234567",
  "deliveryAddress": "Atatürk Cad. No:123 Beşiktaş Daire 5",
  "deliveryAddressDetails": "Market Yanı",
  "orderNote": "Zeytin istemiyorum",
  "products": [
    { "id": "1767964527", "name": "Kaşık Salata", "price": 10, "quantity": 1 }
  ],
  "deliveryLatitude": 41.0428476152693,
  "deliveryLongitude": 29.0062497136863,
  "originalCreateOn": "2026-01-12T08:29:44.386Z",
  "integrationOrderId": "ORD789456",
  "orderOrigin": "OTHER"
}'

200 — {"success":true,"message":"Order received successfully"}

Zorunlu: storeId, paymentType, price, müşteri alanları, deliveryAddress, products, originalCreateOn, integrationOrderId, orderOrigin

KuryeX → SuitablePOS outbound webhook. Header: api-key

URL SuitablePOS tarafından paylaşılır (SUITABLEPOS_STATUS_WEBHOOK_URL).

{
  "storeId": 12345,
  "orderId": "CR789123456",
  "orderStatusText": "PICKED_UP",
  "cancelledText": "Müşteriye ulaşılamadı"
}

200 — {"success":true,"message":"order cancelled"}