ZUGFeRD SharePoint Listesinden E-Fatura: PDF4me ile Power Automate'te JSON'u EN 16931 XML ve PDF/A-3'e Dönüştürme

PDF4me Create ZUGFeRD Invoice fatura verilerini hibrit bir PDF/A-3 e-faturaya dönüştüren bir Power Automate eylemidir. Bir SharePoint listesine yönlendirilen bu eylem, Compose eyleminin her satırdan oluşturduğu JSON verilerini alır, EN 16931 XML'ini kendisi yazar, okunabilir faturayı temel PDF'nize çizer, sonucu dosyalar ve alıcıya e-posta ile gönderir.

ZUGFeRD arattığınızda üç yerden birine ulaşırsınız: formatın ne olduğuna dair bir açıklama, zaten sahip olduğunuz bir dosyanın doğru olup olmadığını söyleyen bir doğrulayıcı veya faturalama yazılımı geliştiren geliştiriciler için PHP, Java veya C#'ta yazılmış bir kütüphane. Üçü de faturanın zaten bir yerde mevcut olduğunu varsayar. Hiçbirinin cevaplamadığı soru, bir finans ekibinin aslında sorduğu sorudur: fatura verileri bir listede, bir elektronik tabloda veya satılanları kaydeden herhangi bir sistemde bulunur ve diğer uçtan uyumlu bir e-fatura olarak çıkması gerekir. Bu akış, yedi adımda ve kod yazmadan, eksik olan orta noktayı tamamlar.

Neden Odaklı Soru-Cevap​

Neler Alacaksınız?​

Girdi: Fatura numarası, tarihler, para birimi, satıcı bloğu, alıcı bloğu ve bir kalem içeren bir satır. Çıktı: ZUGFeRD Invoices kütüphanesinde ZUGFeRD PDF/A-3 faturası, durumu ve bağlantısıyla güncellenmiş satır ve faturanın ekli olduğu alıcıya gönderilen bir e-posta.

Fatura başına bir satır. Bu bölmedeki her sütun, akışın oluşturduğu JSON'da bir anahtar haline gelir.

Her fatura numarası için bir dosya, akış hesabı tarafından yazılır.

Alıcının gördüğü şekliyle, aynı dosyanın okunabilir yarısı.

İhtiyacınız Olanlar​

Akışa Genel Bakış​

1. When an item is created (SharePoint) ZUGFeRD Requests adlı listeyi izler.
2. Compose ilgili satırdan fatura JSON'unu oluşturur.
3. Dosya içeriğini /ZUGFeRD Templates/BaseInvoice.pdf Get file content using path.
4. Create ZUGFeRD Invoice (PDF4me PDF), JSON'u EN 16931 XML'e dönüştürür ve hibrit PDF döndürür.
5. Create file (SharePoint) işlemi, dosyayı ZUGFeRD_<invoice number>.pdf olarak kaydeder.
6. Update item (SharePoint), Status Generated olarak ayarlar ve OutputLink doldurur.
7. Send an email (V2) (Office 365 Outlook), faturayı alıcıya gönderir.

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

Baştan sona dört saniyeden biraz fazla sürüyor ve e-faturanın kendisi yaklaşık bir saniye sürüyor. En yavaş adım SharePoint'in dosyayı yazmasıdır.

Adım 1: Bir talep geldiğinde e-faturayı nasıl tetiklersiniz?​

Şu ana kadar olan süreç: henüz hiçbir şey olmadı, bu tetikleyici.

Bir satır eklemek, fatura talebinin yapılma şeklidir, dolayısıyla bu bir sinyaldir.

1. Automated cloud flow oluşturun ve SharePoint > When an item is created seçeneğini belirleyin.
2. Yapılandır:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • List Name: ZUGFeRD Requests

When an item is created: yapılandırma​

Yeni satırdaki her sütun, sonraki altı işlemin kullanabileceği bir belirteç haline gelir.

Adım 2: Liste sütunlarından fatura JSON'unu nasıl oluşturursunuz?​

Şu ana kadarki süreç: SharePoint tetikleyicisi.

Tek bir Compose işlemi, faturanın tamamını tanımlar. Bu aşamada sütun adlarınız, standartların beklediği adlarla eşleşir ve tek ekranda okunabilecek kadar kısadır.

1. Data Operation > Compose.
2. Aşağıdaki nesneyi Girişler alanına yapıştırın ve her değeri eşleşen belirteçle değiştirin.

{
  "InvoiceId": "@{triggerBody()?['InvoiceNumber']}",
  "TypeCode": "380",
  "InvoiceType": "RECHNUNG",
  "IssueDate": "@{triggerBody()?['InvoiceDate']}T00:00:00",
  "DeliveryDate": "@{triggerBody()?['InvoiceDate']}T00:00:00",
  "IsTest": false,
  "Seller": {
    "Name": "@{triggerBody()?['SellerName']}",
    "VatId": "@{triggerBody()?['SellerVATID']}",
    "Address": {
      "Street": "@{triggerBody()?['SellerStreet']}",
      "PostalCode": "@{triggerBody()?['SellerPostalCode']}",
      "City": "@{triggerBody()?['SellerCity']}",
      "Country": "@{triggerBody()?['SellerCountry']}"
    }
  },
  "Buyer": {
    "Name": "@{triggerBody()?['BuyerName']}",
    "Address": {
      "Street": "@{triggerBody()?['BuyerStreet']}",
      "PostalCode": "@{triggerBody()?['BuyerPostalCode']}",
      "City": "@{triggerBody()?['BuyerCity']}",
      "Country": "@{triggerBody()?['BuyerCountry']}"
    }
  },
  "LineItems": [
    {
      "ProductName": "@{triggerBody()?['ItemDescription']}",
      "Quantity": @{triggerBody()?['Quantity']},
      "UnitCode": "C62",
      "UnitPrice": @{triggerBody()?['UnitPrice']},
      "LineTotal": @{float(...)}
    }
  ],
  "Totals": {
    "Currency": "@{triggerBody()?['Currency']?['Value']}",
    "LineTotal": @{float(...)},
    "TaxBasisTotal": @{float(...)},
    "TaxPercent": @{triggerBody()?['VATRate']},
    "TaxTotal": @{float(...)},
    "GrandTotal": @{float(...)},
    "ChargeTotal": 0,
    "AllowanceTotal": 0
  },
  "Payment": {
    "Currency": "@{triggerBody()?['Currency']?['Value']}",
    "PaymentReference": "@{triggerBody()?['InvoiceNumber']}",
    "DueDate": "@{triggerBody()?['DueDate']}T00:00:00"
  }
}

Compose: yapılandırma​

Metin değerleri tırnak içinde belirteçlerdir. Para ve miktarlar ise çıplak sayılardır, bu yüzden float türünde işlem görürler.

Faturanın her bir bölümünün nereden geldiği​

3. Adım: Temel PDF dosyası nereden geliyor?​

Şu ana kadarki akış: tetikleyici artı Compose.

ZUGFeRD dosyalarının okunabilir bir sayfası vardır ve bu sayfa buradan başlar.

1. SharePoint > Get file content using path ekleyin.
2. Yapılandır:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • File Path: /ZUGFeRD Templates/BaseInvoice.pdf
   • Infer content type (gelişmiş): Yes

Get file content using path: yapılandırma​

Antetli kağıdınızı bu dosyada saklayın. Her çalıştırmada yeniden okunur, bu nedenle üzerinde değişiklik yapılması bir sonraki faturayı da etkiler.

Adım 4: JSON verilerini ZUGFeRD PDF/A-3 formatına nasıl dönüştürürsünüz?​

Şu ana kadarki akış: tetikleyici, Compose ve Get file content using path.

Bu işlem, elektronik faturayı oluşturur. JSON dosyasını okur, EN 16931 XML formatını kendisi yazar ve her iki parçayı da içeren tek bir dosya olarak geri gönderir.

1. PDF4me PDF bağlantısından Create ZUGFeRD Invoice ekleyin.
2. Yapılandır:
   • ZUGFeRD version and Input Format: 2.0-JSON
   • Output Mode: XmlWithPdf
   • Invoice JSON Data: base64(outputs('Compose')) ifadesi
   • Conformance Level: EN16931
   • Render Invoice on PDF: Yes
   • File Content: Get file content using path içeriğe uygulanan bir base64() ifadesi
   • File Name: BaseInvoice.pdf

Create ZUGFeRD Invoice: yapılandırma​

Giriş formatı, hangi veri alanının görüneceğini belirler. 2.0-JSON seçerseniz, işlem Invoice XML Data Invoice JSON Data isteyecektir.

Her ayarın neye karar verdiği​

Adım 5: Fatura nereye kaydedilecek?​

Şu ana kadarki süreç: Her şey Create ZUGFeRD Invoice aşamasından geçiyor.

Dosya adı, dosyanın adını belirler ve bu sayede kütüphanede arama yapılabilirliği sağlanır.

1. SharePoint ekle > Create file.
2. Yapılandır:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • Folder Path: /ZUGFeRD Invoices
   • File Name: ZUGFeRD_ ardından InvoiceNumber belirteci ve .pdf
   • File Content: Create ZUGFeRD Invoice işleminden Body belirteci

Create file: yapılandırma​

RE-2026-0007 için bu ZUGFeRD_RE-2026-0007.pdf olarak yazılır.

Adım 6: Sonucu istek üzerine nasıl kaydedersiniz?​

Şu ana kadarki süreç: Her şey Create file aşamasından geçiyor.

Faturayı isteyen satırda, faturanın akıbeti de belirtilmelidir.

1. SharePoint ekle > Update item.
2. Yapılandır:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • List Name: ZUGFeRD Requests
   • Id: Tetikleyiciden gelen ID belirteci
   • Title: Tetikleyiciden gelen Title belirteci
   • Status Value (gelişmiş): Generated
   • OutputLink (gelişmiş): Kütüphane URL'si, ardından ZUGFeRD_, InvoiceNumber belirteci ve .pdf

Update item: yapılandırma​

Bağlantı, kütüphane URL'sinden ve aynı ad kalıbı kullanılarak Create file; kütüphane adındaki boşluk zaten %20 olarak kodlanmıştır.

Adım 7: Faturayı alıcıya nasıl gönderirsiniz?​

Şu ana kadarki süreç: Her şey Update item üzerinden ilerliyor.

Kütüphanede kalan bir elektronik fatura henüz düzenlenmemiştir, bu nedenle son işlem onu teslim eder.

1. Office 365 Outlook > Send an email (V2) ekleyin.
2. Yapılandır:
   • Kime: Tetikleyiciden gelen Email belirteci
   • Konu: Your ZUGFeRD e-invoice ve ardından InvoiceNumber belirteci
   • Body: Alıcının ve faturanın adını belirten ve dosyanın EN 16931 XML gömülü bir PDF/A-3 dosyası olduğunu söyleyen bir satır
3. Advanced parameters açın ve eki ekleyin:
   • Attachments Adı - 1: ZUGFeRD_ artı InvoiceNumber belirteci artı .pdf
   • Attachments İçeriği - 1: Create ZUGFeRD Invoice işleminden File Content İçeriği belirteci
   • Importance: Normal

Send an email (V2): yapılandırma​

Ek dosya, kendisini oluşturan işlemden baytlarını alır, bu nedenle SharePoint hiçbir zaman geri okunmaz.

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

1. Akışı Save.
2. ZUGFeRD Requests alıcıyı, tek bir kalem öğesini, her iki tarihi ve kontrol edebileceğiniz bir adresi içeren bir satır ekleyin.
3. Koşu geçmişini açın. Yedi işlemin tamamı yeşil renkte olmalı ve tüm koşu birkaç saniye sürmelidir.
4. ZUGFeRD Invoices kütüphanesini açın ve dosyanın fatura numarası altında mevcut olup olmadığını kontrol edin.
5. Önceki satıra geri dönün: Status Generated olarak görünmeli ve OutputLink faturayı açmalıdır.
6. E-postadaki eki açın ve her iki bölümü de kontrol edin: sayfada doğru miktarlar gösterilmeli ve dosya içinde XML verileri bulunmalıdır.

Yakalanan işlem toplamda yaklaşık dört saniye sürdü ve e-fatura da bu süre içinde oluşturuldu. Sonuç olarak, ZUGFeRD_RE-2026-0007.pdf yaklaşık 331 KB boyutunda olup Almanca bir fatura olarak görüntülenir: satıcı Berlin bulunan Muster GmbH (KDV ID DE123456789), müşteri Muenchen bulunan Test Kunde AG, belge türü 380, %19 KDV'li tek satırlık Consulting, net 1.005,00 EUR, KDV 190,95 EUR ve toplam 1.195,95 EUR.

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

Bu, ZUGFeRD faturası oluşturmanın diğer yöntemleriyle nasıl karşılaştırılır?​

Her satır alternatifi açıklıyor. Son satır ise bu akışı gösteriyor.

Sıkça sorulan sorular​

ZUGFeRD faturası nedir?​

ZUGFeRD faturası, iki şekilde çalışan tek bir dosyadır. Açılıp okunabilen normal bir PDF dosyasıdır ve içinde aynı faturayı yapılandırılmış veri olarak içeren bir XML eki bulunur. Alıcının muhasebe sistemi XML dosyasını okur ve faturayı kimsenin elle yazmasına gerek kalmadan kaydederken, ödeme departmanındaki kişi yine de bir sayfa görür.

Bu format, elektronik faturalama için Alman forumu olan FeRD geliyor ve Fransız muadili de aynı fikri farklı bir isim altında sunan Factur-X.

ZUGFeRD formatı nedir?​

Teknik olarak, bu Cross Industry Invoice sözdiziminde gömülü bir XML dosyası ve verilerin ne kadar eksiksiz olduğunu belirten bir profil içeren bir PDF/A-3 konteyneridir. Burada kullanılan profil, e-faturalama için Avrupa semantik standardına karşılık gelen EN16931: EN 16931 bir faturanın çekirdeği olarak tanımladığı alanlar kümesi.

Otomasyonun pratik sonucu, çıktının sayfa üzerinde değil, XML üzerinde değerlendirilmesidir. Profilin istediği verileri sağlarsanız dosya onaylanır; sayfayı daha güzel hale getirirseniz hiçbir şey değişmez.

ZUGFeRD faturası nasıl oluşturulur?​

Üç şeye ihtiyacınız var: yapılandırılmış biçimde fatura verileri, insan tarafından yazılacak bir sayfa ve XML'i PDF/A-3 eki olarak PDF'ye yazan bir araç.

Bu akışta veriler JSON'a dönüştürülmüş bir SharePoint satırıdır, sayfa BaseInvoice.pdf ve Create ZUGFeRD Invoice üçüncü kısmı XmlWithPdf Output Mode ile gerçekleştirir. Verileriniz zaten Cross Industry Invoice XML'i veya CSV satırı olarak mevcutsa, giriş biçimini değiştirin ve bunun yerine onu besleyin. Akışın geri kalanı değişmez.

ZUGFeRD ve XRechnung arasındaki fark nedir?​

İkisi de aynı Avrupa standardını karşılıyor ve aralarındaki fark ambalajda. ZUGFeRD hibrit bir format: içinde XML bulunan okunabilir bir PDF; bu da faturaların elle açılmasını bekleyen müşterilere gönderilmesi için uygun. XRechnung ise yalnızca XML formatında ve Alman kamu sektörü alıcılarının talep ettiği format.

Kurumsal firmalara gönderim yapıyorsanız, hibrit dosya genellikle daha güvenli bir seçenektir çünkü dosyayı açan herkes tarafından okunabilir. Kamu kurumlarına fatura kesiyorsanız, göndermeden önce ilgili kurumun hangi formatı gerektirdiğini kontrol edin.

Sorun giderme​

Sonraki Adımlar​

Alıcılarınızın nihayetinde hangi formata ihtiyaç duyarsa duysun, her e-fatura zorunluluğu aslında aynı yedi adımlı süreci (bir satır gelir, fatura veri olarak tanımlanır, bir dosya oluşturulur, arşivlenir, kaydedilir ve gönderilir) gerektirir.