E-Fatura Entegrasyonları

E-Fatura Entegrasyonları

Devoplus Fatura Yönetim Sistemi üzerinde onaylanacak e-faturalar, GİB tarafından belirlenen özel entegratör firmalardan otomatik olarak alınmaktadır. Entegratör firmalardan yeni e-faturaları alıp Devoplus Portal'a aktararak yeni bir Fatura Onay Süreci başlatan entegrasyonlar DEXA üzerinde çalışmaktadır.

Devoplus'ın entegre olduğu özel entegratör firmaların listesi aşağıdaki gibidir:

  1. Doğan e-Dönüşüm

  2. QNB eFinans

Entegrasyon Ayarları

DEXA üzerinden Ayarlar menüsü altında Entegrasyon Ayarları bölümüne gelerek E-Fatura Entegrasyonu için kullanılacak entegratör firmaları ve bu firmalara ait web servis parametrelerini yapılandırabilirsiniz.

Entegrasyon Parametreleri

Alıcı Vergi Kimlik Numarası: Adına fatura düzenlenen firmaya ait Vergi Kimlik Numarası ya da T.C. Kimlik Numarası

Web Servis Kullanıcısı: Entegrator firma tarafından firmanıza özel sağlanan entegrasyon kullanıcısı
Web Servis Şifresi: Entegrator firma tarafından firmanıza özel sağlanan entegrasyon şifresi

Entegrasyon Başlangıç Tarihi: Fatura Yönetim Sistemi üzerinden onay akışına alınmaya başlanacak faturalara ait başlangıç tarihi

image-20250716-202403.png

Yapılandırma ayarları tamamlandıktan sonra Entegrasyonlar menüsüne gelerek entegrasyonu çalıştırabilir, entegrasyonun çalışacağı zamanı değiştirebilirsiniz. Burada her entegrator firma için iki ayrı entegrasyon listelenmektedir.

FYS: Günlük rutin olarak çalışan, en son başarılı şekilde alınan faturadan sonra gelen faturaları çekerek sisteme alan entegrasyondur.

FYS Sync All: Günlük rutin entegrasyon sırasında herhangi bir hata nedeniyle alınamayan faturaları almak için son 30 güne ait tüm faturaları kontrol eden ve eksik faturaları çekerek sisteme alan entegrasyondur.

Entegrasyon zamanlama ayarları CRON ifadeleriyle yazılmalıdır. CRON ifadelerinizi oluşturmak ve test etmek için tıklayınız.

image-20250716-202541.png

Entegrasyon Hata Kodları

Entegratör Firma

Hata Kodu

Hata Açıklaması

Olası Çözümler

Entegratör Firma

Hata Kodu

Hata Açıklaması

Olası Çözümler

-

006

Bilinmeyen / beklenmeyen hata

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

-

011

Parametre hatası

Entegrasyonu başlatmak için gerekli olan parametreler eksik ya da hatalı. Entegrasyon ayarlarını kontrol ediniz.

-

013

Entegratör firma web servis hatası

Entegratör firmaya ait web servislere erişilemiyor ya da beklenen yanıt gelmiyor. İnternet bağlantısını, web servis adreslerine erişim kısıtlamalarını, entegratör firmanın sistem durumunu, entegrasyon kullanıcı adı ve şifresini kontrol ediniz. Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10001

Sistemde Beklenmedik Bir Hata Oluştu

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10002

Oturum oluşturulamadı

Entegrasyon ayarlarını kontrol ediniz.

Doğan e-Dönüşüm

10003

Belge kontrolden geçemedi

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10004

Geçersiz oturum. Lütfen oturum açıp tekrar deneyiniz

Entegrasyon ayarlarını kontrol ediniz.

Doğan e-Dönüşüm

10005

Hesabınızın {ÜRÜN ADI} ürün aktif degildir. Lütfen firma yetkiliniz ile görüşünüz.

Entegrasyon ayarlarında belirttiğiniz kullanıcıya ait yetkileri ve entegratör firma üzerindeki lisanslarınızı kontrol ediniz.

Doğan e-Dönüşüm

10006

Yetkiniz bulunmamaktadır

Entegrasyon ayarlarını kontrol ediniz.

Doğan e-Dönüşüm

10007

İstek ZİP bir dosya içermelidir

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10008

Belirtilen kriterlere uygun kayıt bulunamamıştır {KRITER}

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10009

Gönderilen belge daha önce gönderilmiş bir belge ile eşleşmektedir. Belge Tipi: Belge No: ve ETTN:

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10010

Bir istek boyutu maksimum 5MB veya 100 adet belge içerebilir

E-fatura şablonunuzun boyutunu kontrol ediniz.

Doğan e-Dönüşüm

10011

Tekrarlanan işlem: kayıt sistemde mevcuttur

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10012

Kullanıcı aktif degil {kullanıcı adı}

Entegrasyon ayarlarını kontrol ediniz.

Doğan e-Dönüşüm

10013

Gönderilen istek geçersizdir. Hata sebebi {HATA SEBEBİ}

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10014

Geçersiz İmza Hata Sebebi: {HATA SEBEBİ}

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10015

Servis desteklenmemektedir. Servis adı

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10016

Müşteri sistemde aktif degildir.

Entegrasyon ayarlarında belirttiğiniz kullanıcıya ait yetkileri ve entegratör firma üzerindeki lisanslarınızı kontrol ediniz.

Doğan e-Dönüşüm

10017

Gönderilen belge daha önce gönderilmiş bir belge ile eşleşmektedir. ID: ve UUID:

Sistem Günlüğünü görüntüleyerek ayrıntılı hata mesajını kontrol ediniz.

Doğan e-Dönüşüm

10018

Yetkisiz erişim tespit edildi! {HATA SEBEBİ}

Entegrasyon ayarlarında belirttiğiniz kullanıcıya ait yetkileri ve entegratör firma üzerindeki lisanslarınızı kontrol ediniz.