Fiyatlar, para birimleri ve tarihler

Gösterim ve tahsilat

Alan	Anlamı
grossAmount	Görüntüleme para birimindeki KDV dahil toplam
currency	Görüntüleme para birimi
netAmount	Görüntüleme para birimindeki net tutar
vatRate / vatAmount	KDV oranı (%) ve KDV tutarı
tollRoadFee	Görüntüleme para birimindeki geçiş ücreti
chargeAmount / chargeCurrency	Tahsilat tutarı ve tahsilat para birimi

Toplamı sunucunun döndürdüğü grossAmount alanından okuyun. Geçiş ücretinin KDV ayrıştırması nedeniyle netAmount + vatAmount her teklifin toplamına eşit olmayabilir. tollRoadFee tutarını grossAmount üzerine yeniden eklemeyin.

chargeAmount mevcut akışta TRY tahsilatını ifade eder. Gösterilen fiyat EUR olsa bile tahsilat para birimi farklı olabilir; ikisini kullanıcıya açıkça gösterin. Ek hizmetlerin KDV oranları farklı olabilir.

Para birimini seçme

Müsaitlik ve rezervasyon oluşturma çağrılarında X-Currency ile TRY, EUR, USD veya RUB seçebilirsiniz. Desteklenen bir override yoksa dil varsayılanı kullanılır:

Accept-Language	Varsayılan para birimi
tr-TR	TRY
en-US	EUR
de-DE	EUR
ru-RU	RUB

Arama, yeniden fiyatlama ve rezervasyon oluşturma boyunca aynı X-Currency ve Accept-Language başlıklarını gönderin. Rezervasyonun para birimi oluşturma isteğinin bağlamından belirlenir; aramadaki tercihin otomatik taşındığını varsaymayın. Sunucunun döndürdüğü currency ve chargeCurrency alanlarını kontrol edin.

Rezervasyon detayında totalNetAmount, totalVatAmount ve totalGrossAmount TRY cinsindedir. customerTotalNet, currency alanındaki müşteri para birimindedir. exchangeRate, 1 TRY karşılığındaki müşteri para birimi tutarını belirtir; ters kur olarak kullanmayın.

Webhook görüntüsündeki totalNetAmount, totalVatAmount ve totalGrossAmount da rezervasyonun TRY tutarlarıdır. Webhook currency alanı müşteri para birimini taşıyabilir; bu alanı kullanarak total* tutarlarını doğrudan döviz etiketiyle göstermeyin. Müşteri para birimindeki detay için rezervasyonu sorgulayın.

Ekstra, ara durak ve yeniden fiyatlama

waypointNetAmount, waypointVatAmount ve waypointGrossAmount, toplam teklifin ara durak bileşenini açıklar; toplamın üzerine ikinci kez eklenmez. supplierExtraIds ile seçilen standart ekstraların fiyat/KDV bilgilerini ekstra kataloğundan kontrol edin; teklif fiyatının henüz seçmediğiniz bütün hizmetleri kapsadığını varsaymayın.

Dış ekstra veya alternatif rota seçimi yeni teklif üretebilir. En son dönen itemId, fiyat, para birimi ve hizmet koşullarını birlikte kullanın; fiyat değiştiyse rezervasyondan önce kullanıcıya tekrar gösterin. Çift yönde her bacağın teklifini ayrı takip edin. Farklı para birimlerindeki fiyatları doğrudan toplamayın.

API tutarları JSON sayılarıdır. Finansal hesap ve saklama için dilinizin ondalık para türünü kullanmanız, ikili kayan nokta yuvarlama farklarını önlemeniz önerilir. Ekran yuvarlaması rezervasyonun sunucu toplamını değiştirmemelidir.

Tarih ve saat

Tarihleri ISO 8601 biçiminde açık saat dilimiyle gönderin:

2030-06-15T12:00:00+03:00
2030-06-15T09:00:00Z

Bu iki değer aynı anı gösterir. API açıklamasına göre saat dilimi belirtilmeyen girişler Europe/Istanbul varsayımıyla yorumlanır; entegrasyonunuzda bu belirsizliği önlemek için daima Z veya offset gönderin. Yanıt tarihleri UTC olarak belgelenmiştir.

İptal koşulları

freeCancellationUntilUtc doluysa teklifin bildirdiği cezasız iptal son zamanını kullanın. Null olması ücretsiz iptal garantisi değildir. Özellikle dış tedarikçi tekliflerinde serviceConditions içeriğini kontrol edin; sabit bir iptal süresi varsaymayın.

İptal endpoint'inin sonucu para tutarı değil kesinti yüzdesidir. İptal işlemi ve para iadesinin bankada tamamlanması farklı durumlardır. Hesabınıza ait iptal sonucunu ve rezervasyonun ödeme bilgilerini yaşam döngüsü rehberindeki şekilde kontrol edin.