Karayolu e-Bileti

Karayolu Entegratör API

Karayolu bileti oluşturma, iptal, durum ve harici numara sorgulama endpoint sözleşmeleri.

Endpoint Matrisi

İşlem	HTTP	Adres	Girdi
Karayolu bileti oluştur	`POST`	`/api/CustomHwTicket/HwTicketSave`	JSON body: `HwTicketRequestModel`
Bileti iptal et	`POST`	`/api/CustomHwTicket/CancelHwTicket?ticketExternalNumber={değer}`	URI parametresi; body yok
Durum sorgula	`POST`	`/api/CustomHwTicket/KyGetTicketStatus?ticketNumber={değer}`	URI parametresi; body yok
Harici numarayla getir	`GET`	`/api/CustomHwTicket/GetTicketByExternalNumber?ticketExternalNumber={değer}`	URI parametresi; body yok

Oluşturma Sözleşmesi

HwTicketSave yalnızca JSON body kabul eder. Başarılı cevapta Data.TicketNumber ve Data.UUId saklanmalıdır. Bu cevap, imzalı PDF veya GİB raporu sonucu değildir.

{
  "Data": {
    "TicketNumber": "BLT2026000000001",
    "UUId": "ea9c6fc2-e0ea-41df-b816-f6f9d70fdcdf",
    "IsSucceded": true,
    "Messages": []
  },
  "HasError": false,
  "Errors": []
}

URI Parametreli İşlemler

İptal ve durum çağrılarında JSON body kullanılmaz. Parametre adı endpointte yazıldığı biçimiyle gönderilir ve URL güvenli kodlanır.

POST /api/CustomHwTicket/CancelHwTicket?ticketExternalNumber=ERP-KY-20260802-0001
VbtAuthorization: {token}

POST /api/CustomHwTicket/KyGetTicketStatus?ticketNumber=BLT2026000000001
VbtAuthorization: {token}

GET /api/CustomHwTicket/GetTicketByExternalNumber?ticketExternalNumber=ERP-KY-20260802-0001
VbtAuthorization: {token}

Önerilen Çağrı Sırası

Kaynak sistemde değişmeyecek bir TicketExternalNumber üretin.
HwTicketSave ile bileti oluşturun.
Response içindeki bilet numarası ve ETTN'yi kalıcı olarak saklayın.
PDF ve durum için aynı kimliklerle sorgulama yapın.
Timeout halinde yeni kimlik üretmeden önce harici numarayla kaydı arayın.