n8n'de İsviçre QR Faturası Oluşturma: İki Tam İş Akışı (Mevcut PDF ile ve PDF Olmadan)
Her İsviçre faturasında şu unsur bulunmalıdır: İsviçre QR Banknotu (İsviçre QR ödeme fişi olarak da adlandırılır) bankaların ve muhasebe yazılımlarının ödemeyi otomatik olarak tarayıp işleyebilmesi için kullanılır. n8n ve PDF4me bu oluşturma işlemini tamamen otomatik hale getirir. Bu kılavuz, bu işlemi adım adım açıklamaktadır. iki üretime hazır iş akışıİki seçenek mevcut: Biri QR kodunu Dropbox'ta zaten bulunan bir PDF dosyasının üzerine yerleştiriyor, diğeri ise arka plan PDF dosyasına gerek kalmadan yalnızca ödeme verilerinden bağımsız bir QR fatura belgesi oluşturuyor. Her ikisinin de kurulumu 10 dakikadan kısa sürüyor.
İş akışı A: Tetikleyici çalışıyor. Dropbox İndirme işlemi verileri alıyor. Test Borç AG.pdf (344 kB). PDF4me Create SwissQR Bill runs with Giriş Veri Türü: İkili VeriMiktar 1000, CHF, IBAN CH0200700110003765824Alacaklı: Test AG. Çıktı: swissqr_bill.pdf 602 kB boyutunda. Dropbox Yükleme sonucu kaydeder.
İş akışı B: Tetik ateşleniyor. PDF4me SwissQR Faturası Oluşturma işlemi şu şekilde gerçekleşiyor: Giriş Veri Türü: YokAynı ödeme alanları artı tam yapılandırılmış alacaklı adresi. Çıktı şu şekildedir: n8n_swissqr02.pdf 132 kB boyutunda. Dropbox Yükleme sonucu kaydeder.
O Giriş Veri Türü PDF4me düğümündeki alan, iki iş akışı arasındaki tek yapısal farktır. Bunu şu şekilde ayarlayın: İkili Veri Mevcut bir PDF dosyanız olduğunda (İş Akışı A). Bunu şu şekilde ayarlayın: Hiçbiri Yalnızca ödeme verilerinden bağımsız bir QR fişi oluşturmak istediğinizde (İş Akışı B). Diğer tüm parametreler, tutar, IBAN, para birimi, alacaklı adı, her ikisi arasında aynıdır.
Ne inşa ediyorsunuz?
2020 yılında eski ödeme fişi standardından geçişten sonra düzenlenen her İsviçre faturasında bir İsviçre QR Faturası bulunmalıdır: IBAN, tutar, para birimi, alacaklı ve isteğe bağlı borçlu verilerini ISO 20022 formatında kodlayan bir QR kodu içeren standartlaştırılmış bir ödeme bölümü. Bankalar ve muhasebe yazılımları, herhangi bir manuel giriş gerektirmeden bunu tarar. Bu kılavuzdaki iki n8n iş akışı, bu oluşturma adımını otomatikleştirerek QR Faturasının manuel olarak dokunulmadan üretilmesini ve Dropbox'a kaydedilmesini sağlar.
Bir bakışta
İş akışı A: 4 adım
İş Akışı A: dört düğüm, İndirmeyi tetikleyen, SwissQR Faturası (İkili Veri) oluşturan ve Yükleyen.
İş akışı B: 3 adım
İş Akışı B: üç düğüm, Yüklemek için SwissQR Faturası Oluşturma Tetikleyicisi (Giriş Veri Türü Yok). İndirme adımına gerek yok.
Neden iki ayrı iş akışı?
İş akışı A, markalı fatura şablonunuzu olduğu gibi korur. PDF4me, İsviçre QR kodunu Dropbox'ta zaten bulunan PDF'ye ekler. Yeniden biçimlendirme, yeniden tasarım veya manuel düzenleme gerektirmez.
İş akışı B, indirme adımını tamamen atlar. Ödeme verilerini girin ve PDF4me, eksiksiz QR ödeme makbuzu belgesini sıfırdan oluşturur. Hiçbir temel PDF dosyasına gerek yoktur.
Tek yapısal fark şudur: Giriş Veri Türü Alan: İş Akışı A için İkili Veri, İş Akışı B için Yok. Tutar, IBAN, para birimi ve alacaklı adı her ikisinde de aynı şekilde yapılandırılmıştır.
Başlamadan önce
- n8n (Bulut tabanlı veya kendi sunucunuzda barındırılan). Yeni bir boş iş akışı oluşturun.
- PDF4me API anahtarıİlk kurulum: PDF4me'yi n8n'ye bağlayın.
- Dropbox n8n'de çalışma klasörünüze okuma ve yazma erişimi sağlayan OAuth2 kimlik bilgisi.
- Yalnızca A iş akışı: Dropbox'ta saklanan mevcut bir PDF dosyası (örneğin,
Test Borç AG.pdfiçinde/Blog Verileri/SwissQR/). - Ödeme bilgileri: Geçerli bir İsviçre IBAN numarası (21 karakter, ile başlar)
CH), tutar, para birimi (CHF veya EUR), alacaklı adı ve İş Akışı B için alacaklının tam yapılandırılmış adresi.
İş Akışı A: Mevcut bir PDF üzerinde İsviçre QR Faturası Oluşturma (4 düğüm)
PDF formatında bir faturanız veya belgeniz zaten varsa bunu kullanın. PDF4me, İsviçre QR kodlu faturayı dosyanın üzerine yerleştirir.
Adım 1: Mevcut PDF dosyasını Dropbox'tan indirin.
Şu ana kadarki akış: Tetiklemek.
- Ekle Dropbox düğüm.
- Kimlik bilgileri: Dropbox OAuth2 API.
- Kaynak: Dosya. Operasyon: İndirmek.
- Dosya Yolu: Dropbox'taki PDF dosyanızın yolu, örneğin:
Test Borç AG.pdf(bu örnekte dosya şu konumda yer almaktadır:/Blog Verileri/SwissQR/). - Çıktı dosyasını ilgili alana yerleştirin:
veri. - Adımı çalıştırın. ÇIKTI panelinde dosya adı görünmelidir (
Test Borç AG.pdf), dizin, MIME türüuygulama/pdfve dosya boyutu 344 kB.
Dropbox İndirme işlemi Dosya Yolu ile yapılandırıldı Test Borç AG.pdf ve Çıktı Dosyasını Alana Yerleştirin veriÇıktı, dosyanın 344 kB boyutunda indirildiğini doğruluyor.
Adım 2: İndirilen PDF dosyası üzerinde SwissQR faturası oluşturun.
Şu ana kadarki akış: Tetikle ve ardından PDF'i indir.
Bu, temel adımdır. PDF4me, indirilen PDF dosyasını okur ve İsviçre QR kodunu eklenmiş yeni bir PDF dosyası oluşturur.
- Ekle PDF4me düğüm.
- Kimlik bilgileri: PDF4ME hesabı.
- Kaynak: Fatura. Fatura İşlemleri: SwissQR faturası oluşturun.
- Giriş Veri Türü: İkili Veri (çünkü PDF'yi önceki düğümden besliyorsunuz).
- İkili Özellik:
veri(İndirme adımındaki alan adıyla eşleşir). - Dosya adı:
Test Borç AG.pdf(Kaynak belgenin dosya adı). - Ödeme alanlarını doldurun:
- Miktar:
1000 - Para birimi: İsviçre Frangı
- IBAN:
CH0200700110003765824 - Alacaklının Adı:
Test AG
- Miktar:
- Adımı çalıştırın. ÇIKTI paneli şunları gösterir:
swissqr_bill.pdfMIME türüuygulama/pdfDosya boyutu 602 kB (QR bağlantı sayfaları eklendiği için 344 kB'den 602 kB'ye yükseldi).
Giriş veri türü ikili veri olan SwissQR faturası oluşturun. GİRİŞ, Dropbox'tan alınan 344 kB'lık PDF dosyasıdır. ÇIKIŞ ise... swissqr_bill.pdf 602 kB'de. Boyut artışı, QR kodunun yerleştirildiğini doğruluyor.
3. Adım: Sonucu Dropbox'a yükleyin
Şu ana kadarki akış: Önce tetikleyin, ardından PDF dosyasını indirin ve son olarak SwissQR faturası oluşturun.
- Başka bir tane ekle Dropbox düğüm.
- Kimlik bilgileri: Dropbox OAuth2 API.
- Kaynak: Dosya. Operasyon: Yüklemek.
- Dosya Yolu: Dropbox'taki hedef yol, örneğin:
/Blog Verileri/SwissQR/swissqr_bill.pdf. - İkili Dosya: Açık.
- Giriş İkili Alanı:
veri(Önceki adımdan elde edilen SwissQR fatura çıktısı). - Çalıştırın. Dropbox, dosya adını ve yolunu doğrulayan yükleme meta verilerini döndürür.
İş akışı A tamamlandı. Mevcut PDF dosyanız artık İsviçre QR faturasını içeriyor ve Dropbox'a kaydedildi.
İş Akışı B: Bağımsız bir İsviçre QR Faturası Oluşturma (3 düğüm)
Arka plan PDF'iniz olmadığında bunu kullanın. PDF4me, düğüme doğrudan girdiğiniz ödeme ayrıntılarından tüm QR ödeme fişi belgesini oluşturur.
Adım 1: Arka planı olmayan SwissQR faturası PDF'si oluşturun
Şu ana kadarki akış: Tetiklemek.
PDF dosyası bulunmadığı için, PDF4me'nin eksiksiz İsviçre QR fatura düzenini oluşturabilmesi için alacaklının adresini eksiksiz olarak girmeniz gerekmektedir.
- Ekle PDF4me düğüm.
- Kimlik bilgileri: PDF4ME hesabı.
- Kaynak: Fatura. Fatura İşlemleri: SwissQR faturası oluşturun.
- Giriş Veri Türü: Hiçbiri (bu, PDF4me'ye arka plan PDF'si olmadan bağımsız bir QR kodu oluşturmasını söyler).
- Ödeme alanlarını doldurun:
- Miktar:
1000 - Para birimi: İsviçre Frangı
- IBAN:
CH0200700110003765824 - Alacaklının Adı:
Test AG - Alacaklı Adres Türü: Yapılandırılmış
- Alacaklının Sokak Adı veya Adresi:
Test Yolu - Alacaklı Bina Numarası:
1 - Alacaklının Posta Kodu:
8000 - Alacaklı Şehir:
Zürih
- Miktar:
- Adımı çalıştırın. ÇIKTI paneli şunları gösterir:
swissqr_bill.pdf132 kB boyutunda. Arka planda PDF olmadığı, yalnızca QR kodunun bulunduğu için İş Akışı A'dan (602 kB) önemli ölçüde daha küçük.
Giriş Veri Türü Yok olarak SwissQR Faturası oluşturun. PDF4me düzeni sıfırdan oluşturduğu için alacaklının tam adresi gereklidir. Çıktı boyutu 132 kB'dir.
Adım 2: Bağımsız QR faturasını Dropbox'a yükleyin
Şu ana kadarki akış: Ardından SwissQR faturasını oluşturun.
- Ekle Dropbox düğüm.
- Kimlik bilgileri: Dropbox OAuth2 API.
- Kaynak: Dosya. Operasyon: Yüklemek.
- Dosya Yolu:
/n8n_swissqr02.pdf(veya Dropbox'unuzdaki herhangi bir yol). - İkili Dosya: Açık.
- Giriş İkili Alanı:
veri. - Çalıştır. ÇIKTI paneli yüklemeyi onaylıyor:
adı: n8n_swissqr02.pdf,path_display: /n8n_swissqr02.pdf,boyut: 132191, Veindirilebilir: doğru.
Yükleme onaylıyor: isim n8n_swissqr02.pdf, yol /n8n_swissqr02.pdf, boyutu 132191 bayt, indirilebilir: doğru.
İş akışı B tamamlandı. Bağımsız İsviçre QR fatura PDF dosyası Dropbox'ta ve e-posta ile gönderilmeye veya herhangi bir giden belgeye eklenmeye hazır.
Hangi iş akışını seçmelisiniz?
| İş Akışı A (mevcut PDF ile) | İş Akışı B (bağımsız) | |
|---|---|---|
| Nodes | 4 (trigger + download + QR + upload) | 3 (trigger + QR + upload) |
| Input Data Type | Binary Data | None |
| Requires existing PDF | Yes (in Dropbox or another source) | No |
| Output size (example) | 602 kB | 132 kB |
| Full creditor address required | No (name only shown in example) | Yes (Structured address required for layout) |
| Best for | Adding QR slip to finished invoices or letters | Sending a separate payment slip alongside any document |
Hızlı referans: temel parametreler
| Düğüm | Tuş ayarı | Örnek değer |
|---|---|---|
| Dropbox Download (A only) | File Path + Put Output File in Field | Test Debt AG.pdf; data |
| PDF4me Create SwissQR Bill (A) | Input Data Type + Binary Property + File Name | Binary Data; data; Test Debt AG.pdf |
| PDF4me Create SwissQR Bill (A and B) | Amount + Currency + IBAN + Creditor Name | 1000; Swiss Franc; CH0200700110003765824; Test AG |
| PDF4me Create SwissQR Bill (B only) | Input Data Type | None |
| PDF4me Create SwissQR Bill (B only) | Creditor Address Type + Street + Number + Postal Code + City | Structured; Test Strasse; 1; 8000; Zurich |
| Dropbox Upload (A) | File Path + Binary File + Input Binary Field | /Blog Data/SwissQR/swissqr_bill.pdf; On; data |
| Dropbox Upload (B) | File Path + Binary File + Input Binary Field | /n8n_swissqr02.pdf; On; data |
Kullanım örnekleri
Aylık fatura grubu: Dropbox'tan fatura PDF'lerinin bir listesini çekin, bunları bir döngüyle inceleyin. n8n Parçalar Halinde Bölünmüş Düğümde, her birinde A İş Akışını çalıştırın ve sonuçları ayrı bir klasöre kaydedin. Tek bir çalıştırma tüm ayı kapsar.
Veritabanından dinamik ödeme fişleri oluşturma: Ödeme talebi oluşturulduğunda Webhook aracılığıyla tetikleyin. Tutar, IBAN ve alacaklı verilerini bir Postgres veya Airtable düğümünden çekin. QR fişini oluşturmak ve otomatik olarak Gmail veya Outlook üzerinden e-posta ile göndermek için İş Akışı B'yi kullanın.
Kira ve faturalar: Her ay kira, fatura veya üyelik ücretleri için bağımsız QR fişleri oluşturun (İş Akışı B). Bunları Dropbox'a kaydedin ve n8n'den gönderilen e-postalara ekleyin. Arka plan PDF'sine gerek yok.
Kendi sunucunuzda barındırılan ve şirket içi: n8n'i kendi altyapınızda çalıştırın. Ödeme verileri, PDF4me API çağrısı dışında asla ağınızdan ayrılmaz. Dropbox yerine şirket içi dosya paylaşım sistemleri veya NAS ile entegre edin.
Sıkça sorulan sorular
İş akışı A'yı mı yoksa iş akışı B'yi mi ne zaman kullanmalıyım?
Kullanmak İş Akışı A Hali hazırda tamamlanmış bir PDF belgeniz (fatura, mektup, herhangi bir dosya) varsa ve buna İsviçre QR faturası eklemek istiyorsanız, PDF4me QR fişini mevcut dosyanıza ekler. İş Akışı B Sadece ödeme verileriniz (IBAN, tutar, alacaklı bilgileri) varsa ve bağımsız bir QR ödeme makbuzu PDF'si istiyorsanız, İş Akışı B, arka plan PDF'sine gerek kalmadan eksiksiz belgeyi sıfırdan oluşturur.
İsviçre QR banknotu hangi IBAN formatını gerektiriyor?
IBAN geçerli olmalıdır. İsviçre IBAN'ı: tam 21 karakter, ile başlayarak CHArdından iki kontrol rakamı ve 17 haneli banka hesap numarası gelir. Örnek: CH0200700110003765824İsviçre QR standardı ayrıca QR-IBAN'ları da desteklemektedir (başlangıçta). CH (ve banka tanımlayıcısı için 3000 ile 3199 aralığını kullanarak). Geçersiz veya İsviçre dışı bir IBAN, herhangi bir PDF oluşturulmadan önce PDF4me API'sinden bir doğrulama hatasına neden olur.
İş Akışı B neden alacaklının tam adresini gerektirirken İş Akışı A gerektirmiyor?
Giriş Veri Türünü kullandığınızda İkili Veri (İş Akışı A), PDF4me QR kodunu mevcut bir PDF'ye ekler ve düzen, kaynak belgeden görsel bağlam içerir. QR kod bölümü sıfırdan oluşturulmadığı, sonradan eklendiği için alacaklı adresi isteğe bağlıdır. Giriş Veri Türünü kullandığınızda Hiçbiri (İş Akışı B), PDF4me, belgenin tüm düzenini sıfırdan oluşturur. İsviçre QR standardı, bağımsız bir QR faturasının, ödeme sistemlerinin başka bir belge bağlamına ihtiyaç duymadan işleyebilmesi için QR kod verilerinde alacaklının tam adresini (sokak, bina numarası, posta kodu, şehir) içermesini zorunlu kılar.
Veritabanından veya formdan gelen dinamik ödeme verilerini, kod içine yazılmış sabit değerler yerine kullanabilir miyim?
Evet. n8n'de, PDF4me düğümündeki herhangi bir alan ifadeleri kabul eder. Tutar, IBAN, Alacaklı Adı ve Şehir alanlarını, Postgres sorgusu, Airtable kaydı, Google Sheets satırı, n8n Form Tetikleyicisi aracılığıyla form gönderimi veya webhook yükü gibi önceki bir düğümden eşleştirin. Her yürütme, iş akışında herhangi bir manuel düzenleme yapmadan, geçerli öğe için benzersiz bir QR Fatura oluşturur. Bu, üretim faturalama otomasyonu için önerilen yaklaşımdır.
PDF4me düğümü hata döndürüyor. İlk olarak neyi kontrol etmeliyim?
Üç şeyi sırayla kontrol edin. BirinciAPI anahtarınızın etkin olduğunu şu adresten doğrulayın: dev.pdf4me.com ve hesabınızda bakiye bulunmaktadır. Saniyeİş Akışı B için, Alacaklı Adres Türü Yapılandırılmış olduğunda dört alacaklı adres alanının (Sokak, Bina Numarası, Posta Kodu, Şehir) tümünün doldurulmuş olduğunu doğrulayın. Bunlardan herhangi birinin eksik olması doğrulama hatasına neden olur. Üçüncüİş Akışı A için, Dropbox İndirme adımının başarıyla tamamlandığını ve PDF4me düğümündeki İkili Özellik adının İndirme düğümünde ayarlanan alan adıyla eşleştiğini doğrulayın (her ikisi de aynı olmalıdır). veri).
Sorun giderme
Dropbox Yükleme düğümü, "alan" olarak adlandırılan bir alanı arar. veri Varsayılan olarak. Eğer "SwissQR Fatura Oluştur" düğmesi farklı bir Çıkış İkili Alan Adı kullanıyorsa, Yükleme düğmesindeki Giriş İkili Alanını buna uygun şekilde güncelleyin. Bunu önlemek için tüm düğmelerde aynı alan adını kullanın.
IBAN, geçerli bir İsviçre IBAN'ı olmalı ve ile başlamalıdır. CH (21 karakter). İş Akışı B için, Alacaklı Adresi Türü Yapılandırılmış olduğunda, dört alacaklı adresi alanının (Sokak, Bina Numarası, Posta Kodu, Şehir) tümü doldurulmalıdır. Bunlardan herhangi birinin eksik olması doğrulama hatasına neden olur.
İndirme düğmesindeki Dosya Yolunu tekrar kontrol edin. Dropbox yolları bazı hesaplarda büyük/küçük harf duyarlıdır. Dropbox'ınızı açın ve klasör adları ve dosya uzantısı dahil olmak üzere tam yolu kopyalayın. Dosya bir alt klasörün içindeyse, yol tam klasör hiyerarşisini içermelidir, örneğin: /Blog Verileri/SwissQR/Test Borç AG.pdf.
Görmek PDF4me Sorun Giderme API anahtarınızı doğrulama, kalan kredileri kontrol etme ve n8n'de kimlik bilgilerini yeniden bağlama adımları için lütfen aşağıdaki bilgilere bakın.
Sırada ne denenecek?
İsteğe bağlı: tetiği değiştirin. Manuel tetiği bir başka tetikle değiştirin. Takvim aylık faturalama işlemleri için, bir Webhook Ödeme talebi oluşturulduğunda tetiklenmek üzere, veya Dropbox'ta dosya oluşturuldu. Yeni PDF dosyaları geldikçe otomatik olarak işlemek.