PDF4me icon

PDF4me

Comprehensive PDF and document processing: generate barcodes, convert files, extract data, manipulate images, and automate workflows with the PDF4ME API

Actions80

Overview

The node provides functionality to create a Swiss QR Bill PDF document. A Swiss QR Bill is a standardized payment slip used in Switzerland that includes a QR code for easy and error-free payment processing. This node allows users to generate such bills by providing necessary billing information, creditor and debtor details, payment amount, currency, and other optional parameters.

This node is beneficial in scenarios where businesses or service providers need to automate the generation of Swiss QR Bills for invoicing and payment collection. For example, an accounting workflow can automatically produce payment slips after invoice creation, which can then be sent to customers.

Properties

Name Meaning
Input Data Type How the input file data is provided. Options: Binary Data (file from previous node), Base64 String (base64 encoded content), URL (link to the file).
Binary Property Name of the binary property containing the file to process (used if Input Data Type is Binary Data).
Base64 Content Base64 encoded content of the file to process (used if Input Data Type is Base64 String).
File URL URL to the file to process (used if Input Data Type is URL).
File Name The name of the input file from the source (e.g., "document.pdf").
Amount The payment amount to be entered without leading zeroes (e.g., "1000").
Currency Currency type for the payment. Options: Swiss Franc (CHF), Euro (EUR).
IBAN IBAN number of the creditor's bank account (e.g., "CH0200700110003765824").
Creditor Name Name or company name of the creditor as per the account name (e.g., "Test AG").
Creditor Address Type Type of the creditor's address. Options: Structured ("S"), Combined ("K").
Creditor Address Line 1 First line of the creditor's address (max 70 characters).
Creditor Address Line 2 Second line of the creditor's address. For Structured type max 16 characters, for Combined type max 70 characters.
Creditor Postal Code Postal code of the creditor (max 16 characters).
Creditor City Town or city of the creditor (max 35 characters).
Ultimate Debtor Name Name or company name of the debtor (payer) according to account name (e.g., "Test Debt AG").
Ultimate Debtor Address Type Address type of the debtor. Options: Structured ("S"), Combined ("K").
Ultimate Debtor Address Line 1 First line of the debtor's address (max 70 characters).
Ultimate Debtor Address Line 2 Second line of the debtor's address. For Structured type max 16 characters, for Combined type max 70 characters.
Ultimate Debtor Postal Code Postal code of the debtor.
Ultimate Debtor City Town or city of the debtor.
Reference Type Type of reference on the bill. Options: No Reference ("NON"), QR Reference ("QRR"), Creditor Reference ("SCOR").
Language Type Language of the bill. Options: English, German, French, Italian.
Separator Line Style of separator line in the QR Bill. Options: Line With Scissor, Dotted Line, Solid Line.
Output File Name Name for the output Swiss QR Bill PDF file (default "swissqr_bill.pdf").
Output Binary Field Name Name of the binary property to store the output PDF file (default "data").
Advanced Options Collection of optional advanced settings:
- Reference: Custom reference string (max 27 chars).
- Unstructured Message: Free text message (max 140 chars).
- Billing Info: Additional billing info.
- AV1 & AV2 Parameters: Alternative scheme parameters.
- Custom Profiles: JSON string to adjust custom properties for API calls.

Output

The node outputs a binary PDF file representing the generated Swiss QR Bill. The output binary data is stored under a user-defined binary property name (default is "data"). The output also includes JSON metadata about the operation result.

  • json: Contains metadata or status information related to the creation process.
  • binary: Contains the generated Swiss QR Bill PDF file.

Dependencies

  • Requires access to an external PDF generation service or API capable of creating Swiss QR Bills based on the provided input data.
  • Requires proper configuration of API credentials or authentication tokens within n8n to interact with the external service.
  • Network access may be needed if input files are provided via URLs.

Troubleshooting

  • Common Issues:

    • Invalid or missing required fields such as IBAN, amount, or creditor/debtor details will cause errors.
    • Incorrect formatting of addresses or exceeding character limits may lead to validation failures.
    • Providing an invalid or inaccessible file URL will cause the node to fail when fetching the input file.
    • If the input data type does not match the actual input (e.g., specifying base64 but providing binary), the node will error.
  • Error Messages:

    • Errors related to missing mandatory parameters should be resolved by ensuring all required fields are filled correctly.
    • Authentication errors indicate misconfigured or missing API credentials.
    • File retrieval errors suggest checking the URL accessibility or binary property correctness.
    • Validation errors on references or messages indicate exceeding allowed character limits or invalid characters.

Links and References

Discussion