Saltar al contenido principal

Agregar un código QR suizo a cualquier factura en formato PDF en Make: un flujo de trabajo de Dropbox de 3 módulos.

· 21 min de lectura
SEO and Content Writer

Cada factura suiza debe llevar un Billete QR suizo para que los bancos y el software de contabilidad puedan escanear y procesar el pago automáticamente. Con Make y PDF4me, la adición es una escenario de tres módulos: Dropbox Descargar un archivoPDF4me Crear factura QR suizaDropbox Subir un archivo. Las capturas de pantalla a continuación muestran la ejecución exacta que se muestra en el lienzo: una factura de 10 páginas en /pdf4metest/Files/10 page.pdf se convierte en una factura que cumple con las normas suizas con el comprobante de pago adjunto y guardado en /pdf4meoutput/Listo para producción en menos de 10 minutos.

El panorama general
1. Dropbox Download a File
Reads /pdf4metest/Files/10 page.pdf. Scheduled trigger (clock badge) is shown but any trigger works.
2. PDF4me Create Swiss QR-bill
Appends the QR payment slip to the source PDF. Currency, IBAN, creditor + debtor blocks, reference filled out.
3. Dropbox Upload a File
Writes the populated PDF to /pdf4meoutput/. File Name and Data mapped from the prior step.
La versión corta

Tres módulos Make. Dropbox Descargar un archivo extrae la factura de origen (la captura de pantalla muestra YnooxTestone conexión, Seleccione un archivo, camino /pdf4metest/Archivos/10 página.pdf). PDF4me Crear factura QR suiza adjunta una página de factura QR que cumple con los estándares de pago suizos (Tipo de formato) PDFOpciones de paginación Primero, Divisa insuficiencia cardíaca congestiva, IBAN que comienza con CH, bloqueos completos de acreedores y deudores). Dropbox Subir un archivo escribe el resultado en /pdf4meoutput/ con el archivo configurado en Mapa, Nombre del archivo = 6. Nombre, Datos = 6. DocumentoEl archivo PDF resultante está listo para enviarse por correo electrónico y para ser escaneado mediante el código QR de cualquier aplicación móvil de un banco suizo.

Dos factores que determinan si su salida es escaneable por el banco.

Primero, el El IBAN debe comenzar con CH o LI. y tener un máximo de 21 caracteres. Para un tipo de referencia QRR, el IBAN debe ser un QR-IBAN, no un IBAN estándar. Segundo, cuando El tipo de referencia es QRR, el El campo de referencia es una cadena numérica de 27 dígitos con un dígito de control módulo 10.; si no tiene uno, establezca el tipo de referencia en PUNTUACIÓN (ISO 11649) o NO y deje el campo Referencia vacío. Los bancos rechazan los valores de referencia mal escritos, no la imagen del código QR.

Esto resuelve preguntas comunes del mundo real.

La gente busca este problema exacto con frases como:

  • "¿Cómo puedo añadir automáticamente un código QR suizo a mi factura en formato PDF?" Sube la factura a Dropbox; este sistema de 3 módulos se encarga del resto, incluyendo el IBAN, el importe, la referencia y los datos del acreedor/deudor.
  • "¿Puede Make generar una factura suiza con código QR a partir de una factura existente?" Sí, mediante el módulo PDF4me Create Swiss QR-bill. El resultado es el mismo PDF con el comprobante de pago insertado en la página que elijas (primera, última o específica).
  • ¿Necesito una plantilla de Excel o una biblioteca de códigos QR? No. El módulo oculta toda la generación de códigos QR, las operaciones matemáticas de referencia módulo 10 y el diseño de los estándares de pago suizos tras un único paso configurable.
  • "¿Qué ocurre si no tengo una factura en formato PDF? ¿Puedo generar igualmente un comprobante QR independiente?" Sí. Si se omite por completo el grupo Archivo, el módulo devuelve un PDF independiente con la factura QR suiza.
  • "¿Aceptarán realmente los bancos suizos esta producción?" El módulo genera un comprobante que cumple con la norma ISO 20022 de los Estándares Suizos de Pago. La aplicación de banca móvil de cualquier banco suizo puede escanearlo para iniciar el pago.

Lo que estás construyendo

Un escenario de Make reutilizable de 3 módulos. Se activa un disparador (manual, programado, monitor de archivo, etc.), se extrae la factura original, se añade el código QR suizo y se guarda el resultado. Este mismo patrón funciona para pruebas puntuales, ejecuciones por lotes programadas o procesamiento de facturas totalmente basado en eventos.

Crear lienzo de escenario: Dropbox Descargar un archivo (con insignia de reloj programada) conectado a PDF4me Crear factura QR suiza, que está conectada a Dropbox Cargar un archivo. Tres grandes iconos de módulo circulares conectados con los conectores estándar Crear conectores de línea punteada.

Tres módulos de extremo a extremo. El icono del reloj en Dropbox 1 indica un activador programado. Cambia a modo manual o webhook según tus necesidades.


Lo que necesitas

  • Hacer cuenta con un escenario abierto. Crear una cuenta de Make Si necesitas uno.
  • Clave API de PDF4me. Obtén tu clave API y agréguelo cuando PDF4me solicite una conexión. Ver Conectar PDF4me para crear.
  • Dropbox con una carpeta de origen (por ejemplo, /pdf4metest/Archivos/) y una carpeta de salida (/pdf4meoutput/Cualquier sistema de almacenamiento funciona de la misma manera. Cámbialo por Google Drive, OneDrive o SharePoint según sea necesario.
  • Una factura en formato PDF (las capturas de pantalla usan 10 páginas.pdf). Opcional: omitir el archivo fuente y generar un comprobante QR independiente a partir únicamente de los datos de pago.
  • Datos de pago suizos: a CH o LI IBAN, cantidad, moneda (insuficiencia cardíaca congestiva o EUR), y bloques de nombre/dirección del acreedor + deudor. Referencia completa del campo en el documentos de acción.

Construye el escenario

Módulo 1: Dropbox - Descargar un archivo

Extraiga la factura original de su carpeta de entrada.

CampoValor utilizado en esta ejecución
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Configurar la descarga de archivos de Dropbox. Conexión establecida en YnooxTestone. Método de selección de archivos establecido en Seleccionar un archivo. Ruta del archivo /pdf4metest/Files/10 page.pdf. Botones Cancelar y Guardar en la parte inferior.

Dropbox Descargar un archivo config. Seleccione el archivo a través del selector de ruta o, para procesamiento por lotes, utilice Buscar archivos y enlazar el archivo dinámicamente.

Módulo 2: PDF4me - Creación de facturas QR suizas

Buscar PDF4me y elegir Crear factura QR suizaEl módulo expone 26 campos. La referencia completa por campo (con las 5 capturas de pantalla detalladas de la interfaz de usuario y valores de ejemplo como Var Schneider AG, CH4431999123000889012, Pia-Maria Rutschmann-Schnyder) se encuentra en el Crear factura SwissQR en Make Página de acciones. Lo mínimo a configurar:

GrupoCampoValor
SourceFileDropbox - Download a File (pulls from Module 1 automatically)
OutputFormat TypePDF
OutputPaging OptionsFirst (also: Last, or a specific 1-based page number)
PaymentCurrencyCHF (or EUR)
PaymentReference TypeQRR, SCOR, or NON
PaymentLanguageEnglish / German / French / Italian
PaymentSeparator LineLine With Scissor, Only Line, or No Line
PaymentAmounte.g. 1250.00
PaymentIBANCH or LI IBAN, max 21 chars
CreditorCreditor Address TypeS (Structured) or K (Combined)
CreditorCreditor NameCompany name on the account
DebtorUltimate Debtor AddressTypeS or K

Rellene los campos de dirección del acreedor y del deudor según el tipo de dirección que haya seleccionado, y a continuación, cualquier parámetro opcional de referencia/mensaje no estructurado/información de facturación/AV1/AV2.

Módulo 3: Dropbox - Subir un archivo

Escriba el PDF completado en la carpeta de salida.

CampoValor utilizado en esta ejecución
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection as Module 1
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name6. Name (dynamic content from PDF4me Module 2)
Data6. Document (dynamic content from PDF4me Module 2)
Configurar Dropbox Upload a File. Conexión YnooxTestone. Carpeta /pdf4meoutput/. Archivo configurado en Map. Nombre de archivo vinculado a 6. Nombre (de PDF4me Create Swiss QR-bill). Datos vinculados a 6. Documento. La sugerencia dice: Nombre del archivo, incluyendo la extensión, por ejemplo invoice.xml.

La radio File configurada para Mapa Expone el nombre del archivo y los datos como ranuras separadas. Vincule ambos a las salidas del módulo 2 de PDF4me para que el PDF completado se guarde intacto.

Guardar y hacer clic Correr una vez. La factura completada aparecerá en /pdf4meoutput/ en un par de segundos.


¿Qué se guarda en la carpeta de salida?

Un único PDF con el nombre de la fuente (por ejemplo, 10 page.pdf) con la página de la factura QR suiza insertada en la posición elegida en Opciones de paginación (First lo coloca como la nueva página 1; Last (lo añade al final). Abra el archivo en cualquier visor de PDF y la sección de factura QR mostrará el código QR de pago, la cuenta/a pagar legible, el importe, la moneda, la referencia y las direcciones del acreedor/deudor. Apunte una aplicación bancaria suiza al código QR y el pago se completará automáticamente.


Referencia rápida: parámetros clave

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Anything else is rejected by the Swiss Payment Standards.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON. Pick once, fill Reference accordingly.
Address Type
S = structured (separate PostalCode + City). K = combined (full address in two AddressLines).
Paging Options
First, Last, or a 1-based page number. Decides where the QR-bill page lands.
AV1 / AV2
Alternative scheme parameters for eBill and similar. Format: Name AV1: UV;value;id.

Solución de problemas

QR-bill page is blank or the QR code is unreadable
The IBAN is invalid (must start with CH or LI, max 21 chars) or the Currency was something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Reference Type QRR but the bank rejects the reference
QRR references must be 27 digits with a mod-10 check digit. If you do not have one, switch Reference Type to SCOR (ISO 11649) or NON and leave Reference empty.
QR-bill landed on the wrong page
Adjust Paging Options. First puts the slip as the new page 1. Last appends it after the last page. Or pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With type S, fill PostalCode + City and use AddressLine1/2 for street. With type K, leave PostalCode + City empty and put the full address into AddressLine1 + AddressLine2.
Upload writes a zero-byte file
File Name or Data in the Upload module is not bound to the PDF4me Module 2 outputs. Click the field and re-pick the dynamic content from Module 6 (PDF4me Create Swiss QR-bill).
Want a standalone QR slip without an invoice
Skip the source file entirely. Remove Dropbox Module 1, or leave the File group empty in the PDF4me module. The output is a standalone Swiss QR-bill PDF.

Cuándo utilizar este patrón

Outgoing customer invoices
Bills that need to be Swiss-payable directly from a banking app via QR scan.
Subscription billing
QR-IBAN + 27-digit QRR reference identifies the customer or contract on every recurring run.
Bulk invoice retrofitting
When an existing PDF invoice template does not yet carry the payment slip. Append it via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

¿Qué leer a continuación?


Preguntas frecuentes

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR-bill module bundles QR-code generation, the QR-bill fonts (Liberation Sans), the mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, click Run, and the output is a Swiss-compliant PDF.
What is the difference between QRR, SCOR, and NON references?+
QRR is the Swiss 27-digit numeric reference with a mod-10 check digit; it requires a QR-IBAN. SCOR is the international ISO 11649 creditor reference; it works with a standard IBAN. NON means no reference is shown on the slip. useful for ad-hoc one-off payments where the debtor adds their own reference at payment time.
Can I generate a Swiss QR-bill without an existing PDF invoice?+
Yes. Skip the File group in the PDF4me module and the output is a standalone Swiss QR-bill PDF (just the payment slip, no invoice body). Useful when the debtor only needs the slip, or when your invoice body comes from a different source.
My IBAN starts with DE / FR / IT. can I still use this?+
No, Swiss QR-bills are scoped to CH and LI IBANs only. For European SEPA payments with non-Swiss IBANs, use the Generate EPC QR Code for SEPA module instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; AddressLine1/2 carries the street. K (Combined) puts the full address in two free-text AddressLine fields and ignores PostalCode/City. New integrations should use S unless you are importing legacy data that does not separate postal code and city.
Does the output PDF work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (which is all of them since 2022) can scan the output to pre-fill the payment form. Test by opening UBS, PostFinance, Raiffeisen, or any Swiss banking app and scanning the QR code on the printed or on-screen slip.
How do I change where the QR-bill page lands?+
Set Paging Options. First puts the slip as the new page 1 of the output PDF, Last appends it to the end, or pass a 1-based page number to insert it at that position. Page indexing starts at 1.
Same scenario in n8n, Zapier, or Power Automate?+
Yes. The same PDF4me Create Swiss QR-bill action is available on all four platforms with identical parameters. See the cross-platform comparison at the bottom of the Create SwissQR Bill action page.

Comience