Uçtan Uca Yaşam Döngüsü

Bir acente API'yi kullanmaya başladığında sistem üç açıdan çalışır: acente kurar & satar, Woxx admini ticari koşulları ayarlar, operatör rezervasyonu TRMS'te yönetir. Aşağıdaki her adım gerçek ekran görüntüleriyle gösterilmiştir.

1

Acente — kurulum & satış

Acente bir kez kurulur; sonrası tekrar tıklamak değil, API entegrasyonudur. Panelde kendi yönettikleri azdır (anahtar + canlı talep) — asıl iş kendi sisteminden API çağrısıdır.

Adım 1 — Başvuru

İş ortaklığı başvurusu

Acente partner.travapi.com'dan firma, vergi ve yetkili bilgileriyle başvurur; başvurusu ekibimize ulaşır.

Başvuru formu
Acente firma, vergi ve yetkili bilgilerini girip başvurusunu gönderir.
Başvuru alındı
Başvuru alındı onayı — ekibimiz inceleyip iletişime geçer.
Adım 2 — Şifre belirleme

Onay sonrası kendi şifresini oluşturur

Başvuru onaylanınca acenteye e-posta gider; acente bağlantıdan kendi şifresini belirler. (Onay adımı admin tarafındadır — aşağıda.)

Şifre belirle
E-postadaki bağlantıdan acente yeni şifresini iki kez girip kaydeder.
Şifre kaydedildi
Şifre kaydedildi — artık giriş yapılabilir.
Adım 3 — Giriş & panel

Giriş yap, API Erişimi paneline ulaş

Acente e-posta + şifresiyle giriş yapar ve API Erişimi paneline ulaşır. Panelde tek işi anahtar yönetimidir.

Giriş
Acente e-posta ve belirlediği şifreyle giriş yapar.
Panel
API Erişimi paneli — acentenin kendi yönettiği tek yer. Henüz anahtar yok.
Adım 4 — Sandbox anahtarı

Tek tıkla test anahtarı

Acente panelden sandbox (test) anahtarı üretir; secret yalnızca bir kez gösterilir. Anahtar listede belirir. Canlı satış için "Canlı erişim iste" ile talep açar (Woxx onaylar).

Sandbox anahtarı
Tek tıkla sandbox anahtarı; secret bir kez gösterilir, hemen kaydedilir (görselde maskeli).
Key'li panel
Oluşturulan anahtar listede: ortam (sandbox), durum (active), oluşturma tarihi.
Adım 5 — Asıl kullanım — API

Kendi sisteminden: token → ara → sat

Acentenin günlük hayatı panelde değil, kendi yazılımında: anahtarla token alır, otel/tur/cruise arar, seçtiği rateKey ile rezervasyon yapar. Sandbox'ta gerçek borç oluşmaz.

token · 1 saatarama · gerçek-zamanlıbooking · idempotent
API akışı
Acentenin kendi sisteminden gerçek koşum: token al → 1068 otel dönüyor → SBX- sandbox booking (borç yok).
2

Admin (Woxx) — ticari ayarlar

Acentenin parası burada ayarlanır: başvuru onayında markup, anahtar yönetiminde kota/IP/scope, cari limitinde kredi. Woxx admini tüm ticari koşulların sahibidir.

Admin paneli

Yönetim ekranına giriş

Woxx admini yönetim paneline giriş yapar; buradan başvuru, acente, anahtar ve rezervasyon işlerini yürütür.

Admin paneli
Operasyonel yönetim paneli — başvuru, acente, anahtar ve rezervasyon yönetiminin merkezi.
Onay + markup

Başvuruyu onayla, komisyon marjını ata

Admin "Acente Başvuruları"nda bekleyen başvuruyu görür. Onaylarken markup % girer — acente + kullanıcı oluşur, şifre belirleme maili gider.

Başvurular
Admin bekleyen başvuruları görür; her satırda firma bilgisi + onayla/reddet.
Onay dialog
Onay anında acente + kullanıcı oluşur, komisyon marjı (markup %) atanır, şifre maili gider.
Onaylandı
Onay sonucu — acente oluşturuldu ve şifre belirleme maili gönderildi.
Acente yönetimi

Acente kaydı

Onaylanan acente "Acenteler" listesinde görünür (firma, vergi dairesi, iletişim, rezervasyon sayısı). Markup, kaynak pazar ve cruise komisyonu gibi ticari ayarlar acente detayından düzenlenir.

Acente kaydı
Onaylanan acente listede: firma, vergi dairesi, iletişim ve rezervasyon sayısı. Ticari ayarlar detaydan düzenlenir.
Anahtar & kota yönetimi

API anahtarları: üret, kısıtla, izle

Admin acenteye anahtar üretir; kapsam (hotel/tour/cruise), izinli IP, günlük kota ve rate limit tanımlar. Kullanım analitiği (çağrı sayısı, hata oranı, gecikme, endpoint dağılımı) canlı izlenir. Anahtar askıya alınabilir / iptal edilebilir; canlı anahtar onaydan sonra aktifleşir.

Anahtar yönetimi
Admin anahtar yönetimi: kullanım analitiği (çağrı/hata/gecikme), yeni anahtar üretimi (kapsam/IP/kota/rate) ve anahtar listesi (askı/iptal).
3

Operatör (TRMS) — rezervasyon & cari

Acentenin API'den yaptığı her canlı rezervasyon TRMS'e düşer. Operatör onu acente atıflı görür, finansallarını (satış/net/komisyon) izler ve acentenin cari hesabını yönetir.

Rezervasyon listesi

Operatör tüm rezervasyonları görür

TRMS rezervasyon listesinde kaynak (Travapi / WOXX B2B / Reswio…), tedarikçi, otel/ürün, satış tutarı ve durum bir arada. Acente filtresiyle bir acentenin tüm rezervasyonları süzülür. (Misafir adları gizlilik için bulanıklaştırılmıştır.)

TRMS rezervasyonlar
Operatör tüm rezervasyonları görür: kaynak sekmeleri (Travapi/WOXX B2B/…), acente & tedarikçi & durum filtreleri (misafir adları gizli).
Rezervasyon detayı

Acente atıflı, finansallı detay

Detayda rezervasyonun hangi acenteye ait olduğu (Kaya Travel Agency), tedarikçi (Woxx), tarihler, satış / alış (net) / komisyon kırılımı ve ödeme durumu görünür. Operatör buradan onay/iptal/iade, voucher ve fatura işlemlerini yürütür.

Rezervasyon detayı
Rezervasyon detayı — Kaynak Travapi, Acente: Kaya Travel Agency, tedarikçi Woxx; satış/alış/komisyon ve ödeme durumu bir arada.
Acente cari

Cari hesap: kredi limiti & bakiye

Kartsız (cari) satışta her rezervasyon acentenin cari hesabına borç yazar. Operatör acentenin kredi limitini, kullanılabilir bakiyesini ve hareketlerini buradan izler/yönetir.

Acente cari
Acente cari hesabı — Kaya: kredi limiti 5.000 EUR, kullanılabilir bakiye ve hareketler; kartsız satışta borç buraya işler.
Zincir tamamlanır Acente API'den satar → rezervasyon TRMS'e acente atıflı düşer → komisyon & cari otomatik işler → operatör görür ve yönetir. Üç perspektif tek sistemde birleşir.