Ana içeriğe geç

ZUGFeRD Faturası Oluştur Zapier

Bu eylemin yaptığı şey

PDF4me ZUGFeRD Faturası Oluştur tamamen uyumlu bir şekilde üretir. ZUGFeRD hibrit e-faturaları, A PDF/A-3 belgesi yapılandırılmış XML Fatura verileri doğrudan içine yerleştirilmiştir. Zapier iş akışı. Dönüştür XML, JSON, veya CSV Fatura verilerini tek bir hibrit dosyaya dönüştürerek kullanıma hazır hale getirin. Almanya'da B2B e-fatura zorunluluğu (2025+)AB çapında EN 16931 uyumluluğu veya Alman XRECHNUNG kamu sektörü profili. ZUGFeRD 1.0'dan 2.x'e kadar olan sürümleri ve BASIC, COMFORT, EXTENDED, EN16931, XRECHNUNG olmak üzere tüm uyumluluk seviyelerini tek bir Zap işlemiyle destekler. Manuel Adobe Acrobat, JustOn veya ZUGFeRD Manager iş akışlarının yerine doğrudan kullanılabilir.

İlgili Blog Yazıları(1)

Kimliğinizi Doğrulama API Rica etmek

Erişmek için PDF4me Web API başından sonuna kadar ZapierHer işlem doğrulanmalıdır. Tıklayın. Yeni bir hesap bağlayın ilk kez ve yapıştırın PDF4me API Bu özellik sayesinde, sonraki Zap'ler bağlantıyı otomatik olarak yeniden kullanır.

Kaçırmamanız Gereken Önemli Bilgiler

2025 Alman B2B zorunluluğu için ZUGFeRD 2.0+ gereklidir.
Wachstumschancengesetz, 1 Ocak 2025'ten itibaren e-fatura alımını zorunlu hale getirmiş ve 2028 yılına kadar tüm gönderim yükümlülüklerini getirmiştir. EN16931 veya XRECHNUNG uyumluluğuna sahip ZUGFeRD 2.0 veya üzeri sürümler bu zorunluluğu karşılamaktadır: ZUGFeRD 1.0 uyumlu değildir. Bazı kurulumlarda işlem varsayılan olarak 1.0 sürümüne ayarlanmıştır; üretim için açıkça 2.0+ sürümüne geçiş yapılmalıdır.
Her çalıştırmada yalnızca bir veri alanını doldurun, asla iki alanı birden doldurmayın.
Harita sadece Fatura veri alanı, Giriş Biçiminizle eşleşiyor, Fatura XML Verileri için XMLFatura JSON Verileri için JSONFatura CSV Verileri için CSVBirden fazla alanı "her ihtimale karşı" doldurmak, doğrulama işlemini bozar ve çalışma zamanında Zap adımının başarısız olmasına neden olur.
Uyumluluk Seviyesi, EN16931, 2.x için güvenli varsayılan değerdir.
Seçmek EN16931 Genel AB B2B faturalama için (ZUGFeRD 2.x), XRECH Alman kamu sektörü kuruluşları için, UZATILMIŞ Sektöre özgü alanlar için. ZUGFeRD 1.0 için BASIC, yasal minimum fatura seviyesidir. MINIMUM ve BASICWL, kalem öğelerini içermez ve kendi başlarına yasal fatura değildir.
Zapier PDF4me'de Yapılandırma adımında ZUGFeRD Fatura Oluşturma eylemi: Önceki adımlardan alınan Dosya ve Dosya Adı, Giriş Formatı XML, Önceki adımdan eşleştirilen Fatura XML Verileri, Çıkış Modu Yalnızca XML, Zugferd Sürümü 1.0, Uyumluluk Seviyesi TEMEL, Faturayı PDF Olarak Oluştur (Doğru), Dil (de)

Zapier aksiyon Yapılandır sekme, harita Dosya / Dosya adı, ayarlamak Giriş Formatı ve ardından eşleşen fatura veri alanı. Çıkış Modu, Zugferd Versiyonu, Uygunluk Seviyesi, Faturayı PDF Olarak Oluştur, Ve Dil.

Parametreler

Gereklidir Zapier UI (yıldız işaretiyle belirtilmiştir): Giriş Formatı, Çıkış Modu, Zugferd Sürümü ve Uyumluluk Seviyesi. Şartlı: Giriş Formatına göre eşleşen Fatura veri alanı (Fatura XML Verisi, Fatura JSON Verisi veya Fatura CSV Verisi). XmlWithPdf çıktısı için: Dosya ve Dosya Adı (şablon PDF) genellikle bağlayıcı tarafından istenir, ancak her düzende yıldız işaretiyle belirtilmemiştir. İsteğe bağlı: Faturayı PDF olarak oluştur, Dil.

ParametreGerekliNe işe yarar?Örnek
FileConditionalTemplate/layout PDF that will hold the embedded XML in XmlWithPdf output. Map from a previous step (Dropbox, Google Drive, HTTP). Not required when Output Mode is XmlOnly.3. File: (Exists but not shown)
File NameConditionalFilename of the template PDF (filename + extension). Required alongside File for XmlWithPdf output. Map both `File Name` and `File Ext` from the prior step.3. File Name: 10 page + 3. File Ext: .pdf
Input FormatYesFormat of the invoice payload: XML, JSON, or CSV. Determines which invoice data field below must be filled. Asterisked in the Zapier UI.XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample
Invoice Xml DataConditionalXML invoice payload. Required when Input Format is XML. Map from a previous file step that produced XML content. Leave empty for JSON/CSV inputs.XML sampleXML 2.0 sample4. File: (Exists but not shown)
Invoice Json DataConditionalJSON invoice payload. Required when Input Format is JSON. Best for webhook-driven or API-driven invoice data.JSON 2.0 EN16931 sampleJSON (basic)4. Body
Invoice Csv DataConditionalCSV invoice payload. Required when Input Format is CSV. Best for batch invoice exports from spreadsheets or legacy ERP exports.CSV sampleCSV 2.0 sample4. File
Output ModeYesXmlWithPdf produces the hybrid PDF/A-3 + embedded XML (canonical ZUGFeRD). XmlOnly produces pure XML with no PDF wrapper. Asterisked.XmlOnly
Zugferd VersionYesZUGFeRD specification version. 1.0 is legacy. 2.0+ aligns with EN 16931 and satisfies the German B2B mandate. Asterisked.1.0
Conformance LevelYesProfile controlling required invoice fields. For 1.0: BASIC, COMFORT, EXTENDED. For 2.x: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Asterisked.BASIC
Render Invoice On PdfNoToggle (True / False). When True, PDF4me visually renders invoice content on the PDF. When False, only the XML is embedded: useful when the template PDF already shows the invoice layout.True
LanguageNoTwo-letter locale code for printed invoice labels: de (German, default), en (English), fr (French), it (Italian), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese). The XML data itself remains language-neutral.de

Giriş Biçimi Seçenekleri

Fatura içeriğinizin hangi veri formatını kullanacağını ve aşağıda hangi fatura veri alanını doldurmanız gerektiğini kontrol eder.

XMLÖnceden üretilmiş XML fatura
En iyisi senin ERP halihazırda ZUGFeRD uyumlu ürünler üretiyor. XML veya UBL XML Sadece hibrit bir araçla sarılması gerekiyor. PDFDosyayı şu şekilde eşleştirin: Fatura XML Verileri.
JSONModern API-kaynaklı veriler
Webhook tabanlı iş akışları için en uygunudur veya SaaS faturalama sistemleri JSON. PDF4me haritalar JSON ZUGFeRD'e ait alanlar XML Şemayı otomatik olarak eşleştir. Fatura JSON Verileri.
CSVElektronik tablo veya toplu dışa aktarma
Google Sheets, Excel, eski sistemlerden toplu fatura dışa aktarımı veya satır bazlı faturalama senaryoları için en uygunudur. PDF4me haritalar CSV Şemaya sütunlar ekleyin. Eşleştirin Fatura CSV Verileri.

Çıkış Modu Seçenekleri

Standart ZUGFeRD hibrit dosyasını mı yoksa saf XML dosyasını mı üreteceğinizi kontrol eder.

XmlWithPdfVarsayılan, tam ZUGFeRD hibrit dosyası
Standart ZUGFeRD hibritini üretir: PDF/A-3 arşivsel PDF yapılandırılmış ile XML Fatura, ek olarak dosyaya yerleştirilmiştir. İnsanlar bunu okur. PDFmakineler bunu ayrıştırır XMLB2B e-faturalama için standart çıktı. Dosya ve Dosya Adı'nın eşleştirilmesi gereklidir.
Yalnızca XMLSaf XML, HAYIR PDF sarmalayıcı
Yalnızca yapılandırılmış verileri üretir. XML fatura. XRechnung pure- için kullanılır.XML kamu sektörü başvuruları, EDI işlem hatları, veri katmanı testleri veya yalnızca veri alan sistemler XML görsel bir temsil olmaksızın.

Zugferd Sürüm Seçenekleri

Oluşturulan faturaya gömülü ZUGFeRD spesifikasyon sürümü. Açılır menüde hangi Uygunluk Seviyesi seçeneklerinin görüneceğini belirler.

1.0Legacy, pre-EN 16931
Orijinal 2014 spesifikasyonu. Uyumluluk seçenekleri: TEMEL, KONFORLU, GENİŞLETİLMİŞ. 2025 ve sonrası Alman B2B e-fatura zorunluluğunu karşılamaz. Yalnızca 1.0 sürümünü açıkça gerektiren eski alıcılar için kullanın.
2.0+Tavsiye edilen, EN 16931 standardına uygun.
Avrupa Standardı EN 16931 ile uyumludur ve Alman B2B şartını karşılar. Uyumluluk seçenekleri şunları içerir: MİNİMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG2025 ve sonrası üretim faturalaması ve Factur-X birlikte çalışabilirliği için doğru seçim.

Uyumluluk Seviyesi Seçenekleri

Uyumluluk profili, hangi fatura alanlarının zorunlu ve doğrulanmış olduğunu kontrol eder. Mevcut seçenekler, seçilen Zugferd sürümüne bağlıdır.

MİNİMUMYalnızca 2.x sürümü, yalnızca başlık
Sadece başlık bilgileri, satır öğeleri yok. Geçerli bir yasal fatura DEĞİLDİR. Sadece dahili muhasebe teslimatları içindir.
TEMELWL2.x yalnızca, KDV hariç
KDV detaylarını ekler ancak kalem kalem listeleme yapmaz. Sadece rezervasyon yapılan senaryolarda siparişlerle karşılaştırılır.
TEMELHer iki versiyon için de asgari yasal fatura geçerlidir.
Ürün kalemlerini ekler. AB e-fatura direktifinin mutlak minimum gereksinimlerini karşılar. Hem 1.0 hem de 2.x sürümlerinde mevcuttur.
KONFORYalnızca 1.0 sürümü, genişletilmiş referanslar
BASIC koduna referans verileri ve ek alanlar ekler. Yalnızca ZUGFeRD 1.0 ile uyumludur, modern 2.x sürümlerinde EN16931'e eşdeğerdir.
EN169312.x, B2B için önerilen varsayılan sürüm
Avrupa Standardı EN 16931 tam profili. AB B2B faturalaması için önerilen varsayılan ayar ve Alman yönetmeliğinin referans aldığı seviye. Yalnızca ZUGFeRD 2.x ile uyumludur.
UZATILMIŞHer iki versiyonda da, sektöre özel ekstralar mevcuttur.
Temel özelliklere ek olarak sektöre özgü alanlar (lojistik, kargo, sektöre özgü referanslar) ekler. Hem 1.0 hem de 2.x sürümlerinde mevcuttur.
XRECHARGE2.x, Alman kamu sektörü için zorunlu
Federal, eyalet ve belediye yetkililerine kesilen faturalar için zorunlu olan Alman XRechnung CIUS profili. EN16931'den daha sıkı doğrulama. Yalnızca ZUGFeRD 2.x ile uyumludur.

Çıkış Alanları

AlanTipİçeriğinde neler var?
File ContentBinaryGenerated ZUGFeRD invoice file: hybrid PDF/A-3 for XmlWithPdf output or pure XML for XmlOnly output. Map into the next Zap step (upload, email, ERP POST).
File UrlStringDirect URL to access the generated file: useful for sharing or downstream HTTP processing.
File NameStringOutput filename without extension.
Full File NameStringComplete output filename with extension (.pdf for hybrid, .xml for XmlOnly).

Örnek Fatura Dosyaları

Canlı veri kaynağınızı bağlamadan önce, her giriş formatıyla işlemi test etmek için bu örnek dosyaları kullanın. Alman B2B üretim iş akışları için şunlarla başlayın: örnek-fatura-zugferd-2.0-en16931.json (ZUGFeRD 2.0, EN16931 uygunluk).

ZUGFeRD XML Örneği
ZUGFeRD 1.0 TEMEL XML. ile kullanın Giriş Formatı: XMLHaritaya dönüştürün. Fatura XML Verileri.
ZUGFeRD-fatura-örneği.xml
ZUGFeRD 2.0
ZUGFeRD 2.0 XML Örneği (EN16931)
ZUGFeRD 2.0 EN16931 XML Satıcı/alıcı tarafları, kalemler, KDV ve parasal toplam içeren, sektörler arası fatura formatında. Şunlarla kullanın: Giriş Formatı: XML, ZUGFeRD Sürümü: 2.0, Uygunluk: EN16931.
ZUGFeRD-fatura-örneği-2.0.xml
Tavsiye edilen
JSON 2.0 EN16931 Örneği
Tam yapılandırılmış fatura ZUGFeRD 2.0 ile EN16931 Uyumluluk. Kullanım amacı. Giriş Formatı: JSON, Zugferd Sürümü: 2.0, Uygunluk Seviyesi: EN16931Haritaya dönüştürün. Fatura JSON Verileri.
örnek-fatura-zugferd-2.0-en16931.json
JSON Fatura Örneği (temel)
Daha Basit JSON duman testleri için ZUGFeRD 1.0 Ve TEMEL uyumluluk.
örnek-fatura.json
CSV Fatura Örneği
Düz CSV satır için Giriş Formatı: CSVHaritaya dönüştürün. Fatura CSV Verileri.
test-fatura.csv
ZUGFeRD 2.0
CSV 2.0 Fatura Örneği
Genişletilmiş 22 sütunlu CSV: Fatura Kimliği, Düzenleme Tarihi, satıcı/alıcı adres alanları, Satıcı KDV Kimliği, Ürün Kimliği, Para Birimi, Ödeme Referansı, IBANBIC. Şunlarla kullanın: Giriş Formatı: CSV, ZUGFeRD 2.0.
zugferd-fatura-2.0.csv

Hızlı Kurulum

  1. İçinde Zapier, tıklamak + Yeni bir işlem eklemek ve seçmek için PDF4me.
  2. Seçmek ZUGFeRD Faturası Oluştur Olay örgüsü olarak.
  3. Bağlantınızı kurun. PDF4me hesabınızı veya adresinizi yapıştırın. API İstendiğinde tuşa basın.
  4. İçin XmlWithPdf çıktı, harita Dosya Ve Dosya adı düzeninize PDF (genellikle önceki bir Dropbox veya Google Drive indirme adımı). İçin Yalnızca XMLBunlar boş bırakılabilir.
  5. Ayarlamak Giriş Formatı ile XML, JSON, veya CSV Veri kaynağınıza bağlı olarak.
  6. Doldurmak sadece İlgili fatura verisi alanını seçin: Fatura XML Verisi, Fatura JSON Verisi veya Fatura CSV Verisi. Diğer ikisini boş bırakın.
  7. Ayarlamak Çıkış Modu ile XmlWithPdf (hibrit dosya, kanonik ZUGFeRD) veya Yalnızca XML (saf XML).
  8. Seçmek Zugferd Versiyonu: 2.0+ 2025 ve sonrası Alman B2B zorunluluğuna uyum için, 1.0 Sadece eski model alıcılar için geçerlidir.
  9. Seçmek Uygunluk Seviyesi: EN16931 genel B2B (2.x) için, XRECHARGE Alman kamu sektörü için, TEMEL ZUGFeRD 1.0 eski sürümü için.
  10. Açma/Kapama Faturayı PDF Olarak Oluştur ile Doğru eğer istersen PDF4me fatura içeriğini görsel olarak görüntülemek için PDF; YANLIŞ şablonunuz PDF Düzeni zaten gösteriyor.
  11. Ayarlamak Dil Alıcınızın bölgesine karşılık gelen yerel koda (de, en, fr, it, es, nl, pl, pt).
  12. Tıklamak Test işlemiÇıktıyı doğrulayın ve Zap'ı açın.

İş Akışı Örnekleri

İş Akışı ÖrnekleriCommon Zapier workflow patterns using Create ZUGFeRD Invoice.
SaaS webhook JSON → ZUGFeRD 2.x EN16931 → müşteriye e-posta gönder
  1. Senin SaaS faturalama sistemi bir webhook tetikliyor Zapier Bir Alman B2B müşterisine fatura kesildiğinde.
  2. PDF4me ZUGFeRD fatura çalıştırmaları oluşturun: Giriş Formatı = JSONFatura JSON verileri webhook yükünden eşleştirildi, Çıkış Modu = XmlWithPdf, Zugferd Sürümü = 2.0, Uyumluluk = EN16931, Dil = Almanca.
  3. Hibrit PDF (İnsan tarafından okunabilir + makine tarafından ayrıştırılabilir) formatta olan bu belge, bir Gmail adımına eklenerek müşterinin ödeme adresine gönderilir ve 2025+ B2B e-fatura zorunluluğunu karşılar.
  4. Google Sheets'te yer alan bir satır, denetim raporlaması için fatura kimliğini, müşteriyi, tutarı ve zaman damgasını kaydeder.
  5. A SharePoint ZUGFeRD'nin bir kopyasını arşivlere yükleyin. PDF Uyumluluk amacıyla saklama.
ERP CSV dışa aktarma → ÇEVİRİ → Alman kamu sektörü portalı
  1. Planlanmış bir Zap işlemi, kamu sektörüne ait bekleyen faturaları işlemek üzere her hafta içi saat 16:00'da çalışır.
  2. Dropbox tetikleyicisi en son gelenleri algılıyor. ERP CSV dışa aktarma ve düzen PDF.
  3. PDF4me ZUGFeRD fatura çalıştırmaları oluşturun: Giriş Formatı = CSVFatura CSV Verileri = CSV Dosya, Çıktı Modu = XmlWithPdf, Zugferd Sürümü = 2.0, Uyumluluk = XRECHNUNG, Dil = de.
  4. Uyumlu XRECHNUNG hibrit PDF Bu bilgi, bir Webhook adımı aracılığıyla federal ZRE portalına veya ilgili eyalet e-fatura uç noktasına POST edilir.
  5. Onay e-postası, gönderim referansıyla birlikte AR ekibine gönderilir; PostgreSQL günlüğü ise denetim izini kaydeder.
Önceden oluşturulmuş XML → Yalnızca XML → EDI iş ortağı entegrasyonu
  1. Senin ERP halihazırda ZUGFeRD uyumlu üretim yapıyor. XML Faturaları dışa aktarma modülü aracılığıyla oluşturur ve Google Drive klasörüne kaydeder.
  2. Zapier her yeni tetikleyici XML dosya. PDF4me ZUGFeRD fatura çalıştırmaları oluşturun: Giriş Formatı = XMLFatura XML Verileri = XML Dosya, Çıkış Modu = XmlOnly, Zugferd Sürümü = 2.0, Uyumluluk = EN16931.
  3. Doğrulanan saf-XML Fatura, SFTP aracılığıyla ticaret ortağının EDI uç noktasına gönderilir, hayır PDF Sistemler arası aktarım için gerekli olan sarmalayıcı (wrapper) yapısı.
  4. Slack üzerinden gelen bir bildirim EDI teslimatını doğruluyor; Airtable kaydı ise iş ortağı ve gönderim zaman damgasıyla güncelleniyor.

Sıkça Sorulan Sorular

What is ZUGFeRD and how does it differ from XRechnung and Factur-X?+
ZUGFeRD is the German hybrid e-invoicing standard: a PDF/A-3 archival-grade PDF with structured XML invoice data embedded inside as an attachment. Humans can read the PDF in any viewer; ERP systems and accounting software extract and process the XML automatically without manual data entry. XRechnung is the German public-sector profile, mandatory when invoicing federal, state, or municipal authorities, it can be issued as pure XML or as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the identical hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully interoperable for cross-border French-German invoicing. Use ZUGFeRD 2.x with EN16931 for general EU B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for international DACH-FR workflows.
Which ZUGFeRD Version should I choose in Zapier for the 2025 German B2B e-invoicing mandate?+
The German Wachstumschancengesetz (Growth Opportunities Act) made e-invoice receipt mandatory for all B2B transactions from 1 January 2025, with full sending obligations phasing in through 2028. ZUGFeRD 2.0 or higher with EN16931 or XRECHNUNG conformance is required to satisfy the mandate. ZUGFeRD 1.0 is legacy and does not comply. The Zapier action exposes 1.0 as a default in some installations: explicitly switch to 2.0+ for compliant production workflows. Confirm the exact version your trading partner or invoicing portal accepts; some larger enterprises and government portals may require version 2.2 or 2.4 specifically.
What is the difference between XmlWithPdf and XmlOnly output modes?+
XmlWithPdf generates the standard ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the structured XML invoice data embedded as an attachment inside the PDF. Humans read the PDF, machines parse the XML: one file serves both audiences and is the canonical ZUGFeRD format for B2B. XmlOnly generates a pure XML file with no PDF wrapper, used when the receiving system only ingests XML, typical for XRechnung pure-XML public-sector portals, EDI pipelines, or data-layer integration testing. Choose XmlWithPdf for production B2B invoicing; XmlOnly for pure-XML system integration or compliance submissions that explicitly require XML-only delivery.
Which Conformance Level should I pick: BASIC, COMFORT, EXTENDED, EN16931, or XRECHNUNG?+
Conformance levels differ by ZUGFeRD version. For ZUGFeRD 1.0: BASIC (minimum legal invoice with line items), COMFORT (additional reference data on top of BASIC), and EXTENDED (industry-specific fields beyond the baseline) are available. For ZUGFeRD 2.x: MINIMUM (header only, not a legal invoice: for internal use only), BASICWL (Basic Without Lines, adds VAT but no line items, for booking-only), BASIC (line items, minimum EU directive), EN16931 (European Standard full profile, recommended default for EU B2B), EXTENDED (industry-specific fields), and XRECHNUNG (German public-sector mandatory profile with stricter validation). Start with BASIC for ZUGFeRD 1.0 workflows and EN16931 for ZUGFeRD 2.x B2B. Switch to XRECHNUNG when invoicing German federal, state, or municipal authorities.
Can I generate ZUGFeRD invoices from CSV data, and how do CSV, JSON, and XML inputs compare?+
Yes. The Input Format parameter supports XML, JSON, and CSV: pick the format matching your data source. CSV is ideal for batch invoice exports from spreadsheets (Google Sheets, Excel), legacy ERP exports, or per-row billing workflows where each row represents one invoice. JSON is the modern choice when invoice data arrives from a webhook, REST API, or SaaS billing system that emits structured JSON payloads. XML is best when your ERP already produces ZUGFeRD or UBL XML that just needs wrapping in the hybrid PDF. The action automatically maps CSV columns or JSON fields to the ZUGFeRD XML schema before embedding in the output PDF, no manual XML construction is required for CSV or JSON paths. Critical: fill ONLY the data field matching your chosen Input Format. Mapping both Invoice Xml Data and Invoice Csv Data in the same run will fail the validation step.

İlgili Eylemler

Diğer Platformlarda Aynı Görev

Yardım Alın