Entegrasyon · 2026-07-10
Markdown dışa aktarFaturaları e-posta ile entegre etme
Doğrulanmış bir gönderici yapılandırın, profilde gösterilen biçime özel gelen kutusunu kullanın ve kanıt destekli yanıt iletilerini aynı ileti dizisinde alın; ek boyutu gerektirirse iletiler bölünür.
Hesap için etkinleştirilen e-posta kanalı
Bu kanalı kontrollü ve düşük hacimli fatura iş akışları için kullanın.
E-posta ile fatura dönüştürme, mevcut pilotta yalnızca etkinleştirilmiş Enterprise hesaplarında kullanılabilir. Etkin abonelik, açılmış e-posta içe aktarma ve en az bir doğrulanmış gönderici gerekir.
Profilde gösterilen biçime özel gelen kutusu adresleri geçerlidir. Adresler ortama göre değişebileceğinden örneklerden veya dahili belgelerden alınan adresleri kod içine sabitlemeyin.
Kullanılabilirlik
Etkinleştirme ve gönderici doğrulaması müşteri kurulumu sırasında tamamlanır. Normal bir hesap yalnızca e-posta göndererek kanalı etkinleştiremez.
İlk faturadan önce göndericiyi hazırlama
Bir posta kutusu veya ERP kuralını otomatikleştirmeden önce bu adımları hesap profilinde tamamlayın.
- Invoice-Converter ekibinden Enterprise hesap için e-posta kanalını etkinleştirmesini isteyin.
- Gönderen adresini ekleyin ve bu posta kutusuna gelen doğrulama bağlantısını tamamlayın.
- Yanıtların ilk göndericiye mi yoksa doğrulanmış ortak adrese mi döneceğini seçin ve yanıt dilini belirleyin.
- XRechnung ve ZUGFeRD adreslerini profilden kopyalayın; gereken her rotayı temsilî bir PDF ile sınayın.
Hedef biçimi alıcı adresiyle seçme
| Hedef | Kullanılacak adres | Başarılı yanıt |
|---|---|---|
| XRechnung | Etkin hesap profilinde gösterilen XRechnung gelen kutusu. | Doğrulanmış XML ve çıktıya bağlı HTML doğrulama raporu. |
| ZUGFeRD / Factur-X | Etkin hesap profilinde gösterilen ZUGFeRD gelen kutusu. | Doğrulanmış hibrit PDF/A-3 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.
- Doğrulanmış gönderici, biçime özel bir veya daha fazla gelen kutusuna gerçek PDF ekleri yollar.
- 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.
- 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.
- İstenen çıktı yalnızca yetkili doğrulama, kalıcı kanıt ve çıktı eşliği kontrolleri geçtikten sonra yayımlanır.
- 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.
- Profilinizde kayıtlı satıcı ana verileri, varsayılan kullanım açıkken eksik satıcı alanlarını (ad, adres, KDV numarası, iletişim) tamamlar; PDF’den çıkarılan değerlerin üzerine asla yazmaz.
Son durumlar ve çıktılar
| Sonuç | Yanıtın içeriği | Ekler |
|---|---|---|
| Yayımlandı | Dosya tamamlandı ve yetkili doğrulama geçti. | İstenen ana çıktı ve ona bağlı HTML doğrulama raporu. |
| Kısmi | En 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 durdu | Engelleyici 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 ret | Yanı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 pilot 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 müşteri kurulumu sırasında bildirilen sınırın altında tutun; sağlayıcı ve ortam sınırları 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
| Kanal | En uygun kullanım | Entegrasyon 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ı. |
Müşteri kurulumu ve destek
Müşteri kurulumu sırasında beklenen gönderen adreslerini, hedef biçimleri, yanıt hedefini, dili ve aylık hacmi paylaşı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 kaynakHem 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 doldururProfilinizde kayıtlı satıcı ana verileri (ad, adres, KDV numarası, iletişim) varsayılan kullanım açıkken eksik satıcı alanlarını tamamlar; çıkarılan değerlerin üzerine yazmaz.
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
Doğrulanmış gönderici
Etkin hesap gerçek PDF dosyaları yollar.
Biçim gelen kutusu
Alıcı adresi XRechnung veya ZUGFeRD seçer.
Katı görev
Çıkarma ve üretim taslak geçersiz kılmaları olmadan çalışır.
Kanıt kapısı
Doğrulama, kanıt saklama ve eşlik geçmelidir.
İ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
- 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.