API anahtarını kaybettim, nereden görürüm?

Hiçbir yerden. Anahtar yalnızca üretildiği anda gösterilir ve saklanmaz. Tek çözüm Bağlı cihazlar listesinde Yeni anahtar demek ve çıkan yeni anahtarı Hugin'e iletmektir; eski anahtar o anda geçersiz olur.

Fişler geliyor ama siparişe işlenmiyor

Siparişe işlendi sütununda İşlenemedi görüyorsanız Yeniden dene deyin; panel kaç kaydın işlendiğini ve kaçının beklediğini söyler. Tekrarlıyorsa fişteki tutar ya da tarih ile eşleşecek bir sipariş bulunamıyordur — kasadan kesilen satışın panelde bir karşılığı olduğundan emin olun.

Kasa satışları sipariş listesinde neden hazırlanıyor görünüyor?

Teslimat durumu ayarındaki Kasa satışları teslim edildi olarak işaretlensin kapalıdır. Tezgâh üstü satış yapıyorsanız açın — müşteri malı zaten elinde götürüyor, sipariş hazırlanıyor durumunda kalmasın.

Birden fazla kasa bağlayabilir miyim?

Evet. Her cihaz kendi mali sicil numarasıyla ayrı ayrı eklenir ve kendi API anahtarını alır. Fiş listesindeki Cihaz sütunu hangi satışın hangi kasadan geldiğini gösterir; Etiket alanını doldurursanız bu okuma çok kolaylaşır.

Yazarkasa (ÖKC) mağazaya nasıl bağlanır

Hugin yazarkasanızı panele tanıtın, API anahtarını alın, kasadan kesilen fişlerin siparişe işlenmesini ve Z raporlarını takip edin.

3 dk okumaSon güncelleme: 2026-09-01

Dükkânda kasadan kesilen fiş ile internetteki sipariş listesi ayrı iki dünya olmak zorunda değil. Yazarkasa (ÖKC) ekranı cihazınızı panele tanıtır; kasada bir satış tamamlandığında fiş buraya düşer ve ilgili siparişe işlenir. Kurulum üç adımdır: cihazı ekleyin, çıkan API anahtarını Hugin'e iletin, cihaz aktive olunca fişler akmaya başlar.

Başlamadan önce

Hugin ile yapılmış bir yazarkasa sözleşmesi ve sözleşmedeki vergi kimlik numarası
Cihazın üzerinde yazan mali sicil numarası
Panelde yazarkasa ekranını görebilen bir hesap

Adımlar

Ekran görüntüleri örnektir; kendi panelinizdeki veriler farklı olacaktır.

Adım 1: Cihazı tanıtın
Yazarkasa ekranında Yazarkasa ekle deyin. Mali sicil no cihazın üzerinde ve fişlerde yazan numaradır. Vergi kimlik no, Hugin sözleşmenizdeki VKN olmalıdır — cihaz aktivasyon sırasında bunu gönderir, uyuşmazsa eşleşme kurulmaz. Etiket zorunlu değildir ama birden fazla kasanız varsa hangisinin hangisi olduğunu ayırt etmenizi sağlar.
Yazarkasa (ÖKC)
Yazarkasa ekle
Mali sicil no
FU00001234
Cihazın üzerinde ve fişlerde yazan sicil numarası (örn. FU00001234).
Vergi kimlik no
1234567890
Hugin sözleşmenizdeki VKN. Cihaz aktivasyonda bunu gönderir.
Etiket
Kasa 1
Bu cihazı kasada tanımanız için (zorunlu değil).
Yazarkasa ekle
Yazarkasa ekle — panelden örnek görünüm
Adım 2: API anahtarını hemen kopyalayın
Cihaz eklendiğinde panel bir API anahtarı üretir ve bunu yalnızca o an gösterir. Ekranı kapattığınızda anahtar bir daha görünmez; kaybederseniz Yeni anahtar ile yenisini üretmek zorunda kalırsınız ve eski anahtar geçersiz olur. Kopyala deyip Hugin'e iletmeden bu pencereyi kapatmayın.
API anahtarı — yalnızca ŞİMDİ gösterilir
API anahtarı — yalnızca ŞİMDİ gösterilir
okc_live_9f2c8ad41b7e4c5fa03b6d18e7c92aa4
KopyalaKapat
Bir cihaz ekleyin, ardından API anahtarını Hugin'e iletin.
API anahtarı — yalnızca ŞİMDİ gösterilir — panelden örnek görünüm
Adım 3: Cihazın aktive olmasını bekleyin
Bağlı cihazlar listesinde yeni cihaz önce Aktivasyon bekliyor durumundadır. Hugin anahtarı cihaza tanımlayıp aktivasyonu tamamladığında durum Aktif olur ve Son görülme sütunu dolmaya başlar. Bir cihazı geçici olarak durdurmak isterseniz Devre dışı bırakın; silmeye gerek yoktur, sonra Etkinleştir dersiniz.
Bağlı cihazlar
Mali sicil no Etiket Durum Son görülme
FU00001234 Kasa 1 Aktif 01.09.2026 14:22
FU00005678 Kasa 2 Aktivasyon bekliyor —
Yeni anahtarDevre dışı bırak
Bağlı cihazlar — panelden örnek görünüm
Adım 4: Kasadan gelen fişleri izleyin
Kasadan gelen fişler listesi her satışı Fiş no, Cihaz, Tutar ve Tarih ile gösterir. Tür sütunu Satış veya İptal olabilir. Siparişe işlendi sütunu, fişin ilgili siparişe bağlanıp bağlanmadığını söyler; İşlenemedi görüyorsanız Yeniden dene deyin — panel kaç kaydın işlendiğini ve kaçının hâlâ beklediğini yazar.
Kasadan gelen fişler
Fiş no Cihaz Tür Tutar Siparişe işlendi
000241 Kasa 1 Satış 348,00 ₺ Siparişe işlendi
000242 Kasa 1 İptal -120,00 ₺ İşlenemedi
Yeniden dene
Kasadan bir satış tamamlandığında burada görünür.
Kasadan gelen fişler — panelden örnek görünüm
Adım 5: KDV oranı ve teslimat durumunu ayarlayın
KDV oranı bölümündeki Varsayılan KDV oranı (%), kasadan gelen satırlarda oran bilgisi yoksa kullanılır ve 0 ile 100 arasında olmalıdır. Teslimat durumu ise kasa satışlarının sipariş listesinde hangi durumda açılacağını belirler: işaretlerseniz teslim edildi olarak, işaretlemezseniz hazırlanıyor olarak açılır. Tezgâh üstü satışta ilki, paket serviste ikincisi doğrudur.
KDV oranı
Varsayılan KDV oranı (%)
20
Kasadan yapılan satışlar sipariş listesinde hangi durumda görünsün?
Kasa satışları teslim edildi olarak işaretlensin
açık
Kasa satışları teslim edildi olarak işaretlenecek.
KDV oranı — panelden örnek görünüm
Adım 6: Z raporlarını kontrol edin
Z raporları bölümü cihazın gönderdiği gün sonu raporlarını tutar ve günde bir kez alınır. Kasada gün sonu alındığında rapor buraya düşer. Bu liste boşsa ya henüz gün sonu alınmamıştır ya da cihaz panele ulaşamıyordur — ikinci durumda Bağlı cihazlar listesindeki Son görülme sütunu da eskimiş olur.
Z raporları
Cihazın gönderdiği gün sonu raporları. Günde bir kez alınır.
31.08.2026
Aktif
Kasa 1
Kasada gün sonu alındığında burada görünür.
Z raporları — panelden örnek görünüm

Mali sicil no	Etiket	Durum	Son görülme
FU00001234	Kasa 1	Aktif	01.09.2026 14:22
FU00005678	Kasa 2	Aktivasyon bekliyor	—

Fiş no	Cihaz	Tür	Tutar	Siparişe işlendi
000241	Kasa 1	Satış	348,00 ₺	Siparişe işlendi
000242	Kasa 1	İptal	-120,00 ₺	İşlenemedi

İpuçları

Anahtarı yenilemek eskisini iptal eder

Yeni anahtar dediğinizde eski anahtar anında geçersiz olur. Cihaz eski anahtarla çalışmaya devam ediyorsa fiş göndermeyi keser. Yenileme yaptığınızda yeni anahtarı Hugin'e iletmeden kasayı çalıştırmayın.

VKN uyuşmazlığı sessiz bir hatadır

Cihaz aktivasyonda sözleşmedeki VKN'yi gönderir. Panele farklı bir VKN yazdıysanız eşleşme kurulmaz ve cihaz Aktivasyon bekliyor durumunda takılı kalır. Durum günlerce değişmiyorsa ilk bakacağınız yer burasıdır.

İptal fişleri de akar

Kasada iptal edilen bir satış listeye İptal türüyle ve eksi tutarla düşer. Ciro raporlarınızı okurken bunu hesaba katın; liste ham fiş akışını gösterir, net satışı değil.

Sık sorulan sorular

API anahtarını kaybettim, nereden görürüm?: Hiçbir yerden. Anahtar yalnızca üretildiği anda gösterilir ve saklanmaz. Tek çözüm Bağlı cihazlar listesinde Yeni anahtar demek ve çıkan yeni anahtarı Hugin'e iletmektir; eski anahtar o anda geçersiz olur.
Fişler geliyor ama siparişe işlenmiyor: Siparişe işlendi sütununda İşlenemedi görüyorsanız Yeniden dene deyin; panel kaç kaydın işlendiğini ve kaçının beklediğini söyler. Tekrarlıyorsa fişteki tutar ya da tarih ile eşleşecek bir sipariş bulunamıyordur — kasadan kesilen satışın panelde bir karşılığı olduğundan emin olun.
Kasa satışları sipariş listesinde neden hazırlanıyor görünüyor?: Teslimat durumu ayarındaki Kasa satışları teslim edildi olarak işaretlensin kapalıdır. Tezgâh üstü satış yapıyorsanız açın — müşteri malı zaten elinde götürüyor, sipariş hazırlanıyor durumunda kalmasın.
Birden fazla kasa bağlayabilir miyim?: Evet. Her cihaz kendi mali sicil numarasıyla ayrı ayrı eklenir ve kendi API anahtarını alır. Fiş listesindeki Cihaz sütunu hangi satışın hangi kasadan geldiğini gösterir; Etiket alanını doldurursanız bu okuma çok kolaylaşır.