Ana içeriğe atla

Entegrasyon · 2026-08-07

Markdown dışa aktar

Faturaları e-posta ile entegre etme

Doğrulanmış bir gönderici yapılandırın, genel posta kutusuna tam olarak bir biçim etiketiyle gönderin ve kanıt destekli yanıtları aynı ileti dizisinde alın.

Her Enterprise hesabı için e-posta içe aktarma

Bu kanalı kontrollü ve düşük hacimli fatura iş akışları için kullanın.

E-posta içe aktarma her etkin Enterprise aboneliğine dahildir. İlk faturadan önce profilde etkinleştirin ve en az bir göndericiyi doğrulayın.

Genel posta kutusu einvoice@api.invoice-converter.com adresine gönderin ve konu satırında tam olarak bir desteklenen etiket kullanın. Etiket yoksa veya birden fazlaysa hiçbir şey işlenmez ve gönderene geçerli etiketler e-postayla bildirilir.

Kullanılabilirlik

Hesap izin listesi veya ekip onayı gerekmez. Enterprise erişimi, profil ayarı ve gönderici doğrulaması kanalı korumaya devam eder.

İlk faturadan önce göndericiyi hazırlama

Bir posta kutusu veya ERP kuralını otomatikleştirmeden önce bu adımları hesap profilinde tamamlayın.

  1. Enterprise aboneliğini başlatın ve profilde e-posta içe aktarmayı etkinleştirin.
  2. Gönderen adresini ekleyin ve bu posta kutusuna gelen doğrulama bağlantısını tamamlayın.
  3. Yanıtların ilk göndericiye mi yoksa doğrulanmış ortak adrese mi döneceğini seçin ve yanıt dilini belirleyin.
  4. Genel posta kutusunu profilden kopyalayın, belgelenmiş bir etiket seçin ve gereken her rotayı temsilî bir PDF ile sınayın.

Hedef biçimi konu etiketiyle seçme

HedefKonu etiketiBaşarılı yanıt
XRechnung[XRechnung]Doğrulanmış XML ve çıktıya bağlı HTML doğrulama raporu.
ZUGFeRD / Factur-X[ZUGFeRD]Doğrulanmış hibrit PDF/A-3 ve çıktıya bağlı HTML doğrulama raporu.
EN 16931[EN16931]Doğrulanmış UBL XML ve çıktıya bağlı HTML doğrulama raporu.
UBL[UBL]Doğrulanmış UBL XML ve çıktıya bağlı HTML doğrulama raporu.
CII[CII]Doğrulanmış CII XML ve çıktıya bağlı HTML doğrulama raporu.

Alımdan yanıta kadar

Kanal sağlayıcıya hızlı yanıt verir, ardından katı dönüştürmeyi eşzamansız yürütür.

  1. Doğrulanmış gönderici, biçime özel bir veya daha fazla gelen kutusuna gerçek PDF ekleri yollar.
  2. Gelen e-posta sağlayıcısı iletiyi kaydeder; hizmet etkin kiracıyı, göndericiyi, yanıt hedefini ve seçilen hedef biçimleri çözümler.
  3. Kabul edilen her PDF, çıktı doğrulaması zorunlu ve taslak ya da uyarı geçersiz kılma seçenekleri kapalı katı bir göreve dönüşür.
  4. İstenen çıktı yalnızca yetkili doğrulama, kalıcı kanıt ve çıktı eşliği kontrolleri geçtikten sonra yayımlanır.
  5. Aynı ileti dizisindeki yanıt iletileri yayımlanan çıktıları ve HTML raporlarını döndürür; ek boyutu gerektirirse iletiler bölünür, ileti, öğe, kullanım olayı, kanıt ve kalıcı yanıt dosyaları ise kimliklerle izlenebilir kalır.

Faturalandırma birimleri ve e-posta bağlamı

Göndermeden önce iletinin tamamını sayın ve metnini dönüştürme girdisi olarak değerlendirin.

  • Kabul edilen her PDF, eşleşen her hedef biçim için bir dönüştürme birimi kullanır. Örneğin, her iki biçim posta kutusuna gönderilen iki PDF dört birim gerektirir.
  • Hizmet, dönüştürmeden önce iletideki tüm birimleri ayırır: önce aylık dahil kotadan, ardından kullanılabilir API kredilerinden.
  • Tüm birimler için yeterli kapsam yoksa iletinin tamamı dönüştürmeden önce reddedilir. Yalnız başarılı birimler, kalıcı yanıt çıktıları saklandıktan sonra borçlandırılır; başarısız birimler serbest bırakılır.
  • Gövde metni varsa doğrulanmış e-postanın konusu ve gövdesi ek dönüştürme girdisidir. Eksik değişiklikleri, düzeltmeleri, referansları veya fatura bilgilerini sağlayabilir. Çatışma durumunda PDF’deki parasal toplamlar, vergi toplamları ve fatura satırları önceliklidir; yalnız e-posta metninden fatura satırı oluşturulmaz. E-posta bağlamı sınırlıdır ve kısaltılabilir; bu nedenle imzaları ve çevreleyen metni kısa, ilgili ve açık tutun.
  • Varsayılan kullanım açıkken her satıcı profil değeri (ad, adres, KDV numarası, iletişim), PDF’den çıkarılan ilgili değerin yerini alır. Fark, engel değil uyarı oluşturur.

Son durumlar ve çıktılar

SonuçYanıtın içeriğiEkler
YayımlandıDosya tamamlandı ve yetkili doğrulama geçti.İstenen ana çıktı ve ona bağlı HTML doğrulama raporu.
KısmiEn az bir dosya tamamlandı; en az biri başarısız oldu veya atlandı.Yalnız tamamlanan dosyaların kanıt destekli çıktıları ve dosya bazında durum.
Doğrulama durduEngelleyici doğrulama ayrıntıları yayımlamanın neden durduğunu açıklar.Doğrulanmamış çıktı ve çıktıya bağlı HTML raporu yoktur.
Teknik retYanıt gönderici, dosya, yetki, sınır veya geçici işlem sorununu belirtir.Sonuç çıktısı yoktur; yeniden denemeden önce yönergeyi izleyin.

Kabul edilen dosyalar ve hizmet sınırları

Bu noktaları bu bölüm için pratik kontrol adımları olarak kullanın.

  • Gerçek PDF dosyaları ekleyin. Uzantısı veya MIME türü PDF görünse bile yeniden adlandırılmış görsel ya da başka belge reddedilir.
  • Bir ileti birden çok PDF içerebilir; kanal toplu alım için değil, kontrollü ve düşük hacimli iş akışları içindir.
  • Her eki 10 MB altında tutun; sağlayıcı sınırları daha düşük olabilir ve değişebilir.
  • Bir ileti tanınan birden çok biçim gelen kutusuna ulaşırsa kabul edilen her PDF seçilen her biçim için bir kez işlenir.
  • Yanıt ekleri ileti başına 15 MB eşiğiyle gruplanır. Başka bir dosyanın eklenmesi eşiği aşacaksa kalan ekler aynı ileti dizisindeki başka bir iletide devam eder; tek bir dosya bölünmez.

İnsan incelemesi gereken noktalar

Bu noktaları bu bölüm için pratik kontrol adımları olarak kullanın.

  • Tedarikçi, alıcı, fatura numarası, tarihler, para birimi, vergi, toplamlar, ödeme bilgileri ve tüm satırları kaynak faturayla karşılaştırın.
  • Alıcıya özel yönlendirme referanslarını, uç nokta kimliklerini, sipariş verilerini ve teslim kanalı kurallarını doğrulayın.
  • Sonucu iletmeden önce düşük güvenli kaynak kanıtlarını ve tüm uyarı ya da doğrulama ayrıntılarını inceleyin.
  • Başarılı teknik doğrulama, yayımlanan dosyayı seçili kurallara göre kanıtlar; ticari, vergisel veya alıcı onayının yerini almaz.

E-posta veya API kanalını bilinçli seçme

KanalEn uygun kullanımEntegrasyon denetimi
E-posta kanalıDüşük hacimli, insan veya posta kutusu kuralı tarafından yürütülen ve ileti dizisinin yararlı olduğu akışlar.Biçim gelen kutusu, doğrulanmış gönderici, dönüş adresi, yanıt dili ve ileti bazında sonuçlar.
External API V1İdempotans, yoklama, yapısal durum ve açık indirme denetimi isteyen sunucudan sunucuya akışlar.Kimliği doğrulanmış istekler, istemci referansları, korelasyon kimlikleri, hız sınırı başlıkları ve çıktı uç noktaları.

Kurulum ve destek

Gönderenleri, hedef biçimleri, yanıt hedefini ve dili profilde yapılandırın.

Akış diyagramları

Diyagramlar yukarıdaki aranabilir bölümlerle aynı sözleşmeyi özetler.

Dönüştürmeye neler girer, size neler döner

Neler girer

  • PDF eki

    Birincil kaynak

    Hem metin katmanı hem de OCR ile okunur. Parasal tutarlar, vergi toplamları ve fatura satırları her zaman PDF’den gelir.

  • E-posta konusu ve gövdesi

    Tamamlayıcı

    Doğrulanmış e-posta metni referans, düzeltme ve eksik bilgi sağlayabilir. PDF tutarlarının yerine asla geçmez ve fatura satırı oluşturamaz.

  • Profildeki ana veriler

    Eksikleri doldurur

    Varsayılan kullanım açıkken her kayıtlı satıcı profil değeri (ad, adres, KDV numarası, iletişim), ilgili çıkarılan değerin yerini alır. Fark, engel değil uyarı oluşturur.

Katı dönüştürme

Çıkarma, zenginleştirme ve kanıt ile eşlik kontrolleri eşliğinde yetkili doğrulama.

Neler döner

  • Doğrulanmış çıktı

    Kullandığınız gelen kutusuna göre XRechnung XML veya hibrit ZUGFeRD / Factur-X PDF/A-3.

  • HTML doğrulama raporu

    Çıktıya bağlı rapor, teslim edilen dosyanın doğrulamasını kanıtlar.

  • Dizinizde yanıt

    Her şey özgün iletinize yanıt olarak gelir.

Gelen kutusundan kanıtlı yanıta

  1. Doğrulanmış gönderici

    Etkin hesap gerçek PDF dosyaları yollar.

  2. Biçim gelen kutusu

    Alıcı adresi XRechnung veya ZUGFeRD seçer.

  3. Katı görev

    Çıkarma ve üretim taslak geçersiz kılmaları olmadan çalışır.

  4. Kanıt kapısı

    Doğrulama, kanıt saklama ve eşlik geçmelidir.

  5. İleti dizisi yanıtı

    Çıktı ve rapor bir veya daha fazla iletide döner; boyut bölmeleri aynı dizide kalır.

Tüm son durumlar

Katı dönüştürme sonucu
  • Yayımlandı

    Çıktı ve rapor

    Yalnız kanıt destekli baytlar eklenir.

  • Kısmi

    Başarılı dosyalar korunur

    Çıktılar ve dosya hataları aynı yanıt dizisinde yer alır.

  • Doğrulama durdu

    Ayrıntı var, çıktı yok

    Engelleyici kurallar doğrulanmamış çıktıyı durdurur.

  • Teknik ret

    Eyleme dönük yeniden deneme

    Yanıt neyin değişmesi veya yinelenmesi gerektiğini açıklar.