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

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

Content type
application/json
{
  • "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": [
    ],
  • "notes": [
    ]
}

Response samples

Content type
application/json
{
  • "ettn": null,
  • "ticketNumber": "string"
}

Get Ticket List

Bilet 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

Content type
application/json
{
  • "pageIndex": null,
  • "pageSize": null,
  • "totalCount": null,
  • "totalPages": null,
  • "hasNextPage": null,
  • "hasPreviousPage": null,
  • "items": {
    }
}

Get Ticket

Tek bir bileti çekmek için kullanılır.

path Parameters
id
Guid

Erişilmek istenen kaynağın unique id'si

Responses

Response samples

Content type
application/json
{
  • "id": null,
  • "ticketNumber":