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

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
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ü).
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
Bu iş akışı düzeninin işe yaramasının nedenleri
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.
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.
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
- Güç Otomasyonu Bulut akışları oluşturma iznine sahip ortam.
- PDF4me API anahtarıİlk kurulum: PDF4me'yi Power Automate'e bağlayın.
- Kaynak dosyalara okuma erişimi ve çıktı klasörüne yazma erişimi sağlayan Dropbox bağlantısı.
- Dropbox'ta geçerli bir fatura JSON verisi ve temel bir PDF dosyası bulunmalıdır.
Bu kılavuzda kullanılan giriş dosyaları

Temel PDF giriş dosyası.

Fatura JSON veri girişi.
İş akışına genel bakış (beş adım)
- Akışı manuel olarak tetikleYapılandırma sırasında isteğe bağlı olarak çalıştırın.
- Temel PDF Dosyasını Al (Dropbox): Şablon PDF dosyasını okur.
- JSON Dosyasını Al (Dropbox): Fatura JSON baytlarını/içeriğini okur.
- ZUGFeRD Faturası Oluştur (PDF4me): JSON modunu kullanarak girdileri birleştirir.
- Dosya oluştur (Dropbox): Oluşturulan çıktıyı hedef klasöre kaydeder.
Akışa genel bakış

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.
- Eklemek Dropbox Dosya içeriğini yol üzerinden alma işlemi.
- Ayarlamak Dosya Yolu Temel şablon PDF'sine (örnek:
/blog data/zugferd invoice/simplepdf.pdf). - Gelişmiş seçeneklerde, saklayın İçerik Türünü Çıkar = Evet.
- Bu adımı kaydedin ve test edin; dosya içeriği/ikili çıktı döndürdüğünden emin olun.

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.
- Başka bir Dropbox dosya içeriği işlemi ekleyin.
- Ayarlamak Dosya Yolu Fatura verilerinizin JSON formatına (örnek:
/blog data/zugferd invoice/sample-invoice.json). - Kale İçerik Türünü Çıkar = Evet.
- Kaydedin ve test edin; 3. adımda eşleme için JSON içeriğinin kullanılabilir olduğunu doğrulayın.

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:
- Dosya adı: kaynak PDF adı (örnek:
Test.pdf). - PDF Dosya İçeriği: haritadan Temel PDF Dosyasını Al.
- Çıktı Dosya Adı: istenen çıktı dosya adı (örnek:
Zugferd Faturası.pdf). - Giriş Formatı: ayarlandı JSON.
- Çıkış Modu: ayarlandı XML içeren PDF.
- Fatura JSON Verileri: haritadan JSON Dosyasını Al.
- Uygunluk Seviyesi: örnek: TEMEL.
- ZUGFeRD Versiyonu: örnek: 1.0 (veya ihtiyaç duyduğunuz sürüm).
- Faturayı PDF olarak oluştur: örnek: Evet.

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.
- Eklemek Dropbox: Dosya oluştur.
- Klasör Yolu: çıktı hedef klasörü (örnek:
/blog data/zugferd invoice/output). - Dosya adı: çıktı dosya adını haritadan ZUGFeRD Faturası Oluştur.
- Dosya İçeriği: Oluşturulan dosya içeriğini haritadan ZUGFeRD Faturası Oluştur.
- Kaydedin ve tüm akışı çalıştırın.

4. Adım ekran görüntüsü: Çıktı dosyasının Dropbox'a geri yazılması.
Çıktı doğrulama
Açık çıktı örnekleri

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

Ekli dosya görünümünde, içine yerleştirilmiş yapılandırılmış fatura verileri gösterilmektedir.
Hızlı referans
| # | Adım | Tuş eşleme |
|---|---|---|
| 1 | Get Base PDF File | File path to template PDF + Infer Content Type = Yes |
| 2 | Get JSON File | File path to invoice JSON + Infer Content Type = Yes |
| 3 | Create ZUGFeRD Invoice | PDF File Content from step 1, Input Format = JSON, Invoice JSON Data from step 2 |
| 4 | Create file | File Name and File Content from Create ZUGFeRD Invoice output |
Derin parametre referansları: ZUGFeRD Faturası Oluştur, PDF'yi doğrula.
Sorun giderme
Eğer Giriş Formatı = JSONsadece harita Fatura JSON VerileriBu çalıştırma için XML/CSV alanlarını temizleyin.
İle XML içeren PDF, eksik PDF Dosya İçeriği Hatalara neden olur. Temel PDF adımından dosya baytlarını eşleştirin.
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.