Yazarkasa ve POS cihazı KOBİ GO’ya nasıl bağlanır?

Kısa Yanıt

Yazarkasa veya fiziksel kart POS cihazınızı KOBİ GO'ya bağlamak için Ayarlar → Hızlı Satış Ayarları bölümüne gidin. POS Cihazları alanından Yeni cihaz seçeneğini kullanarak cihazınızı ekleyin. Cihaz için oluşturulan API anahtarını yazarkasa veya entegrasyon yazılımınıza tanımlayın ve fiş verilerinin KOBİ GO Webhook URL'sine gönderilmesini sağlayın.

POS Cihazı Entegrasyonu Nedir?

POS Cihazı Entegrasyonu, yazarkasa ve fiziksel kart POS cihazlarınızdan oluşan satış verilerinin KOBİ GO'ya aktarılması için kullanılır. Entegrasyon, cihazınız veya cihazla çalışan entegrasyon yazılımı üzerinden gerçekleştirilebilir.

POS Cihazları Bölümüne Nasıl Ulaşılır?

1. 1

   Ayarlar bölümünü açın

   KOBİ GO sol menüsünden Ayarlar bölümüne girin.

2. 2

   Hızlı Satış Ayarları'nı seçin

   Ayarlar menüsündeki Hızlı Satış Ayarları sayfasını açın.

3. 3

   POS Cihazları bölümünü bulun

   Sayfadaki POS Cihazları bölümünü açın.

4. 4

   Yeni cihaz seçeneğini kullanın

   İlk yazarkasa veya POS cihazınızı tanımlamak için Yeni cihaz butonuna tıklayın.

Yeni Cihaz Nasıl Eklenir?

POS Cihazları bölümünde henüz tanımlanmış cihaz bulunmuyorsa 'Henüz cihaz yok. Yeni cihaz ile ilk yazarkasanızı ekleyin.' bilgisi görüntülenir. Yeni cihaz butonu cihaz tanımlama işlemini başlatır.

API Anahtarı Ne İşe Yarar?

KOBİ GO'da eklenen her cihaz için bir API anahtarı oluşturulur. Bu anahtar, KOBİ GO'ya fiş gönderen cihazın veya entegrasyon yazılımının ilgili cihaz tanımıyla ilişkilendirilmesi için kullanılır.

Webhook URL Nedir?

Webhook URL, yazarkasa veya entegrasyon yazılımının fiş verilerini KOBİ GO'ya göndereceği adrestir. Hızlı Satış Ayarları → POS Cihazları bölümünde kullanılacak Webhook URL görüntülenir ve yanındaki Kopyala butonuyla kopyalanabilir.

Cihaz KOBİ GO'ya Nasıl Veri Gönderir?

Cihazınız veya entegrasyon yazılımınız, her fiş kesildiğinde fiş bilgilerini KOBİ GO'da gösterilen Webhook URL'ye POST isteği olarak gönderecek şekilde yapılandırılır.

Yazarkasa Entegrasyonu Nasıl Çalışır?

1. 1

   Cihazınızı KOBİ GO'ya ekleyin

   POS Cihazları bölümündeki Yeni cihaz seçeneğini kullanarak yazarkasa veya POS cihazınızı tanımlayın.

2. 2

   API anahtarını alın

   Cihaz için oluşturulan API anahtarını kopyalayın.

3. 3

   Entegrasyon yazılımını yapılandırın

   Cihazınızı veya entegrasyon yazılımınızı KOBİ GO'da gösterilen Webhook URL'ye fiş verisi gönderecek şekilde yapılandırın.

4. 4

   API anahtarını isteğe ekleyin

   Oluşturulan cihaz API anahtarını X-POS-Api-Key başlığıyla gönderin.

5. 5

   Fiş verisini gönderin

   Her fiş kesildiğinde entegrasyon yazılımının fiş verisini JSON POST olarak KOBİ GO'ya göndermesini sağlayın.

6. 6

   Satış akışını yönetin

   KOBİ GO'ya gelen fiş siparişe dönüşür; etkin Hızlı Satış Ayarlarınıza göre stok ve muhasebe süreçlerine yansır.

Fiş KOBİ GO'ya Geldiğinde Ne Olur?

Entegrasyon Rehberi'nde belirtildiği üzere cihazdan veya entegrasyon yazılımından gelen fiş otomatik olarak siparişe dönüşür. Sonraki işlemler Hızlı Satış Ayarlarında yaptığınız seçimlere göre ilerler.

• Gelen fiş siparişe dönüşür.
• Satışta otomatik stok düşümü açıksa stok bakiyesi azalır.
• Muhasebeye otomatik kayıt açıksa tamamlanan satış gelir olarak muhasebeye yansır.
• Günlük rapora ekle açıksa satış günlük Z raporuna dahil edilir.

Yazarkasa Modunu Kontrol Edin

Hızlı Satış Ayarları'nın Genel bölümündeki Yazarkasa Modu, mevcut yazarkasa veya POS cihazınızdan kesilen fişlerin otomatik olarak KOBİ GO'ya düşmesi için kullanılan seçenektir. Yazarkasa entegrasyonunu kullanırken bu ayarın durumunu kontrol edin.

Otomatik Stok ve Muhasebe Ayarlarını Kontrol Edin

Cihaz bağlantısını yaptıktan sonra satışların işletme kayıtlarınıza nasıl yansıyacağını Hızlı Satış Ayarları'ndan belirleyebilirsiniz. Otomatik stok düşümü ve muhasebeye otomatik kayıt seçenekleri birbirinden ayrı olarak yönetilir.

Farklı Yazarkasa Markaları Kullanılabilir mi?

KOBİ GO Entegrasyon Rehberi'nde farklı yazarkasa markaları için adapter mimarisinin kullanılabileceği belirtilir. Kendi entegratörünüz, yazarkasadan gelen veriyi KOBİ GO'nun beklediği veri yapısına dönüştürerek Webhook üzerinden gönderebilir.

Entegrasyon İçin Hangi Tarafın Yapılandırılması Gerekir?

KOBİ GO tarafında cihaz tanımı ve cihaz API anahtarı oluşturulur. Yazarkasa, POS cihazı veya bu cihazlarla çalışan entegrasyon yazılımı tarafında ise fiş verilerinin KOBİ GO Webhook URL'sine uygun şekilde gönderilmesi gerekir.

Bağlantı Sonrası Neleri Kontrol Etmelisiniz?

• Cihazın KOBİ GO POS Cihazları bölümüne eklendiğini kontrol edin.
• Doğru cihaz API anahtarının kullanıldığından emin olun.
• Fiş verilerinin KOBİ GO'da gösterilen Webhook URL'ye gönderildiğini kontrol edin.
• API anahtarının X-POS-Api-Key başlığıyla gönderildiğini kontrol edin.
• Gönderilen verinin KOBİ GO'nun entegrasyon yapısına uygun olduğundan emin olun.
• Yazarkasa Modu ve kullanmak istediğiniz otomatik satış ayarlarının durumunu kontrol edin.

Fişler KOBİ GO'ya Gelmiyorsa

Cihazı eklediğiniz halde fişler KOBİ GO'ya ulaşmıyorsa öncelikle Webhook adresini, kullanılan cihaz API anahtarını ve X-POS-Api-Key başlığını kontrol edin. Ayrıca cihaz veya entegrasyon yazılımının fiş verisini POST isteğiyle gönderdiğinden emin olun.