Crear factura QR suiza en n8n
Lo que hace este nodo
PDF4meCrear factura QR suiza genera comprobantes de pago QR suizos totalmente compatibles integrados en PDF documentos a través de su n8n flujo de trabajo de automatización. Proporcione un PDF factura mediante datos binarios, base64, URL, o ningún documento de fondo en absoluto, el nodo genera una factura QR suiza estandarizada con Datos del acreedor y del deudor, IBANnúmeros de referencia, etiquetas multilingües y formatos de salida configurables en un solo paso automatizado. Totalmente compatible con todos los bancos suizos, PostFinancey las Normas de Pago Suizas (SPS) especificación.
Autenticando su API Pedido
Cada PDF4me nodo en n8n requiere un válido Credencial para conectarse con. Crea o selecciona uno que contenga tu PDF4me API clave para que el flujo de trabajo pueda autenticar de forma segura las solicitudes de generación de billetes con código QR suizo.
Datos importantes que no debes perderte

Campos del panel superior, conexión, tipo de entrada, detalles de pago y dirección del acreedor

Panel inferior, dirección del deudor, tipo de referencia, idioma, formato, paginación y configuración de salida.
Parámetros
Requerido en el n8n UI: Credencial para conectarse, Tipo de datos de entrada, Cantidad, Moneda, IBAN, Nombre del acreedor, Tipo de dirección del acreedor, Tipo de dirección del deudor final, Tipo de referencia, Tipo de idioma, Línea separadora, Tipo de formato y (cuando el tipo de formato es PDF) Opciones de paginación. Todos los campos de línea de dirección, código postal y ciudad están marcados como opcionales en el UI pero son Muy recomendable para billetes QR suizos válidos., la especificación de estándares de pago suizos y la PDF4me API Trátelos como si fueran necesarios para su uso en producción. La carga útil de ejecución siempre los envía (como cadenas vacías si están en blanco).
| Parámetro | Requerido | Lo que hace | Ejemplo |
|---|---|---|---|
| Input Data Type | Conditional | How the source PDF is supplied. None generates a standalone QR bill with no background document. Binary Data reads from a previous n8n node: the most common option. Base64 String accepts encoded file content. URL downloads from a public link. | Binary Data |
| Binary Property Name | Conditional | Name of the binary field from the previous node. Required when Input Data Type is Binary Data. Maps to the output binary field of a prior download or file node. | data |
| Base64 Content | Conditional | Base64-encoded PDF content. Required when Input Data Type is Base64 String. | JVBERi0xLjQK... |
| File URL | Conditional | Public URL to the source PDF file. Required when Input Data Type is URL. | https://example.com/invoice.pdf |
| File Name | Conditional | Filename of the source PDF input. Shown only when Input Data Type is Binary Data, Base64 String, or URL: hidden for None. Include the .pdf extension. | document.pdf |
| Amount | Yes | Payment amount for the Swiss QR bill. Enter without leading zeroes (per the node field description). Must be a positive number with up to two decimal places. | 1000 |
| Currency | Yes | Currency for the QR bill. Only two options accepted: CHF (Swiss Franc, standard for domestic Swiss payments) or EUR (cross-border transactions). | CHF |
| IBAN | Yes | Creditor's Swiss IBAN. Must start with CH followed by 19 digits and be linked to a valid PostFinance or Swiss bank account. An invalid IBAN halts the workflow. | CH0200700110003765824 |
| Creditor Name | Yes | Full name of the creditor company or individual as registered with the bank. Printed on the generated QR bill in the creditor section. | Test AG |
| Creditor Address Type | Yes | Address format for creditor information. Sent as code S (Structured: components stored separately for maximum SPS compliance) or K (Combined, two free-form lines). | Structured (S) |
| Creditor Address Line 1 | No | Street name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills: always provide it. When Address Type is Structured, enter the street name only. | Test Strasse |
| Creditor Address Line 2 | No | House number or secondary address detail. Used as the second address line when Creditor Address Type is Structured. | 1 |
| Creditor Postal Code | No | Swiss postal code for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must be a 4-digit Swiss postal code matching the creditor city. | 8000 |
| Creditor City | No | Swiss city name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must correspond to the postal code entered above. | Zurich |
| Ultimate Debtor Name | No | Full name of the party who will pay the bill. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. Appears in the payment section of the printed QR bill. | Test Debt AG |
| Ultimate Debtor Address Type | Yes | Address format for the ultimate debtor. Sent as code S (Structured: recommended for automated Swiss banking) or K (Combined, two free-form lines). | Structured (S) |
| Ultimate Debtor Address Line 1 | No | Street name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Test Deb Strasse |
| Ultimate Debtor Address Line 2 | No | House number or secondary address line for the debtor. Used as the second line when Ultimate Debtor Address Type is Structured. | 2 |
| Ultimate Debtor Postal Code | No | Swiss postal code for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | 8000 |
| Ultimate Debtor City | No | Swiss city name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Zurich |
| Reference Type | Yes | Sent as code NON (No Reference: simple payments), QRR (QR Reference, 27-digit numeric for PostFinance/Swiss bank reconciliation), or SCOR (Creditor Reference, ISO 11649 for SEPA-compatible cross-border payments). | NON |
| Language Type | Yes | Display language for QR bill labels and printed text. Options: English, German, French, Italian. Choose the language matching the recipient's Swiss region. | English |
| Separator Line | Yes | Visual separator between the invoice body and the QR bill tear-off section. Note the node field name is spelled "seperatorLine". Options: Line With Scissor (Swiss standard), Simple Line, No Line. | Line With Scissor |
| Format Type | Yes | Output file format for the generated QR bill. PDF is recommended for print-ready documents. PNG and JPEG for digital delivery. TIFF for archival quality. Empty or null for raw data output. | PDF |
| Paging Options | Conditional | Controls where the QR bill slip is placed in the output document. Required when Format Type is PDF. Options: First, Last, Add Page At End, Custom. | First |
| Page Number | Conditional | Specific page index for placing the QR bill. Shown and required only when Format Type is PDF and Paging Options is Custom. | 3 |
| Output File Name | No | Filename for the generated Swiss QR bill document. Default value is provided by the node. Include the extension matching your chosen Format Type. | swissqr_bill.pdf |
| Output Binary Field Name | No | Name of the binary field in the n8n output that holds the generated QR bill file. Default is data. Used to reference the file in subsequent workflow nodes. | data |
Opciones avanzadas
Todos los campos dentro del Opciones avanzadas La recopilación es opcional y proporciona un control adicional sobre la carga útil de la factura QR. Agréguelas a través de Agregar opción en la interfaz de usuario del nodo.
referenciaMensaje no estructuradoinformación de facturaciónav1av2perfilesOpciones de tipo de datos de entrada
Elige cómo la fuente PDF ingresa al nodo. Cada opción se adapta a un patrón de flujo de trabajo diferente.

Menú desplegable Tipo de datos de entrada, cuatro opciones controlan cómo la fuente PDF se suministra al nodo
NingunoSin documento de antecedentesDatos binariosArchivo del nodo anterior, el más comúndatos).Cadena Base64Contenido del archivo codificado en Base64URLDescargar desde un enlace públicoOpciones de tipo de dirección
Se aplica a ambos Tipo de dirección del acreedor y Tipo de dirección del deudor finalElija cómo se almacenan los componentes de la dirección en los datos del código QR.
EstructuradoSe recomienda separar los campos de dirección.ConjuntoDos líneas de dirección de formato libre
Tipo de dirección del acreedor, estructurada frente a combinada

Tipo de dirección del deudor final, la misma opción que para el acreedor.
Opciones de tipo de referencia
Controla qué estándar de referencia de pago se incorpora al código QR. Esto afecta a cómo se asocia el pago con la factura en el sistema bancario.

Tipo de referencia, Sin referencia, Referencia QR o Referencia del acreedor
Sin referenciaPor defecto, sin referencia estructurada.Referencia QRConciliación bancaria suiza numérica de 27 dígitosReferencia del acreedorISO 11649transfronterizo SEPA pagosOpciones de tipo de formato
Controla el formato de archivo de la factura QR generada.

Menú desplegable Tipo de formato, PDF, PNG, JPEG, TIFF, o vacío (nulo)
PDFPredeterminado, listo para imprimirPNGEntrega web y digitalJPEGImagen apta para correo electrónicoPELEACalidad de archivoVacío (nulo)Salida de datos sin procesarOpciones de paginación
Controla la ubicación del comprobante de pago con código QR dentro del documento de salida en relación con las páginas de la factura existentes.

Opciones de paginación: Primera, Última, Agregar página al final o Personalizada
PrimeroPor defecto, factura con código QR en la página 1ÚltimoBillete QR en la última páginaAgregar página al finalPágina de facturación QR dedicada, la más comúnCostumbrePosicionamiento específico de la páginaCampos de salida
| Campo | Tipo | Lo que contiene |
|---|---|---|
fileName | String | Filename of the generated Swiss QR bill document, for example swissqr_bill.pdf. Map into an upload or email node as the destination filename. |
mimeType | String | MIME type of the output file, for example application/pdf. Useful for content type validation in downstream HTTP or storage nodes. |
fileSize | Number | Size of the generated QR bill file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow. |
success | Boolean | True when the Swiss QR bill was created successfully. False if an error occurred during generation. Use this field to route error handling branches in your workflow. |
message | String | Human-readable status message confirming success or describing the error encountered. Useful for logging and error notification steps. |
Configuración rápida
- Agregar PDF4me a tu n8n flujo de trabajo. Establecer Recurso a Factura y Operaciones de facturación a Crear factura SwissQR.
- En Credencial para conectarse con, seleccione su PDF4me credenciales o haga clic Crear nueva credencial y pega tu API llave.
- Colocar Tipo de datos de entrada: conecta la salida binaria de un nodo anterior (Datos binarios), proporciona un Base64 cadena, suministrar un público URLo seleccione Ninguno para un comprobante QR independiente.
- Ingrese al Cantidad, Divisa (Franco suizo para pagos en CHF), y IBAN (válido en Suiza CH IBAN comenzando con CH).
- Rellene todo Acreedor Campos: Nombre, Tipo de dirección (se recomienda Estructurada), Línea de dirección 1, Línea de dirección 2, Código postal y Ciudad.
- Rellene todo Deudor final campos con el nombre completo y la dirección del pagador.
- Colocar Tipo de referencia (Sin referencia es la opción predeterminada), Tipo de idioma (inglés, alemán, francés o italiano), y Línea separadora (La técnica de corte con tijeras es el estándar suizo).
- Configurar Tipo de formato (PDF recomendado) y Opciones de paginación (Añadir página al final para agregar una página de factura con código QR a una factura existente).
- Colocar Nombre del archivo de salida a
swissqr_bill.pdfy Nombre del campo binario de salida adata. - Conecte la salida al siguiente nodo: remitente de correo electrónico, carga al almacenamiento en la nube, escritura en la base de datos y ejecución del flujo de trabajo.
Ejemplos de flujo de trabajo
Ejemplos de flujo de trabajoCommon n8n workflow patterns using Create Swiss QR Bill.
- Un activador programado se ejecuta el primer día de cada mes para iniciar el proceso de facturación.
- Un nodo de Google Drive enumera todas las facturas. PDFs en la carpeta de facturación mensual, una por cliente.
- Un nodo Loop Over Items itera sobre cada archivo. Para cada uno, un nodo Google Drive Download recupera el contenido binario.
- PDF4me Create Swiss QR Bill adjunta un comprobante de pago QR compatible a cada factura utilizando el importe del cliente. IBANy la dirección se obtiene de un registro de cliente de Google Sheets. El tipo de idioma está configurado en alemán. La opción de paginación es Agregar página al final.
- Un nodo de Gmail envía la factura QR PDF Se envía como archivo adjunto por correo electrónico a cada cliente. El nombre del archivo utiliza el ID del cliente para facilitar su identificación.
- Un activador de webhook se dispara cuando se confirma un pedido en la plataforma de comercio electrónico.
- Un HTTP El nodo de solicitud genera una factura. PDF de un HTML Plantilla que utiliza los datos del pedido.
- PDF4me Create Swiss QR Bill adjunta un comprobante QR compatible a la factura. PDFEl importe y los detalles del deudor se obtienen de la carga útil del webhook. El tipo de referencia se establece como Referencia del acreedor para la conciliación. El idioma es francés para la Suiza francófona.
- Un Microsoft SharePoint El nodo carga la factura QR completada PDF a la carpeta de archivo de Órdenes.
- Un HTTP El nodo de solicitud actualiza el estado del pedido a Factura enviada en el CRM sistema.
- Un activador programado se ejecuta todos los lunes por la mañana para comprobar si hay cuentas de suscripción vencidas.
- Un nodo de PostgreSQL consulta todas las cuentas con saldos pendientes con una antigüedad superior a 14 días.
- Un nodo Loop Over Items procesa a cada suscriptor. PDF4me La creación de la factura QR suiza se llama con el tipo de datos de entrada establecido en Ninguno, sin fondo. PDFGenera una factura QR limpia e independiente. El nombre y la dirección del deudor se obtienen del registro de la base de datos. El tipo de referencia es Sin referencia. El tipo de idioma es Italiano para la Suiza de habla italiana.
- Un Microsoft Outlook El nodo envía un correo electrónico de recordatorio de pago a cada suscriptor con la factura QR independiente. PDF adjunto.
- Un nodo de PostgreSQL registra la marca de tiempo del envío del recordatorio e incrementa el contador de recordatorios para cada cuenta.