e-Bilet

Karayolu e-Bileti

Karayolu Request Örnekleri

Karayolu bileti oluşturma ve işlem çağrıları için tam ve kopyalanabilir örnekler.

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.

JSON örneğini görüntüle

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

{
  "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.

JSON örneğini görüntüle

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

{
  "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.

JSON örneğini görüntüle

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

{
  "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