Olay Türleri

Bu parametre, ilgili webhook isteğinin hangi olay esnasında tetikleneceğini ve iletileceğini belirtir.

  • Enum Sınıf Adı: WebhookSubscribedEvent
  • Parametre Adı: subscribedEvent
Değer Açıklama
consignment.size.updated Sevkiyat boyut bilgileri güncellendiğinde tetiklenir
consignment.status.updated Sevkiyat durumu güncellendiğinde tetiklenir
consignment.label.created Sevkiyata yeni label eklendiğinde tetiklenir

Bu değerler, hem webhook oluşturulurken hem de yanıt verirken kullanılabilir. Kendi sisteminize dahil ederek entegrasyonu ve anlaşılabilirliği artırabilirsiniz.


Webhook Payload Örnekleri

Aşağıda her olay türü için webhook'un sisteminize göndereceği örnek payload'lar bulunmaktadır.

consignment.status.updated

Sevkiyat durumu güncellendiğinde tetiklenir.

{
  "headers": {
    "Authorization": "__YOUR_AUTH_KEY__",
    "Content-Type": "application/json"
  },
  "body": {
    "event": "consignment.status.updated",
    "data": {
      "consignmentId": 3396107,
      "consignmentUuid": "8378bbe5-b66c-4048-bf9d-b4cd52469bec",
      "barcode": "C2H04729482615",
      "referenceNo": "KPTT1661447TDBZP",
      "location": null,
      "status": 1,
      "statusMessage": "Consignment sent to provider",
      "statusUpdatedAt": "2025-10-31 13:09:16.903467",
      "lastTrackingCode": "KPTT1661447TDBZP",
      "createdAt": "2025-10-31 13:09:16.903467",
      "events": [
        {
          "status": 1,
          "statusMessage": "Consignment sent to provider",
          "statusUpdatedAt": "2025-10-31 13:09:16.903467",
          "location": null
        }
      ],
      "labels": []
    }
  }
}

consignment.label.created

Sevkiyata yeni label eklendiğinde tetiklenir.

{
  "headers": {
    "Authorization": "__YOUR_AUTH_KEY__",
    "Content-Type": "application/json"
  },
  "body": {
    "event": "consignment.label.created",
    "data": {
      "consignmentId": 3393215,
      "consignmentUuid": "8f5ad2c9-3a2a-4e7d-a858-d1b9e17fd15d",
      "barcode": "KP05917924760",
      "referenceNo": "EPTT898824753",
      "trackingCode": "KP05917924760",
      "trackingType": 1,
      "provider": "Ptt",
      "createdAt": "2025-10-31 13:09:16.903467",
      "updatedAt": "2025-10-31 13:09:16.903467",
      "base64label": "__BASE64_DATA__"
    }
  }
}

consignment.size.updated

Sevkiyat boyut bilgileri güncellendiğinde tetiklenir.

{
  "headers": {
    "Authorization": "__YOUR_AUTH_KEY__",
    "Content-Type": "application/json"
  },
  "body": {
    "event": "consignment.size.updated",
    "data": {
      "consignmentId": 3393215,
      "consignmentUuid": "8f5ad2c9-3a2a-4e7d-a858-d1b9e17fd15d",
      "barcode": "C2H11294525102",
      "referenceNo": "EPTT898824753",
      "weight": 0.5,
      "length": 0,
      "width": 0,
      "height": 0,
      "desi": 1,
      "lastTrackingCode": "KP05917924760",
      "createdAt": "2025-10-31 13:09:16.903467",
      "updatedAt": "2025-10-31 13:09:16.903467",
      "events": [
        {
          "status": 1,
          "statusMessage": "Consignment sent to provider",
          "statusUpdatedAt": "2025-10-31 13:09:16.903467",
          "location": null
        },
        {
          "status": 2,
          "statusMessage": "Kabul Edildi",
          "statusUpdatedAt": "2025-10-31 13:09:16.903467",
          "location": "SAKARYA PKİM/SAKARYA PKİM"
        }
      ],
      "statusMessage": "Kabul Edildi",
      "status": 2
    }
  }
}