Karayolu e-Bileti

Karayolu Alan Kuralları

Karayolu request alanları, koşullu zorunluluklar, numara ve tekillik kuralları.

Kimlik ve Numara Alanları

Alan	Zorunluluk	Kural
`TicketNumber`	Koşullu	Gönderilirse 16 karakter olmalı, 4–7. karakterler `TicketModDate` yılıyla eşleşmeli ve Türkçe karakter içermemelidir. Boşsa `LocationCode` zorunludur.
`LocationCode`	Koşullu	`TicketNumber` boş bırakıldığında platform numara üretimi için gönderilir.
`TicketExternalNumber`	Tekrar güvenliği için gerekli	Kaynak sistemde tekil tutulur; daha önce kullanılmış değer yeni kayıt olarak kabul edilmez.
`UUId`	Opsiyonel	Boş bırakıldığında platform tarafından üretilir; response değeri saklanır.
`TicketPnrNo`	Opsiyonel	Kaynak sistem PNR bilgisi.
`TicketReferenceNumber`	Opsiyonel	İlişkili bilet veya kaynak referansı.

Yolcu Alanları

Alan	Koşul	Kural
`PassangerNameSurname`	Her bilette	Boş bırakılamaz.
`PassangerIsTR`	Her bilette	Türkiye kimliği ile pasaport yolunu seçer.
`PassangerTaxOrId`	`PassangerIsTR=true`	11 haneli ve yalnız rakam olmalıdır.
`PassangerPasaportNo`	`PassangerIsTR=false`	Yabancı yolcu için pasaport numarası gönderilir.
`SeatNumber`	Her bilette	Boş bırakılamaz.

Sefer, Hizmet ve Ödeme

Alan	Zorunluluk	Açıklama
`ServiceType`	Zorunlu	`SEYAHAT`, `BAGAJ`, `CEZA`, `IPTALDEGISIKLIKTAZMINATI`, `YEMEK`, `KOLTUKSECIMI` veya `DIGER`.
`PaymentType`	Gönderilmesi önerilir	Desteklenen ödeme değerlerinden biri kullanılmalıdır; boş değer rapor üretiminde varsayılan ödeme davranışına düşebilir.
`DepartureDate`	Rapor ve sefer için gerekli	Kalkış tarih/saatini taşır.
`DepartureFrom`	Senaryoya göre	Kalkış noktası.
`Destination`	Senaryoya göre	Varış noktası.
`DepertureNo`	Senaryoya göre	Modeldeki alan adı bu yazımla kullanılır; sefer numarasını taşır.

Gider Gösteren

Alan	Koşul	Kural
`IsCustomer`	Her bilette	Gider gösteren bilgisinin rapora eklenip eklenmeyeceğini belirler.
`CustomerTaxOrId`	`IsCustomer=true`	10 veya 11 haneli ve yalnız rakam olmalıdır.
`CustomerTaxOffice`	`IsCustomer=true`	Boş bırakılamaz.
`CustomerName`	`IsCustomer=true`	Gider gösteren kişi veya firma adı.

Tutar Alanları

Alan	Anlam	Tutarlılık
`TicketFee`	KDV hariç bilet/hizmet tutarı	GİB raporunun `tutar` alanına aktarılır.
`TicketVatAmount`	KDV tutarı	GİB raporunun `kdv` alanına aktarılır.
`TicketTotalFee`	Toplam bilet bedeli	Kaynak sistemde `TicketFee + TicketVatAmount` ve diğer vergi bileşenleriyle tutarlı tutulmalıdır.
`OtherTaxCode`, `OtherTaxName`, `OtherTaxAmount`	Varsa diğer vergi	Kod, ad ve tutar birlikte gönderilmelidir.

Gönderim Öncesi Kontrol

Kontrol	Başarılı sinyal
Bilet numarası/seri seçimi	Ya geçerli `TicketNumber` ya da `LocationCode` var.
Yolcu kimliği	Vatandaşlık seçimine uygun TCKN veya pasaport bilgisi var.
Tekillik	`TicketExternalNumber` bu iş belgesi için değişmez.
Sefer ve koltuk	Kalkış zamanı ile `SeatNumber` dolu.
Gider gösteren	`IsCustomer=true` ise kimlik ve vergi dairesi tamam.
Tutarlar	KDV hariç, KDV ve toplam değerler kaynak ERP ile aynı.