How can we help?

Makaleleri buradan arayın veya aşağıdaki kategorilere göz atın.

Browse by topic

Find guides, tutorials, and answers organised by category.

Popular articles

What other people are reading right now.

🧑‍💻 Entegrasyon Kurulumları

Logo Tiger Entegrasyonu

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.

🧑‍💻 Entegrasyon Kurulumları

Sovos Entegrasyonu Nasıl Yapılır ?

Sovos Entegrasyonu Nasıl Yapılır? Bu dokümanda Sovos entegrasyonunu adım adım nasıl tamamlayacağınızı öğreneceksiniz. Entegrasyon tamamlandığında Fatura Entegratör üzerinden doğrudan fatura kesmeye başlayabilirsiniz. https://www.youtube.com/watch?v=sTaTZAeLjzY Başlamadan Önce Kuruluma geçmeden önce aşağıdakilere sahip olduğunuzdan emin olun: - Sovos portalı giriş bilgileriniz (e-posta ve şifre) - Sovos portalında Ürün Ayarları bölümüne erişim yetkisi - Firma bilgileriniz (unvan, vergi dairesi, VKN/TCKN vb.) Adım 1: Kullanıcı Adı ve Şifre Bilgilerini Girin Öncelikle Kullanıcı Adı ve Şifre alanlarına, Sovos portalına giriş yaparken kullandığınız e-posta ve şifre bilgilerini giriyoruz. Sovos entegrasyon ekranı - kullanıcı adı ve şifre alanları Bu bilgiler Sovos portalındaki hesabınızla birebir aynı olmalıdır. Portalda şifrenizi değiştirdiğinizde bu alanı da güncellemeyi unutmayın. Adım 2: Gelen Kutusu ve Posta Kutusu Bilgilerini Bulun Gelen Kutusu ve Posta Kutusu bilgilerimizi Sovos portalı üzerinden öğrenebiliriz: 1. Sovos portalına giriş yapın. 2. Ürün Ayarları > E-Fatura Ayarları bölümüne gidin. 3. "Etiket" yazan kısımdaki bilgileri kopyalayın. 4. Kopyaladığınız bilgileri entegrasyon ekranındaki ilgili alanlara yapıştırın. Sovos portalı - Ürün Ayarları > E-Fatura Ayarları Etiket alanı Adım 3: Fatura Numarası Ayarlarını Yapılandırın Aynı menü üzerinde yer alan "Otomatik Fatura ID" tercihine göre aşağıdaki adımları izlemelisiniz. Seçenek "Evet" ise Fatura Numarası Ön Eki ve Fatura Numarası Seri Numarası alanlarını boş bırakabilirsiniz. Fatura numaraları otomatik olarak oluşturulur. Seçenek "Kapalı" ise - Fatura Numarası Ön Eki: 3 harften oluşan bir ön ek belirlemelisiniz. (örn. GIB) - Fatura Numarası Seri Numarası: Başlangıç numarasını girmelisiniz. (örn. 2026000000001) Otomatik Fatura ID ayarı Not: Otomatik Fatura ID özelliğini kullanmayıp bu değerleri kendiniz belirlediğinizde, oluşturacağınız faturaların numaraları yazdığınız bu başlangıç değeri üzerinden otomatik olarak artmaya devam eder. Adım 4: Firma Bilgilerini Tamamlayın ve Kaydedin Kalan kısımları firma bilgileriniz ile doldurarak entegrasyonu tamamlayabilirsiniz. "Hesap Bilgilerini Kaydet" dedikten sonra fatura kesmeye hazırsınız. Firma bilgileri ve Hesap Bilgilerini Kaydet butonu Entegrasyon tamamlandı. Artık Fatura Entegratör üzerinden fatura oluşturabilirsiniz. Sık Karşılaşılan Durumlar | Durum | Çözüm | | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Giriş bilgileri hatalı uyarısı alıyorum | Sovos portalına aynı e-posta ve şifre ile giriş yapabildiğinizi kontrol edin. | | Etiket bilgilerini bulamıyorum | Sovos portalında Ürün Ayarları > E-Fatura Ayarları bölümündeki "Etiket" alanına bakın. | | Fatura numarası beklediğim gibi ilerlemiyor | Otomatik Fatura ID ayarınızın açık mı kapalı mı olduğunu kontrol edin; kapalıysa girdiğiniz başlangıç numarasını gözden geçirin. |

🧑‍💻 Entegrasyon Kurulumları

Paraşüt Entegrasyonu Nasıl Yapılır?

video Ayarlar > Fatura Hesapları > Hesap Ekle yolunu izleyerek yeni hesap ekleme işlemine başlıyoruz Açılan ekranda arama kutusuna ‘Paraşüt’ yazıyoruz ve çıkan sonuçlardan ‘Ekle’ butonuna tıklıyoruz. Açılan ekranda Paraşüt hesap bilgilerimizi giriyoruz. Gerekli olan Client ID ve Client Secret bilgileri Paraşüt tarafından sağlanmaktadır.” Varsayılan Hesap Numarası’ alanı için, Paraşüt uygulamasında Nakit > Kasalar ve Bankalar > Kasa Hesabı kısmınına ilerleyip, tarayıcı adres çubuğunda (URL) görünen numarayı kopyalayıp bu alana yapıştırıyoruz. Bilgileri girdikten sonra ‘Bağlantıyı Test Et’ butonuyla doğrulama yapıyoruz. Doğrulama tamamlandığında, hesabı kaydederek işlemimizi bitiriyoruz. Tüm adımların tamamlanmasının ardından Paraşüt entegrasyonu başarıyla gerçekleştirilmiş olur.

🐛 Neden Hata Alıyorum?

Bu Mükellef Kullanıcı Bilgilerini Hiç Güncellememiş Hatası Nasıl Giderilir?

Bu mükellef kullanıcı bilgilerini hiç güncellememiş hatası nasıl giderilir? “kullanıcı bilgilerini hiç güncellememiş” hatası alınmasının sebebi, firma bilgilerinin GIB portalında tanımlanmamış olmasıdır. Çözüm Adımları 1. GİB portalına giriş yapın. 2. Firma bilgilerinizi tanımlayın 3. Değişiklikleri kaydedin. 4. İşlem tamamlandıktan sonra hata ortadan kalkacaktır.

Başlangıç

WordPress Eklentisi Kanca (Hook) Listesi

Fatura Entegratör Verilerini Manipüle Etme ginvoice_invoice_map_wc_order_request filtresi, sipariş verilerini Woo'dan alıp Fatura Entegratör API'sine iletilmeden hemen önce tetiklenir. Bu filtreler sayesinde, gönderi etiketi oluşturulmadan önce ürün adları, fatura tarihi gibi tüm fatura oluşturma verilerini değiştirebilirsiniz. Aşağıdaki kod bloğu; ürün adını düzenleme, fatura tarihini değiştirme etme gibi senaryoları kapsar: add_filter('ginvoice_invoice_map_wc_order_request', function($ginvoice_request, $order) { // Ürün satırlarını döngüye alarak başlıkları güncelle $ginvoice_request['lines'] = array_map(function($line) { // Sipariş öğesi meta verisini al $sample_meta_value = wc_get_order_item_meta($line['id'], '_my_sample_meta_key', true); // Ürün adına meta değerini ekle if (!empty($sample_meta_value)) { $line['title'] = $line['title'] . ' - ' . $sample_meta_value; } return $line; }, $ginvoice_request['lines']); // Fatura tarihini sipariş tarihi yapma $ginvoice_request['issue_date'] = $order->get_date_created()->date('Y-m-d'); return $ginvoice_request; }, 10, 2);

❓ Sık Sorular Sorular

Hatalı Fatura Sonrası Geriye Dönük Fatura Nasıl Kesilir ? Mysoft/E-Faturam

https://www.youtube.com/watch?v=aO0rH35aEk8 Mysoft paneli üzerinden sol taraftaki menüden Firma bilgileri bölümüne tıklayın, açılan menüden Belge ayarları seçeneğine giriş yapın. Ekranın sol en üst köşesinde yer alan Numaratörler alanına tıklayın. Geriye dönük fatura kesebilmek adına yeni bir seri başlatmak için Yeni numaratör ekle butonuna tıklayın. Hangi fatura türünde işlem yapmanız gerekiyorsa ilgili türü (e-arşiv veya e-fatura) seçin. Yeni numaratörünüz için üç harfli bir ön ek belirleyin. Belirlediğiniz bu yeni seriyi sistemde Varsayılan Yap seçeneği ile işaretleyin. Son olarak işlemi Kaydet diyerek tamamlayın.