Ana içeriğe geç

Power Automate'te ZUGFeRD Faturası Nasıl Oluşturulur? Dropbox + JSON Adım Adım İş Akışı.

· 14 dakikalık okuma
SEO and Content Writer

Bu kılavuz, her şeyi ayrıntılı olarak göstermektedir. Güç Otomasyonu bir şeyi okuyan bir iş akışı temel PDF Ve fatura JSON Dropbox'tan, bir şey oluşturur. ZUGFeRD/Factor-X fatura kullanarak PDF4me ZUGFeRD Faturası Oluşturve son dosyayı Dropbox'a geri yazar.

Ekran görüntüsü dizisi şu örnek yolları kullanır:

  • Temel PDF: /blog data/zugferd invoice/simplepdf.pdf
  • JSON: /blog data/zugferd invoice/sample-invoice.json
  • Çıktı klasörü: /blog data/zugferd invoice/output
kısa versiyon

1. Akışı manuel olarak tetikle → 2. Temel PDF Dosyasını İndir (Dropbox) → 3. JSON Dosyasını İndir (Dropbox) → 4. ZUGFeRD Faturası Oluştur (PDF4me, Giriş Formatı = JSON, Çıkış Modu = XML'li PDF) → 5. Dosyayı oluşturun (Dropbox çıktı klasörü).

4. adımı yapılandırırken bunu aklınızda bulundurun.

Ayarlamak Giriş Formatı = JSONo zaman sadece haritala Fatura JSON Verileri. Kale Fatura XML Verileri Ve Fatura CSV Verileri Bu çalıştırmada boş. İçin XML içeren PDF, PDF Dosya İçeriği Bu gereklidir ve temel PDF adımından gelmelidir.

Ne inşa ediyorsunuz?

Siz bir ürün üretiyorsunuz. hibrit fatura PDF Şablon bir PDF dosyasından ve yapılandırılmış JSON verilerinden oluşturulur. Çıktı, ZUGFeRD/Factur-X kurallarına göre paketlenmiş, makine tarafından okunabilir fatura verileri içeren okunabilir PDF çıktısına ihtiyaç duyan ekipler için uygundur.


Özetle: tüm beş adım

1Trigger
2Get PDF
3Get JSON
4Create ZUGFeRD
5Save output

Bu iş akışı düzeninin işe yaramasının nedenleri

Ayrı girişler

PDF ve JSON dosyaları birbirinden bağımsız olarak alınır, bu nedenle görsel PDF şablon akışına dokunmadan yük dosyalarını güncelleyebilirsiniz.

Tek nesillik adım

ZUGFeRD Faturası Oluştur İki içerik kaynağını tek bir yerden alır ve Dropbox tarafından doğrudan kullanılabilen bir dosya çıktısı döndürür. Dosya oluştur.

Sonradan dallanmak kolay

Oluşturma işleminden sonra, temel iş akışını yeniden yapılandırmadan doğrulama, bildirimler, ERP/API teslimatı veya arşiv yönlendirmesi ekleyebilirsiniz.


Başlamadan önce

Kontrol listesi

Bu kılavuzda kullanılan giriş dosyaları

ZUGFeRD Faturası Oluşturma işlemi için PDF girişi olarak kullanılan temel PDF belge önizlemesi.

Temel PDF giriş dosyası.

Fatura alanlarının ZUGFeRD üretimine nasıl eşlendiğini gösteren fatura JSON veri içeriği.

Fatura JSON veri girişi.


İş akışına genel bakış (beş adım)

  1. Akışı manuel olarak tetikleYapılandırma sırasında isteğe bağlı olarak çalıştırın.
  2. Temel PDF Dosyasını Al (Dropbox): Şablon PDF dosyasını okur.
  3. JSON Dosyasını Al (Dropbox): Fatura JSON baytlarını/içeriğini okur.
  4. ZUGFeRD Faturası Oluştur (PDF4me): JSON modunu kullanarak girdileri birleştirir.
  5. Dosya oluştur (Dropbox): Oluşturulan çıktıyı hedef klasöre kaydeder.

Akışa genel bakış

Power Automate akışı: Akışı manuel olarak tetikle, Temel PDF dosyasını al, JSON dosyasını al, ZUGFeRD faturası oluştur, Dosya oluştur

Bu ZUGFeRD üretim modeli için kullanılan eksiksiz akış zinciri.


Adım 1: Temel PDF Dosyasını İndirin (Dropbox)

Şu ana kadarki akış: Tetikleyici → Temel PDF Dosyasını Al.

  1. Eklemek Dropbox Dosya içeriğini yol üzerinden alma işlemi.
  2. Ayarlamak Dosya Yolu Temel şablon PDF'sine (örnek: /blog data/zugferd invoice/simplepdf.pdf).
  3. Gelişmiş seçeneklerde, saklayın İçerik Türünü Çıkar = Evet.
  4. Bu adımı kaydedin ve test edin; dosya içeriği/ikili çıktı döndürdüğünden emin olun.
Dropbox Get Base PDF File eylemi, dosya yolu, blog verileri, zugferd faturası, simplepdf.pdf ve İçerik Türünü Çıkarma Evet seçeneklerini gösteriyor.

1. Adım ekran görüntüsü: Temel PDF yolu ve içerik çıkarımı yapılandırılmış.


Adım 2: JSON Dosyasını İndirin (Dropbox)

Şu ana kadarki akış: Tetikleyici → Temel PDF'i Al → JSON Dosyasını Al.

  1. Başka bir Dropbox dosya içeriği işlemi ekleyin.
  2. Ayarlamak Dosya Yolu Fatura verilerinizin JSON formatına (örnek: /blog data/zugferd invoice/sample-invoice.json).
  3. Kale İçerik Türünü Çıkar = Evet.
  4. Kaydedin ve test edin; 3. adımda eşleme için JSON içeriğinin kullanılabilir olduğunu doğrulayın.
Dropbox Get JSON File eylemi, dosya yolu, blog verileri, zugferd fatura örneği (örnek fatura.json) ve İçerik Türünü Çıkarma Evet seçeneklerini gösteriyor.

2. Adım ekran görüntüsü: Dropbox'tan alınan JSON kaynak dosyası.


3. Adım: ZUGFeRD Faturası Oluşturun (PDF4me)

Şu ana kadarki akış: Tetikleyici → Temel PDF'i Al → JSON'u Al → ZUGFeRD Oluştur.

Yapılandır PDF4me, ZUGFeRD Faturası Oluştur Gösterildiği gibi:

  1. Dosya adı: kaynak PDF adı (örnek: Test.pdf).
  2. PDF Dosya İçeriği: haritadan Temel PDF Dosyasını Al.
  3. Çıktı Dosya Adı: istenen çıktı dosya adı (örnek: Zugferd Faturası.pdf).
  4. Giriş Formatı: ayarlandı JSON.
  5. Çıkış Modu: ayarlandı XML içeren PDF.
  6. Fatura JSON Verileri: haritadan JSON Dosyasını Al.
  7. Uygunluk Seviyesi: örnek: TEMEL.
  8. ZUGFeRD Versiyonu: örnek: 1.0 (veya ihtiyaç duyduğunuz sürüm).
  9. Faturayı PDF olarak oluştur: örnek: Evet.
ZUGFeRD Fatura oluşturma işlemi, Dosya Adı, PDF Dosya İçeriği, Çıktı Dosya Adı, Giriş Formatı JSON, Çıktı Modu PDF (XML ile), Fatura JSON Verileri, Uyumluluk BASIC, ZUGFeRD Sürüm 1.0, Faturayı PDF olarak oluşturma Evet seçeneklerini gösterir.

3. Adım ekran görüntüsü: JSON tabanlı ZUGFeRD oluşturma için tam parametre eşleştirmesi.


Adım 4: Dosya oluşturun (Dropbox)

Şu ana kadarki akış: Tetikle → PDF + JSON Oku → ZUGFeRD Oluştur → Dosyayı Kaydet.

  1. Eklemek Dropbox: Dosya oluştur.
  2. Klasör Yolu: çıktı hedef klasörü (örnek: /blog data/zugferd invoice/output).
  3. Dosya adı: çıktı dosya adını haritadan ZUGFeRD Faturası Oluştur.
  4. Dosya İçeriği: Oluşturulan dosya içeriğini haritadan ZUGFeRD Faturası Oluştur.
  5. Kaydedin ve tüm akışı çalıştırın.
Dropbox Dosya Oluşturma eylemi, klasör yolu, blog verileri, zugferd fatura çıktısı ve eşlenmiş dosya adı ve dosya içeriği ile ZUGFeRD Fatura Oluşturma işleminden elde edilir.

4. Adım ekran görüntüsü: Çıktı dosyasının Dropbox'a geri yazılması.


Çıktı doğrulama

Açık çıktı örnekleri
ZUGFeRD Faturası Oluşturma işleminden sonra oluşturulan ZUGFeRD faturasının PDF görsel çıktısı.

Oluşturulan faturanın PDF çıktısı.

Oluşturulan ZUGFeRD fatura PDF'sinde gömülü XML verilerini gösteren ekler paneliyle birlikte açılan çıktı.

Ekli dosya görünümünde, içine yerleştirilmiş yapılandırılmış fatura verileri gösterilmektedir.


Hızlı referans

#AdımTuş eşleme
1Get Base PDF FileFile path to template PDF + Infer Content Type = Yes
2Get JSON FileFile path to invoice JSON + Infer Content Type = Yes
3Create ZUGFeRD InvoicePDF File Content from step 1, Input Format = JSON, Invoice JSON Data from step 2
4Create fileFile Name and File Content from Create ZUGFeRD Invoice output

Derin parametre referansları: ZUGFeRD Faturası Oluştur, PDF'yi doğrula.


Sorun giderme

Giriş eşlemesi nedeniyle üretim başarısız oluyor.

Eğer Giriş Formatı = JSONsadece harita Fatura JSON VerileriBu çalıştırma için XML/CSV alanlarını temizleyin.

Çıkış modu uyumsuzluğu

İle XML içeren PDF, eksik PDF Dosya İçeriği Hatalara neden olur. Temel PDF adımından dosya baytlarını eşleştirin.

401, 402 veya bağlantı sorunları

Görmek PDF4me Sorun Giderme API anahtarı, krediler ve bağlantı yetkilendirme kontrolleri için.


Sırada ne denenecek?

İsteğe bağlı sertleştirme: ekleyin Durum 3. adımdan sonra çıktı varlığını kontrol edin, ardından son dosya yazma işleminden önce başarı/başarısızlık bildirimlerine dallanın.