Fiyuu Kurye Entegrasyonu — Personel Kılavuzu

01 Sistem nasıl çalışıyor

Restoranda bir paket sipariş “Bekleyenler”e düştüğünde, POS bunu otomatik olarak Fiyuu'ya gönderir ve Fiyuu bir kurye görevlendirir. Kurye siparişi aldığında Fiyuu bize haber verir, paket POS'ta “Yola Çıkanlar”a geçer.

Restoran POS

Bekleyenlere düşen paketi 30 saniye içinde Fiyuu'ya gönderir.

Fiyuu

Kurye atar. Her durum değişiminde tek bir adrese bildirim yollar.

Yönlendirici

Bildirimi kaydeder, mağaza koduna bakıp doğru restorana iletir.

Restoran POS

Kurye ürünü alınca paket “Yola Çıkanlar”a geçer.

Fiyuu bütün restoranların bildirimini tek bir adrese gönderir; hangi restoran olduğunu ayırt etmek için sipariş numarasının başına mağaza kodu eklenir (3450247803-70000000001735893). Yönlendiricinin varlık sebebi budur.

Fiyuu başarısız bildirimi tekrar denemez. Bir bildirim ulaşmazsa kalıcı olarak kaybolur. Bu yüzden yönlendirici gelen her bildirimi önce kaydeder; iletemezse panelde “iletilemeyen” olarak durur ve elle gönderilebilir. Panele düzenli bakmanın sebebi budur.

02 Yeni restoran bağlama

Sırayla yapılır. Bir adımı atlarsan sonraki adım çalışmaz.

Fiyuu'dan mağaza kodu tanımlat

satisdestek@fiyuu.com.tr adresine restoranın bilgilerini ve vergi numarasını gönder; mağaza kodu olarak vergi numarasını tanımlamalarını iste.

Mağaza kodu standardımız vergi numarasıdır. Bu kod üç yerde birebir aynı olacak: Fiyuu'da, yönlendirici panelinde ve restoranın POS ayarında.
Müşterinin admin panelinden API anahtarı üret

Restoranın kendi admin paneline gir: Ayarlar → API Anahtarları → Yeni anahtar. Adına “Fiyuu Webhook” yaz. Üretilen anahtarı kopyala.

Bu anahtar o restorana özeldir. Fiyuu'nun bize verdiği anahtarla karıştırma — o ayrı ve tüm restoranlarda ortaktır.
Yönlendirici panelinde restoranı ekle

Restoranlar → + Yeni restoran. Üç alan doldurulur:
- Restoran adı — sadece senin görmen için, serbest.
- Mağaza kodu — vergi numarası, 1. adımda Fiyuu'ya bildirdiğin.
- Hedef adres — restoranın statik IP'si ve portu, örneğin 88.249.201.180:90. Gerisini sistem tamamlar, sen yol yazma.
- API anahtarı — 2. adımda ürettiğin.
Restoranın statik IP'si olmalı. IP değişirse bildirimler ulaşmaz ve Fiyuu tekrar denemediği için kaybolur.
Bağlantıyı test et

Restoran satırındaki Test düğmesine bas. Beklenen cevap: Bağlantı başarılı (HTTP 200)

Test, olmayan bir sipariş numarasıyla zararsız bir bildirim gönderir — hiçbir gerçek sipariş etkilenmez. Başarısız olursa 4. bölüme bak; mesaj sana ne yapman gerektiğini söyler.
POS ayarını yap

Panelin Durum sekmesindeki POS ayarı bloğunu Kopyala ile al ve restoranın bilgisayarında uygula:
- POS'u kapat. Program açıkken dosya düzenlenirse değişiklik kaybolur.
- RESPOS.exe ile aynı klasördeki RESPOS.exe.config dosyasını Not Defteri ile aç (genelde C:\DINOSOFT\RESPOS\).
- Blogu </appSettings> satırının hemen üstüne yapıştır.
- VERGI_NUMARASI_YAZIN yazan yeri mağaza koduyla değiştir.
- Aynı isimde satır zaten varsa eskisini sil. İki kez tanımlanırsa POS hiç açılmaz.
- Kaydet, POS'u aç.
Bitti sayılır: Restoranda bir paket siparişi bekleyenlere düşür. 30 saniye içinde not alanında [FİYUU: Fiyuu'ya gönderildi] yazmalı. Yazmıyorsa 4. bölüm.

03 Günlük kontrol

Yönlendirici panelinin Durum sekmesine günde bir kez bak. İki şeye dikkat et — ikisi de sıfır olmalı.

Gösterge	Ne demek	Sıfır değilse
İletilemeyen	Fiyuu bildirim gönderdi ama restoranın bilgisayarına ulaştıramadık.	Bildirimler sekmesi → “Yalnızca iletilemeyenler” → sebebi gör, düzelt, Tekrar gönder.
Tanımsız mağaza kodu	Bir restorandan bildirim geliyor ama o restoran panelde ekli değil.	Restoranı 2. bölümdeki adımlarla ekle, sonra bildirimleri tekrar gönder.

Bir siparişin geçmişini görmek istersen Bildirimler sekmesinde satıra tıkla: Fiyuu'nun gönderdiği ham bilgi, iletim sonucu ve deneme sayısı açılır.

POS'taki Fiyuu günlüğü

Panel, Fiyuu'dan bize gelen bildirimleri gösterir. Bizim Fiyuu'ya gönderdiğimiz bilgi ise restoranın kendi bilgisayarında tutulur:

C:\DINOSOFT\RESPOS\Log\Fiyuu\fiyuu-YYYYAAGG.log

“Fiyuu'da yanlış adres / yanlış ödeme türü görünüyor” gibi bir şikâyette hatanın bizde mi Fiyuu'da mı olduğunu ayırt etmenin tek yolu bu dosyadır. Sipariş numarasını arat, satırı oku — gönderdiğimiz değerler ile adisyondaki değerler yan yana yazılıdır.

Dosya müşteri adı, telefonu ve adresi içerir. Dışarı paylaşırken dikkatli ol; 30 gün sonra kendiliğinden silinir.

04 Sorun giderme

Panelde Test başarısız

Mesaj	Sebep	Yapılacak
Hedef sürüm eski	Restoranın admin programı güncel değil, yeni sipariş numarası biçimini tanımıyor.	O restorana admin güncellemesi yap, sonra tekrar test et.
Hedefe ulaşılamadı	Adres yanlış, sunucu kapalı ya da IP değişmiş.	IP'yi ve portu doğrula, restoranın sunucusunun açık olduğundan emin ol. IP değiştiyse panelden güncelle.
API anahtarı reddedildi	Paneldeki anahtar, restoranın admin panelindekiyle aynı değil.	Restoranın admin panelinden yeni anahtar üret, panelde Düzenle ile gir. (Boş bırakırsan eski anahtar korunur — değiştirmek için yenisini yazman gerekir.)

Paket POS'ta bekleyenlerde kalıyor

Not alanındaki [FİYUU: ...] yazısına bak; sebebi orada yazar.

Not alanında yazan	Sebep	Yapılacak
GÖNDERİLEMEDİ adres hizmet alanı dışında	Müşterinin adresi Fiyuu'nun çalıştığı bölgenin dışında.	Bu siparişi kendi kuryene ver. Fiyuu bu adrese gitmez.
GÖNDERİLEMEDİ telefon / adres hatalı	Cari kartta telefon 10 haneye tamamlanamıyor ya da adres boş.	Cari kartı düzelt. Düzeltince sipariş kendiliğinden yeniden denenir.
GÖNDERİLEMEDİ restoran kapalı	Fiyuu'daki çalışma saatleri dışındasınız.	Saatler yanlışsa Fiyuu'dan düzelttir. Geçici durumdur, açılınca kendi gönderilir.
Fiyuu'ya gönderildi ama uzun süre değişmiyor	Kurye henüz atanmamış ya da bildirim ulaşmamış olabilir.	Panelde iletilemeyen var mı bak. Yoksa Fiyuu'yu ara — POS zaten 5 dakikada bir durumu kendisi sorup düzeltir.
Not alanında hiç `[FİYUU: ...]` yazmıyorsa sipariş Fiyuu'ya hiç gönderilmemiş demektir. POS ayarı yapılmamış ya da mağaza kodu yanlış olabilir — 2. bölüm, 5. adım.

Kurye hiç gelmiyor ama her şey normal görünüyor

Restoranın RESPOS.exe.config dosyasında iki değeri kontrol et:

<add key="FiyuuTestOrder" value="0" />   ← 1 ise sipariş TEST sayılır
<add key="FiyuuStoreId"   value="…" />   ← restoranın kendi vergi numarası olmalı

FiyuuTestOrder değeri 1 kalmışsa ya da mağaza kodu başka bir restoranın koduysa sipariş “başarıyla gönderildi” görünür, ama gerçek kurye çıkmaz. Hiçbir yerde hata görünmediği için en zor fark edilen durum budur.

Günlükten sipariş okuma

Her sipariş için üç satır yazılır:

Etiket	Ne yazar
[INF]	Okunabilir özet: gönderdiğimiz ad, telefon, adres, ödeme türü ve adisyondaki ham hâlleri.
[REQ]	Fiyuu'ya giden ham istek.
[RES]	Fiyuu'nun cevabı. `HTTP 201` = sipariş açıldı.

[INF] satırında adres= ile ADISYON: adres= aynıysa doğru göndermişiz, sorun Fiyuu tarafındadır. Farklıysa sorun bizdedir — ekran görüntüsüyle birlikte yazılıma ilet.

Günlükte görürsen	Ne demek	Yapılacak
ODEME TURU TANINMADI → NAKIT varsayildi	Siparişin ödeme türü çözülemedi; kurye kapıda nakit almaya gider.	Telefon siparişinde kasiyer ödeme türü seçmemiş olabilir. Pazaryeri siparişinde görüyorsan ödeme türü eşlemesinde eksik kayıt var — yazılıma bildir.
konum=,	Adresin koordinatı yok; Fiyuu haritada iğne gösteremez.	Cari kartın adresinde konum yoksa, admin → Ayarlar → Konum sayfasından teslimat bölgesine bir kez konum işaretle.
ad=MÜŞTERİ 5xxxxxxxxx	Adisyonda müşteri adı yok, yerine telefon yazıldı.	Hata değil, sipariş normal gider. Rahatsız ediyorsa cari karta ad gir.
HTTP 400 · VAL_102 “zaten mevcut”	Aynı sipariş ikinci kez gönderilmiş.	Genellikle paketin “Yola Çıkanlar”dan geri alınmasından olur (bkz. 6. bölüm). Sipariş Fiyuu'da zaten açık olduğu için kayıp yoktur.

05 Teslimat sonrası otomatik tahsilat

Kurye siparişi teslim ettiğinde, ödemesi online alınmış paketin tahsilatı POS'ta otomatik yazılabilir ve adisyon kendiliğinden kapanır. Böylece kasiyerin gün sonunda tek tek kapatması gerekmez.

Varsayılan olarak kapalıdır. Para kapatan bir akış olduğu için restoran bazında, müşteriyle konuşarak açılır.

Ayar POS kurulum bloğunda 0 (kapalı) olarak gelir. Açmak için RESPOS.exe.config dosyasında değeri 1 yapın:

<add key="FiyuuAutoCollectOnDelivered" value="1" />

Neyi kapatır, neyi kapatmaz

Sipariş	Davranış	Sebep
Online ödemeli	Teslim edilince otomatik kapanır.	Para pazaryerinden zaten alınmış; kasiyerin işlemi yalnızca kayıt.
Kapıda ödemeli	Kapanmaz, eskisi gibi kasiyer kapatır.	Kurye parayı kasaya getirmeden tahsilat yazılmamalı.

Kapıda ödemeli siparişler için paket ekranındaki Otomatik Tahsilat butonu eskisi gibi çalışır — kasiyer vardiya sonunda kuryelerden nakiti teslim aldıktan sonra basar.

Otomatik tahsilat mali fiş kesmez. Yazarkasa fişi akışı değişmedi.

06 Yapılmayacaklar

Çalışan bir restoranın mağaza kodunu değiştirme. Fiyuu'daki geçmiş siparişleri sahipsiz kalır ve bildirimleri artık eşleşmez.
POS açıkken RESPOS.exe.config düzenleme. Program kapanırken dosyayı üzerine yazar, yaptığın değişiklik kaybolur.
Aynı ayarı iki kez ekleme. RESPOS.exe.config içinde aynı key iki kez geçerse POS hiç açılmaz.
Fiyuu'nun anahtarını restoran anahtarı yerine kullanma. İkisi ayrı; hangisinin nereye gittiğini 6. bölümde bulursun.
Fiyuu'ya devredilmiş paketi “Yola Çıkanlar”dan geri alma. Paket bekleyenlere düşer düşmez sistem onu 30 saniye içinde Fiyuu'ya yeniden gönderir; Fiyuu “bu sipariş zaten var” der ve paket geri devredilmiş olur. Siparişi gerçekten Fiyuu'dan almak istiyorsan önce Fiyuu'yu arayıp iptal ettir.
İletilemeyen bildirimleri silme. Onlar kurtarılabilir kayıtlardır; silinirse o siparişin durumu POS'a hiç ulaşmaz.

07 Terimler

Mağaza kodu (storeId): Restoranın Fiyuu'daki kimliği. Bizde vergi numarası kullanılır.
Yönlendirici: Fiyuu'dan gelen bildirimleri doğru restorana dağıtan merkezî panel.
Fiyuu anahtarı: Fiyuu'nun Dinosoft'a verdiği anahtar. Tüm restoranlarda ortak, yalnızca yönlendiricide durur. Personel bunu kullanmaz.
Restoran anahtarı: Her restoranın kendi admin panelinden ürettiğin anahtar. Yönlendiricinin o restorana bildirim gönderirken kullandığı şifre.
Bildirim: Fiyuu'nun “kurye atandı / ürünü aldı / teslim edildi / iptal” haberleri.
İletilemeyen: Bize ulaşan ama restorana aktarılamayan bildirim. Panelden elle gönderilebilir.
Online ödemeli: Parası pazaryerinde (Yemeksepeti, Trendyol, Getir, Migros) müşteriden çoktan alınmış sipariş. Kurye kapıda para almaz.
POS günlüğü: Restoranın bilgisayarındaki Log\Fiyuu\ klasöründe, Fiyuu'ya ne gönderdiğimizin kaydı. 30 gün saklanır.