🧑‍💻

Entegrasyon Kurulumları

11 makaleler Fatih ÇELEBİ Talha MERT Fuat POYRAZ Tarafından Fatih ÇELEBİ, Talha MERT, and Fuat POYRAZ

E-Fatura Entegratörlerin kurulum rehberleri

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.

Bizim Hesap Entegrasyonu

Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “Bizim Hesap” kısmında yer alan “Ekle” butonunu kullanıyoruz. Bizim Hesap tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

E-Arşiv Portal Entegrasyonu

video Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “E-Arşiv Portal” kısmında yer alan “Ekle” butonunu kullanıyoruz. E-Logo tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

Mysoft Entegrasyonu

Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “Mysoft” kısmında yer alan “Ekle” butonunu kullanıyoruz. Mysoft tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

Logo işbaşı Entegrasyonu

Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “Logo İşbaşı” kısmında yer alan “Ekle” butonunu kullanıyoruz. Logo İşbaşı tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

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

Uyumsoft Entegrasyonu Nasıl Yapılır ?

1. Gerekli Bilgiler Entegrasyon sürecine başlamadan önce Uyumsoft tarafından size iletilen aşağıdaki bilgilere sahip olduğunuzdan emin olun: - Portal Kullanıcı Adı: Uyumsoft portalına giriş yaparken kullandığınız kullanıcı adı (Genellikle API yetkisi olan bir kullanıcıdır). - Portal Şifresi: Kullanıcı adına ait şifre. - Firma Bilgileri: Sisteme entegre edilecek şirketin resmi bilgileri (Vergi Kimlik Numarası / TCKN, Firma Unvanı vb.). 2. Entegrasyon Adımları Adım 1: Entegrasyon Ekranına Erişim - Kullandığınız yazılımın/panelin Ayarlar veya Entegrasyonlar menüsüne gidin. - Açılan listeden Uyumsoft Entegrasyonu seçeneğine tıklayın. Adım 2: Portal Bilgilerinin Girilmesi - Karşınıza çıkan ekrandaki ilgili alanlara, Uyumsoft tarafından sağlanan Kullanıcı Adı ve Şifre bilgilerinizi eksiksiz bir şekilde yazın. Adım 3: Firma Bilgilerinin Tanımlanması - Fatura kesecek veya işlem yapacak kuruma ait Firma Bilgilerini (VKN/TCKN, Unvan, Adres vb.) ilgili kutucuklara girin. Not: Girdiğiniz VKN/TCKN bilgisinin Uyumsoft portalındaki bilgilerle birebir eşleştiğinden emin olun. Adım 4: Kaydetme ve Test İşlemi - Tüm bilgileri doldurduktan sonra "Kaydet" veya "Bağlantıyı Test Et" butonuna tıklayın. - Sistem, girdiğiniz bilgilerle Uyumsoft sunucularına bir test isteği gönderecektir. "Bağlantı Başarılı" uyarısını aldığınızda entegrasyonunuz tamamlanmış demektir.

EDM Entegrasyonu Nasıl Yapılır ?

1. Gerekli Bilgiler Entegrasyon sürecine başlamadan önce EDM Bilişim tarafından size iletilen aşağıdaki bilgilere sahip olduğunuzdan emin olun: - Portal Kullanıcı Adı: EDM portalına giriş yaparken kullandığınız kullanıcı adı (Genellikle API/Web servis yetkisi olan ana kullanıcı veya alt kullanıcıdır). - Portal Şifresi: Kullanıcı adına ait şifre. - Firma Bilgileri: Sisteme entegre edilecek şirketin resmi bilgileri (Vergi Kimlik Numarası / TCKN, Firma Unvanı vb.). 2. Entegrasyon Adımları Adım 1: Entegrasyon Ekranına Erişim - Kullandığınız yazılımın/panelin Ayarlar veya Entegrasyonlar menüsüne gidin. - Açılan listeden EDM Bilişim Entegrasyonu seçeneğine tıklayın. Adım 2: Portal Bilgilerinin Girilmesi - Karşınıza çıkan ekrandaki ilgili alanlara, EDM Bilişim tarafından sağlanan Kullanıcı Adı ve Şifre bilgilerinizi eksiksiz bir şekilde yazın. Adım 3: Firma Bilgilerinin Tanımlanması - Fatura kesecek veya işlem yapacak kuruma ait Firma Bilgilerini (VKN/TCKN, Unvan, Adres vb.) ilgili kutucuklara girin. Not: Girdiğiniz VKN/TCKN bilgisinin EDM portalındaki üyelik bilgilerinizle birebir eşleştiğinden emin olun. Adım 4: Kaydetme ve Test İşlemi - Tüm bilgileri doldurduktan sonra "Kaydet" veya "Bağlantıyı Test Et" butonuna tıklayın. - Sistem, girdiğiniz bilgilerle EDM sunucularına bir test isteği gönderecektir. "Bağlantı Başarılı" uyarısını aldığınızda entegrasyonunuz tamamlanmış demektir.

Trendyol Entegrasyonu Nasıl Yapılır ?

Trendyol üzerinden sağ üstte bulunan hesabınıza tıklayarak 'Hesap Bilgileri' sekmesine gidiyoruz. Ardından Entegrasyon Bilgileri Sekmesine İlerliyoruz. Karşımıza Çıkan Sayfadan 'Yeni Entegratör Ekle' Diyerek Entegrasyon Ekliyoruz. Entegratör Adı Olarak 'Fatura Entegratör' Yazabiliriz ve Rol Seçimi Kısmından Tüm İzinleri seçerek ilerliyoruz. Entegrasyon Bilgilerimiz Burada Yer Alıyor. Fatura Entegratör Uygulama Sayfasından Ayarlar Sekmesine Gidiyoruz. Ardından Satış Kanalları Sekmesine Gidiyoruz. Kanal Ekle Butonu ile Trendyol Hesabını Ekle Butonuna Basıp, İçerisindeki Bilgileri Trendyol Tarafındaki Entegrasyon Bilgileri ile Doldurarak Entegrasyonu Sağlıyoruz.

Turkcell e-Faturam Entegrasyonu Rehberi

Entegrasyon Aşaması Turkcell E-Faturam entegrasyonu için öncelikle app.faturaentegrator.com üzerinden Ayarlar > Fatura Hesapları bölümünden 'Turkcell e-Faturam' hesabımızı ekle butonuna basarak entegrasyon ayarlarına gidiyoruz ve firma bilgileri istenen alanları dolduruyoruz. API Key Bilgisi API key alabilmek için portal.turkcellesirket.com üzerinden Turkcell e-Faturam portalına giriş yapıyoruz, daha sonra portal üzerinden API Yönetimi sekmesi üzerinden > Yeni API Anahtarı butonuna tıklıyoruz. Yeni API Key Oluşturma Yeni API anahatarımız için isim berirliyoruz, örnek olarak 'Fatura Entegrator API' Entegrasyonu Tamamlama API anahtarınız bu aşamalardan sonra oluşacak ve bu anahtarı Fatura Entegratör uygulama sayfası üzerindeki entegrasyon bilgileri ekranına girdiğinizde artık Turkcell e-Faturam hesabınızın entegrasyonunu tamamlamış olacaksınız.

JSON Feed (Özel Entegrasyon) Nasıl Yapılır?

Bu entegrasyon için sisteminizin, siparişlerinizi belirli bir adreste (URL) JSON formatında yayınlaması gerekir. Bunun için teknik ekibinize veya yazılımcınıza aşağıdaki dokümanı iletmeniz yeterlidir: Teknik (geliştirici) dokümanı: https://dev.faturaentegrator.com/feed-entegrasyonu Yazılımcınızdan şu bilgileri isteyin: - Sipariş Feed Adresi (URL) — zorunlu - Yetkilendirme bilgileri — feed adresiniz korumalıysa (token, kullanıcı adı/şifre veya özel header) - Bildirim Adresi (URL) — isteğe bağlı; fatura kesildiğinde sisteminize haber vermemizi istiyorsanız Kanalı Ekleyin Fatura Entegratör paneline giriş yapıp Ayarlar > Entegrasyonlar > Satış Kanalları yolunu izliyoruz. Kanal Ekle butonuna tıklayıp listeden JSON Feed (Özel Entegrasyon) kanalını seçiyoruz. Bilgileri Doldurun Açılan ekranda aşağıdaki alanları dolduruyoruz: Sipariş Feed Adresi (URL) Siparişlerinizin yayınlandığı adres. Yetkilendirme Türü Feed adresiniz herkese açıksa Yok seçeneğini işaretleyin. Adresiniz korumalıysa sisteminize uygun olan seçeneği belirleyin: - Bearer Token — token bilgisi istenir - Basic Auth — kullanıcı adı ve şifre istenir - Özel Header — header adı ve değeri istenir Seçiminize göre ilgili alanlar ekranda otomatik olarak belirir. Bildirim Adresi (URL) İsteğe bağlıdır. Doldurduğunuzda, faturanız oluşturulduğunda veya silindiğinde sipariş numarası ve fatura bilgileriyle (PDF bağlantısı dahil) bu adrese bildirim gönderilir. Bağlantıyı Test Edin ve Kaydedin Bağlantıyı Test Et butonuna tıklıyoruz. "Bağlantı başarılı" mesajını gördüğümüzde Kanal Bilgilerini Kaydet butonu ile kurulumu tamamlıyoruz. ⚠️ Bağlantı testi başarısız olursa: Feed adresinizin internetten erişilebilir olduğundan, yetkilendirme bilgilerini doğru girdiğinizden ve adresin teknik dokümandaki JSON formatında yanıt verdiğinden emin olun. Siparişlerinizi ve Faturalarınızı Takip Edin - Siparişleriniz saatte bir otomatik olarak alınır ve Siparişler sayfasında listelenir. - Siparişlerinizden dilediğiniz an tek tıkla fatura oluşturabilir veya otomatik faturalandırmayı kullanabilirsiniz. - Bildirim Adresi tanımladıysanız, faturanız resmileştiğinde PDF bağlantısıyla birlikte sisteminize otomatik bildirim gönderilir. Denemek İster Misiniz? - https://feed-example.faturaentegrator.com/ adresinden tüm tip ve webhook için deneme endpointleri mevcut Kendi feed'inizi hazırlamadan önce entegrasyonun nasıl çalıştığını görmek isterseniz örnek feed adresimizi kullanabilirsiniz: - Feed Adresi: https://feed-example.faturaentegrator.com/orders - Yetkilendirme Türü: Yok Bu adres, örnek siparişler içeren bir deneme feed'idir. Kanalı bu adresle ekleyip akışı uçtan uca test edebilirsiniz. Sık Sorulan Sorular Siparişlerim gelmiyor, ne yapmalıyım? Kanal düzenleme sayfasındaki Bağlantıyı Test Et butonu ile adresinizi doğrulayın. Sorun devam ederse feed'inizin teknik dokümandaki formata uygun olduğunu yazılımcınızla birlikte kontrol edin. Feed'imde vergi numarası olmayan siparişler var, fatura kesilebilir mi? Evet. Vergi/TC kimlik numarası boş gelen siparişler, mevzuata uygun şekilde 11111111111 (nihai tüketici) olarak faturalandırılır. Hangi para birimleri destekleniyor? Feed'inizde ISO kodu ile gönderilen tüm para birimleri (TRY, USD, EUR vb.) desteklenir.