# Logo Tiger Entegrasyonu Nasıl Yapılır?

Fatura Entegratör, satış kanallarınızdan gelen siparişleri **Logo REST servisi** üzerinden Logo Tiger firmanıza **satış siparişi** veya **satış faturası** olarak aktarır. e-Fatura / e-Arşiv gönderimi Logo'nun kendi e-Dönüşüm modülünden yapılır; Fatura Entegratör kaydı takip eder ve fatura gönderildiğinde satış kanalınıza bildirir.

## 1. Logo REST servisinin açılması

Entegrasyonun çalışabilmesi için Logo sunucunuzda **Logo REST servisinin** kurulu ve internetten erişilebilir olması gerekir. Bu kurulum genellikle **Logo iş ortağınız** tarafından yapılır. İş ortağınıza iletmeniz gerekenler:

* Logo REST servisinin kurulup çalışır hale getirilmesi.

* Servisin dışarıdan **HTTPS** ile erişilebilir bir adresinin olması (alan adı veya sabit IP, güvenlik duvarında ilgili portun açılması).

* Servise erişen uygulama için Fatura Entegratör'ün kullandığı istemci (client) tanımının yapılması. İstemci bilgilerini destek ekibimizden talep edebilirsiniz.

**Kontrol:** Tarayıcınızda `<servis adresi>/swagger` adresini açtığınızda Logo REST API sayfası görünüyorsa servis dışarıdan erişilebilir durumdadır.

## 2. Entegrasyon kullanıcısı ve yetkileri

Entegrasyon için Logo'da ayrı bir kullanıcı açmanızı öneririz. Bu kullanıcının faturaların aktarılacağı **firmaya erişimi** olmalı ve aşağıdaki yetkilere sahip olmalıdır:

- **Cari hesap kartları:** Görüntüleme, ekleme

- **Malzeme kartları:** Görüntüleme, ekleme

- **Birim setleri:** Görüntüleme

- **Satış siparişleri:** Görüntüleme, ekleme, silme

- **Satış faturaları:** Görüntüleme, ekleme, silme

- **Ödeme planları, satış elemanları, projeler:** Görüntüleme

Kullanıcınızda **yetki kodu** kısıtı varsa, Fatura Entegratör ayarlarındaki **Yetki Kodu** alanına kullanıcının erişebildiği kodu yazın; aksi halde oluşturulan kayıtları kullanıcı göremeyebilir.

## 3. Fatura Entegratör'de hesabın eklenmesi

Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından **Hesap Ekle** diyoruz, **Logo Tiger** kısmında yer alan **Ekle** butonunu kullanıyoruz ve aşağıdaki bilgileri giriyoruz:

* **Servis URL:** Logo REST servisinin internetten erişilen adresi (ör. `https://logo.firmaniz.com`).

* **Firma No:** Logo'da faturaların aktarılacağı firmanın numarası.

* **Kullanıcı Adı / Parola:** 2. adımda açtığınız Logo kullanıcısının bilgileri.

Kaydettikten sonra **Logo Aktarım Ayarları** kartından aktarım tercihlerinizi yapabilirsiniz. **Varsayılan** sekmesindeki ayarlar tüm satış kanallarında geçerlidir; her satış kanalı için ayrı sekmeden farklı değer verebilirsiniz (boş bırakılan alanlar varsayılan ayarı kullanır).

* **Aktarım Türü:** Satış Siparişi veya Satış Faturası.

* **Satış Fatura Türü:** Toptan veya Perakende satış faturası (aktarım türü fatura ise).

* **Sipariş Durumu:** Öneri, Sevkedilemez veya Sevkedilebilir (aktarım türü sipariş ise). Öneri durumundaki siparişler Logo'da onaylanmadan faturalanamaz.

* **Yetki Kodu / Özel Kod:** Oluşturulan fiş, cari ve malzeme kartlarına yazılır (en fazla 11 karakter).

* **Ambar / İşyeri / Bölüm No, Ödeme Planı, Satış Elemanı, Proje:** Fişe atanacak değerler. Ödeme planı, satış elemanı ve proje listeleri Logo'daki tanımlarınızdan gelir.

## 4. Eşleştirme kuralları

* **Malzemeler:** Satırdaki stok kodu (SKU), Logo'da malzeme kartının **Kodu** ve **Özel Kodu** alanlarında aranır. Bulunamazsa stok koduyla, satış / satınalma / malzeme yönetiminde kullanılabilir yeni bir malzeme kartı açılır.

* **Birimler:** Ürün birimi, Logo birim setlerindeki uluslararası birim koduna (ör. C62 = adet) göre eşleştirilir.

* **Cariler:** Müşteri vergi numarası veya T.C. kimlik numarası ile aranır. Bulunamazsa kodu vergi / T.C. kimlik numarası olan yeni bir cari hesap kartı açılır.

* **İnternet satışı ve KDV istisnası** bilgileri siparişte varsa faturaya otomatik aktarılır.

## 5. Takip

Kayıt Logo'ya aktarıldıktan sonra Fatura Entegratör 7 gün boyunca durumunu takip eder:

* Aktarım türü **fatura** ise: fatura Logo'dan e-Fatura / e-Arşiv olarak gönderildiğinde fatura numarası ve ETTN Fatura Entegratör'e alınır.

* Aktarım türü **sipariş** ise: sipariş Logo'da faturalandığında oluşan fatura bulunur ve aynı şekilde takip edilir.

Aktarılan kayıtların **iptali Logo üzerinden** yapılmalıdır. Şu an yalnızca **TL** faturalar aktarılabilir.