Agentora
EN Demo talep et

Entegrasyonlar: kanaldan faturaya tek akış.

Satış kanallarından (GetYourGuide bugün canlı; Viator, Klook ve Headout yol haritasında) gelen rezervasyon panele düşer, iyzico ile alınan ödeme cariye işlenir, gün sonunda e-Fatura kesilir. Hangi bağlantı canlı, hangisi süreçte, hangisi yol haritasında — aşağıda açıkça yazıyor.

Demo talep etGetYourGuide akışını gör
CanlıÜretimde çalışıyorSertifikasyon sürecindeEntegrasyon hazır; hesap bağlantısı kanalın onayına bağlıYol haritasıHenüz canlı değil

01Kanallar

Kanaldan gelen rezervasyon doğrudan panele düşer.

GetYourGuide Supplier API’ye göre bir entegrasyon geliştirdik: müsaitlik, rezervasyon, iptal ve fiyat akışı iki yönlü işler. Kanaldan gelen rezervasyon, işletmenizin kendi rezervasyon kaydına dönüşür.

GetYourGuide

Supplier API Sertifikasyon sürecinde

Entegrasyon GetYourGuide Supplier API’ye göre geliştirildi. Hesabınızın bağlanması GetYourGuide’ın kendi onay sürecine tabidir.

GetYourGuide ⇄ Agentora
GetYourGuideSupplier API Agentoraİşletmeniz
  1. Müsaitlik sorgusuget-availabilities
    müsaitlik + fiyat
  2. Rezervasyonu tutreserve
    tutuldu
  3. Rezervasyonu onaylabook
    onaylandı
  4. İptalcancel-booking
    iptal edildi
  5. Fiyat ve müsaitlik göndernotify
    alındı

Akışta neler var

  1. 01

    Müsaitlik

    Kanalın sorduğu müsaitlik, salon kapasitesinden ve mevcut rezervasyonlardan hesaplanır.

  2. 02

    Tut, sonra onayla

    Rezervasyon önce tutulur, sonra onaylanır. Onaylanan kayıt panelde rezervasyon olarak görünür.

  3. 03

    Otomatik iptal

    Kanaldan gelen iptalde, panelde bağlı olan rezervasyon da otomatik iptal edilir.

  4. 04

    Fiyat ve müsaitlik push

    Fiyat ve müsaitlik değişiklikleri kanala gönderilir (notify); kanaldaki bilgi güncel kalır.

  5. 05

    Perakende fiyat cariye

    Kanalın perakende fiyatı, kanal hesabına (cari) yazılır.

Doluluğa göre kademeli fiyat

Kanala giden fiyat salon doluluğuna göre kademelenebilir: doluluk arttıkça bir üst kademe devreye girer.

Tek adres, çok işletme

GetYourGuide tek bir adrese istek atar. Agentora her isteği, taşıdığı tedarikçi kodundan doğru işletmeye yönlendirir; çok tedarikçili yapı bunun için var.

Kayıt altında, şifreli

Giden senkronlar ve kanaldan gelen istekler loglanır. Kanal anahtarları AES-256-GCM ile şifreli saklanır.

Yol haritasında ViatorYol haritasıKlookYol haritasıHeadoutYol haritası

Henüz canlı değil. Bu kanallar için altyapı hazırlığı yol haritasında; henüz canlı değil. Başka bir kanal ihtiyacınız varsa bize yazın.

02Ödeme

Link gönderin, ödemeyi alın, cariye işleyin.

İki ödeme altyapısı bugün canlıda: iyzico ve Garanti BBVA sanal POS. Kart bilgisi ödeme sağlayıcının kendi sayfasında girilir; Agentora’da hiçbir aşamada saklanmaz.

iyzico

Ödeme linkleri Canlı

Panelden rezervasyon ya da cari için ödeme linki üretin; müşteriye kopyalayarak, WhatsApp ya da e-posta ile gönderin.

Takipli link rezervasyona ya da cariye bağlıdır ve ödeme panele yansır. Takipsiz link serbest bir tahsilat bağlantısıdır; ödeme Hareketler raporunda izlenir.

  • TRY · EUR · USD · GBP
  • Takipli ve takipsiz link
  • Webhook
  • İade
  • Cariye işle
  • Hareketler raporu

Garanti BBVA

Sanal POS Canlı

3D Secure ile kartlı ödeme; tanım her işletme için ayrıdır. Online rezervasyon sayfasında kart ödemesi iyzico ya da Garanti ile alınır.

  • 3D Secure
  • İşletme bazlı tanım
  • Online rezervasyon ödemesi
iyzico ödeme linkinin yolculuğu
  1. 01

    Link

    Rezervasyon için ödeme linki üretilir.

    EUR 120,00Rezervasyon 260924-031KopyalaWhatsAppE-posta
  2. 02

    Ödeme

    Misafir kartını iyzico’nun sayfasında girer.

    iyzico barındırılan sayfa•••• 4242Kart bilgisi yalnız burada
  3. 03

    Webhook

    iyzico bildirir, Agentora ödemeyi doğrular.

    webhookDoğrulandı
  4. 04

    Cariye işle

    Yarı otomatik: tahsilatı siz onaylarsınız.

    • Kasa fişi
    • Cari hareket
    • Rezervasyon tahsilatı

Kart verisi Agentora’da saklanmaz.

Ödeme katmanı sağlayıcıdan bağımsız tasarlandı: mimari yeni bir sanal POS ya da ödeme altyapısı eklemeye açık. Başka bir ödeme sağlayıcısı kullanıyorsanız bize yazın, birlikte değerlendirelim.

03Fatura ve kur

Fatura kesilir, kur kendiliğinden gelir.

Gün sonu akışının iki ayağı: faturalar bir kuyruğa girip Nilvera üzerinden gider, TCMB kurları gün açılışında hazırdır.

Nilvera

e-Fatura ve e-Arşiv Canlı

Panelden gönderilen belgeler bir kuyruğa girer; hata olursa yeniden denenir ve GİB durumu senkronlanır. Gelen faturalar içe aktarılır.

  • Mükellef sorgulama
  • Kuyruk ve yeniden deneme
  • GİB durum senkronu
  • PDF ve XML
  • Gelen fatura kabul / red
  • Gün sonunda otomatik fatura

TCMB

Döviz kurları Canlı

Merkez bankası kurları gün açılışında otomatik alınır. Gün sonu adımlarında da kur çekme yer alır.

  • Gün açılışında otomatik
  • Gün sonunda kur çekme
e-Belge kuyruğu
  • e-FaturaSatış faturasıKuyruktaGönderiliyorGİB onaylı
  • e-ArşivSatış faturasıKuyruktaGönderiliyorHataYeniden deneniyorGİB onaylı
  • GelenTedarikçi faturasıBekliyorKabulRedKabul edildi
TCMB kurları · gün açılışı
  • USD
  • EUR
  • GBP
alındı

04Harita ve konum

Rota, ETA ve canlı takip haritada buluşur.

Transfer operasyonu iki harita servisine yaslanır: rota ve varış tahmini için Google Maps (Directions), canlı şoför takibi için OpenStreetMap tabanlı Leaflet.

Google Maps

Rota, ETA, harita seçici Canlı

İşletme ayarından açılır. Kalan duraklar için rota ve süre hesaplanır; sıra ya da durum değiştikçe yeniden hesaplanır. Kapalıyken sistem çalışır, yalnız ETA gösterilmez.

  • Ara duraklı rota
  • Durak başına bekleme payı
  • Uyarlanır yeniden hesaplama
  • Transfer noktası harita seçici
  • Günlük çağrı sınırı

OpenStreetMap

Canlı takip (Leaflet) Canlı

Şoför “Transferi Başlat”a dokunduktan sonra konumu haritada görünür: şoför adı, plaka ve son bir saatin izi. Vardiya bitince takip kapanır.

  • Şoför adı ve plaka
  • Son 1 saat
  • Konum yalnız vardiyada

05Bildirim

Doğru kişiye doğru kanaldan haber.

E-posta ve mobil/web push bildirimleri canlıda. WhatsApp yalnızca paylaşım bağlantısı olarak var; WhatsApp Business API ve SMS entegrasyonu bulunmuyor.

E-posta (Resend)

İşlem e-postaları Canlı

Rezervasyon onayı, şifre sıfırlama ve gün sonu raporu e-postayla gider.

  • Rezervasyon onayı
  • Şifre sıfırlama
  • Gün sonu raporu

Push bildirim

Expo + Web Push Canlı

Mobil uygulamada Expo push, web uygulamalarında Web Push (VAPID). Şoföre atama değişince “Yeni Transfer”, garsona mutfak hazır bildirimi düşer.

  • Expo push
  • Web Push (VAPID)
  • Şoför atama bildirimi
  • Mutfak hazır bildirimi

WhatsApp paylaşım bağlantısı

wa.me Yalnız bağlantı

Rezervasyon kartını ve şoför iletişimini WhatsApp’ta paylaşmak için wa.me bağlantıları. Mesajı kullanıcı kendi WhatsApp’ından gönderir; bu bir WhatsApp Business API entegrasyonu değildir.

  • Rezervasyon kartı
  • Şoför iletişimi
Bildirim örnekleri
  • Rezervasyonunuz onaylandıe-bilet ve QR ekte E-posta
  • Yeni TransferOtel → İskele · alış 17:10 Push
  • Mutfak: Masa 12 hazırgarson uygulamasına Push
  • Rezervasyon kartını paylaşWhatsApp’ta açılır wa.me
BulunmayanlarSMSWhatsApp Business API

06Donanım

Sipariş mutfakta fişe dönüşür.

Gemideki bar ve mutfak yazıcıları için Windows tabanlı bir yazdırma ajanı çalışır. Termal fişler ESC/POS ile, Türkçe karakter destekli basılır.

Windows yazdırma ajanı

Kuyruk ve ajan Canlı

Yazdırma işleri bir kuyruğa girer; ajan, yazıcıya bağlı Windows bilgisayarda bunları basar. Yeniden yazdırma ve toplu “Mutfağı Yazdır” vardır.

  • Yazdırma kuyruğu
  • Yeniden yazdırma
  • Bar ve mutfak yazıcı tipleri

ESC/POS termal yazıcılar

Fiş şablonları Canlı

Fiş şablonları 58 ve 80 mm için tasarlanır: blok düzeni ya da serbest tuval. Türkçe karakterler CP857 kod sayfasıyla basılır.

  • 58 / 80 mm
  • Şablon tasarımcısı
  • Türkçe karakter (CP857)

Mutfak ekranı ayrıdır: tarayıcıda açılan bir sayfadır, özel donanım gerekmez.

07Koruma

Bot koruması giriş kapısında.

Cloudflare Turnstile, web girişinde ve online rezervasyon akışında botları ayıklar. Hesap kilidi, hız sınırı ve ekran kilidi gibi diğer katmanlar Güvenlik sayfasında.

Güvenlik ve mimari

Cloudflare Turnstile

Bot koruması Canlı

Giriş ve online rezervasyon formlarında insan doğrulaması yapılır; kötü niyetli otomatik denemeler kapıda kalır.

  • Web girişi
  • Online rezervasyon

08Üzerine inşa edin

Yeni kanal mı lazım? Mimari çok tedarikçili.

Kanal entegrasyonları ortak bir katmanın üzerinde durur: kanal hesapları, ürün eşleme, fiyat çözümleme, müsaitlik ve senkron logları her tedarikçi için aynıdır; tedarikçiye özgü kısım bir adaptördür. GetYourGuide bu yapıdaki ilk adaptör; Viator, Klook ve Headout yol haritasında.

Kanal ihtiyacınızı paylaşın

09SSS

Kanallar ve ödeme hakkında.

Başka bir şey mi merak ediyorsunuz? Tüm sorular SSS sayfasında; gerisini demoda konuşalım.

Tüm sorular
GetYourGuide ile çalışıyor mu?

Evet. GetYourGuide Supplier API ile müsaitlik, rezervasyon, iptal ve fiyat akışı için entegrasyon geliştirildi; kanaldan gelen rezervasyon doğrudan panele düşer ve iptalde bağlı rezervasyon otomatik iptal edilir. Hesabınızın bağlanması GetYourGuide’ın kendi onay sürecine tabidir.

Viator, Klook ve diğer kanallar?

Kanal mimarisi çok tedarikçilidir; Viator ve Klook için altyapı hazırlığı yol haritasındadır ancak henüz canlı değildir. Yeni kanal ihtiyacınızı bizimle paylaşabilirsiniz.

Ödemeyi hangi altyapılarla alabiliyorum? Kart bilgisi saklanıyor mu?

iyzico (ödeme linkleri, takipli ve takipsiz link, iade, cariye işleme) ve Garanti BBVA sanal POS (3D Secure) desteklenir. Kart bilgisi hiçbir zaman Agentora’da saklanmaz.

e-Fatura ve e-Arşiv nasıl çalışıyor?

Nilvera entegrasyonuyla e-Fatura ve e-Arşiv kesilir; mükellef sorgulama, gönderim kuyruğu, yeniden deneme, GİB durum takibi ve gelen fatura yönetimi vardır. Gün sonunda faturalar otomatik kesilebilir.

SMS ve WhatsApp bildirimi var mı?

Şu an e-posta (onay, şifre sıfırlama, gün sonu raporu) ve mobil/web push bildirimleri kullanılır. WhatsApp için rezervasyon kartını ve şoför iletişimini paylaşma bağlantıları vardır; WhatsApp Business API ve SMS entegrasyonu bulunmuyor.

Agentora

Kanalınız, ödemeniz, faturanız tek yerde.

Demoda kullandığınız kanalları ve ödeme yöntemlerini birlikte ele alalım; hangi bağlantının bugün canlı olduğunu net söyleriz.

Demo talep et info@agentora.tr