Fatura Profili Geçersiz Hatası Nasıl Çözülür? Rehber
Profil, alıcı, fatura tipi ve XML ayarlarını sırayla kontrol ederek geçersiz fatura profili hatasını güvenle teşhis edin.
Fatura profili geçersiz hatası, gönderilen belgedeki profil bilgisinin seçilen kanal, alıcı veya belge türüyle doğrulanamaması demektir. Hata genellikle e-Fatura XML içindeki ProfileID alanı ile portal ayarlarının uyuşmamasından kaynaklanır.
Fatura profili geçersiz hatası, gönderilen belgedeki profil bilgisinin seçilen kanal, alıcı veya belge türüyle doğrulanamaması demektir. Hata genellikle e-Fatura XML içindeki ProfileID alanı ile portal ayarlarının uyuşmamasından kaynaklanır.
Bu rehber, e-Fatura portalı veya özel entegratör kullanan işletmeler için hazırlanmıştır. Profil, senaryo, alıcı kaydı, fatura tipi ve entegrasyon ayarlarını hangi sırayla kontrol edeceğinizi açıklar.
Fatura profili geçersiz hatası nedir?
Fatura profili geçersiz hatası, e-belgenin profil değerinin GİB doğrulama kurallarıyla eşleşmediğini gösterir. Sistem, belgeyi kabul etmeden önce profil bilgisini kanal, alıcı ve belge yapısıyla birlikte kontrol eder.
Fatura profili, belgenin hangi e-belge akışı içinde işleneceğini belirleyen teknik bilgidir. Portal ekranında bu alan profil, senaryo veya fatura senaryosu adıyla gösterilebilir.
Entegrasyonlarda profil bilgisi çoğunlukla ProfileID alanına yazılır. Yaygın e-Fatura seçimleri arasında TEMELFATURA ve TICARIFATURA bulunur; kullanılabilir seçenekler belge kanalına göre değişebilir.
e-Arşiv fatura ile e-Fatura aynı profil mantığıyla gönderilmez. e-Arşiv belgesinin e-Fatura gönderim servisine, e-Fatura belgesinin de yanlış kanala yönlendirilmesi bu hatayı tetikleyebilir.
Sistem mesajı bazen yalnızca profil bilgisini işaret eder. Ancak asıl neden, alıcının kayıt durumu, VKN veya TCKN bilgisi, fatura tipi ya da eski entegrasyon eşlemesi olabilir.
Yanlış: Hata mesajını yalnızca görsel bir portal problemi kabul etmek. Doğru: Önce profil alanını, ardından alıcı ve belge türü uyumunu birlikte incelemek.
Bu hata, faturanın tutarının yanlış olduğunu doğrudan göstermez. KDV hesabı, birim kodu veya logo gibi başka alanlar farklı doğrulama mesajları oluşturabilir.
Fatura profili, e-belgenin hangi teknik iş akışında işleneceğini belirleyen seçim demektir. Bu seçim, tutar hesaplamasından farklıdır ve belgenin doğru servise yönlendirilmesini sağlar.
Profil seçimi, tek başına kullanıcı tercihi değildir; alıcının e-Fatura sistemindeki durumu, gönderim servisi ve belge senaryosu birlikte değerlendirilir. Bu üç unsurdan biri farklıysa doğrulama, profil alanını hatalı gösterebilir.
Örneğin ticari fatura seçeneği görünmüyorsa bunu XML'e elle eklemek yerine portalın sunduğu kanal ve yetki seçeneklerini inceleyin. Menüdeki ad ile teknik kod farklı olabilir; esas kontrol XML değeridir.
Fatura profili geçersiz hatası neden olur?
Fatura profili geçersiz hatasının en yaygın nedeni, seçilen profilin kullanılan e-belge kanalına uygun olmamasıdır. Profil alanı boş, yanlış yazılmış veya desteklenmeyen bir değer içeriyor olabilir.
Bir diğer neden, e-Fatura mükellefi olmayan alıcı için e-Fatura profilinin seçilmesidir. Alıcının güncel kayıt durumu, belge oluşturulmadan önce GİB sorgusu veya entegratör ekranından kontrol edilmelidir.
VKN ya da TCKN bilgisindeki tek bir rakam hatası da alıcı eşleşmesini bozabilir. Sistem, doğru profil seçilmiş olsa bile yanlış kimlik numarasına sahip belgeyi reddedebilir.
Profil ile fatura tipi birbirinden farklı alanlardır. Satış, iade, tevkifat veya istisna gibi fatura tipleri profil seçimiyle karıştırılırsa belge doğrulaması başarısız olabilir.
Entegrasyon yazılımındaki varsayılan değerler de sık karşılaşılan bir nedendir. Özellikle farklı şube, şirket veya belge türlerinde aynı profilin otomatik atanması hatalı XML üretir.
Test ortamında hazırlanan bir belgenin canlı servise gönderilmesi, geçersiz profil mesajına benzer sonuç verebilir. Kullanılan kullanıcı hesabı, servis adresi ve ortam bilgisi birlikte incelenmelidir.
GİB teknik kurallarında veya entegratör ekranında yapılan güncellemelerden sonra eski şablonlar çalışmayabilir. Emin olmadığınız seçeneklerde güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.
Hata tek bir müşteri kartında çıkıyorsa profil kodundan önce o kartın kopyalanmış alanlarını inceleyin. Tüm müşterilerde çıkıyorsa şirket, şube veya kullanıcı bazlı varsayılan ayarın ortak biçimde yanlış tanımlanması daha olasıdır.
Belgeyi kopyalayarak oluşturmak da eski alıcının senaryo bilgisini taşıyabilir. Kopya taslakta alıcıyı değiştirdiğinizde kanal ve profil alanlarını otomatik kabul etmeyin; kaydetmeden önce yeni alıcı için baştan doğrulayın.
Fatura profili ile senaryo arasındaki fark nedir?
Fatura profili ile senaryo, uygulamalarda çoğu zaman birbirinin yerine kullanılan, ancak teknik olarak aynı anlamı taşımayabilen iki kavramdır. Profil, belgenin iş akışını; senaryo ise portalın sunduğu işlem seçimini ifade edebilir.
e-Fatura XML içinde profil bilgisi ProfileID alanında yer alır. Kullanıcı arayüzünde ise bu alan Temel Fatura veya Ticari Fatura gibi seçeneklerle gösterilebilir.
Ticari Fatura seçimi, taraflar arasındaki kabul veya ret sürecini etkileyen bir iş akışına bağlanabilir. Temel Fatura seçiminde ise farklı bir uygulama akışı bulunabilir.
Fatura tipi, profil ile aynı alan değildir. SATIS, IADE, TEVKIFAT veya ISTISNA gibi belge türü bilgileri, seçilen profilin yanında ayrıca doğrulanır.
e-Arşiv seçeneği de bazı ekranlarda senaryo olarak görünür. Bu seçeneğin e-Fatura profilinden ayrı değerlendirilmesi ve doğru gönderim kanalıyla kullanılması gerekir.
Yanlış: İade faturası düzenlendiğinde profili otomatik olarak değiştirmek. Doğru: İade bilgisini fatura tipi alanında, profil seçimini ise işlem kanalına uygun şekilde yapmak.
Portal, ERP ve API ekranları aynı alanı farklı adlandırabilir. Bu nedenle kullanıcı arayüzündeki etiketi değil, oluşturulan XML içindeki profil değerini ve gönderim servisini karşılaştırın.
Profil, belgenin teknik iş akışını belirleyen değer demektir. Senaryo, bu akışta kabul, ret veya işlem adımlarının nasıl yürütüleceğini belirleyen uygulama seçimi demektir.
Pratikte profil, senaryo ve fatura tipi üç ayrı kontrol noktası olarak düşünülmelidir. Ekran bunları tek başlık altında gösterse bile XML'de farklı alanlara yazılabilir ve her alanın doğrulama kuralı değişebilir.
Kararsız kaldığınızda önce gönderim kanalını sabitleyin, sonra profil seçimini yapın ve en son satış ya da iade tipini işaretleyin. Bu sıra, bir seçimin diğer alanı otomatik ezmesini azaltır.
e-Fatura kanalındaki profil ve senaryo ayrımını, e-Fatura ürün sayfasındaki süreç açıklamalarıyla karşılaştırabilirsiniz. Ancak kesin seçim için kendi portalınızdaki seçenekleri ve güncel GİB kurallarını esas alın.
Fatura profili geçersiz hatası nasıl teşhis edilir?
Fatura profili geçersiz hatasını teşhis etmek için önce hata metnini ve belgenin hangi kanaldan gönderildiğini belirleyin. Rastgele profil değiştirerek yeniden göndermek, gerçek nedeni gizleyebilir.
Hata ekranının görüntüsünü, belge numarasını, gönderim tarihini ve varsa UUID bilgisini saklayın. Destek talebinde bu bilgiler, aynı hatanın yeniden üretilmesini kolaylaştırır.
- Belgenin e-Fatura, e-Arşiv veya başka bir e-belge kanalından gönderildiğini doğrulayın.
- Alıcının VKN veya TCKN bilgisini resmi kayıttan ve müşteri kartından karşılaştırın.
- Portalda seçilen profil ya da senaryo bilgisini not edin.
- Fatura tipi, istisna ve tevkifat alanlarının işlemle uyumlu olup olmadığını kontrol edin.
- Belge önizlemesi ile oluşturulan XML içindeki ProfileID değerini karşılaştırın.
- Aynı ayarlarla yeni bir taslak oluşturup doğrulama sonucunu gözlemleyin.
Hata yalnızca tek bir belgede görülüyorsa müşteri kartı veya taslak alanı öncelikli şüphelidir. Aynı hata bütün müşterilerde oluşuyorsa entegrasyon varsayılanları veya servis bağlantısı incelenmelidir.
Belge gönderilmiş görünüyorsa aynı numarayı tekrar kullanmadan önce gönderim durumunu kontrol edin. Kabul edilmiş bir belgenin yeniden gönderilmesi farklı bir mükerrerlik sorununa yol açabilir.
İlk teşhiste amaç hemen fatura kesmek değil, hatanın profil mi, alıcı mı, belge tipi mi olduğunu ayırmaktır. Bu ayrım, sonraki düzeltme adımını belirler.
Teşhis sırasında bir belgeyi değiştirmeden önce hata kodunu ve XML sürümünü kaydedin. Aynı taslağın ekran görüntüsü, XML'i ve servis yanıtı birlikte tutulursa portal ile entegrasyon arasındaki fark kolayca görülebilir.
Yeni test taslağını küçük ve basit bir işlemle oluşturun. Ancak test belgesi gerçek gönderim oluşturabileceğinden, canlı ortamda gönderim yetkisini ve belge numarası kuralını mali müşavirinizle veya yazılım sorumlusuyla doğrulayın.
Alıcının e-Fatura kaydı fatura profili hatasını nasıl etkiler?
Alıcının e-Fatura mükellefiyet durumu, fatura profili seçiminde temel kontroldür. Kayıtlı kullanıcıya ve kayıtlı olmayan kullanıcıya uygulanacak belge akışı aynı olmayabilir.
Alıcı kartındaki VKN veya TCKN, GİB kayıt sorgusunda görünen kimlik bilgisiyle aynı olmalıdır. Şube kodu, müşteri kodu veya ticari unvan farklı olabilir; kimlik numarası farklı olmamalıdır.
Kayıt durumu zaman içinde değişebilir. Daha önce e-Fatura kabul eden bir müşteri için yeni işlemden önce güncel kayıt sorgusu yapılması bu nedenle önemlidir.
- Alıcının VKN veya TCKN bilgisini müşteri kartı ve resmi kayıtla karşılaştırın.
- Alıcının güncel e-Fatura kayıt durumunu GİB sorgusu veya entegratör ekranından kontrol edin.
- Gerçek kişi ve tüzel kişi bilgilerinin belge ekranında doğru seçildiğini doğrulayın.
- Alıcının kayıtlı olduğu belge kanalına uygun profil ve senaryoyu kullanın.
- Kayıt dışı alıcıya geçişte e-Arşiv seçeneğinin mevzuat ve işlem koşullarına uygunluğunu inceleyin.
Alıcı e-Fatura sisteminde kayıtlı değilse e-Fatura profiliyle gönderim yapmak doğru olmayabilir. Böyle bir durumda e-Arşiv düzenlenip düzenlenemeyeceğini güncel kurallara göre değerlendirin.
Kayıt sorgusu doğru olduğu halde hata sürüyorsa alıcı bilgilerinin entegrasyon yazılımına eski haliyle aktarılması mümkündür. Müşteri kartını yenileyin, önbelleğe alınmış bilgileri temizleyin ve taslağı yeniden oluşturun.
GİB sorgusunda kayıt görüldüğü halde portal farklı sonuç veriyorsa sorgu zamanını not edin ve müşteri kartını yenileyin. Geçici önbellek, eski unvanı değil fakat özellikle kimlik ve kanal bilgisini yanlış taşıyabilir.
Alıcı hem şube hem merkez bilgisi veriyorsa belgeye yazılacak VKN veya TCKN'nin mükellef kaydıyla eşleştiğini teyit edin. Ticari unvanın benzemesi, farklı vergi kimlik numarasını kullanmayı haklı çıkarmaz.
Fatura profili portalda nasıl düzeltilir?
Fatura profili portalda, taslak belgenin profil veya senaryo alanı açılarak düzeltilir. Ekran adları hizmet sağlayıcıya göre değişse de kontrol sırası genellikle aynıdır.
Önce hatalı taslağın belge türünü ve alıcı kaydını inceleyin. Sadece profil alanını değiştirmek, yanlış alıcı veya yanlış kanal sorununu çözmeyebilir.
Portalda kayıtlı müşteri bilgisi ile GİB sorgusunu karşılaştırdıktan sonra uygun belge kanalını seçin. Profil seçenekleri, seçilen kanal değişince farklı görünebilir.
- Giden belgeler veya taslaklar ekranından hatalı faturayı açın.
- Alıcı bilgilerini ve VKN veya TCKN alanını yeniden doğrulayın.
- Belgenin e-Fatura ya da e-Arşiv olarak düzenlenmesi gerekip gerekmediğini belirleyin.
- Profil veya senaryo alanında yalnızca ilgili kanalın sunduğu seçeneği işaretleyin.
- Fatura tipi, vergi bilgileri ve özel alanları tekrar kontrol ederek belgeyi kaydedin.
- Portalın doğrulama önizlemesini çalıştırıp belgeyi yeniden gönderin.
Hatalı taslak profil alanını kilitliyorsa belgeyi zorla değiştirmeyin. Yeni taslak oluşturmak, eski değerlerin XML içine tekrar taşınmasını önleyebilir.
Yanlış: XML dosyasını rastgele bir metin düzenleyiciyle değiştirmek. Doğru: Portalın veya entegrasyon yazılımının desteklediği alanlardan profil seçimini yenilemek.
Profil değişikliğinden sonra belge numarası, tarih ve alıcı bilgilerini yeniden kontrol edin. Düzeltme sırasında başka alanların istemeden değişmediğinden emin olun.
Portalda profil alanı hiç görünmüyorsa önce belge türünü değiştirip tekrar kontrol etmeyin; taslağın kanalını ve alıcı kaydını doğrulayın. Bazı ekranlar, geçersiz kanal seçildiğinde ilgili profil seçeneklerini otomatik gizler.
Gönderimden önce önizleme ile XML doğrulaması aynı sonucu vermelidir. Önizleme doğru, XML hatalıysa dönüşüm şablonu; ikisi de hatalıysa taslak veya müşteri kartı öncelikli incelenmelidir.
Entegrasyonda fatura profili ayarları nasıl kontrol edilir?
Entegrasyonda fatura profili ayarları, müşteri kartı, belge türü ve gönderim servisiyle birlikte kontrol edilir. Tek bir sabit varsayılan değer, farklı işlemlerde geçersiz belge üretebilir.
ERP veya ön muhasebe yazılımında ProfileID, senaryo ve fatura tipi alanlarının hangi kaynaklardan beslendiğini bulun. Alanlar sabit, müşteri bazlı veya belge türüne bağlı olabilir.
Birden fazla şirket veya şube kullanılıyorsa her şirketin profil eşlemesini ayrı inceleyin. Bir şirket için doğru olan değer, başka bir şirketin gönderim kanalında geçerli olmayabilir.
API kullanan sistemlerde profil değeri, izin verilen seçenekler listesine göre gönderilmelidir. Büyük-küçük harf, boşluk, Türkçe karakter veya yanlış kod kullanımı doğrulamayı bozabilir.
Canlı ve test ortamlarının servis adresleri ile kullanıcı bilgilerini karşılaştırın. Testte kabul edilen bir profil değeri, canlı ortamda aynı şekilde çalışmayabilir.
Profil alanı doğru görünüyorsa oluşan XML dosyasını inceleyin. Ekrandaki seçim doğru olsa bile dönüştürme şablonu eski değeri ProfileID alanına yazıyor olabilir.
Yazılım güncellemesi, yeni bir profil seçeneği veya mevzuat değişikliği sonrasında eşlemeleri yeniden test edin. Güncel GİB teknik dokümanını ve mali müşavirinizi kontrol etmeden sabit değer tanımlamayın.
Alan eşlemesini kontrol etmek için aynı veriyi portalda manuel taslakla ve ERP'den üretilen taslakla karşılaştırın. Manuel belge geçiyor, entegrasyon belgesi kalıyorsa sorun çoğunlukla mapping, sabit kod veya dönüşüm şablonundadır.
Değişikliği canlıya almadan önce ayrı bir şirket, şube veya yetkili kullanıcıyla deneme yapın. Test sonucu olumlu olsa bile gerçek gönderim öncesinde servis yanıtını ve XML değerini kaydetmek gerekir.
Fatura tipi ve istisna alanı fatura profili hatasını nasıl etkiler?
Fatura tipi ve istisna alanı, fatura profili geçersiz hatasını doğrudan veya dolaylı olarak etkileyebilir. Profil doğru olsa bile belge türü, vergi bilgisi ve özel alanlar birbiriyle uyuşmayabilir.
Satış faturasında satış, iade işleminde iade, tevkifatlı işlemde tevkifat ve istisnalı işlemde ilgili istisna bilgisi kullanılmalıdır. Bu alanlar profil alanının yerine geçmez.
Bir belgeyi iade olarak düzenlemek, her durumda farklı bir profil seçileceği anlamına gelmez. İşleme uygun profil korunurken fatura tipi ve açıklama alanları doğru doldurulmalıdır.
İstisna kodu yalnızca gerçekten istisna kapsamındaki işlem için kullanılmalıdır. Profil hatasını düzeltmek amacıyla rastgele istisna kodu eklemek, yeni vergi doğrulama hataları oluşturabilir.
İstisna alanında sorun yaşıyorsanız istisna kodu hatasının adım adım çözümünü ayrıca inceleyin. Profil ve istisna kontrollerini ayrı yürütün.
Özel matrah, tevkifat veya ihracat gibi işlemlerde ekranın sunduğu alanlar değişebilir. Bu işlemlerde profil seçimini fatura tipinden bağımsız kontrol etmek gerekir.
Mevzuat kapsamı işlem türüne ve mükellefin durumuna göre değişebilir. Güncel GİB duyurusunu ve mali müşavirinizi kontrol etmeden vergi veya istisna alanını tahminle doldurmayın.
Bu nedenle doğrulama sırası profil, belge türü, vergi alanları ve toplamlar şeklinde kurulabilir. Bir alanı düzeltirken sistemin otomatik hesapladığı toplamları yeniden üretin; eski taslak değerlerini elle taşımayın.
Örneğin iade satırlarında referans fatura bilgisi istenebilir, fakat bu gereklilik profil kodunun yerine geçmez. İşlemde istisna yoksa istisna kodu eklemek, mevcut profil hatasını çözmek yerine yeni bir uyumsuzluk yaratır.
Fatura profili geçersiz hatası sürerse hangi teknik kontroller yapılır?
Fatura profili geçersiz hatası sürerse teknik kontrolde hata kodu, XML alanı, servis ortamı ve gönderim yanıtı birlikte incelenmelidir. Yalnızca tarayıcıyı yenilemek çoğu zaman yeterli olmaz.
Önce aynı hatanın bütün belgelerde mi, yoksa belirli alıcılarda mı oluştuğunu belirleyin. Kapsam, problemin müşteri kartında mı yoksa genel eşlemede mi olduğunu gösterir.
Portalda doğrulama başarılı, gönderimde hata varsa servis yanıtındaki ayrıntıyı alın. Doğrulama başarılı olsa bile canlı servis, alıcı kaydı veya kanal uyumunu ayrıca denetleyebilir.
Uzman notu: Aynı faturayı art arda göndermeden önce gönderim durumunu ve belge numarasını kontrol edin; başarılı işlem gecikmeli görünüyorsa mükerrer belge oluşturabilirsiniz.
GİB tarafında geçici yoğunluk veya servis kesintisi şüphesi varsa GİB sistem yoğunluğu hatası için kontrol adımlarını uygulayın.
Tarayıcı oturumunu kapatmak, farklı bir tarayıcı denemek veya önbelleği temizlemek yalnızca ekran kaynaklı sorunlarda işe yarar. XML aynı hatalı değeri içeriyorsa işlem tekrarlanır.
Destek birimine hata metni, zaman bilgisi, belge UUID'si, alıcı kimliği ve XML doğrulama sonucunu iletin. Özel ticari bilgileri paylaşmadan, gerekli teknik kayıtları hazırlayın.
XML incelemesinde yalnızca ProfileID satırına bakmayın; belge türü, alıcı kimliği, gönderim servisi ve ortam bilgisini de aynı kayıt üzerinde karşılaştırın. Alanların birbirini tamamlaması, tek bir doğru kod bulunmasından daha önemlidir.
Portal doğrulaması ile servis kabulü arasındaki farkı anlamak için e-belge sık sorulan sorular bölümündeki durum açıklamalarını kontrol edin. Teknik kayıt yeterli değilse iletişim kanalına hata zamanı ve UUID ile başvurun.
Servis yanıtı belirli bir ProfileID veya kod veriyorsa, destek ekibine yalnızca ekran görüntüsü değil, anonimleştirilmiş XML satırını da iletin. Böylece sorun yanlış kanal mı, dönüşüm mü, yetki mi daha hızlı ayrılır.
Küçük işletmede fatura profili geçersiz hatası nasıl çözülür?
Bir küçük işletmede fatura profili geçersiz hatası, günlük satış akışını durdurmadan kontrollü bir müşteri ve kanal sorgusuyla çözülmelidir. Örneğin bir eczane sahibi her alıcı için aynı profili kullanamaz.
Eczane sahibi Ayşe, kayıtlı bir işletmeye satış faturası hazırlarken müşteri VKN bilgisini sorgular. Alıcı e-Fatura kullanıcısıysa uygun e-Fatura profili ve işlem senaryosu seçilir.
Ayşe, bireysel ve kayıtlı olmayan başka bir müşteri için aynı taslağı kopyalarsa profil bilgisi eski müşteriden taşınabilir. Bu durumda yeni müşteri kartı ve belge kanalı yeniden kontrol edilir.
Bir müşteride düzenli satış, diğerinde iade işlemi olabilir. Profil seçimi kanal ve iş akışına göre yapılırken satış veya iade bilgisi ayrıca fatura tipi alanında gösterilir.
ERP programı her belgeye otomatik olarak EARSIVFATURA yazıyorsa e-Fatura alıcısına gönderimde hata oluşabilir. Varsayılan eşleme, müşteri kayıt durumu ve belge türü birlikte düzeltilmelidir.
Profil düzeltildiği halde hata devam ederse Ayşe, alıcının kimlik numarasını ve gönderim ortamını kontrol eder. Aynı taslağı tekrar göndermek yerine yeni bir test taslağı oluşturur.
Bu örnekte çözüm, her müşteriye farklı ve rastgele profil vermek değildir. Doğru yöntem, alıcı kaydını, belge kanalını, profil değerini ve fatura tipini sırayla eşleştirmektir.
Ayşe'nin günlük akışında çözüm sırası şöyledir: önce müşteriyi sorgular, sonra yeni taslak açar, belge kanalını seçer, profili kontrol eder ve en son fatura tipini belirler. Bu sırada eski taslağı kopyalamaz.
Hata yalnızca kayıtlı işletme müşterilerinde çıkıyorsa eczanenin ERP müşteri kartı ile portal alıcı sorgusu karşılaştırılır. Bireysel satışlarda ise e-Arşiv koşulları ayrıca incelenir; iki işlem aynı profil varsayımıyla yürütülmez.
Fatura profili geçersiz hatası hangi hatalarla karıştırılır?
Fatura profili geçersiz hatası, KDV, birim, logo veya istisna hatalarıyla karıştırılabilir. Hata mesajındaki alan adı, hangi kontrolün önce yapılacağını belirler.
Aşağıdaki tablo, benzer görünen sorunları ayırır. Profil sorunu genellikle belge rotası veya ProfileID ile ilgilidir; diğerleri farklı XML alanlarını ve doğrulama kurallarını işaret eder.
| Hata veya belirti | Muhtemel alan | İlk kontrol |
|---|---|---|
| Fatura profili geçersiz | ProfileID, kanal veya senaryo | Profil ile alıcı kaydını karşılaştırın. |
| KDV tutarı uyumsuz | Vergi matrahı ve toplamlar | KDV tutarı uyumsuz hatası adımlarını uygulayın. |
| Birim kodu geçersiz | Mal veya hizmet birim kodu | Birim kodu geçersiz kontrolünü yapın. |
| Logo görünmüyor | Görsel dosyası veya şablon | Logo görünmüyor sorununa özel ayarları inceleyin. |
| İstisna kodu hatası | Vergi istisnası alanı | İstisna kodunu yalnızca uygun işlemde kullanın. |
KDV hatasında profil değiştirmeniz çözüm sağlamaz; vergi matrahı ve toplamlar yeniden hesaplanmalıdır. Aynı şekilde birim kodu hatasında doğru ölçü birimi seçilmelidir.
Yanlış: Her gönderim reddinde profil değiştirmek. Doğru: Hata mesajında belirtilen XML alanını bulup yalnızca ilgili değeri düzeltmek.
Logo görünmüyorsa belge teknik olarak geçerli olabilir; sorun görsel şablonda bulunabilir. Bu ayrım, geçerli bir belgeyi gereksiz yere yeniden düzenlemenizi önler.
Hata metninde ProfileID açıkça yazıyorsa profil kontrolü ilk sıradadır. Mesaj yalnızca vergi toplamını, birimi veya şablonu belirtiyorsa profil değiştirmeden ilgili alana gidin; her ret aynı kökten kaynaklanmaz.
Bir belge kanal olarak doğru, fakat görsel olarak eksik olabilir. Gönderim durumunda kabul bilgisi varsa sırf logo görünmediği için yeni fatura kesmeyin; şablon düzeltmesini ayrı bir işlem olarak ele alın.
Fatura profili geçersiz hatası tekrar etmemesi için ne yapılır?
Fatura profili geçersiz hatasının tekrarlamaması için profil eşlemelerini belge kanalı, alıcı kaydı ve fatura tipiyle birlikte standartlaştırın. Her yeni müşteri veya şube için kısa bir test yapın.
Müşteri kartında VKN veya TCKN, mükellefiyet durumu ve belge kanalı güncel tutulmalıdır. Kayıt sorgusu yapılmadan kopyalanan eski taslaklar profil bilgisini yanlış taşıyabilir.
Entegrasyonda profil alanını sabit bir varsayılan yerine işlem türüne bağlı kurallar üzerinden yönetin. Kullanıcıların serbest metinle profil kodu girmesini mümkünse sınırlandırın.
- Belge oluşturmadan önce alıcının güncel e-Fatura kayıt durumunu kontrol edin.
- Profil veya senaryo seçimini kullanılan e-belge kanalına göre yapın.
- Fatura tipi ile profil alanını ayrı ayrı doğrulayın.
- Gönderim öncesi önizleme ve XML doğrulamasını kullanın.
- GİB teknik güncellemelerini ve entegrasyon eşlemelerini düzenli olarak inceleyin.
Hata kayıtlarını tarih, müşteri, belge tipi ve servis yanıtıyla arşivlemek tekrar eden nedenleri görmenizi sağlar. Aynı hata birkaç kullanıcıda görülüyorsa ortak ayarları önce inceleyin.
Yeni kuralı uygulamadan önce birkaç farklı alıcı ve belge türüyle kontrol senaryosu hazırlayın. En az kayıtlı işletme, kayıtlı olmayan alıcı, satış ve iade örnekleriyle profil eşlemesinin beklenen sonucu verdiğini gözlemleyin.
Yetkili kullanıcı değiştiğinde veya yazılım güncellendiğinde bu kontrolü tekrarlayın. Ayarın çalışması, her zaman mevzuata uygun olduğu anlamına gelmez; güncel GİB duyurusunu ve mali müşavirinizi ayrıca kontrol edin.
İç kontrol kaydında kullanılan profil kodunu, sorgu tarihini ve test sonucunu saklayın. Böylece aynı hata yeniden oluştuğunda her kullanıcı farklı deneme yapmak yerine ortak ayarı karşılaştırabilir ve düzeltme kaydını izleyebilir.
Özet: 5 maddede fatura profili geçersiz hatası çözümü
Fatura profili geçersiz hatasını çözmenin temel yolu, kanal, alıcı, profil, belge tipi ve XML değerlerini aynı sırayla eşleştirmektir.
- Önce belgenin e-Fatura veya e-Arşiv kanalına ait olduğunu ve doğru servise gönderildiğini doğrulayın.
- Alıcının VKN veya TCKN bilgisini güncel GİB kayıt durumu ve müşteri kartıyla karşılaştırın.
- Profil veya senaryo seçimini fatura tipinden ayrı değerlendirin ve ProfileID değerini XML içinde kontrol edin.
- Portal, ERP ve API kullanıyorsanız canlı-test ortamı ile profil eşlemelerinin aynı olmadığını ayrıca inceleyin.
- Hata sürerse belge durumunu, UUID bilgisini ve servis yanıtını saklayarak entegratör desteğine veya ilgili iletişim kanalına başvurun.
efaturakontor.com'da tüm e-belgelerde geçerli havuz kontör paketleri 100'den 500.000 kontöre kadar, ücretsiz e-Fatura portalı ve Sovos altyapısına aynı gün tanımlama seçenekleriyle sunulur. Paketlerin kullanım süresi 12-18 aydır; güncel koşulları inceleyebilirsiniz.
Sık Sorulan Sorular
Fatura profili geçersiz hatası ne anlama gelir?
Fatura profili geçersiz hatası, belgedeki ProfileID veya profil seçiminin kullanılan e-belge kanalı, alıcı kaydı ya da belge türüyle uyuşmadığını gösterir. Önce belgenin e-Fatura mı e-Arşiv mi olduğunu belirleyin. Ardından alıcının VKN veya TCKN bilgisini, GİB kayıt durumunu, profil seçimini ve fatura tipini birlikte kontrol edin. Profil değerini rastgele değiştirmek yerine XML doğrulamasını inceleyin.
Fatura profili geçersiz hatası neden oluşur?
Bu hata; profil alanının boş veya hatalı olması, e-Fatura alıcısı için yanlış kanal kullanılması, VKN veya TCKN bilgisinin yanlış girilmesi, fatura tipiyle profilin uyuşmaması ya da entegrasyondaki eski varsayılan değerler nedeniyle oluşabilir. Test ve canlı ortamların karıştırılması da benzer bir sonuç doğurabilir. Güncel GİB teknik kurallarını ve mali müşavirinizi kontrol edin.
Fatura profili geçersiz hatası portalda nasıl düzeltilir?
Hatalı taslağı açın, önce alıcının kimlik bilgisini ve e-Fatura kayıt durumunu doğrulayın. Belgenin e-Fatura veya e-Arşiv kanalına uygunluğunu belirleyin. Ardından portalda profil ya da senaryo alanından yalnızca ilgili kanalın sunduğu seçeneği seçin. Fatura tipi ve vergi alanlarını yeniden kontrol edip taslağı kaydedin. Profil kilitliyse yeni taslak oluşturup gönderim öncesi doğrulama yapın.
E-Fatura profili ile fatura tipi aynı şey midir?
Hayır. E-Fatura profili, belgenin iş akışını ve gönderim profilini belirler. Fatura tipi ise satış, iade, tevkifat veya istisna gibi işlemin niteliğini gösterir. Bir iade faturasında profil otomatik olarak değiştirilmemelidir; uygun profil korunurken fatura tipi iade olarak seçilmelidir. Portal etiketleri değişebildiği için XML içindeki ProfileID ve belge türü alanlarını birlikte kontrol edin.
Alıcının e-Fatura kaydı profil hatasına neden olabilir mi?
Evet. Alıcının VKN veya TCKN bilgisi yanlışsa ya da alıcı güncel e-Fatura kayıtlarında bulunmuyorsa seçilen profil geçersiz olabilir. Müşteri kartındaki kimlik bilgisini GİB sorgusu veya entegratör ekranıyla karşılaştırın. Kayıtlı olmayan alıcı için e-Arşiv seçeneğinin uygun olup olmadığını mevzuata göre değerlendirin. Kayıt doğru olduğu halde hata sürerse entegrasyonun eski müşteri bilgisini kullanıp kullanmadığını inceleyin.
Profil düzeltildiği halde fatura gönderilmiyorsa ne yapılır?
Önce aynı belgenin daha önce kabul edilip edilmediğini ve gönderim durumunu kontrol edin. Sonra hata kapsamını belirleyin: sorun tek müşterideyse müşteri kartını, tüm belgelerdeyse entegrasyon eşlemesini inceleyin. Oluşturulan XML içindeki ProfileID, fatura tipi ve alıcı bilgilerini portal seçimiyle karşılaştırın. GİB servis yoğunluğu ihtimali varsa güncel durum duyurularını kontrol edin ve destek kaydı için hata kodunu saklayın.
Tüm e-belgelerde geçerli havuz kontör, ücretsiz portal, aynı gün tanımlama. Sovos altyapısı.