# 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.

Canonical page: https://magazamhazir.com/yardim/yazarkasa-okc
Menu path in the store admin: Yazarkasa
Available on every plan — no plugin required.
Last updated: 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

### 1. Cihazı tanıtın {#adim-1}

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.

### 2. API anahtarını hemen kopyalayın {#adim-2}

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.

### 3. Cihazın aktive olmasını bekleyin {#adim-3}

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.

### 4. Kasadan gelen fişleri izleyin {#adim-4}

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.

### 5. KDV oranı ve teslimat durumunu ayarlayın {#adim-5}

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.

### 6. Z raporlarını kontrol edin {#adim-6}

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.

## İ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.