Hugin T300 ÖKC Entegrasyonu (TCP/IP)

PixelPOS üzerinden Hugin T300 cihaz ekleme, eşleştirme, lisanslama ve satışta otomatik yazdırma adımları

İlk ve En Önemli Adım: Ön Koşullar

Başlamadan Önce Lütfen Okuyun! Aşağıdaki maddelerin her biri, entegrasyonun başarılı olması için tamamen zorunludur. Maddeleri teyit ettikçe işaretleyebilirsiniz.

Bilgisayar internete bağlı.
* PixelPOS'un kurulu olduğu bilgisayarın internete bağlı olduğundan emin olun (kablo bağlantısı önerilir).
Yazarkasa cihazı internete KABLO (Ethernet/CAT) ile sımsıkı bağlı.
* Cihazın arkasındaki 'ETH' girişine, bilgisayarınızın bağlı olduğu modemden standart bir internet kablosu takın.
Cihazın IP adresi (ETH adresi) ve Sicil Numarası bilgi raporundan öğrenilmiş.
* Nasıl öğrenilir? Cihazdan sırasıyla şu tuşlara basın:
1. MENÜ tuşuna basın.
2. Ayarlar'a girin (veya 0 tuşuna basın).
3. SİSTEM BİLGİ RAPORU'nu seçin.
* Yazdırılan kağıttaki "ETH Adresi:" (Örn: 192.168.1.50) sizin IP adresinizdir. Aynı kağıtta veya cihazın altında yazan sicil numarasını da (Mali ID) not alın.
PixelPOS uygulamasındaki tüm ürünlerin KDV oranları doğru ayarlanmış.
* Cihaz sadece %1, %10 ve %20 oranlarını tanır. Eski olan %8 ve %18 gibi oranları olan ürünleri gönderirseniz cihaz hata verir ve fiş yazmaz. PixelPOS'ta "Ürün İşlemleri" menüsünden tüm ürünlerin KDV'lerini düzenleyebilirsiniz. Eğer hiç ürününüz yoksa, ileride gireceğiniz yeni ürünlerin KDV'lerinin düzgün (%1, %10, %20) girildiğine emin olmalısınız.
Gerekli lisans işlemleri Yazarkasa POS firması (Hugin) tarafından açılmış.
* Eşleştirme işlemini tamamlasanız bile satıştan fiş kesebilmek için, Hugin müşteri hizmetlerini arayıp cihazınızın "Entegrasyon (Harici Cihaz Modu)" lisansını açtırmanız gerekir.

Hızlı Özet

Neler Gerekli?

Aynı ağda çalışan cihaz, PixelPOS ve cihazın bilgi raporundaki IP adresi.

Kaç Dakika Sürer?

Ortalama 5-15 dakika sürer. İlk kurulumda lütfen adımları atlamayınız.

Eşleştirme Mantığı

Cihazdaki YEŞİL tuş ile PixelPOS'taki Bağlantı Testi butonuna AYNI ANDA basılır!

Eşleştirme Sonrası

Cihaz satışlarında fiş yazdırmak için yazarkasa lisansı ve PixelPOS entegrasyon lisansı gerekir.

İpucu Eşleştirme testi sırasında 2-3 kez başarısız deneme olması normaldir. Cihaz ve bilgisayarın aynı anda sinyal göndermesi kritik bir adımdır, tekrar deneyiniz.

İlk Adım: Bağlantılar ve İp Adresi Bulma

🔌 Fiziksel Bağlantı Nasıl Yapılır?

PixelPOS'un (bilgisayarınızın) ve Hugin cihazınızın haberleşmesi için aynı internet ağına bağlı olmaları şarttır. Kutu içerisinden her zaman bağlantı kablosu çıkmayabilir.

Bilgisayarınızı internete (modeme veya routera) kablo ile bağlayın (Wi-Fi ile bağlıysa sorun yok, ancak kablo her zaman daha sağlıklıdır).
Hugin yazarkasanızı, bilgisayarınızın bağlı olduğu aynı modeme veya ağ anahtarına (switch) bir Ethernet (CAT) kablosu ile bağlayın.

📄 Hugin İp Adresi (ETH Adresi) Nerede Yazar?

Kurulum sırasında bize cihazın İp adresi (ETH adresi) gerekecek. Aşağıdaki çok basit adımları cihaz üzerinde uygulayarak öğrenebilirsiniz:

Cihaz üzerindeki MENÜ tuşuna basın.
Ekranda çıkan "Ayarlar" menüsüne tıklayın (veya tuş takımından "0" tuşuna basın).
Açılan ekrandan 3. seçenek olan "SİSTEM BİLGİ RAPORU" seçeneğine tıklayın.
Cihazınız bir bilgi fişi (kağıt) yazdıracaktır. O kağıtta yazan "ETH Adresi:" satırını bulun. (Örnek: 192.168.1.50)

İşte bu sizin İp adresinizdir! Birazdan programda bu adresi kullanacağız.

1. PixelPOS'ta Cihaz Ekleme

PixelPOS ana menüsünden aşağıdaki yolu izleyin:
Ayarlar > POS Ayarları > Yeni Cihaz Ekle

POS Markası

Hugin T300

İsim

Kasadaki ÖKC

Bağlantı Tipi

TCP/IP

IP Adresi

(Cihaz bilgi raporunda yazan IP adresini giriniz)

Port

(Birazdan cihaz ekranında göreceğimiz port numarasını gireceğiz)

Seri / Sicil No

(Cihaz altındaki veya rapordaki Seri/Sicil numarasını giriniz)

"Varsayılan Bağlantı" işaretli olsun "Varsayılan" işaretli olsun

⚠️ Bilgileri doldurup bu ekranda bekleyin. "Bağlantı Testi" butonuna henüz BASMAYIN!

2. Cihazda Servis Moduna Girme

Cihaz ekranından Kasiyer 1'i seçin.
Şifre alanına 99 girin ve Onay (Giriş) tuşuna basın.
Ekranda "Servis moduna girmek istiyor musunuz?" sorusu çıkacaktır. Onay verin.
Servis şifresi olarak 12345 girin ve servis moduna geçiş yapın.

Dikkat: Servis Şifresi Hakkında

Bazı cihazlarda veya kurulumlarda servis şifresi farklı olabilir ya da menü akışı değişebilir. Eğer 12345 kabul edilmezse, yetkili servis veya bağlı olduğunuz partner üzerinden cihazın kendi servis şifresini talep etmeniz gerekebilir.

3. Eşleştirme İşlemi (En Kritik Bölüm)

Cihaz servis modundayken aşağıdaki adımları dikkatlice uygulayın:

Servis menüsünden 14. Bağlantı Seçenekleri bölümüne girin.
Menüden "Cihaz Eşleştir" seçeneğini bulun ve onaylayın.
Ekranda bir Port Numarası belirecektir.
(PixelPOS ekranında boş bıraktığımız "Port" alanına tam olarak bu sayıyı yazın.)
Aynı Anda Bas!
Port cihaz ekranında görünür haldeyken ve PixelPOS formunda port yazılmışken, AYNI ANDA şu iki işlemi yapın:
- Cihazın klavyesinden YEŞİL (GİRİŞ) tuşuna basın.
- Bilgisayarda PixelPOS ekranındaki "Bağlantı Testi" butonuna tıklayın.
Başarılı Sonuç: Bilgisayar ekranında "Eşleştirildi" veya "Eşleşme tamamlandı" şeklinde başarılı yeşil bildirim mesajı görülür.
Başarısız Olursa: 2-3 defa üst üste tekrar denemek tamamen normaldir. Senkronizasyon gecikmesi yaşanabilir. Cihazdaki menüden bir kez (Kırmızı tuş ile) çıkıp tekrar "Cihaz Eşleştir"e girin ve adımı tekrarlayın.

4. Servis Modundan Çıkış ve ETH Modu

Başarılı eşleşme sonrasında cihazın menüsünden geri/çıkış (Kırmızı) tuşları ile ana ekrana doğru ilerleyin.
Cihaz sizden çıkış onayı ve şifre isterse cihazın kendi ekranındaki yönlendirmeyi takip ederek (genellikle tekrar 12345 şifresiyle) servisten çıkın.
Servisten çıkıldığında cihaz kendini yeniden başlatabilir veya otomatik olarak ETH (Ethernet) Moduna alacaktır. Satış bağlantısı bu mod üzerinden sağlanır.

Not: Bazı cihazlarda servisten çıkış işlemi, modelin versiyon farkından dolayı ekranda farklı görünebilir. Cihazın ekrandaki yönergelerini okuyarak güvenli şekilde ana ekrana (satış ekranına) dönünüz.

5. Lisans Süreci

Lisans İşlemleri Tamamlanmadan Fiş Yazdırılamaz!

Eşleştirme işlemi sadece yerel ağdaki teknik bağlantıyı sağlar. Satış ekranında otomatik yazdırma için aşağıda belirtilen her iki lisansın da aktif olması şarttır:

PixelPOS Lisansı: PixelPOS yönetici/bayi paneli üzerinden "Yazarkasa için lisans talep" işlemi yapılmalı ve onaylanmalıdır.
Yazarkasa Modeli Lisansı: Hugin T300 veya kullanılan yazarkasa modelinin, üretici/entegratör firma tarafında entegrasyon/aktivasyon aboneliğinin ödenmiş veya aktif edilmiş olması gerekir.

Sonraki Adım: Bize Ulaşın Lütfen yukarıdaki teknik eşleştirmeyi sağladıktan sonra lisansları onaylatmak için destek ekibimizle iletişime geçiniz.

6. İlk Satış Testi

Tüm bağlantı ve lisans işlemleri onaylandıktan sonra entegrasyonun düzgün çalışıp çalışmadığını son kez test edin:

PixelPOS Satış Ekranına girin.
1 TL tutarında deneme amaçlı bir ürünü sepete ekleyin.
Ödeme tipi olarak Nakit veya Kredi Kartı işlemlerinden birini seçerek tahsilatı tamamlayın.
Satışı tamamladığınız anda Hugin T300 cihazı otomatik olarak uyanmalı ve mali fişi / POS slibini otomatik yazdırmalıdır.

Cihaz hiçbir tepki vermiyor ya da hata üretiyorsa, aşağıdaki KDV veya Sorun Giderme bölümlerini inceleyin.

KDV Oranları (Mini Rehber)

ÖKC entegrasyonlarında cihazın fiş yazdıramamasının en temel sebebi, satılan ürünün hatalı orana sahip olmasıdır.

PixelPOS'taki ürünlerin KDV oranları ile yazar kasa cihazının içerisindeki KDV departmanları zorunlu olarak uyuşmalıdır. PixelPOS üzerinde Tanımlar > Ürünler ekranından satış yapacağınız ürünün değerini kontrol edin.

%0
KDV Hariç / İstisna
%1
Temel Gıda vb.
%10
Hizmet, Tekstil vb.
%20
Genel Ürün Oranı

Önemli: Eski dönemde kalmış %8 veya %18 gibi oranları olan ürünleri satış ekranına çağırırsanız cihaz doğrudan hata verir ve satış işlemini (ve fiş yazdırmayı) durdurur. İlgili ürünleri %10 veya %20 olarak güncelleyin.

Sorun Giderme Rehberi

Sık karşılaşılan hatalar ve çözüm yöntemleri aşağıda listelenmiştir. Detayları görmek için başlıkların üzerine tıklayınız.

"Bağlantı testi başarısız" hatası veriyor

IP veya Ağ Yanlış: Cihaz ile bilgisayar kesinlikle aynı ağ (aynı modem) altyapısında bulunmalıdır. Bilgisayarınız misafir ağına veya cep telefonu Wi-Fi paylaşımına, cihaz ise dükkanın sabit modemi gibi farklı bir hatta bağlıysa eşleşme sağlanamaz.
Port Yanlış: PixelPOS formuna yazdığınız port değerinin, tam o saniyede cihaz ekranında aktif olarak gördüğünüz port numarası ile birebir aynı olduğundan emin olun.
Sicil/Seri Numarası Yanlış: Bir harf/rakam hatası dahi cihazın güvenlik nedeniyle eşleşmeyi reddetmesine neden olur. Kontrol edin.
Gecikme (Zamanlama): Cihaz klavyesindeki Yeşil tuş ile ekrandaki butona kelimenin tam anlamıyla "Aynı Anda" basmayı başaramamış olabilirsiniz. Biraz daha senkronize olarak tekrar deneyin.

Her şeyi doğru yapmama rağmen 2-3 denemede de eşleşmiyor

Bağlantıda fiziksel sorunları kontrol edin:

Cihazın arka tarafındaki ve duvardaki/modemdeki ethernet (ağ) kablosunun klik sesi ile yerine tam oturduğundan ve koptuğu bir yer olmadığından emin olun.
İşletmedeki modemin veya firewall (güvenlik duvarı) cihazının yerel ağ içinde TCP trafiğini engelleyen sıkı güvenlik kuralları olabilir.
Girdiğiniz servis şifresi (12345) size menülere girme hakkı verse dahi yetki profiliniz eşleştirme sinyali göndermeye uygun ayarlanmamış olabilir. Cihazı temin ettiğiniz yetkili servise danışın.

Cihaz başarılı şekilde eşleşti ancak satış sırasında yazdırmıyor

En yaygın durum: Cihaz lisansı ve özel PixelPOS entegrasyon lisansınızın merkez üzerinde ya girilmemiş ya da henüz onaylanıp aktif edilmemiş olmasıdır. Lütfen destek isteyin.
İkinci sebep (KDV Hatası): Sepete eklediğiniz ürünün PixelPOS içerisindeki KDV oranının (%1, %10, %20 yerine eski %8, %18 veya eşleşmeyen bambaşka bir değer) hatalı olmasıdır.
Cihazı servisten "ETH" moduna aldığınızdan ("Servisten Çıkış" adımı) kesin olarak emin olun.

İşlem bittikten sonra cihaz otomatik olarak ETH moduna geçmedi

Servis menüsünde işiniz bittiğinde menülerden kırmızı veya geri tuşları ile tam anlamıyla çıkış yapıp, cihazın size son kez şifre (12345) sorarak kapanış yapmasına izin vermelisiniz. Yanlışlıkla yarıda kestiyseniz cihaz serviste kalmış sayılabilir. Sorun devam ediyorsa cihazın elektrik bağlantısını söküp / düğmesinden kapatıp yeniden açın.

Port numarası çok garip veya çok büyük rakamlar görünüyor (örneğin 50214)

Bu standart ve tamamen beklenen bir durumdur. Hugin T300 "Cihaz Eşleştir" ekranında hangi dinamik port numarasını (ne kadar büyük de olsa) veriyorsa güvenlik nedeniyle o an geçerli olan o port numarasıdır. Ekranda gördüğünüz rakamı hiçbir değişiklik yapmadan aynen PixelPOS port giriş alanına yazın.

Sıkça Sorulan Sorular

Bu kurulum işlemi baştan sona ne kadar zaman alır?

Tüm bilgilerin hazır olması (IP, seri no) durumunda bağlantı ve aynı anda basıp eşleştirme işlemi tecrübeye bağlı olarak genellikle 5 ile 15 dakika arasında tamamlanır. İşletmeyi etkilememek için en boş zamanınızda yapmanız önerilir.

Entegrasyon sonrası her satışta cihazdan manuel olarak tutar mı tuşlayacağım?

Hayır. Entegrasyon yapıldı anlamına gelen şey budur; PixelPOS satış ekranı üzerinden nakit veya kredi kartı seçeneğine tıkladığınızda sinyal anında cihaza iletilir, cihaz otomatik olarak uyanır, ekranda tutarı gösterir (kredi kartıysa kart ister) ve direkt olarak tahsilatı yapıp fişi basar.

Cihazın IP adresini veya Seri Numarasını nereden/nasıl bulacağım?

Cihazın kendi ana menüsünden Raporlar > Cihaz Bilgi Raporu (veya bazı modellerde Ağ Raporu) menüsüne ilerleyip bu raporu kağıt olarak yazdırarak kağıt üzerindeki IP adresini ve Sicil/Seri bilgisini net biçimde okuyabilirsiniz.

Girmem gereken servis şifresi 12345 değilse ve geçersiz uyarısı veriyorsa ne yapmalıyım?

Hugin markasının bölgesel yetkili servisi veya cihazı kurup yazar kasa kaydını yapan aracı partner firma ile görüşerek cihaza özgü ayarlanmış teknisyen/servis şifresini doğrudan onlardan talep etmelisiniz. Bazı partnerler cihazları spesifik şifreler ile kurmaktadırlar.

Girdiğim port numarası kalıcı/sabit bir numara mı, sonradan değişir mi?

Bu akışta eşleştirme ekranına girdiğinizde cihaz her teşebbüste güvenliği sağlamak için özel olarak kullanılacak yeni bir işlemi dinamik port numarası ile kilitler. O an aktif ekrandaki port numarası takip edilmelidir. Cihaz eşleştikten sonra PixelPOS tarafındaki port ayarıyla bir daha oynamanıza ve bağlantı testi yapmanıza normal şartlarda gerek yoktur.