Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Lea el código SwissQR en Make

Lea el código SwissQR es un Make módulo que lee suizo QR códigos de PDF facturas automáticamente, extrayendo el total QR-factura (QRCarga útil (de factura): IBAN, cantidad, moneda (CHF/EUR), acreedor, deudor y número de referencia. Úselo para automatizar las cuentas por pagar y la conciliación de pagos para facturas suizas en Make sin introducción manual de datos.

Lo que hace este módulo

PDF4meLea el código SwissQR detecta y decodifica automáticamente el suizo QR-factura (QR-Rechnung) carga útil de cualquier PDF factura en su Make escenario. Devuelve todos los campos de pago estructurados y listos para usar, IBAN, importe, moneda, nombre y dirección del acreedor, datos del deudor, número de referencia e información de facturación adicional, para que su flujo de trabajo de cuentas por pagar, conciliación o inicio de pago pueda ejecutarse sin que nadie lea o escriba manualmente los datos de la factura.

Entradas de blog relacionadas(1)

Autenticando su API Pedido​

Cada PDF4me módulo en Make requiere un válido Conexión. Crea o selecciona uno que contenga tu PDF4me API clave para que el escenario pueda autenticar Swiss QR decodificando solicitudes de forma segura.

Get your API Key

Datos importantes que no debes perderte​

Se admiten los tres tipos de referencia suizos.
El módulo maneja QRR (27 dígitos) QR referencia utilizada para la conciliación bancaria automática), SCOR (ISO 11649 referencia del acreedor), y NON (sin referencia). El campo Tipo de referencia en la salida indica exactamente qué formato se encontró en la factura, para que la lógica posterior pueda gestionar cada caso correctamente.
QR El código se encuentra automáticamente en cualquier página.
No es necesario indicarle al módulo qué página es la suiza QR El código aparece en. Escanea cada página del PDF y localiza el QR- Facturación automática, independientemente de si la factura es de una o varias páginas. Esto significa que puede procesar facturas de varias páginas. PDFs sin ninguna división previa ni configuración de número de página.
La información adicional puede contener datos contables Swico S1.
Cuando el emisor de la factura ha incluido información de facturación estructurada Swico S1 en la QR carga útil, el campo Información adicional la devuelve junto con el texto del mensaje no estructurado. Swico S1 puede incluir VAT tarifas, condiciones de pago y referencias contables, datos adicionales que van más allá de los campos de pago básicos y son valiosos para la automatización AP reserva.
Haga que PDF4me lea el módulo SwissQR Code mostrando la conexión establecida en TestUser01, el archivo establecido en Map con los campos Nombre de archivo y Documento asignados desde el paso 1.

Archivo configurado para Map pasa el nombre del archivo y PDF El módulo escanea cada página y devuelve el Swiss completo. QR-carga útil de pago de facturas.

Parámetros​

Requerido: Se deben proporcionar la conexión, el nombre del archivo y el documento. PDF debe contener un documento suizo válido QR-factura para que el módulo devuelva los datos de pago.

ParámetroRequeridoLo que haceEjemplo
ConnectionRequiredPDF4me API connection. Click Add and paste your API key if connecting for the first time.Your PDF4me connection
File NameRequiredSource PDF filename including the .pdf extension. Map from the prior module's file name output.swiss_invoice_2024.pdf
DocumentRequiredBinary PDF buffer from a prior module: cloud storage download (Dropbox, Google Drive, SharePoint), email attachment, or HTTP response. The PDF must contain a Swiss QR-bill on any page.1. Data
IsAsyncConditionalSet to true for async processing. Returns a polling URL instead of waiting inline. Use for large PDFs or high-volume batch runs where Make timeout limits apply.false

Producción​

El módulo devuelve el Swiss completo QR-carga útil de la factura como campos mapeados individuales en el Make manojo.

CampoTipoLo que contiene
IBANStringInternational Bank Account Number of the payee. 21-character Swiss IBAN starting with CH or LI.
AmountStringPayment amount as a string (e.g. "1250.00"). Convert to Number in Make if arithmetic is needed downstream.
CurrencyStringCHF or EUR. The Swiss Payment Standard allows only these two values.
CreditorObjectCreditor name, address type (K or S), street/PO box, building number, postcode, town, and country.
DebtorObjectDebtor (payer) name and address fields, same structure as Creditor. May be empty if the invoice omits debtor data.
ReferenceStringThe reference number: 27-digit QRR, ISO 11649 SCOR, or empty string for NON reference type.
Reference TypeStringQRR, SCOR, or NON. Identifies the reference format so your downstream logic can branch accordingly.
Additional InfoStringUnstructured message text and Swico S1 structured billing data (VAT rates, payment conditions, accounting codes) when included by the invoice issuer.

¿Cómo configuro la lectura de códigos SwissQR en Make¿​

  1. Agregar PDF4me → Lea el código SwissQR a tu Make escenario.
  2. Seleccionar Conexión (o haga clic Agregar para crear uno con tu API llave).
  3. Mapa Nombre del archivo y Documento del módulo anterior: un monitor de archivos adjuntos de correo electrónico, obtener archivo de almacenamiento en la nube o HTTP descargar.
  4. Haga clic Ahorrar y ejecutar el escenario. Los campos de salida: IBAN, Cantidad, Divisa, Acreedor, Deudor, Referencia, Tipo de referencia, y Información adicional: todos están disponibles para ser mapeados en módulos posteriores.

¿Cuándo debo usar Read SwissQR Code en Make¿​

Ejemplos de flujo de trabajoCommon Make scenario patterns using Read SwissQR Code.
Automatice las cuentas por pagar a partir de las facturas suizas recibidas.
  1. Email Watch se activa cuando una factura de proveedor con un nombre suizo QR-Llega la factura.
  2. Lea los extractos de códigos SwissQR. IBANImporte, referencia y datos del acreedor.
  3. Un HTTP El módulo envía los datos de pago a la cuenta bancaria de la empresa o ERP API.
  4. Se crea una fila en Google Sheets que registra la referencia de la factura, el importe y el acreedor. AP registro.
Conciliar los pagos bancarios recibidos con las facturas pendientes.
  1. Un activador programado se ejecuta diariamente para procesar la descarga del extracto bancario.
  2. Para cada pago no coincidente, Read SwissQR Code extrae la referencia de la factura enviada correspondiente. PDF.
  3. La referencia se compara con los registros de facturas abiertas en la base de datos; las facturas coincidentes se marcan automáticamente como pagadas.
  4. Se envía un correo electrónico de resumen a AR Listado del equipo con los pagos coincidentes y no coincidentes del día.
Archivar facturas por nombre del acreedor usando QR datos
  1. La función Dropbox Watch Folder se activa cuando llega una nueva factura suiza. PDF se deposita en la carpeta de la bandeja de entrada.
  2. El código SwissQR extrae el nombre y la referencia del acreedor. QR carga útil.
  3. Google Drive crea una carpeta para el acreedor (si no existe) y sube la factura con la referencia como nombre de archivo.
  4. Una notificación de Slack alerta al AP Al equipo le informamos que se ha presentado una nueva factura y que está lista para su aprobación.

Preguntas frecuentes​

What is a Swiss QR-bill and which reference types does this module support?+
A Swiss QR-bill (QR-Rechnung) is the standardised Swiss invoice format defined by the <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/standards/qr-bill.html" target="_blank" rel="noopener noreferrer">SIX Group Swiss Payment Standard</a> that replaced payment slips in 2020. It carries a machine-readable QR code encoding all payment fields. This module supports all three reference types defined in the Swiss Payment Standard: QRR (27-digit numeric QR reference for automatic bank matching), SCOR (ISO 11649 creditor reference), and NON (no reference number). The Reference Type output field identifies which was detected. For more on Make scenario setup, see the <a href="https://www.make.com/en/help/apps/pdf4me" target="_blank" rel="noopener noreferrer">Make PDF4me integration docs</a>.
Does it work on scanned Swiss invoices?+
Yes. The module processes both digitally generated PDFs and scanned paper invoices. For reliable QR extraction from scanned documents, a minimum resolution of 200 DPI is recommended. The module scans every page of the PDF automatically: you do not need to specify the page number where the QR-bill appears.
What currencies are supported?+
The Swiss Payment Standard defines exactly two valid currencies: CHF (Swiss Franc) and EUR (Euro). The Currency output field will always contain one of these two values as encoded in the QR payload.
What does the Additional Info field contain and is it useful for accounting?+
The Additional Info field returns two types of data: unstructured payment message text (a free-text note the invoice issuer has added) and Swico S1 structured billing information when present. Swico S1 can include VAT rates, payment conditions, and accounting reference codes: AP-relevant data that goes well beyond the core payment fields and is useful for automated invoice booking.
How do I use the extracted IBAN and amount to initiate a payment?+
Map the IBAN and Amount output fields into a banking integration module or HTTP request that connects to your payment gateway or ERP. You can also write them to a Google Sheet or database row as a pending payment record and route it through a manager approval workflow before the actual payment is triggered.

Módulos relacionados​

Obtén ayuda​

Make IntegrationGet your API KeyMake Documentation