e-Bilet Rest Api Geliştirici Kılavuzu (1.0)
Download OpenAPI specification:Download
Turkcell e-Şirket e-Bilet API uç noktalarını, kullanıcı yönetiminden entegrasyon kullanıcısı oluşturarak kullanamaya başlayabilirsiniz. API kullanımı ve entegrasyon süreçlerinize başlamadan önce mutlaka satis@eplatform.com.tr adresinden satış ekibimiz ile iletişime geçmelisiniz.Satın alma süreçlerinden sonra satış temsilcimiz entegrasyon ekibimiz ile iletişime geçecektir. Turkcell e-Şirket bünyesindeki yer alan diğer uygulamaların dökümantasyonlarına https://developer.turkcellesirket.com adresinden ulaşabilirsiniz. Servis uç noktalarımız authentication mekanizması olarak OAuth 2.0 kullanmaktadır.
Canlı ortamı Auth servis adresi; https://core.turkcellesirket.com/v1/token
Test ortamı Auth servis adresi; https://coretest.isim360.com/v1/token
Entegrasyon çalışmalarında yaptığınız işlemlerin sonuçlarını, test portalimizi kullanarak gözlemleyebilirsiniz.
Test arayüz adresi; https://maintest.isim360.com/
Örnek token isteği; {
-X POST https://core.turkcellesirket.com/v1/token /
-H 'Cache-Control: no-cache' /
-H 'Content-Type: application/x-www-form-urlencoded' /
-d 'username=yourUserName&password=yourPassword&client_id=serviceApi'
}e-Bilet servis adresi: https://ebiletservice.turkcellesirket.com e-Bilet servisini kullanarak işlem yapmak için, bu adresi baz alarak işlem gerçekleştirmelisiniz.
Etkinlik e-Bilet gönderim ve sorgulama için ortak olan servis uç noktalarını içerir.
Post Ticket
Yeni bilet kayıt etmek için kullanılır. Turkcell e-Şirket bilet oluşturma arayüzlerininde kullandığı, JSON model vasıtasıyla bilet oluşturmak isteyenler için sunulan uç noktasıdır.
Request Body schema: application/json
| ettn | Guid Bilet Ettn'sidir. |
| status | integer Enum: "Taslak : 0" "Kuyrukta : 20" Biletin durumunu belirtir. |
| documentType | byte Enum: "SATIS : 0" "IADE : 1" Belge tipi. |
| ticketType required | string Enum: "YOLCU" "ETKINLIK" Bilet tipi. |
| ticketDate | Datetime Bilet tarihi. |
| ticketNumber required | string ÖRNEK:BLT2020000001220, 3 hane ön ek, 4 hane yıl bilgisi, 9 bilet numarası olacak şekilde 16 haneli olur.Sayacın 1'den başlayıp müteselsil olarak devam etmesi önemlidir. |
| prefix required | string Bilet numarasının ilk üç hanesi ile (ön ek) aynı gönderilmesi gerekmektedir.Örnek olarak yukarıdaki BLT2020000001220 fatura numarasındaki ön ek(BLT) ile aynı olmalıdır. |
| currencyCode | string Para Birimi. Boş veya null gönderilemez,farklı bir para birimi değeri yoksa TRY gönderilmeli. |
| exchangeRate | decimal Döviz kuru. |
| referenceNumber | string Referans numarasıdır. |
| identifier | string VKN/TCKN/Pasaport bilgisidir. |
| customerFirstName | string Müşteri adı. |
| customerLastName | string Müşteri soyadı. |
| customerStreet | string Bulvar/cadde/sokak. |
| customerBuildingName | string Bina adı. |
| customerBuildingNo | string Bina numarası. |
| customerDoorNo | string Kapı numarası. |
| customerTown | string Kasaba/köy. |
| customerDistrict | string Mahalle/semt/ilçe. |
| customerCity | string İl bilgisi. |
| customerPostCode | string Posta kodu. |
| customerCountry | string Ülke bilgisi. Ülke kodları yazılmalıdır. Örneğin Türkiye için TR,Amerika için US |
| customerTelephone | string Telefon bilgisi. |
| customerEmail | string e-Posta bilgisidir,eğer isEmailSend true olarak gönderilirse, bu alanı doldurmak zorunludur . |
| isEmailSend | bool e-Posta gönderilsin mi ?. |
| customerTaxCenter | string Vergi dairesi. |
| paymentType required | string Enum: "BANKAKARTI" "KREDIKARTI" "BEDELSIZ" "COKLU" "PUAN" "NAKIT" "PROMOSYON" "ULASIMKARTI" "DIGER" Biletin ödeme tipi.Diğer olarak seçildiği zaman, ödeme açıklaması zorunlu alandır. |
| paymentDescription | string Biletin ödeme açıklaması.Ödeme şekli DIGER olduğunda zorunlu. |
| seatNumber required | string Koltuk numarası. |
| recordExpensesVknTckn | string Gider gösteren VKN/TCKN bilgisi.Gider gösteren ünvan bilgisi girildiyse,gider gösteren VKN/TCKN bilgisi zorunludur . |
| recordExpensesTitle | string Gider gösteren ünvan bilgisi.Gider gösteren VKN/TCKN bilgisi girildiyse,gider gösteren ünvan bilgisi zorunludur . |
| eventTime | Datetime Etkinlik Zamanı. |
| eventName required | string Etkinlik Adı. |
| eventLocation required | string Etkinlik Yeri. |
| eventCity | string Etkinliğin yapıldığı il. |
| eventCityId required | int İl plaka kodu(1-81 arasında olmalıdır). |
| eventMunicipality required | string Etkinliğin yapıldığı belediye. |
| eventDescription | string Etkinlik açıklaması. |
| eventOrganizerVknTckn required | string Organizatör VKN/TCKN bilgisi, 10 veya 11 hane olarak girilmelidir. |
| xsltCode | string Sizin için özel oluşturulmış bilet görünümünü var ise, bu bilet görünümünü kullanmak için, size verilen xsltCode bilgisini bu alan ile göndermelisiniz. Eğer boş gönderirseniz standart bilet görünümü ile biletleriniz kaydedilir. Özel oluşturulan bilet görünümünü destek ekibimiz sisteme yüklemektedir. |
Array of objects (TicketLines) Bilet kalem bilgisinin girildiği alan. | |
Array of objects Bilet içerisinde liste şeklinde not girmek istediğiniz durumlarda bu alanı kullanabilirsiniz. |
Responses
Request samples
- Payload
{- "ettn": null,
- "status": "Taslak : 0",
- "documentType": "SATIS : 0",
- "ticketType": "YOLCU",
- "ticketDate": null,
- "ticketNumber": "string",
- "prefix": "string",
- "currencyCode": "TRY",
- "exchangeRate": null,
- "referenceNumber": "string",
- "identifier": "string",
- "customerFirstName": "string",
- "customerLastName": "string",
- "customerStreet": "string",
- "customerBuildingName": "string",
- "customerBuildingNo": "string",
- "customerDoorNo": "string",
- "customerTown": "string",
- "customerDistrict": "string",
- "customerCity": "string",
- "customerPostCode": "string",
- "customerCountry": "TR",
- "customerTelephone": "string",
- "customerEmail": "string",
- "isEmailSend": true,
- "customerTaxCenter": "string",
- "paymentType": "BANKAKARTI",
- "paymentDescription": "string",
- "seatNumber": "string",
- "recordExpensesVknTckn": "string",
- "recordExpensesTitle": "string",
- "eventTime": null,
- "eventName": "string",
- "eventLocation": "string",
- "eventCity": "string",
- "eventCityId": null,
- "eventMunicipality": "string",
- "eventDescription": "string",
- "eventOrganizerVknTckn": "string",
- "xsltCode": "string",
- "ticketLines": [
- {
- "serviceType": "NULL",
- "serviceDescription": "string",
- "amount": null,
- "discountRate": null,
- "discountAmount": null,
- "vatRate": null,
- "vatAmount": null,
- "taxes": [
- {
- "taxCode": "string",
- "taxName": "string",
- "taxtRate": null,
- "taxtAmount": null
}
]
}
], - "notes": [
- {
- "note": "string"
}
]
}Response samples
- 200
- 422
{- "ettn": null,
- "ticketNumber": "string"
}Put Ticket
Bilet güncellemek için kullanılır. Statusu 0 (kuyruk) olan e-bilet ile statusu 40 (hata) olan e-bilet güncellenebilir.
path Parameters
| id | Guid Erişilmek istenen kaynağın unique id'si |
Request Body schema: application/json
| ettn required | Guid Bilet Ettn'sidir. |
| status | integer Enum: "Taslak : 0" "Kuyrukta : 20" Biletin durumunu belirtir. |
| documentType | byte Enum: "SATIS : 0" "IADE : 1" Belge tipi. |
| ticketType required | string Enum: "YOLCU" "ETKINLIK" Bilet tipi. |
| ticketDate | Datetime Bilet tarihi. |
| ticketNumber required | string ÖRNEK:BLT2020000001220, 3 hane ön ek, 4 hane yıl bilgisi, 9 bilet numarası olacak şekilde 16 haneli olur.Sayacın 1'den başlayıp müteselsil olarak devam etmesi önemlidir. |
| prefix required | string Bilet numarasının ilk üç hanesi ile (ön ek) aynı gönderilmesi gerekmektedir.Örnek olarak yukarıdaki BLT2020000001220 fatura numarasındaki ön ek(BLT) ile aynı olmalıdır. |
| currencyCode | string Para Birimi. Boş veya null gönderilemez,farklı bir para birimi değeri yoksa TRY gönderilmeli. |
| exchangeRate | decimal Döviz kuru. |
| referenceNumber | string Referans numarasıdır. |
| identifier | string VKN/TCKN/Pasaport bilgisidir. |
| customerFirstName | string Müşteri adı. |
| customerLastName | string Müşteri soyadı. |
| customerStreet | string Bulvar/cadde/sokak. |
| customerBuildingName | string Bina adı. |
| customerBuildingNo | string Bina numarası. |
| customerDoorNo | string Kapı numarası. |
| customerTown | string Kasaba/köy. |
| customerDistrict | string Mahalle/semt/ilçe. |
| customerCity | string İl bilgisi. |
| customerPostCode | string Posta kodu. |
| customerCountry | string Ülke bilgisi. Ülke kodları yazılmalıdır. Örneğin Türkiye için TR,Amerika için US |
| customerTelephone | string Telefon bilgisi. |
| customerEmail | string e-Posta bilgisidir,eğer isEmailSend true olarak gönderilirse, bu alanı doldurmak zorunludur . |
| isEmailSend | bool e-Posta gönderilsin mi ?. |
| customerTaxCenter | string Vergi dairesi. |
| paymentType required | string Enum: "BANKAKARTI" "KREDIKARTI" "BEDELSIZ" "COKLU" "PUAN" "NAKIT" "PROMOSYON" "ULASIMKARTI" "DIGER" Biletin ödeme tipi.Diğer olarak seçildiği zaman, ödeme açıklaması zorunlu alandır. |
| paymentDescription | string Biletin ödeme açıklaması.Ödeme şekli DIGER olduğunda zorunlu. |
| seatNumber | string Koltuk numarası. |
| recordExpensesVknTckn | string Gider gösteren VKN/TCKN bilgisi.Gider gösteren ünvan bilgisi girildiyse,gider gösteren VKN/TCKN bilgisi zorunludur . |
| recordExpensesTitle | string Gider gösteren ünvan bilgisi.Gider gösteren VKN/TCKN bilgisi girildiyse,gider gösteren ünvan bilgisi zorunludur . |
| eventTime | Datetime Etkinlik Zamanı. |
| eventName required | string Etkinlik Adı. |
| eventLocation required | string Etkinlik Yeri. |
| eventCity | string Etkinliğin yapıldığı il. |
| eventMunicipality required | string Etkinliğin yapıldığı belediye. |
| eventDescription | string Etkinlik açıklaması. |
| eventOrganizerVknTckn required | string Organizatör VKN/TCKN bilgisi, 10 veya 11 hane olarak girilmelidir. |
| xsltCode | string Sizin için özel oluşturulmış bilet görünümünü var ise, bu bilet görünümünü kullanmak için, size verilen xsltCode bilgisini bu alan ile göndermelisiniz. Eğer boş gönderirseniz standart bilet görünümü ile biletleriniz kaydedilir. Özel oluşturulan bilet görünümünü destek ekibimiz sisteme yüklemektedir. |
Array of objects (TicketLines) Bilet kalem bilgisinin girildiği alan. | |
Array of objects Bilet içerisinde liste şeklinde not girmek istediğiniz durumlarda bu alanı kullanabilirsiniz. |
Responses
Request samples
- Payload
{- "ettn": null,
- "status": "Taslak : 0",
- "documentType": "SATIS : 0",
- "ticketType": "YOLCU",
- "ticketDate": null,
- "ticketNumber": "string",
- "prefix": "string",
- "currencyCode": "TRY",
- "exchangeRate": null,
- "referenceNumber": "string",
- "identifier": "string",
- "customerFirstName": "string",
- "customerLastName": "string",
- "customerStreet": "string",
- "customerBuildingName": "string",
- "customerBuildingNo": "string",
- "customerDoorNo": "string",
- "customerTown": "string",
- "customerDistrict": "string",
- "customerCity": "string",
- "customerPostCode": "string",
- "customerCountry": "TR",
- "customerTelephone": "string",
- "customerEmail": "string",
- "isEmailSend": true,
- "customerTaxCenter": "string",
- "paymentType": "BANKAKARTI",
- "paymentDescription": "string",
- "seatNumber": "string",
- "recordExpensesVknTckn": "string",
- "recordExpensesTitle": "string",
- "eventTime": null,
- "eventName": "string",
- "eventLocation": "string",
- "eventCity": "string",
- "eventMunicipality": "string",
- "eventDescription": "string",
- "eventOrganizerVknTckn": "string",
- "xsltCode": "string",
- "ticketLines": [
- {
- "serviceType": "NULL",
- "serviceDescription": "string",
- "amount": null,
- "discountRate": null,
- "discountAmount": null,
- "vatRate": null,
- "vatAmount": null,
- "taxes": [
- {
- "taxCode": "string",
- "taxName": "string",
- "taxtRate": null,
- "taxtAmount": null
}
]
}
], - "notes": [
- {
- "note": "string"
}
]
}Response samples
- 200
- 422
{- "ettn": null,
- "ticketNumber": "string"
}Cancel Ticket
Bileti iptal etmek için kullanılır.
Request Body schema: application/json
ids:[ "4f5f8dba-e613-11ea-adc1-0242ac120002"]
Responses
Request samples
- Payload
nullResponse samples
- 422
{- "Error": {
- "title": "string",
- "detail": "string"
}
}Get HTML
Bileti Html formatında indirme.
path Parameters
| id | Guid Erişilmek istenen kaynağın unique id'si |
| isStandartXslt | bool Bu alan false olarak gönderilirse, kendi eklemiş olduğunuz XLST / XSLT'ler içersinden default olana göre bilet getirilir. |
Responses
Response samples
- 200
- 422
{- "Response": { }
}Put Update Status List
Hatalı veya Taslak durumundaki biletlerin statüsünü değiştirmek için kullanılır. Hatalı bileti taslağa çekmek, taslaktaki bileti kuyruğa eklemek için bu metot kullanılır.
Request Body schema: application/json
Ids:[ "ecb37079-8598-5e9c-9a46-6943b0794cf3", "dba1c5ea-0229-410a-8193-958ff76b7d19"]
Status: Taslak: 0, Kuyrukla ve Gönder: 20
Responses
Request samples
- Payload
nullResponse samples
- 422
{- "Error": {
- "title": "string",
- "detail": "string"
}
}Post Ticket
Yeni bilet kayıt etmek için kullanılır. Turkcell e-Şirket bilet oluşturma arayüzlerininde kullandığı, JSON model vasıtasıyla bilet oluşturmak isteyenler için sunulan uç noktasıdır.
Request Body schema: application/json
| ettn | Guid Bilet Ettn'sidir. |
| status | integer Enum: "Taslak : 0" "Kuyrukta : 20" Biletin durumunu belirtir. |
| documentType | byte Enum: "SATIS : 0" "IADE : 1" Belge tipi. |
| ticketType required | string Enum: "YOLCU" "ETKINLIK" Bilet tipi. |
| ticketDate | Datetime Bilet tarihi. |
| ticketNumber required | string ÖRNEK:BLT2020000001220, 3 hane ön ek, 4 hane yıl bilgisi, 9 bilet numarası olacak şekilde 16 haneli olur.Sayacın 1'den başlayıp müteselsil olarak devam etmesi önemlidir. |
| prefix required | string Bilet numarasının ilk üç hanesi ile (ön ek) aynı gönderilmesi gerekmektedir.Örnek olarak yukarıdaki BLT2020000001220 fatura numarasındaki ön ek(BLT) ile aynı olmalıdır. |
| currencyCode | string Para Birimi. Boş veya null gönderilemez,farklı bir para birimi değeri yoksa TRY gönderilmeli. |
| exchangeRate | decimal Döviz kuru. |
| referenceNumber | string Referans numarasıdır. |
| identifier required | string VKN/TCKN/Pasaport bilgisidir. |
| customerFirstName | string Müşteri adı. |
| customerLastName | string Müşteri soyadı. |
| customerStreet | string Bulvar/cadde/sokak. |
| customerBuildingName | string Bina adı. |
| customerBuildingNo | string Bina numarası. |
| customerDoorNo | string Kapı numarası. |
| customerTown | string Kasaba/köy. |
| customerDistrict | string Mahalle/semt/ilçe. |
| customerCity | string İl bilgisi. |
| customerPostCode | string Posta kodu. |
| customerCountry | string Ülke bilgisi. Ülke kodları yazılmalıdır. Örneğin Türkiye için TR,Amerika için US |
| customerTelephone | string Telefon bilgisi. |
| customerEmail | string e-Posta bilgisidir,eğer isEmailSend true olarak gönderilirse, bu alanı doldurmak zorunludur . |
| isEmailSend | bool e-Posta gönderilsin mi ?. |
| customerTaxCenter | string Vergi dairesi. |
| paymentType required | string Enum: "BANKAKARTI" "KREDIKARTI" "BEDELSIZ" "COKLU" "PUAN" "NAKIT" "PROMOSYON" "ULASIMKARTI" "DIGER" Biletin ödeme tipi.Diğer olarak seçildiği zaman, ödeme açıklaması zorunlu alandır. |
| paymentDescription | string Biletin ödeme açıklaması.Ödeme şekli DIGER olduğunda zorunlu. |
| vehicleOperatingVknTckn | string Aracı işleten VKN/TCKN.Aracı işleten ünvanı,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| vehiclePlate required | string Plaka bilgisi. |
| vehicleOperatingTitle | string Aracı işleten ünvanı.Aracı işleten VKN/TCKN,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| vehicleOperatingCountry | string Aracı işletenin ülke bilgisi. |
| vehicleOperatingCity | string Aracı işletenin şehir bilgisi. |
| vehicleOperatingDistrict | string Aracı işletenin mahalle/semt/ilçe bilgisi. |
| vehicleOperatingTown | string Aracı işletenin kasaba/köy bilgisi. |
| vehicleOperatingStreet | string Aracı işletenin bulvar/cad/sok bilgisi. |
| vehicleOperatingBuildingName | string Aracı işletenin bina adı bilgisi. |
| vehicleOperatingBuildingNo | string Aracı işletenin bina no bilgisi. |
| vehicleOperatingDoorNo | string Aracı işletenin kapı no bilgisi. |
| vehicleOperatingMersisNo | string Aracı işletenin mersis no bilgisi. |
| vehicleOperatingRegisterNo | string Aracı işletenin ticari sicil no bilgisi. |
| vehicleOperatingPostCode | string Aracı işletenin posta kodu bilgisi. |
| vehicleOperatingTelephone | string Aracı işletenin telefon numarası. |
| vehicleOperatingEmail | string Aracı işletenin email bilgisi. |
| vehicleOperatingTaxCenter | string Aracı işletenin vergi dairesi. |
| expeditionTime required | Datetime Sefer tarihi. |
| expeditionNumber required | string Sefer numarası. |
| departureDate required | Datetime Hareket zamanı. |
| departureLocation required | string Hareket yeri. |
| destination | string Varış yeri. |
| seatNumber required | string Koltuk numarası. |
| commissionAmount | decimal Komisyon tutarı.Aracı işleten VKN/TCKN,ünvanı,vergi dairesi,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| commissionTaxAmount | decimal Komisyon kdv oranı.Aracı işleten VKN/TCKN,ünvanı,vergi dairesi,komisyon tutarı alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| recordExpensesVknTckn | string Gider gösteren VKN/TCKN bilgisi.Gider gösteren ünvan bilgisi girildiyse,gider gösteren VKN/TCKN bilgisi zorunludur . |
| recordExpensesTitle | string Gider gösteren ünvan bilgisi.Gider gösteren VKN/TCKN bilgisi girildiyse,gider gösteren ünvan bilgisi zorunludur . |
| xsltCode | string Sizin için özel oluşturulmış bilet görünümünü var ise, bu bilet görünümünü kullanmak için, size verilen xsltCode bilgisini bu alan ile göndermelisiniz. Eğer boş gönderirseniz standart bilet görünümü ile biletleriniz kaydedilir. Özel oluşturulan bilet görünümünü destek ekibimiz sisteme yüklemektedir. |
Array of objects (TicketLines) Bilet kalem bilgisinin girildiği alan. | |
Array of objects Bilet içerisinde liste şeklinde not girmek istediğiniz durumlarda bu alanı kullanabilirsiniz. |
Responses
Request samples
- Payload
{- "ettn": null,
- "status": "Taslak : 0",
- "documentType": "SATIS : 0",
- "ticketType": "YOLCU",
- "ticketDate": null,
- "ticketNumber": "string",
- "prefix": "string",
- "currencyCode": "TRY",
- "exchangeRate": null,
- "referenceNumber": "string",
- "identifier": "string",
- "customerFirstName": "string",
- "customerLastName": "string",
- "customerStreet": "string",
- "customerBuildingName": "string",
- "customerBuildingNo": "string",
- "customerDoorNo": "string",
- "customerTown": "string",
- "customerDistrict": "string",
- "customerCity": "string",
- "customerPostCode": "string",
- "customerCountry": "TR",
- "customerTelephone": "string",
- "customerEmail": "string",
- "isEmailSend": true,
- "customerTaxCenter": "string",
- "paymentType": "BANKAKARTI",
- "paymentDescription": "string",
- "vehicleOperatingVknTckn": "string",
- "vehiclePlate": "string",
- "vehicleOperatingTitle": "string",
- "vehicleOperatingCountry": "string",
- "vehicleOperatingCity": "string",
- "vehicleOperatingDistrict": "string",
- "vehicleOperatingTown": "string",
- "vehicleOperatingStreet": "string",
- "vehicleOperatingBuildingName": "string",
- "vehicleOperatingBuildingNo": "string",
- "vehicleOperatingDoorNo": "string",
- "vehicleOperatingMersisNo": "string",
- "vehicleOperatingRegisterNo": "string",
- "vehicleOperatingPostCode": "string",
- "vehicleOperatingTelephone": "string",
- "vehicleOperatingEmail": "string",
- "vehicleOperatingTaxCenter": "string",
- "expeditionTime": null,
- "expeditionNumber": "string",
- "departureDate": null,
- "departureLocation": "string",
- "destination": "string",
- "seatNumber": "string",
- "commissionAmount": null,
- "commissionTaxAmount": null,
- "recordExpensesVknTckn": "string",
- "recordExpensesTitle": "string",
- "xsltCode": "string",
- "ticketLines": [
- {
- "serviceType": "NULL",
- "serviceDescription": "string",
- "amount": null,
- "discountRate": null,
- "discountAmount": null,
- "vatRate": null,
- "vatAmount": null,
- "taxes": [
- {
- "taxCode": "string",
- "taxName": "string",
- "taxtRate": null,
- "taxtAmount": null
}
]
}
], - "notes": [
- {
- "note": "string"
}
]
}Response samples
- 200
- 422
{- "ettn": null,
- "ticketNumber": "string"
}Put Ticket
Bilet güncellemek için kullanılır. Statusu 0 (kuyruk) olan e-bilet ile statusu 40 (hata) olan e-bilet güncellenebilir.
path Parameters
| id | Guid Erişilmek istenen kaynağın unique id'si |
Request Body schema: application/json
| ettn required | Guid Bilet Ettn'sidir. |
| status | integer Enum: "Taslak : 0" "Kuyrukta : 20" Biletin durumunu belirtir. |
| documentType | byte Enum: "SATIS : 0" "IADE : 1" Belge tipi. |
| ticketType required | string Enum: "YOLCU" "ETKINLIK" Bilet tipi. |
| ticketDate | Datetime Bilet tarihi. |
| ticketNumber required | string ÖRNEK:BLT2020000001220, 3 hane ön ek, 4 hane yıl bilgisi, 9 bilet numarası olacak şekilde 16 haneli olur.Sayacın 1'den başlayıp müteselsil olarak devam etmesi önemlidir. |
| prefix required | string Bilet numarasının ilk üç hanesi ile (ön ek) aynı gönderilmesi gerekmektedir.Örnek olarak yukarıdaki BLT2020000001220 fatura numarasındaki ön ek(BLT) ile aynı olmalıdır. |
| currencyCode | string Para Birimi. Boş veya null gönderilemez,farklı bir para birimi değeri yoksa TRY gönderilmeli. |
| exchangeRate | decimal Döviz kuru. |
| referenceNumber | string Referans numarasıdır. |
| identifier required | string VKN/TCKN/Pasaport bilgisidir. |
| customerFirstName | string Müşteri adı. |
| customerLastName | string Müşteri soyadı. |
| customerStreet | string Bulvar/cadde/sokak. |
| customerBuildingName | string Bina adı. |
| customerBuildingNo | string Bina numarası. |
| customerDoorNo | string Kapı numarası. |
| customerTown | string Kasaba/köy. |
| customerDistrict | string Mahalle/semt/ilçe. |
| customerCity | string İl bilgisi. |
| customerPostCode | string Posta kodu. |
| customerCountry | string Ülke bilgisi. Ülke kodları yazılmalıdır. Örneğin Türkiye için TR,Amerika için US |
| customerTelephone | string Telefon bilgisi. |
| customerEmail | string e-Posta bilgisidir,eğer isEmailSend true olarak gönderilirse, bu alanı doldurmak zorunludur . |
| isEmailSend | bool e-Posta gönderilsin mi ?. |
| customerTaxCenter | string Vergi dairesi. |
| paymentType required | string Enum: "BANKAKARTI" "KREDIKARTI" "BEDELSIZ" "COKLU" "PUAN" "NAKIT" "PROMOSYON" "ULASIMKARTI" "DIGER" Biletin ödeme tipi.Diğer olarak seçildiği zaman, ödeme açıklaması zorunlu alandır. |
| paymentDescription | string Biletin ödeme açıklaması.Ödeme şekli DIGER olduğunda zorunlu. |
| vehicleOperatingVknTckn | string Aracı işleten VKN/TCKN.Aracı işleten ünvanı,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| vehiclePlate required | string Plaka bilgisi. |
| vehicleOperatingTitle | string Aracı işleten ünvanı.Aracı işleten VKN/TCKN,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| vehicleOperatingCountry | string Aracı işletenin ülke bilgisi. |
| vehicleOperatingCity | string Aracı işletenin şehir bilgisi. |
| vehicleOperatingDistrict | string Aracı işletenin mahalle/semt/ilçe bilgisi. |
| vehicleOperatingTown | string Aracı işletenin kasaba/köy bilgisi. |
| vehicleOperatingStreet | string Aracı işletenin bulvar/cad/sok bilgisi. |
| vehicleOperatingBuildingName | string Aracı işletenin bina adı bilgisi. |
| vehicleOperatingBuildingNo | string Aracı işletenin bina no bilgisi. |
| vehicleOperatingDoorNo | string Aracı işletenin kapı no bilgisi. |
| vehicleOperatingMersisNo | string Aracı işletenin mersis no bilgisi. |
| vehicleOperatingRegisterNo | string Aracı işletenin ticari sicil no bilgisi. |
| vehicleOperatingPostCode | string Aracı işletenin posta kodu bilgisi. |
| vehicleOperatingTelephone | string Aracı işletenin telefon numarası. |
| vehicleOperatingEmail | string Aracı işletenin email bilgisi. |
| vehicleOperatingTaxCenter | string Aracı işletenin vergi dairesi. Aracı işleten ünvanı,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| expeditionTime required | Datetime Sefer tarihi. |
| expeditionNumber required | string Sefer numarası. |
| departureDate required | Datetime Hareket zamanı. |
| departureLocation required | string Hareket yeri. |
| destination | string Varış yeri. |
| seatNumber required | string Koltuk numarası. |
| commissionAmount | decimal Komisyon tutarı.Aracı işleten VKN/TCKN,ünvanı,vergi dairesi,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| commissionTaxAmount | decimal Komisyon kdv oranı.Aracı işleten VKN/TCKN,ünvanı,vergi dairesi,komisyon tutarı alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| recordExpensesVknTckn | string Gider gösteren VKN/TCKN bilgisi.Gider gösteren ünvan bilgisi girildiyse,gider gösteren VKN/TCKN bilgisi zorunludur . |
| recordExpensesTitle | string Gider gösteren ünvan bilgisi.Gider gösteren VKN/TCKN bilgisi girildiyse,gider gösteren ünvan bilgisi zorunludur . |
| xsltCode | string Sizin için özel oluşturulmış bilet görünümünü var ise, bu bilet görünümünü kullanmak için, size verilen xsltCode bilgisini bu alan ile göndermelisiniz. Eğer boş gönderirseniz standart bilet görünümü ile biletleriniz kaydedilir. Özel oluşturulan bilet görünümünü destek ekibimiz sisteme yüklemektedir. |
Array of objects (TicketLines) Bilet kalem bilgisinin girildiği alan. | |
Array of objects Bilet içerisinde liste şeklinde not girmek istediğiniz durumlarda bu alanı kullanabilirsiniz. |
Responses
Request samples
- Payload
{- "ettn": null,
- "status": "Taslak : 0",
- "documentType": "SATIS : 0",
- "ticketType": "YOLCU",
- "ticketDate": null,
- "ticketNumber": "string",
- "prefix": "string",
- "currencyCode": "TRY",
- "exchangeRate": null,
- "referenceNumber": "string",
- "identifier": "string",
- "customerFirstName": "string",
- "customerLastName": "string",
- "customerStreet": "string",
- "customerBuildingName": "string",
- "customerBuildingNo": "string",
- "customerDoorNo": "string",
- "customerTown": "string",
- "customerDistrict": "string",
- "customerCity": "string",
- "customerPostCode": "string",
- "customerCountry": "TR",
- "customerTelephone": "string",
- "customerEmail": "string",
- "isEmailSend": true,
- "customerTaxCenter": "string",
- "paymentType": "BANKAKARTI",
- "paymentDescription": "string",
- "vehicleOperatingVknTckn": "string",
- "vehiclePlate": "string",
- "vehicleOperatingTitle": "string",
- "vehicleOperatingCountry": "string",
- "vehicleOperatingCity": "string",
- "vehicleOperatingDistrict": "string",
- "vehicleOperatingTown": "string",
- "vehicleOperatingStreet": "string",
- "vehicleOperatingBuildingName": "string",
- "vehicleOperatingBuildingNo": "string",
- "vehicleOperatingDoorNo": "string",
- "vehicleOperatingMersisNo": "string",
- "vehicleOperatingRegisterNo": "string",
- "vehicleOperatingPostCode": "string",
- "vehicleOperatingTelephone": "string",
- "vehicleOperatingEmail": "string",
- "vehicleOperatingTaxCenter": "string",
- "expeditionTime": null,
- "expeditionNumber": "string",
- "departureDate": null,
- "departureLocation": "string",
- "destination": "string",
- "seatNumber": "string",
- "commissionAmount": null,
- "commissionTaxAmount": null,
- "recordExpensesVknTckn": "string",
- "recordExpensesTitle": "string",
- "xsltCode": "string",
- "ticketLines": [
- {
- "serviceType": "NULL",
- "serviceDescription": "string",
- "amount": null,
- "discountRate": null,
- "discountAmount": null,
- "vatRate": null,
- "vatAmount": null,
- "taxes": [
- {
- "taxCode": "string",
- "taxName": "string",
- "taxtRate": null,
- "taxtAmount": null
}
]
}
], - "notes": [
- {
- "note": "string"
}
]
}Response samples
- 200
- 422
{- "ettn": null,
- "ticketNumber": "string"
}Cancel Ticket
Bileti iptal etmek için kullanılır.
Request Body schema: application/json
ids:[ "4f5f8dba-e613-11ea-adc1-0242ac120002"]
Responses
Request samples
- Payload
nullResponse samples
- 422
{- "Error": {
- "title": "string",
- "detail": "string"
}
}Get HTML
Bileti Html formatında indirme.
path Parameters
| id | Guid Erişilmek istenen kaynağın unique id'si |
| isStandartXslt | bool Bu alan false olarak gönderilirse, kendi eklemiş olduğunuz XLST / XSLT'ler içersinden default olana göre bilet getirilir. |
Responses
Response samples
- 200
- 422
{- "Response": { }
}Put Update Status List
Hatalı veya Taslak durumundaki biletlerin statüsünü değiştirmek için kullanılır. Hatalı bileti taslağa çekmek, taslaktaki bileti kuyruğa eklemek için bu metot kullanılır.
Request Body schema: application/json
Ids:[ "ecb37079-8598-5e9c-9a46-6943b0794cf3", "dba1c5ea-0229-410a-8193-958ff76b7d19"]
Status: Taslak: 0, Kuyrukla ve Gönder: 20
Responses
Request samples
- Payload
nullResponse samples
- 422
{- "Error": {
- "title": "string",
- "detail": "string"
}
}Yolcu Bileti Listesi gönderim ve sorgulama için ortak olan servis uç noktalarını içerir.
Post Ticket List
Yeni yolcu bileti listesi oluşturmak için kullanılır. Turkcell e-Şirket yolcu listesi oluşturma arayüzlerininde kullandığı, JSON model vasıtasıyla yolcu bileti listesi oluşturmak isteyenler için sunulan uç noktasıdır. Bir kez oluşturulan yolcu listesi yeniden aynı bilgiler ile oluşturulursa yeni liste eski listeyi ezecek ve yeni liste geçerli olacaktır. Yolcu bileti raporu GİB'e gönderilen yolcu listeleri güncellenemez.
Request Body schema: application/json
| expeditionNumber required | string Sefer numarası. |
| expeditionTime required | Datetime Sefer tarihi. |
| vehiclePlate required | string Plaka bilgisi. |
| isManualPlate | string Bu alan true olarak gönderilirse, yolcu listesi oluşturulurken, biletler sefer numarası ve sefer tarihine göre gruplanır, plaka bilgisi direk yolcu listesine kaydedilir. Eğer bu alan false olarak gönderilirse, yolcu listesi oluşturulurken, biletler sefer numarası , sefer tarihine ve plaka bilgisine göre gruplanır , bu üç bilgiye ait bilet bulunamazsa yolcu listesi oluşturulamaz. |
| vehicleOperatingVknTckn | string Aracı işleten VKN/TCKN. Aracı işleten ünvanı,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| vehicleOperatingTitle | string Aracı işleten ünvanı. Aracı işleten VKN/TCKN,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| vehicleOperatingCountry | string Aracı işletenin ülke bilgisi. |
| vehicleOperatingCity | string Aracı işletenin şehir bilgisi. |
| vehicleOperatingDistrict | string Aracı işletenin mahalle/semt/ilçe bilgisi. |
| vehicleOperatingTown | string Aracı işletenin kasaba/köy bilgisi. |
| vehicleOperatingStreet | string Aracı işletenin bulvar/cad/sok bilgisi. |
| vehicleOperatingBuildingName | string Aracı işletenin bina adı bilgisi. |
| vehicleOperatingBuildingNo | string Aracı işletenin bina no bilgisi. |
| vehicleOperatingDoorNo | string Aracı işletenin kapı no bilgisi. |
| vehicleOperatingMersisNo | string Aracı işletenin mersis no bilgisi. |
| vehicleOperatingRegisterNo | string Aracı işletenin ticari sicil no bilgisi. |
| vehicleOperatingPostCode | string Aracı işletenin posta kodu bilgisi. |
| vehicleOperatingTelephone | string Aracı işletenin telefon numarası. |
| vehicleOperatingEmail | string Aracı işletenin email bilgisi. |
| vehicleOperatingTaxCenter | string Aracı işletenin vergi dairesi. Aracı işleten ünvanı,vergi dairesi,komisyon tutarı,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| commissionAmount | decimal Komisyon tutarı.Aracı işleten VKN/TCKN,ünvanı,vergi dairesi,komisyon kdv alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
| commissionTaxAmount | decimal Komisyon kdv oranı.Aracı işleten VKN/TCKN,ünvanı,vergi dairesi,komisyon tutarı alanlarından bir tanesi dolu olduğunda zorunlu hale gelir. |
Responses
Request samples
- Payload
{- "expeditionNumber": "string",
- "expeditionTime": null,
- "vehiclePlate": "string",
- "isManualPlate": "string",
- "vehicleOperatingVknTckn": "string",
- "vehicleOperatingTitle": "string",
- "vehicleOperatingCountry": "string",
- "vehicleOperatingCity": "string",
- "vehicleOperatingDistrict": "string",
- "vehicleOperatingTown": "string",
- "vehicleOperatingStreet": "string",
- "vehicleOperatingBuildingName": "string",
- "vehicleOperatingBuildingNo": "string",
- "vehicleOperatingDoorNo": "string",
- "vehicleOperatingMersisNo": "string",
- "vehicleOperatingRegisterNo": "string",
- "vehicleOperatingPostCode": "string",
- "vehicleOperatingTelephone": "string",
- "vehicleOperatingEmail": "string",
- "vehicleOperatingTaxCenter": "string",
- "commissionAmount": null,
- "commissionTaxAmount": null
}Response samples
- 200
- 422
{- "ettn": null,
- "passengerListNumber": "string"
}Get Ticket List
Yolcu bileti listesini çekmek için kullanılır.
query Parameters
| pageIndex | int Çekmek istediğiniz başlangıç sayfasını belirtir. |
| pageSize | int Çekmek istediğiniz sayfada kaç adet kayıt olması gerektiğini belirtir. Tek seferde max 500 kayıt |
Responses
Response samples
- 200
- 422
{- "pageIndex": null,
- "pageSize": null,
- "totalCount": null,
- "totalPages": null,
- "hasNextPage": null,
- "hasPreviousPage": null,
- "items": {
- "id": null,
- "passengerListNumber": "string",
- "expeditionNumber": "string",
- "vehiclePlate": "string",
- "expeditionTime": null,
- "createDate": "string"
}
}