x
E R C S O F T

Sovos API Entegrasyon Desteği

Sovos API Kullanımı ve Entegrasyon Sürecinde Destek Veriyoruz

Sovos Portalı, e-Fatura, e-Arşiv Fatura, Serbest Meslek Makbuzu, e-İrsaliye, ÖKC ve EMm gibi belgelerinizi oluşturmanıza ve yönetmenize olanak tanıyan güçlü bir platformdur. Ancak, bu sistemin tam potansiyelini kullanabilmeniz için etkili bir destek hizmetine ihtiyacınız olabilir. Biz, Sovos Portalı kullanıcılarına özel sunduğumuz destek ile iş süreçlerinizi daha verimli ve sorunsuz hale getirmeyi amaçlıyoruz.

Sovos API Entegrasyonu: Nasıl Yardımcı Oluyoruz?

1. Kurulum ve Entegrasyon Desteği: Sovos API entegrasyonunu gerçekleştirirken, sisteminizin mevcut altyapısına uygun konfigürasyonları yapıyoruz. API entegrasyonunu sorunsuz bir şekilde tamamlayarak, Sovos sistemini iş süreçlerinize entegre ediyoruz.

2. API Kullanım Eğitimi ve Kılavuzları: Sovos API'sinin tüm fonksiyonlarını etkili bir şekilde kullanabilmeniz için kapsamlı eğitimler ve kullanım kılavuzları sağlıyoruz. Ekiplerinizin API'den maksimum verimi elde edebilmesi için gerekli bilgileri sunuyoruz.

3. Teknik Destek ve Sorun Çözümü: API entegrasyonu sırasında karşılaşabileceğiniz teknik sorunlara hızlı ve etkili çözümler sunuyoruz. Uzman ekibimiz, API performansınızı optimize etmek ve herhangi bir sorunu çözmek için 7/24 hizmetinizde.

4. Özelleştirme ve Geliştirme: İşletmenizin özel ihtiyaçlarına göre Sovos API'sini özelleştiriyoruz. Özel raporlar, entegrasyonlar veya ek özellikler talep ederseniz, bu taleplerinizi karşılamak için gerekli geliştirmeleri yapıyoruz.

5. Yasal Uyum ve Güncellemeler: Sovos API'sinin yasal düzenlemelere uyumlu olmasını sağlamak için sürekli güncellemeler yapıyoruz. Yasal değişiklikler hakkında bilgi vererek, API sisteminin her zaman güncel ve uyumlu kalmasını sağlıyoruz.

6. Performans İzleme ve Raporlama: API entegrasyonunun performansını sürekli izleyerek, potansiyel sorunları proaktif bir şekilde çözümleme ve performansı artırma konusunda destek sağlıyoruz. Ayrıca, düzenli raporlarla entegrasyon verimliliğinizi analiz ediyoruz.

Neden Bizi Tercih Etmelisiniz?

Biz, Sovos API entegrasyonunda sunduğumuz kapsamlı destek ile sistemin tüm avantajlarından en iyi şekilde yararlanmanızı sağlıyoruz. Profesyonel ekibimiz, size özel çözümler ve yüksek kaliteli destek hizmetleri sunarak, iş süreçlerinizi en iyi şekilde yönetmenize yardımcı olur. İster kurulum ve entegrasyon, ister teknik destek veya özelleştirme ihtiyaçlarınız olsun, sizlere en iyi hizmeti sunmak için buradayız.

İletişime Geçin

Sovos API entegrasyonu hakkında daha fazla bilgi almak ve destek hizmetlerimizden yararlanmak için iletişim sayfamıza göz atabilirsiniz. Size en iyi hizmeti sunmak ve iş süreçlerinizi optimize etmek için buradayız. Bizimle iletişime geçin, Sovos Portalı’nın tüm avantajlarını birlikte keşfedelim!

Bulut e-Fatura API

Servislere erişim için Sovos bulut operasyon ekibi tarafından kaydınız yapılmalıdır.

WS API 2.2
İndir
WS API 2.1 (Eski Versiyon)
İndir
Örnek .Net İstemci Uygulama
GitHub

WS URL - Test
https://efaturawstest.fitbulut.com/ClientEInvoiceServices/ClientEInvoiceServicesPort.svc
WS URL - CANLI
https://efaturaws.fitbulut.com/ClientEInvoiceServices/ClientEInvoiceServicesPort.svc

Test IP
195.142.103.232, 46.18.105.21
Canlı IP
195.142.103.230, 46.18.105.11
DR IP
195.142.125.114
* Sovos Bulut API'a erişebilmek için yukarıda belirtilen IP adreslerine firewall'ınızda 443(HTTPS) portundan erişim izni vermeniz gerekebilir.
**API Bilgileri Sovos Web Sayfasından Alınmıştır.
Sovos Bulut e-Fatura WS API — Uzman Rehberi

API Doğru Kullanım: Sık Sorulan Sorular

Sovos Bulut e-Fatura API nedir? FİT Bulut, Foriba ve Sovos aynı şey mi?

Evet, hepsi aynı altyapıdır ve bu isim karmaşası çok yaşanır. Şirketin resmi ünvanı F.I.T. Bilgi İşlem Sistemleri Servisleri Sanayi ve Ticaret A.Ş.'dir; markası önce Foriba, sonra Sovos oldu. API adresinin hâlâ api.fitbulut.com olması bu yüzdendir — FİT Bulut, Foriba ve Sovos Bulut e-Fatura API'si aynı sistemi ifade eder.

API erişimim neden bloklanıyor / kesiliyor?

Sovos Bulut sistemde çağrı sayısı üst limiti yoktur; ancak hatalı kullanımlar ve bunlardan kaynaklı yüksek çağrı sayıları sebebiyle erişimler, bulut sistemi korumak için otomatik olarak bloklanır. Temel kural: çağrı sayısını minimumda tutmak. Ayda 1 milyon faturası olan bir müşteri ile ayda 100 faturası olan bir müşteri bu metodları aynı disiplinle kullanmalıdır.

sendUBL metodunu nasıl doğru kullanmalıyım?

sendUBL ile fatura ve uygulama yanıtları toplu (zarflı) ya da tek tek (zarfsız) gönderilebilir. Şema-şematron kontrolünden sonra yalnızca GİB'e kayıtlı mükelleflerin etiketlerine gönderim yapılmalıdır. Yüksek hacimde, performans için fatura ve uygulama yanıtları zarflanarak toplu gönderilmelidir. Zip içindeki XML'in açılmış boyutu 5MB ile sınırlıdır; genellikle 25-30 adet fatura/UY içeren zarflar limit aşılmadan gönderilir (ağ hızına ve fatura boyutuna göre optimize edilmelidir).

getUBLList ile gelen/gönderilen belgeleri nasıl çekmeliyim?

Fatura, uygulama yanıtı ve sistem yanıtı için ayrı ayrı çağrı yapmak yerine zarf tipinde tek çağrı ile hepsini alın. Tarih aralığı belgenin buluta geliş/oluşma tarihidir; aynı aralık kesinlikle tekrar tekrar sorgulanmamalı, alınan liste lokal sisteme kaydedilmelidir. Başlangıç-bitiş arası en fazla 1 gün olabilir. Son kullanıcı ekranlarını doğrudan bu metoda bağlamayın; listeler lokal veritabanında tutulmalı, buluta yalnızca yeni dönem için çağrı yapılmalıdır.

Otomatik job (zamanlanmış görev) sıklığı ne olmalı?

Otomatik sorgulamalarda job sıklığı minimum 1 saat olmalı; böylece günde 24 çağrıdan fazla yapılmaz. Özel ihtiyaç yoksa aralık daha da açılmalıdır (2/4/6/12/24 saatte bir). 1 saatlik bir job, 01:00'de ilk çalıştığında 00:00-01:00 aralığını, 02:00'de 01:00-02:00 aralığını sorgulamalıdır — böylece hem belge atlanmaz hem de aynı aralık tekrar sorgulanmaz.

getUBL ile UBL/XML belgelerini nasıl indirmeliyim?

Zarf, fatura, uygulama yanıtı ve sistem yanıtı UBL XML verileri bu metodla 20'şerli olarak indirilir. Tek tek indirme yapılmamalıdır. Örneğin indirilecek 84 UBL varsa 20+20+20+20+4 = toplam 5 çağrıyla indirilmelidir, 84 tekil çağrı yapılmamalıdır. Son kullanıcı anlık indirmelerinde de belgeler gruplanarak 20'şerli alınmalıdır.

getEnvelopeStatus ile zarf durumunu nasıl takip etmeliyim?

Gönderilen zarfların durumu, son duruma ulaşana kadar bu metodla takip edilir. Bir zarfın son duruma ulaşması günler alabildiğinden, sorgulanan bir zarf otomatik job'larla en az 2 saat sonra tekrar sorgulanmalıdır. Zarflar 20'şerli topluca sorgulanmalı, son duruma ulaşmış (kalıcı başarı/hata) zarflar kesinlikle tekrar tekrar sorgulanmamalıdır.

getInvoiceView ile fatura görüntüsünü (PDF/HTML) nasıl almalıyım?

Gelen ya da gönderilen bir faturanın HTML/PDF görüntüsü veya XSLT'si bu metodla alınır. Fatura görüntüsü sistemden yalnızca bir kez alınmalı ve lokale kaydedilmelidir; kullanıcı sonradan tekrar görüntülediğinde buluttan değil lokalden gösterilmelidir. Mümkünse görsel, gönderilen UBL üzerinden kendi sisteminizde oluşturulmalıdır.

getUserList ve getRAWUserList — GİB mükellef listesi nasıl çekilir?

getUserList, GİB'e kayıtlı e-Fatura kullanıcıları listesini döndürür; getRAWUserList ise e-İrsaliye ve e-Fatura kayıtlı kullanıcıları verir. Tam liste günde yalnızca bir kez indirilmeli; alıcının GİB'e kayıtlı olup olmadığı kontrolü kendi lokalinizde yapılmalıdır. Tekli sorgulama zorunlu durumlar dışında kullanılmamalıdır.

getInvResponses ile uygulama yanıtı (Kabul/Red) nasıl alınır?

Bu metodla, herhangi bir gelen/gönderilen faturaya ait uygulama yanıtlarının listesi manuel olarak alınır; Kabul/Red cevabı ve ilgili notlar döner. Bu metod zamanlanmış görevlerle uygulama yanıtı takibi için kesinlikle kullanılmamalıdır; yalnızca ihtiyaç anındaki manuel kullanıcı sorgulamaları içindir.

Fatura numarası (ID) üretimini kim yapmalı?

Belge gönderiminde fatura içindeki 16 haneli "Fatura Numarası" (ID) alanının sizin tarafınızdan üretilip gönderilmesi gerekir. Bu sayede hem performans artar hem de sistem tarafında daha iyi destek sağlanır.

Portalımı/ekranımı doğrudan API'ye bağlayabilir miyim?

Hayır. Son kullanıcıya gösterilen belge listesi ve görüntüleme ekranları doğrudan API'ye bağlanmamalıdır. Örneğin bir kullanıcı 1 aylık liste sorguladığında buluta 30 ardışık çağrı yapılmamalıdır. Tüm veriler lokal veritabanında tutulmalı, sorgular buradan yapılmalı, buluta yalnızca alınmayan yeni dönem için çağrı gidilmelidir.

SOVOS / FORİBA API UZMANI

Mehmet Demirci  LinkedIn ↗

api.fitbulut.com altyapısında sendUBL'den getEnvelopeStatus'a, kontör yönetiminden Partner WS ve SAP entegrasyonlarına kadar tüm servisleri yıllarca sahada kuran ekibin başında Mehmet Demirci var. Entegrasyonunuz bloklanıyor, çağrılarınız optimize değil, faturalarınız takılıyor ya da SAP / Sovos Cloud Public WS bağlantınızda sorun mu yaşıyorsunuz? Doğrudan uzmanına danışın.

Uzmana Danışın   LinkedIn Profili