e-Bilet

Karayolu e-Bileti

Karayolu Request Örnekleri

Karayolu bileti oluşturma ve işlem çağrıları için tam endpoint ve body sözleşmesiyle sunulan kopyalanabilir JSON request örnekleri.

Tam Oluşturma Örneği

Örnek, bilet numarasını platformun ürettiği Türkiye Cumhuriyeti vatandaşı yolcu senaryosudur. Tarihleri ve tekil alanları kendi işleminize göre değiştirin.

Türkiye Cumhuriyeti vatandaşı bir yolcu için standart karayolu bileti oluşturma isteği.

Endpoint: POST /api/CustomHwTicket/HwTicketSave
Body: HwTicketRequestModel (JSON)

{
  "LocationCode": "BLT",
  "IsCancel": false,
  "TicketNumber": null,
  "TicketPnrNo": "PNR-20260802-001",
  "TicketExternalNumber": "ERP-KY-20260802-0001",
  "TicketReferenceNumber": null,
  "BranchCode": "IST01",
  "BranchName": "İstanbul Şubesi",
  "PassangerTaxOrId": "11111111111",
  "PassangerIsTR": true,
  "PassangerNameSurname": "Örnek Yolcu",
  "PassangerPasaportNo": null,
  "ServiceType": "SEYAHAT",
  "PaymentType": "KREDIKARTI",
  "IsCustomer": false,
  "CustomerTaxOrId": null,
  "CustomerName": null,
  "CustomerTaxOffice": null,
  "OtherTaxCode": null,
  "OtherTaxName": null,
  "OtherTaxAmount": 0,
  "TicketFee": 1000.00,
  "TicketVatAmount": 100.00,
  "TicketTotalFee": 1100.00,
  "DepartureDate": "2026-08-15T09:30:00+03:00",
  "DepartureFrom": "İstanbul",
  "Destination": "Ankara",
  "DepertureNo": "SEFER-001",
  "SeatNumber": "12A",
  "CustomField1": null,
  "CustomField2": null,
  "CustomField3": null,
  "TicketDescription": "İstanbul - Ankara yolcu bileti",
  "TicketModDate": "2026-08-02T14:30:00+03:00",
  "CancelDate": null,
  "XsltFileName": null,
  "UUId": null
}

Yabancı Yolcu Farkı

Bu örnekte yolcu kimliği pasaportla bildirilir. Gövde tamdır; ilk örneğe göre değişen alanlar PassangerIsTR, PassangerTaxOrId, PassangerPasaportNo ve PassangerNameSurname alanlarıdır.

Yabancı yolcu için eksiksiz oluşturma isteği.

Endpoint: POST /api/CustomHwTicket/HwTicketSave
Body: HwTicketRequestModel (JSON)

{
  "LocationCode": "BLT",
  "IsCancel": false,
  "TicketNumber": null,
  "TicketPnrNo": "PNR-20260802-002",
  "TicketExternalNumber": "ERP-KY-20260802-0002",
  "TicketReferenceNumber": null,
  "BranchCode": "IST01",
  "BranchName": "İstanbul Şubesi",
  "PassangerIsTR": false,
  "PassangerTaxOrId": null,
  "PassangerPasaportNo": "P12345678",
  "PassangerNameSurname": "Example Passenger",
  "ServiceType": "SEYAHAT",
  "PaymentType": "KREDIKARTI",
  "IsCustomer": false,
  "CustomerTaxOrId": null,
  "CustomerName": null,
  "CustomerTaxOffice": null,
  "OtherTaxCode": null,
  "OtherTaxName": null,
  "OtherTaxAmount": 0,
  "TicketFee": 1000.00,
  "TicketVatAmount": 100.00,
  "TicketTotalFee": 1100.00,
  "DepartureDate": "2026-08-15T09:30:00+03:00",
  "DepartureFrom": "İstanbul",
  "Destination": "Ankara",
  "DepertureNo": "SEFER-001",
  "SeatNumber": "12B",
  "CustomField1": null,
  "CustomField2": null,
  "CustomField3": null,
  "TicketDescription": "İstanbul - Ankara yabancı yolcu bileti",
  "TicketModDate": "2026-08-02T14:35:00+03:00",
  "CancelDate": null,
  "XsltFileName": null,
  "UUId": null
}

Gider Gösteren Farkı

Bu örnekte bilet, müşteri bilgileriyle gider gösterilecek şekilde oluşturulur. Gövde tamdır; ilk örneğe göre IsCustomer ve müşteri alanları değişir.

Gider gösteren müşteri bilgileriyle eksiksiz oluşturma isteği.

Endpoint: POST /api/CustomHwTicket/HwTicketSave
Body: HwTicketRequestModel (JSON)

{
  "LocationCode": "BLT",
  "IsCancel": false,
  "TicketNumber": null,
  "TicketPnrNo": "PNR-20260802-003",
  "TicketExternalNumber": "ERP-KY-20260802-0003",
  "TicketReferenceNumber": null,
  "BranchCode": "IST01",
  "BranchName": "İstanbul Şubesi",
  "PassangerTaxOrId": "11111111111",
  "PassangerIsTR": true,
  "PassangerNameSurname": "Örnek Yolcu",
  "PassangerPasaportNo": null,
  "ServiceType": "SEYAHAT",
  "PaymentType": "KREDIKARTI",
  "IsCustomer": true,
  "CustomerTaxOrId": "1234567890",
  "CustomerName": "Örnek Seyahat AŞ",
  "CustomerTaxOffice": "Büyük Mükellefler",
  "OtherTaxCode": null,
  "OtherTaxName": null,
  "OtherTaxAmount": 0,
  "TicketFee": 1000.00,
  "TicketVatAmount": 100.00,
  "TicketTotalFee": 1100.00,
  "DepartureDate": "2026-08-15T09:30:00+03:00",
  "DepartureFrom": "İstanbul",
  "Destination": "Ankara",
  "DepertureNo": "SEFER-001",
  "SeatNumber": "12C",
  "CustomField1": null,
  "CustomField2": null,
  "CustomField3": null,
  "TicketDescription": "İstanbul - Ankara gider gösteren yolcu bileti",
  "TicketModDate": "2026-08-02T14:40:00+03:00",
  "CancelDate": null,
  "XsltFileName": null,
  "UUId": null
}

Body İçermeyen İşlemler

Aşağıdaki işlemler için JSON örneği yoktur; çünkü sözleşme URI parametresi kabul eder.

POST /api/CustomHwTicket/CancelHwTicket?ticketExternalNumber=ERP-KY-20260802-0001
POST /api/CustomHwTicket/KyGetTicketStatus?ticketNumber=BLT2026000000001
GET /api/CustomHwTicket/GetTicketByExternalNumber?ticketExternalNumber=ERP-KY-20260802-0001