Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

Make kullanarak ZUGFeRD 2.0+ E-Faturası Oluşturma: 4 Modüllü Dropbox İş Akışı

· 21 dakikalık okuma
Sankalp Mishra
SEO and Content Writer

ZUGFeRD 2.0+ (diğer adıyla Faktör-X Fransa'da ve XRechnung (Alman kamu sektöründe) bir hibrit PDF/A-3 fatura PDF'nin içine yerleştirilmiş makine tarafından okunabilir XML ile. Hem insanlar hem de ERP sistemleri tarafından kullanılabilen tek bir dosya. Bu kılavuz, ekran görüntülerinde gösterilen işlemi adım adım açıklıyor: Dropbox'taki temel bir fatura PDF'si ve ZUGFeRD 2.0+ XML dosyası, EN16931 uyumlu hibrit bir e-faturaya dönüşüyor. /pdf4meoutput/, içinde 4. Modüller oluşturun, sıfır kod..

Senaryoya genel bakış
1. Dropbox Download (PDF)
Pulls the base invoice PDF (/pdf4metest/Zugfred Invoice/SimplePdf.pdf). Scheduled trigger shown.
2. Dropbox Download (XML)
Pulls the ZUGFeRD 2.0+ XML invoice data (/pdf4metest/Zugfred Invoice/version2.xml).
3. PDF4me Create a ZUGFeRD invoice
Input Format XML, Output Mode XML With PDF, ZUGFeRD Version 2+, Conformance EN16931, Render Yes, Language de.
4. Dropbox Upload
Writes the hybrid PDF/A-3 e-invoice to /pdf4meoutput/ using File set to Map.
kısa versiyon

Dört adet Make modülü uçtan uca birleştirildi. İki adet Dropbox kutusu. Dosya İndir Adımlar temel PDF dosyasını ve ZUGFeRD 2.0+ XML dosyasını çekiyor (ekran görüntüleri gösteriyor). YnooxTestone bağlantı artı yollar /pdf4metest/Zugfred Faturası/SimplePdf.pdf Ve /pdf4metest/Zugfred Fatura/versiyon2.xmlPDF4me ZUGFeRD faturası oluşturun XML dosyasını PDF'ye şu şekilde yerleştirir: Çıkış Modu XML ve PDF, ZUGFeRD Versiyonu 2+, Uygunluk Seviyesi EN16931, Faturayı PDF olarak oluştur Evet, Dil ile ilgiliDropbox Dosya Yükle sonucu yazıyor hibrit PDF/A-3 ile /pdf4meoutput/ Dosya ayarı ile Harita, Dosya adı 15. İsim, Veri 15. BelgeÇıktı herhangi bir PDF okuyucuda açılır ve ZUGFeRD / Factur-X / XRechnung'u destekleyen herhangi bir ERP sisteminde sorunsuz bir şekilde ayrıştırılır.

ERP sisteminizin faturayı kabul edip etmeyeceğine karar veren iki şey var.

İlk olarak, Uygunluk Seviyesi Alıcınızın veya hedeflediğiniz ERP sisteminin beklentileriyle eşleşmelidir. EN16931 (Comfort), Almanya'da yasal olarak varsayılan değerdir ve AB'de B2B için güvenli bir tercihtir; XRECHARGE Almanya'da B2G (kamu sektörü) faturalaması için gereklidir; TEMEL Diğer birçok alıcı için işe yarıyor. İkincisi, ZUGFeRD Versiyonu olmalıdır 2+ EN 16931 standardına uygun her şey için. Eski sürüm. 1.0 BASIC / COMFORT / EXTENDED seçeneklerini kullanır ve EN 16931 alıcılarıyla uyumlu değildir. Seçiniz. 2+ Alıcı açıkça 1.0 sürümünü talep etmediği sürece.

Bu, gerçek dünyada sıkça karşılaşılan soruları çözüyor.​

İnsanlar bu sorunu şu gibi ifadelerle arıyorlar:

  • "Make kullanarak gömülü XML içeren bir ZUGFeRD faturası nasıl oluşturabilirim?" Bu 4 modüllü senaryo, baştan sona işlemi gerçekleştiriyor: PDF şablonu ve XML fatura girişi, hibrit PDF/A3 çıkışı.
  • "ZUGFeRD ile Factur-X aynı şey mi?" Evet. Farklı isimler altında aynı teknik format. ZUGFeRD 2.x dosyası, Factur-X bekleyen sistemler tarafından kabul edilir ve bunun tersi de geçerlidir.
  • "Hangi uyumluluk seviyesini seçmeliyim?" B2B için EN16931 (Alman yasal standardı ve AB EN 16931 ile uyumlu), Alman kamu sektörü (B2G) için XRECHNUNG, en geniş eski sistem uyumluluğu için BASIC.
  • "XML kodunu kendim mi yazmalıyım?" Hayır, ancak bu senaryoda ekran görüntülerinde mevcut bir XML faturası kullanılıyor. Modül ayrıca JSON veya CSV girdilerini de kabul ediyor ve sizin için XML'i oluşturuyor.
  • "Ya alıcım sadece XML dosyasına ihtiyaç duyarsa, PDF'ye ihtiyacı yoksa?" Çıkış Modunu Ayarla XML Only ve modül hibrit dosya yerine yalnızca XML fatura dosyasını döndürüyor.

Ne inşa ediyorsunuz?​

PDF ve XML fatura dosyalarından tam uyumlu ZUGFeRD 2.0+ hibrit e-fatura üreten, yeniden kullanılabilir bir Make senaryosu. Tetikleyici manuel, zamanlanmış (gösterildiği gibi), Dropbox dosya izleme veya HTTP webhook olabilir. Çıktı, AB e-fatura zorunlulukları için hem insan tarafından okunabilir PDF gereksinimini hem de makine tarafından okunabilir XML gereksinimini karşılayan tek bir dosyadır.

Senaryo tuvali oluşturun: Dropbox'tan Dosya İndir (PDF, zamanlanmış zamanlayıcı rozetiyle) modülü, ikinci bir Dropbox'tan Dosya İndir (XML) modülüne, o da PDF4me'den ZUGFeRD faturası oluştur modülüne, o da Dropbox'tan Dosya Yükle modülüne bağlıdır. Her modül, 1 yineleme sayacı ve başarılı çalıştırmayı gösteren yeşil bir onay işareti gösterir.

Uçtan uca dört modül. İki indirme, bir PDF4me işlemi, bir yükleme. 1. Modüldeki saat simgesi, planlanmış bir tetikleyiciyi gösterir; kullanım durumunuza uyacak şekilde manuel / dosya izleme / webhook'a geçin.

İhtiyacınız olan şey​

  • Yapmak Senaryo açık olan hesap. Make hesabı oluşturun İhtiyacınız varsa.
  • PDF4me API anahtarı. API anahtarınızı alın ve ilk PDF4me modülüne bağlanın. Bakınız. PDF4me'yi Oluşturmak İçin Bağlayın.
  • Dropbox Kaynak klasörüyle birlikte (örneğin, /pdf4metest/Zugfred Faturası/PDF şablonunu ve XML faturasını içeren, ayrıca bir çıktı klasörü de bulunan bir dosya./pdf4meoutput/).
  • Temel bir PDF (ekran görüntüleri kullanılıyor) SimplePdf.pdfHerhangi bir düzenleme işaretlemesine ihtiyaç duymaz. Modül, XML dosyasını PDF/A-3 eki olarak gömer.
  • ZUGFeRD 2.0+ XML faturasıKendi ekipmanınızı kullanın veya bir tane alın. 2.0 XML örneği takip etmek için.

Hızlı referans: Her parametrenin ne işe yaradığı​

Input Format
XML for existing ZUGFeRD XML, JSON for structured JSON, CSV for tabular invoice rows.
Output Mode
XML With PDF returns the hybrid PDF/A-3 (recommended). XML Only returns just the XML invoice file.
ZUGFeRD Version
2+ for EN 16931 alignment (use this). 1.0 is legacy with BASIC / COMFORT / EXTENDED only.
Conformance Level
2+ supports MINIMUM, BASICWL, BASIC, EN16931 (Comfort, default), EXTENDED, XRECHNUNG (German B2G).
Render Invoice on PDF
Yes draws the invoice line items visually on the PDF. Only takes effect when Output Mode is XML With PDF.
Language
Two-letter ISO code: de (default), en, fr, it, es, nl, pl, pt, cs. Controls label localisation on the rendered PDF.

Senaryoyu oluşturun​

Modül 1: Dropbox'tan Dosya İndirme (temel PDF)​

ZUGFeRD XML dosyasının PDF/A-3 eki olarak ekleneceği kaynak PDF dosyasını indirin.

AlanBu çalıştırmada kullanılan değer
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/SimplePdf.pdf
Dropbox'tan dosya indirme yapılandırmasını temel PDF için oluşturun. Bağlantı YnooxTestone. Dosya seçme yöntemi: Dosya seçin. Dosya yolu: /pdf4metest/Zugfred Invoice/SimplePdf.pdf.

Modül 2: Dropbox'tan Dosya İndirme (ZUGFeRD 2.0+ XML)​

ZUGFeRD XML fatura dosyasını çekin. XML dosyası faturanın tüm detaylarını içerir; PDF ise sadece görsel bir çerçevedir.

AlanBu çalıştırmada kullanılan değer
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/version2.xml
ZUGFeRD 2.0+ XML için Dropbox Dosya İndirme yapılandırmasını oluşturun. Bağlantı YnooxTestone. Dosya seçme yöntemi: Dosya seçin. Dosya yolu: /pdf4metest/Zugfred Invoice/version2.xml.

Modül 3: PDF4me ZUGFeRD faturası oluşturma​

Asıl gömme işlemini gerçekleştiren eylem budur. İndirilen her iki dosyayı da girdi olarak eşleştirin, uyumluluk ayarlarınızı seçin ve çalıştırın.

GrupAlanDeğer
AuthConnectionClassify Documen (testva...). PDF4me connection
SourceFile (PDF template)Map → Module 1 File Name + Data
SourceInput FormatXML
SourceFile (XML invoice)Map → Module 2 File Name + Data (a second File picker appears when Input Format is XML)
OutputOutput ModeXML With PDF (hybrid PDF/A-3)
OutputZUGFeRD Version2+
OutputConformance LevelEN16931
OutputRender Invoice on PDFYes
OutputLanguagede

Modül 4: Dropbox'a Dosya Yükleme​

Hibrit PDF/A-3 elektronik faturayı çıktı klasörüne kaydedin.

AlanBu çalıştırmada kullanılan değer
ConnectionYnooxTestone (ynoox.test...)
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name15. Name (dynamic content from PDF4me Module 3)
Data15. Document (dynamic content from PDF4me Module 3)
Dropbox'tan Dosya Yükleme yapılandırması oluşturun. Bağlantı YnooxTestone. Klasör /pdf4meoutput/. Dosya Harita olarak ayarlandı. Dosya Adı 15'e bağlandı. Ad (PDF4me ZUGFeRD faturası oluşturma bölümünden). Veri 15'e bağlandı. Belge.

Kaydet ve tıkla Bir kez çalıştırHibrit PDF/A-3 iniş yapıyor. /pdf4meoutput/ birkaç saniye içinde.

Get your API KeyFull action reference

Örnek dosyalar (XML, JSON, CSV)​

Bu girdilerden herhangi birinin yerine Modül 2'yi (XML) koyabilir ve değişiklik yapabilirsiniz. Giriş Formatı buna göre.

Sorun giderme​

Conformance Level dropdown shows different options than expected
You toggled between Versions. Version 1.0 has BASIC, COMFORT, EXTENDED. Version 2+ has Empty, MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Pick the version first; conformance levels follow.
Second File picker did not appear when Input Format is XML
It only appears when File is set to Map. Click the File radio and choose Map; the second File picker (for the XML invoice) renders below.
Buyer ERP rejects the hybrid PDF as non-compliant
Mismatched Conformance Level. Check what the receiver expects (commonly EN16931 for B2B EU, XRECHNUNG for German B2G). Re-run with the right value.
Output is XML only when you wanted the hybrid PDF
Output Mode is set to XML Only. Switch to XML With PDF.
Rendered invoice on PDF is missing line items
Render Invoice on PDF is set to No or Empty, or Output Mode is XML Only. Set both: Output Mode = XML With PDF AND Render Invoice on PDF = Yes.
Want JSON or CSV instead of XML as the input
Change Input Format. The Invoice XML Data / second File picker is replaced by an Invoice JSON Data or Invoice CSV Data text field, which you map from a Google Sheets, HTTP, or file-download module.

Bu deseni ne zaman kullanmalısınız?​

B2B invoicing in the EU
EN16931 (Comfort) covers the legal default for German and EU business-to-business e-invoicing.
B2G (public-sector) Germany
XRECHNUNG is required for invoicing public authorities. Same flow, different conformance level.
Cross-border Factur-X
France and other EU markets accept ZUGFeRD 2.x as Factur-X. No format conversion needed.
ERP integration without code
Buyer ERP extracts the embedded XML automatically; no manual data entry in accounts payable.

Sırada ne okumalıyım?​

SSS​

What is ZUGFeRD 2.0+ and how does it differ from 1.0?+
ZUGFeRD 2.0+ aligns with the EU EN 16931 e-invoicing standard and supports the modern Conformance Level set (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). ZUGFeRD 1.0 predates EN 16931 and uses BASIC / COMFORT / EXTENDED only. For any new integration in 2026 use 2+; 1.0 is kept for legacy buyer ERPs.
Is ZUGFeRD the same as Factur-X?+
Same technical format under different brand names. ZUGFeRD is the German designation; Factur-X is the French equivalent. Both align to EN 16931 and are cross-compatible: a ZUGFeRD 2.x invoice is accepted by Factur-X receivers and vice versa.
Which Conformance Level should I pick for a typical EU B2B invoice?+
EN16931 (also called Comfort). It is the German legal default and the safe choice for EU business-to-business invoicing. Use XRECHNUNG when invoicing German public authorities (B2G). Use BASIC only when a recipient ERP explicitly requires it.
Do I need to author the XML myself?+
No. The screenshots use an existing XML (Input Format = XML), but the module also accepts JSON or CSV. Choose Input Format = JSON or CSV and the XML is built for you. Sample JSON and CSV files are in the section above.
What if my buyer needs only the XML, no PDF?+
Set Output Mode to XML Only. The module returns just the XML invoice file without a PDF wrapper. Useful when the receiving ERP renders its own document and only consumes the structured data.
Can I render line items visually on the PDF page?+
Yes. Set Render Invoice on PDF = Yes (only effective when Output Mode is XML With PDF). The module draws the invoice items as a visual table on the PDF pages so human reviewers see the invoice content without opening the embedded XML.
Does this work in Power Automate, n8n, or Zapier?+
Yes. The PDF4me Create ZUGFeRD Invoice action is available on all four platforms with the same parameters. See the cross-platform comparison at the bottom of the Make action reference page.
Does the output PDF/A-3 work with every PDF viewer?+
Yes. PDF/A-3 is backward-compatible with all PDF readers. Human readers see the rendered invoice PDF; ZUGFeRD-aware ERPs extract the embedded XML automatically. Non-aware tools just see a normal PDF.

Başlayın​

Get your API KeyPDF4me on MakeAction reference