Faktur Elektronik ZUGFeRD dari Airtable di Zapier: Saring Baris, Buat JSON, Kirim PDF Hibrida melalui Email

PDF4me Create ZUGFeRD Invoice adalah aksi Zapier yang mengubah data faktur terstruktur menjadi faktur elektronik hibrida PDF/A-3. Dengan membaca satu baris Airtable, aksi ini mengubah objek JSON menjadi XML EN 16931 yang disematkan dalam PDF yang dapat dibaca, menulis kembali file tersebut ke dalam catatan, dan mengirimkannya melalui email kepada pembeli.

Mandat faktur elektronik muncul sebagai masalah format file dan dijawab sebagai masalah pengadaan: pilih platform, bayar per dokumen, migrasikan data Anda ke dalamnya. Jawaban itu masuk akal dalam skala besar dan tidak masuk akal untuk tim yang menerbitkan dua puluh faktur per bulan dari basis data yang sudah mereka jalankan. Alternatifnya bukanlah menulis XML secara manual. Alternatifnya adalah mendeskripsikan faktur sebagai JSON dan membiarkan sesuatu yang lain menghasilkan file yang sesuai.

Tanya Jawab Berbasis Alasan​

Apa yang Akan Anda Dapatkan​

Input: sebuah baris Airtable berisi nomor faktur, tanggal, blok penjual dengan ID PPN, blok pembeli, satu item baris, dan total, dengan Status diatur ke New. Output: sebuah PDF/A-3 ZUGFeRD pada catatan tersebut dan di kotak masuk pembeli.

Satu baris per faktur. Setiap kolom di sini menjadi kunci dalam JSON yang dikirim oleh Zap.

Pembeli melihat faktur. Sistem akuntansi mereka melihat XML di dalamnya.

Apa yang Anda Butuhkan​

Sekilas tentang Zap​

1. New Record (Airtable) dijalankan setiap kali ada baris baru dalam ZUGFeRD Requests.
2. Filter conditions (Filter by Zapier) hanya berlanjut jika Status persisnya adalah New.
3. Create ZUGFeRD Invoice (PDF4me) mengkonversi JSON menjadi PDF hibrida.
4. Update Record (Airtable) menulis file, status, dan tautan kembali ke baris tersebut.
5. Send Email (Gmail) mengirimkan faktur elektronik kepada pembeli.

Gambaran umum Zap secara lengkap​

Bentuknya sama seperti QR Zap Swiss yang terdiri dari lima langkah. Hanya langkah PDF4me di tengah yang berbeda.

Langkah 1: Bagaimana cara memicu Zap dari baris Airtable baru?​

Alur sejauh ini: belum ada apa-apa, ini pemicunya.

1. Buat Zap dan pilih Airtable > New Record.
2. Pilih PDF4me Live Automations Base dan Table ZUGFeRD Requests.
3. Tes. Zapier melaporkan " Ditemukan 1 catatan baru di Airtable dan kolom-kolom tersebut tersedia di hilir.

Label jajak pendapat bertuliskan 2 menit, yang berasal dari rencana dan bukan dari langkah ini.

Langkah 2: Bagaimana cara menghentikan Zap dalam membuat faktur untuk baris yang belum selesai?​

Alur sejauh ini: pemicu Airtable.

1. Tambahkan Filter by Zapier > Only continue if....
2. Buat satu aturan: 1. Status / (Teks) Exactly matches / New.
3. Cobalah.

Konfigurasi Filter conditions​

Kotak hijau menunjukkan kolom yang meloloskan rekaman tersebut. Kotak kuning yang setara menunjukkan kolom yang menghentikannya.

Langkah 3: Bagaimana cara mengubah baris tersebut menjadi faktur ZUGFeRD?​

Alur sejauh ini: pemicu dan filter.

1. Tambahkan PDF4me > Create ZUGFeRD Invoice.
2. Atur opsi output:
   • File Name: ZUGFeRD_ ditambah Invoice Number ditambah .pdf
   • Input Format: JSON
   • Output Mode: XmlWithPdf
   • Zugferd Version: 2+
   • Conformance Level: EN16931
   • Render Invoice On Pdf: True
   • Biarkan File kosong kecuali Anda menyediakan halaman kop surat sendiri.
3. Tempelkan objek tersebut ke dalam Invoice Json Data dan petakan setiap kolom Airtable ke dalamnya:

{
  "InvoiceId": "{{Invoice Number}}",
  "TypeCode": "380",
  "InvoiceType": "RECHNUNG",
  "IssueDate": "{{Invoice Date}}T00:00:00",
  "DeliveryDate": "{{Invoice Date}}T00:00:00",
  "IsTest": false,
  "Seller": {
    "Name": "{{Seller Name}}",
    "VatId": "{{Seller VATID}}",
    "Address": {
      "Street": "{{Seller Street}}",
      "PostalCode": "{{Seller Postal Code}}",
      "City": "{{Seller City}}",
      "Country": "{{Seller Country}}"
    }
  },
  "Buyer": {
    "Name": "{{Buyer Name}}",
    "Address": {
      "Street": "{{Buyer Street}}",
      "PostalCode": "{{Buyer Postal Code}}",
      "City": "{{Buyer City}}",
      "Country": "{{Buyer Country}}"
    }
  },
  "LineItems": [
    {
      "ProductName": "{{Item Description}}",
      "Quantity": {{Quantity}},
      "UnitCode": "C62",
      "UnitPrice": {{Unit Price}},
      "LineTotal": {{Net Total}}
    }
  ],
  "Totals": {
    "Currency": "{{Currency}}",
    "LineTotal": {{Net Total}},
    "TaxBasisTotal": {{Net Total}},
    "TaxPercent": {{VAT Rate}},
    "TaxTotal": {{VAT Amount}},
    "GrandTotal": {{Gross Total}},
    "ChargeTotal": 0,
    "AllowanceTotal": 0
  },
  "Payment": {
    "Currency": "{{Currency}}",
    "PaymentReference": "{{Invoice Number}}",
    "DueDate": "{{Due Date}}T00:00:00"
  }
}

Ada tiga bagian yang perlu diperhatikan. TypeCode 380 adalah kode untuk faktur komersial dan bersifat tetap. UnitCode C62 adalah kode UN/ECE untuk "satu dari sesuatu", yang Anda butuhkan untuk jam atau unit layanan. Dan PaymentReference di blok Payment adalah teks yang dikutip pembeli saat membayar, yang di sini hanyalah nomor faktur.

Create ZUGFeRD Invoice​

Setiap nilai adalah token Airtable. Perhatikan VAT Amount 190,95 dan Gross Total 1195,95, meskipun tabel menampilkannya sebagai 191 dan 1196.

Apa yang diputuskan oleh setiap pengaturan​

Langkah 4: Bagaimana cara Anda mencatat faktur ke dalam arsip?​

Alur sejauh ini: semuanya melalui langkah PDF4me.

1. Tambahkan Airtable > Update Record.
2. Konfigurasi:
   • Basis PDF4me Live Automations, Meja ZUGFeRD Requests
   • Record: ID dari pemicu
   • Append attachments: False
   • Document: File Url dari langkah 3
   • Status: Generated
3. Biarkan setiap kolom kedua kosong agar tidak ada yang tertimpa.

Konfigurasi Update Record​

Peringatan di bagian atas adalah yang paling penting untuk dibaca. Semua yang ada di bawahnya sengaja dikosongkan.

Langkah 5: Bagaimana cara Anda mengirimkan faktur elektronik kepada pembeli?​

Alur sejauh ini: semuanya melalui pembaruan catatan.

1. Tambahkan Gmail > Send Email.
2. Konfigurasi:
   • To: kolom Email dari pemicu
   • Subject: Your e-invoice beserta Invoice Number
   • Body type: Html
   • Body: salam singkat yang menyebutkan nama pembeli, nomor faktur, dan total.
   • Attachments: File Url dari langkah 3

Konfigurasi Send Email​

Lampiran tersebut adalah File Url yang sama yang ditulis pada langkah 4 ke Airtable, sehingga catatan dan email selalu membawa file yang sama.

Jalankan Zap dan Verifikasi​

1. Publish Zap tersebut.
2. Tambahkan baris ke ZUGFeRD Requests dengan penjual, pembeli, satu item baris, kedua tanggal, dan Status New.
3. Tunggu hasil jajak pendapat. Kelima langkah tersebut seharusnya berwarna hijau.
4. Buka baris tersebut: Document harus berisi PDF yang diberi nama sesuai nomor faktur, dan Status harus bertuliskan Generated.
5. Buka lampirannya. Anda akan melihat halaman faktur yang dapat dibaca, dan validator ZUGFeRD akan menemukan XML EN 16931 di dalam file yang sama.
6. Tambahkan baris dengan Status Generated dan konfirmasikan bahwa Zap berhenti di langkah 2.

Dalam proses yang terekam, versi 1 berhasil diselesaikan pada 24 Oktober 2026 pukul 00:09:01, menghasilkan ZUGFeRD_RE-2026-0011.pdf untuk faktur dari Muster GmbH di Berlin kepada Test Kunde AG di Muenchen, sepuluh unit Consulting dengan harga 100,50, total 1195,95 EUR.

Variasi Umum yang Dapat Anda Tambahkan Tanpa Membangun Ulang​

Bagaimana perbandingannya dengan cara lain dalam menerbitkan faktur elektronik?​

Setiap baris menjelaskan alternatifnya. Baris terakhir adalah Zap ini.

Kami juga membangunthe identical flow in Make Perbedaannya kecil namun nyata: Make memfilter di dalam pemicu secara gratis sedangkan Zapier menghabiskan satu langkah, Make membutuhkan parseNumber di sekitar setiap nilai uang sedangkan Zapier memetakannya langsung, dan Make mengunggah file sebagai byte sedangkan Zapier memberikan URL Airtable.

Pertanyaan umum​

Apa itu e-invoicing?​

E-invoicing berarti menerbitkan faktur sebagai data terstruktur yang dapat dibaca oleh mesin, bukan sebagai gambar halaman. Sistem akuntansi pembeli akan menguraikannya dan mencatatnya tanpa perlu diketik ulang oleh siapa pun, dan itulah intinya: penghematan ada di pihak penerima, bukan di pihak Anda.

Semakin banyak yurisdiksi yang kini mewajibkannya untuk perdagangan bisnis dan sektor publik.European standard EN 16931 mendefinisikan kumpulan bidang inti, dan format seperti ZUGFeRD mengimplementasikannya.

Apa itu faktur elektronik?​

Intinya sama. Istilah "faktur elektronik" cenderung digunakan dalam perundang-undangan, sedangkan "e-invoicing" digunakan dalam pemasaran produk, dan keduanya merujuk pada data faktur yang terstruktur dan dapat dibaca mesin, bukan PDF yang dilampirkan pada email.

Penting untuk memperjelas apa yang tidak termasuk: faktur kertas yang dipindai bukanlah faktur elektronik, dan PDF biasa juga bukan. Tanpa data terstruktur yang tertanam, penerima masih harus membacanya.

Bisakah Airtable membuat faktur?​

Yang tidak sesuai standar. Airtable menyimpan data dan dapat menampilkannya dalam antarmuka atau tampilan yang dapat dicetak, tetapi tidak dapat menghasilkan PDF/A-3 yang memuat XML sesuai standar EN 16931, yang merupakan persyaratan yang diminta.

Pembagian yang digunakan Zap ini adalah pembagian yang praktis: Airtable adalah rekaman, PDF4me menghasilkan artefak, dan artefak tersebut dikembalikan ke rekaman sebagai lampiran.

Bagaimana cara kerja otomatisasi pembayaran hutang?​

Tiga bagian: penerimaan, ekstraksi, dan posting. Penerimaan mengumpulkan dokumen di satu tempat, ekstraksi mengubahnya menjadi kolom, posting menulis kolom-kolom tersebut ke dalam buku besar dengan gerbang persetujuan di depannya.

Faktur elektronik hibrida menghilangkan bagian tengah. Ketika XML sudah ada di dalam file, ekstraksi menjadi penguraian (parsing) dan bukan pengenalan (recognition), dan itulah mengapa peraturan terus mendorong ke arah ini. Zap ini adalah bagian pengiriman dari pengaturan tersebut.

Penyelesaian Masalah​

Langkah Selanjutnya​

Mandat tampak seperti masalah format, padahal sebenarnya masalah data. Jika faktur sudah ada sebagai baris data, sebagian besar pekerjaan sudah selesai.