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

Dropbox PDF + XML Dosyasından Power Automate'te ZUGFeRD Faturası Oluşturma: 5 Adımlı İş Akışı

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

Almanya'nın Büyüme Fırsatları Yasası ZUGFeRD tarzı hibrit e-faturaları "olması güzel bir özellik" olmaktan çıkarıp B2B için bir gereklilik haline getirdi. 1 Ocak 2025 Her Alman işletmesinin yapılandırılmış elektronik faturaları alabilmesi ve gönderim yükümlülüklerinin aşamalı olarak yerine getirilmesi gerekmektedir. 2028Herhangi bir Microsoft 365 ekibi için en hızlı yol, beş aşamalı bir Power Automate akışıdır: Manuel olarak tetikle → Dropbox Dosya içeriğini al (PDF) → Dropbox Dosya içeriğini al (XML) → PDF4me ZUGFeRD Faturası oluştur → Dropbox Dosya oluşturXML verisi bir dosyanın içine yerleştirilmiştir. PDF/A-3 Arşivleme kabuğu, insanların açtığı ve muhasebe sistemlerinin ayrıştırdığı tek bir dosya üretir. Bu kılavuz, tuvalde yakalanan ekran görüntülerinin aynısını kullanmaktadır: /pdf4metest/sample/10 page.pdf görsel taşıyıcı için ve /pdf4metest/zugfred invoice/version2.xml Yapılandırılmış veriler için, hibrit çıktı şu şekilde elde edilir: /pdf4meoutput Benzersiz bir GUID önekli ad altında. 10 dakikadan kısa sürede üretime hazır.

Akışa genel bakış
1. Manually trigger a flow
Manual trigger for testing. Swap for SharePoint When a file is created, Dropbox When a file is created, or any storage trigger in production.
2. Dropbox Get file content (PDF)
Reads the visual carrier from /pdf4metest/sample/10 page.pdf with Infer Content Type Yes. This is the PDF the recipient sees.
3. Dropbox Get file content (XML)
Reads the structured ZUGFeRD XML from /pdf4metest/zugfred invoice/version2.xml with Infer Content Type Yes. This is what accounting systems parse.
4. PDF4me Create ZUGFeRD Invoice
Combines both inputs as 2.0-XML format, XmlWithPdf output mode, BASIC conformance, Render Invoice on PDF Yes, Language de. Embeds the XML inside a PDF/A-3.
5. Dropbox Create file
Writes the hybrid file to /pdf4meoutput with guid()+headers/FileName so reruns never collide.
kısa versiyon

İki Dropbox dosya alma adımı, bir PDF4me işlemi, bir Dropbox dosya oluşturma adımı. PDF, insan tarafından okunabilir taşıyıcıdır; XML ise makine tarafından okunabilir veridir. PDF4me, her ikisini de 2025 Alman B2B e-fatura zorunluluğunu karşılayan tek bir PDF/A-3 hibrit dosyasına dönüştürür. Kod yok, masaüstü araçları yok, Java SDK yok.

Neden Odaklı Soru-Cevap​

ZUGFeRD'e neden ihtiyaç duyuluyor ki? AB genelindeki elektronik faturalama kuralları ve Almanya'nın Büyüme Fırsatları Yasası B2B için yapılandırılmış faturaları zorunlu hale getirdi. ZUGFeRD, her iki tarafı da çözen hibrit bir formattır: insanlar normal bir PDF elde ederken, AP ve ERP sistemleri aynı dosyanın içine yerleştirilmiş yapılandırılmış XML'i alır. Tek bir dosya, iki okuyucu.

Dosya içeriğini alma işleminde neden iki adım gerekiyor? Birincisi, taşıyıcı kabuk (alıcının açtığı sayfa) haline gelen görsel PDF'yi getirir; diğeri ise taşıyıcının içine yerleştirilen ek dosya haline gelen yapılandırılmış ZUGFeRD XML'ini getirir. Her iki çıktı da Create ZUGFeRD Invoice: PDF as fonksiyonuna beslenir. PDF Dosya İçeriğiXML olarak Fatura XML Verileri.

Birleşik açılır menüde neden "2.0-XML" var? 2025 Alman zorunluluğu için ZUGFeRD 2.0+ gereklidir (eski 1.0 sürümü bunu karşılamaz). "-XML" soneki, bağlantıya fatura yükünüzün zaten ZUGFeRD XML formatında olduğunu bildirir. Seçiniz 2.0-JSON veya 2.0-CSV Yapılandırılmış veri kaynakları için; bağlayıcı, yerleştirmeden önce bunları şemaya dönüştürür.

Neden XmlWithPdf ve değil Yalnızca XML? XmlWithPdf Standart ZUGFeRD hibritini döndürür: içine XML eklenmiş bir PDF/A-3 dosyası. Yalnızca XML Yalnızca XML döndürür. Giden faturalama senaryolarının çoğu, müşterilerin PDF açmayı beklemesi nedeniyle hibrit dosya gönderir; XmlOnly ise doğrudan ERP'den ERP'ye veri aktarımları içindir.

Neler Alacaksınız?​

Giriş: 10 sayfalık bir fatura PDF'si (görsel taşıyıcı) ve bir ZUGFeRD XML dosyası (yapılandırılmış veri). Çıktı: İçine XML'in yerleştirildiği, EN 16931 uyumlu, BASIC uyumlu, müşterilere e-posta ile gönderilmeye, SharePoint'e arşivlenmeye veya ERP sisteminize yüklenmeye hazır tek bir PDF/A-3 dosyası. Dropbox Dosya Oluşturma adımı bunu geri yazar. /pdf4meoutput eşsiz bir şekilde guid() + headers/FileName Eş zamanlı çalıştırmaların asla çakışmaması için isim verin.

İhtiyacınız Olanlar​

  • Güç Otomasyonu. Open Power AutomateYeni bir bulut akışı oluşturun (Anlık veya Otomatik).
  • PDF4me API anahtarı. API anahtarınızı alınZUGFeRD Faturası Oluşturma özelliğini eklerken bunu bağlayın. İlk defa mı kullanıyorsunuz? Bakın PDF4me'yi Power Automate'e bağlayın.
  • Dropbox (veya SharePoint, OneDrive). Kaynak PDF dosyasını, ZUGFeRD XML dosyasını ve çıktı klasörünü barındırır. Bu kılavuzda Dropbox kullanılmıştır.
  • Bir ZUGFeRD XML dosyasıEN 16931 standardına uygun. Depoda bir başlangıç şablonu bulunmaktadır. ZUGFeRD-fatura-örneği-2.0.xml; yeniden adlandır sürüm2.xml Ekran görüntülerinin birebir aynısını istiyorsanız.

Akışa Genel Bakış​

  1. Akışı manuel olarak tetikle (veya Bir dosya oluşturulduğunda (otomasyon için Dropbox'ta).
  2. Dropbox Dosya içeriğini al taşıyıcı için PDF (/pdf4metest/sample/10 page.pdf).
  3. Dropbox Dosya içeriğini al ZUGFeRD XML için (/pdf4metest/zugfred invoice/version2.xml).
  4. PDF4me ZUGFeRD Faturası Oluştur ile 2.0-XML, XmlWithPdf, BASIC, üzerinde görüntüle, dil de.
  5. Dropbox Dosya Oluştur ile /pdf4meoutput ile guid() + headers/FileName Çakışma içermeyen bir çıktı adı için.

Akışın genel görünümü​

Power Automate tuvalinde beş aşamalı ZUGFeRD akışı gösteriliyor: Akışı manuel olarak tetikle, Dosya içeriğini al (PDF), Dosya içeriği 1'i al (XML), ZUGFeRD Faturası oluştur, Dosya oluştur - hepsi Dropbox ve PDF4me simgeleriyle dikey olarak birbirine bağlı.

Yukarıdan aşağıya doğru sıralanmış beş adım. Her Dropbox işlemi mavi dosya içeriği simgesini gösterir; PDF4me ZUGFeRD Fatura Oluştur işlemi ortada yer alır. Her iki Dosya Al çıktısı da aynı PDF4me işlemine beslenir; PDF4me'nin Dosya İçeriği, Dosya Oluştur işlemine beslenir.

Adım 1: Akışı Başlatın​

  1. İçinde Güç Otomasyonu, tıklamak + Oluştur, seçmek Anlık bulut akışı.
  2. Adını koy Create ZUGFeRD Invoice from Dropbox, seçmek Akışı manuel olarak tetikle, tıklamak Yaratmak.
  3. Hareketli parçaların kablolarını bağladıktan sonra tetiği değiştirebilirsiniz. Bir dosya oluşturulduğunda Dropbox'ta (/pdf4metest/zugfred invoice/Bu nedenle, her yeni XML dosyası çalıştırmayı otomatik olarak tetikler. Sonraki işlemler aynı kalır, yeniden derleme gerekmez.

Adım 2: Taşıyıcı PDF dosyasını Dropbox'tan indirin.​

Şu ana kadarki akış: Tetikleyici → Dosya içeriğini al (PDF).

  1. Tıklamak + Yeni adım. Ara Dropbox, seçmek Yol kullanarak dosya içeriğini alİstenirse Dropbox hesabınıza giriş yapın.
  2. Dosya. /pdf4metest/sample/10 page.pdfBu, müşterinizin açtığı görsel faturadır.
  3. Gelişmiş parametreler → İçerik Türünü Çıkar. Evet (Power Automate, dosya uzantısını ve bayt sayısını kullanarak içerik türünü etiketler, böylece PDF4me bunun PDF verisi olduğunu anlar.)
  4. Kaydet. Çıktı Dosya İçeriği Bu, 4. adımda ZUGFeRD yerleştirme işlemi için kaynak PDF haline gelir.

Dosya içeriğini al (PDF): Yapılandırma​

Dosya içeriğini alma işlemi, Dosya olarak /pdf4metest/sample/10 page.pdf ve Gelişmiş parametreler altında İçerik Türünü Çıkarma seçeneği Evet olarak ayarlanmış şekilde ve Dropbox'a bağlı olarak gerçekleştiriliyor.

Taşıyıcı PDF dosyası şu adreste: /pdf4metest/sample/10 page.pdf. İçerik Türünü Çıkar Evet seçeneği, PDF4me'nin PDF/A-3'e dönüştürebileceği temiz PDF baytları döndürür.

3. Adım: ZUGFeRD XML dosyasını Dropbox'tan indirin.​

Şu ana kadarki akış: Dosya içeriğini al (PDF) → Dosya içeriğini al (XML).

  1. Tıklamak + Yeni adımBaşka bir tane ekle. Dropbox → Yol kullanarak dosya içeriğini al. Adını değiştirin. Dosya içeriğini al 1 (Power Automate bunu otomatik olarak yapar) böylece iki Dropbox işlemi birbirinden ayırt edilebilir.
  2. Dosya. /pdf4metest/zugfred invoice/version2.xmlBu, EN 16931 standardına uygun ZUGFeRD XML veri paketidir.
  3. Gelişmiş parametreler → İçerik Türünü Çıkar. Evet.
  4. Kaydet. Çıktı Dosya İçeriği PDF4me, bu yapılandırılmış fatura verilerini PDF/A-3 hibrit dosyasının içine yerleştirecektir.

Dosya içeriğini (XML) al: Yapılandırma​

Dosya içeriğini al 1 eylemi, Dosya olarak /pdf4metest/zugfred invoice/version2.xml ve Gelişmiş parametreler altında İçerik Türünü Çıkar seçeneği Evet olarak ayarlanmış, Dropbox'a bağlı.

ZUGFeRD XML yükü şu adreste: /pdf4metest/zugfred invoice/version2.xmlBu dosya ZUGFeRD 2.0 EN 16931 uyumluluğunda yer almaktadır; seçin 2.0-XML Eşleştirmek için bir sonraki hamle.

Bir ipucu için. XML dosyasını yerleştirmeden önce doğrulamanız mı gerekiyor? Bir hata ayıklama işlemi yapın. Bestelemek 3. ve 4. adımlar arasındaki eylemi inceleyin. Dosya İçeriği Çalıştırma geçmişinde. ZUGFeRD XML her zaman şununla başlar: <?xml version="1.0" ve içerir Sektörler Arası Fatura 2.x yükleri için root erişimi.

Adım 4: ZUGFeRD Faturasını Oluşturun​

Şu ana kadarki akış: Tetikleyici → PDF → XML → ZUGFeRD Faturası Oluştur.

  1. Tıklamak + Yeni adım, aramak PDF4me, seçmek ZUGFeRD Faturası OluşturDaha önce giriş yapmadıysanız, PDF4me API anahtarınızla giriş yapın.
  2. ZUGFeRD sürümü ve Giriş Formatı. 2.0-XMLBirleşik açılır menü, hem spesifikasyon sürümünü (2.0) hem de veri biçimini (XML) tek seferde seçer. "2.0" öneki, 2025 Alman B2B zorunluluğunu karşılamaktadır.
  3. Çıkış Modu. XmlWithPdfXML'i içine ekleyerek standart PDF/A-3 hibrit dosyasını döndürür.
  4. Fatura XML Verileri. Dosya İçeriği itibaren Dosya içeriğini al 1 (XML adımı). Sadece bu adımı eşleştirin. JSON veya CSV alanlarını doldurmayın.
  5. Uygunluk Seviyesi. BASICGiriş seviyesi profil, kalem kalem fiyatlandırma ve vergi dökümü ile en geniş alıcı uyumluluğunu sunar. Alıcı desteğini onayladıktan sonra COMFORT veya EXTENDED paketine geçebilirsiniz.
  6. Faturayı PDF olarak oluştur. YesPDF4me, verilerinizi kullanarak taşıyıcı PDF üzerindeki fatura içeriğini yeniden çizer, böylece görünür sayfa ve gömülü XML senkronize kalır.
  7. Dosya İçeriği. Dosya İçeriği itibaren Dosya içeriğini al (PDF adımı). Bu, taşıyıcı kılıftır.
  8. Dosya adı. abc.pdf (veya gerçek kaynak dosya adınız). İzleme bağlamı için kullanılır.
  9. Gelişmiş parametreler → Dil. de (Almanca etiketler). Kabul edilen diğer kodlar: en, fr, it, es, nl, pl, pt, cs.
  10. Kaydetmek.

ZUGFeRD Faturası Oluştur: Yapılandırma​

Gerekli temel alanlar
  • ZUGFeRD sürümü ve Giriş Formatı: 2.0-XML
  • Çıkış Modu: XmlWithPdf
  • Fatura XML VerileriXML'den Dosya İçeriği oluşturma adımı
  • Uygunluk Seviyesi: TEMEL
  • Faturayı PDF olarak oluştur: Evet
  • Dosya İçeriğiPDF'den Dosya İçeriğini Alma Adımı
  • Dosya adı: abc.pdf
Gelişmiş parametreler
  • Dil: ile ilgili (Almanca, varsayılan)
  • Kabul edildi: of, in, fr, it, es, nl, pl, pt, cs
  • XML dil açısından tarafsız kalır; yalnızca PDF üzerinde çizilen etiketler bu yerel ayarı kullanır.

Gerçekten kullanacağınız üç kombinasyon. 2.0-XML Üst sisteminiz zaten ZUGFeRD XML'i üretiyorsa. 2.0-JSON Faturalama platformunuz JSON formatını kullanıyorsa ve PDF4me'nin bunu ZUGFeRD şemasına dönüştürmesini istiyorsanız. 2.0-CSV Elektronik tablolar ve muhasebe araçlarından toplu dışa aktarımlar için. Her üçü de aynı hibrit çıktıyı üretir; aralarındaki tek fark sağladığınız veri biçimidir.

Adım 5: Hibrit PDF dosyasını Dropbox'a geri kaydedin.​

Şu ana kadarki akış: PDF → XML → ZUGFeRD Faturası Oluştur → Dosya Oluştur.

  1. Tıklamak + Yeni adım. Aramak Dropbox, seçmek Dosya oluştur.
  2. Klasör Yolu. /pdf4meoutput.
  3. Dosya adı. guid() + headers/FileName (ZUGFeRD Faturası Oluştur bölümünden). Doldurmanın iki yolu var:
    • İfade: concat(guid(), '_', outputs('Create_ZUGFeRD_Invoice')?['headers']?['FileName'])Ya da daha basitçe:
    • Dinamik içerik: tip guid() önce (İfade sekmesi), sonra ekleyin. headers/FileName PDF4me işlem çıktısından.
  4. Dosya İçeriği. Dosya İçeriği itibaren ZUGFeRD Faturası Oluştur.
  5. Akışı kaydedin.

Dosya oluştur (Dropbox): Yapılandırma​

Dosya yolu /pdf4meoutput, dosya adı PDF4me işleminden gelen dinamik içeriğin ardından guid() ifadesi olarak ayarlanmış dosya adı ve PDF4me çıktısından eşlenmiş dosya içeriği ile Dropbox dosya oluşturma işlemi gerçekleştirildi ve Dropbox'a bağlandı.

Çıktı şuraya yazıldı: /pdf4meoutput GUID önekli bir adla. GUID, paralel çalıştırmaları çakışmasız hale getirir; başlıklar/DosyaAdı Bu kısım, insan tarafından okunabilir bir sonek içerir.

Akışı Çalıştırın ve Doğrulayın​

  1. Tıklamak Test Sağ üstte, seçin Manuel olarak, tıklamak Test, Daha sonra Çalışma akışı.
  2. Birkaç saniye sonra her işlem yeşil bir onay işaretiyle görünür.
  3. Dropbox'ı açın /pdf4meoutputYeni dosya eşleşiyor. <guid>_<filename>.pdf.
  4. İndirin. Faturayı görmek için herhangi bir PDF görüntüleyiciyle açın. Gömülü içeriği görmek için ZUGFeRD uyumlu herhangi bir AP aracıyla açın (veya ZIP uyumlu bir araçla sıkıştırılmış dosyayı açın). factur-x.xml / zugferd.xml EK.

Peki, tam olarak ne ürettiniz? A PDF/A-3 arşivlenmiş PDF dosyası ile gömülü ZUGFeRD 2.0 EN 16931 XML dosyası. PDF sayfa sayısı ve görsel içeriği orijinal 10 sayfalık faturayla eşleşiyor (çünkü Faturayı PDF olarak oluştur (Evet idi). İçindeki XML, Alman B2B yönetmeliğinin yapılandırılmış veri gereksinimini karşılıyor. Tek dosya, iki okuyucu.

ZUGFeRD vs Factur-X vs XRechnung 30 Saniyede​

BiçimKullanıldığı yerÇıktı türü
ZUGFeRDGermany B2B, EU buyersHybrid PDF/A-3 + embedded XML (this blog)
Factur-XFrance, sister format technically identical to ZUGFeRD 2.xHybrid PDF/A-3 + embedded XML
XRechnungGerman public sector (federal, state, municipal)Strict pure-XML profile

Oluşturduğunuz iş akışı ZUGFeRD üretir; sıfır değişiklikle Factur-X iş akışına geçin (aynı hibrit dosya Ren Nehri'nin her iki yakasında da çalışır). Alman kamu sektörü faturalaması için, alıcı saf XML talep ettiğinde Uyumluluk Seviyesini XRechnung uyumlu bir profille değiştirin.

Yeniden derlemeye gerek kalmadan ekleyebileceğiniz yaygın varyasyonlar​

XML yerine JSON veya CSV kaynağı
3. adımı değiştirerek bir şey alın. .json veya .csv Dosya. Birleşik açılır menüyü değiştirin. 2.0-JSON veya 2.0-CSVEşleşenleri haritalandırın. Fatura JSON Verileri veya Fatura CSV Verileri PDF4me, gömme işleminden önce alanı ZUGFeRD şemasına dönüştürür.
Dropbox yerine SharePoint
Dropbox bağlantılarını şunlarla değiştirin: SharePoint'te yol kullanarak dosya içeriğini alma Ve SharePoint'te dosya oluşturmaAynı alan eşleştirmesi; yalnızca bağlantı yetkisi değişiyor. OneDrive for Business veya Azure Blob Storage ile aynı şekilde çalışır.
Outlook'ta Dosya Oluştur yerine (veya sonrasında) Gönder seçeneği kullanılır.
Eklemek Outlook E-posta Gönder (V2) Müşteri adresiyle birlikte. Harita Dosya İçeriği Ek içeriği olarak ve concat('Fatura-', utcNow(), '.pdf') Ek dosya adı olarak kullanılır. Müşteri hibrit faturayı doğrudan alır.
Arşivlemeden önce PDF/A dosyasını doğrulayın.
Zincir PDF4me PDF/A Doğrulama 4. adımdan sonra. Doğrulama başarılı olursa, uzun süreli arşive yazın; başarısız olursa, Teams uyarısına dönüştürün. Uyumluluk açısından hassas iş akışları için önlem.

Gerçek Hataların Giderilmesi​

1.0-XML seçildi, zorunluluk ihlali sonucu çıktı alındı.

ZUGFeRD 1.0, 2025 Alman B2B zorunluluğunu karşılamamaktadır. Çıktınızın zorunluluğa uygun olması gerekiyorsa, her zaman bir seçenek belirleyin. 2.0-* Birleşik açılır menüdeki kombinasyon.

Hem fatura XML verileri hem de fatura JSON verileri dolduruldu.

Yalnızca açılır menü seçiminizle eşleşen alanı eşleştirin. Power Automate her ikisini de doldurmanızı engellemez, ancak işlem çalıştırıldığında bir doğrulama hatası verecektir. Diğer biçimlendirme alanlarını boş bırakın.

Faturayı PDF olarak oluşturma kapalı + önceden oluşturulmuş görsel yok

İle Faturayı PDF olarak oluştur PDF4me, XML dosyasını yerleştirir ancak fatura içeriğini yeniden çizmez. Gönderdiğiniz kargo şirketi PDF'si Dosya İçeriği Olduğu gibi kalır. Yalnızca operatörünüzün PDF dosyasında fatura içeriği görsel olarak zaten gösteriliyorsa kapatın.

Alıcı tarafından UZATILMIŞ teklif reddedildi.

EXTENDED, EN 16931'in ötesinde sektöre özgü alanlar ekler ve temel standart için ayarlanmış alıcılar tarafından reddedilir. Başlangıç noktası olarak şunu kullanın: TEMEL Uyumluluk testleri için; yalnızca alıcı veya ERP desteği onayladığında bir üst seviyeye geçin.

Sonraki Adımlar​

ZUGFeRD Fatura işlem belgelerini oluşturun

PDF4me'yi Power Automate'e bağlayın

API anahtarınızı alın

Power Automate'te herhangi bir belge otomasyonu için aynı beş adımlı yöntem geçerlidir: tetikle, girdileri al, PDF4me eylemini çalıştır, sonucu yaz. Birini yayınladıktan sonra, sonraki sürümlerin maliyeti neredeyse sıfırdır.