Lea el código SwissQR en Zapier
Lea el código SwissQR es un Zapier acción por PDF4me que descifra el suizo QR-proyecto de ley incrustado en un PDF y devuelve acreedor, deudor, IBAN, cantidad y datos de referencia como JSONÚselo para renombrar automáticamente las facturas, cotejar los pagos con los registros contables o enrutar documentos por importe o referencia sin necesidad de introducir datos manualmente.
Entradas de blog relacionadas(1)
Lo que hace esta acción
PDF4me Lea el código SwissQR toma uno PDF que contiene un Suizo QR-factura (QR-Factura) y devuelve sus datos de pago estructurados, dentro de un Zap. Mapea el Archivoy la acción regresa Texto del documento, a JSON cadena con IBAN, acreedor, acreedor final, deudor, importe, moneda y campos de referencia. Analícelo con un código por Zapier paso a paso para impulsar el cambio de nombre de facturas, la conciliación de pagos o la automatización contable.
Autenticando su API Pedido
Para acceder al PDF4me Web API a través de ZapierCada solicitud debe incluir las credenciales de autenticación adecuadas.
Datos importantes que no debes perderte
El texto del documento es un JSON cadena de caracteres, no campos individuales
La acción devuelve un campo,
Texto del documento, manteniendo toda la carga útil decodificada como un JSON cadena. Necesitas un código por Zapier (Ejecutar JavaScript) paso a JSON.parse antes de asignar valores individuales como IBAN o ud_Name.Los nombres de los campos utilizan los prefijos cr_/ucr_/ud_.
cr_ es el acreedor, ucr_ es el acreedor final (a menudo en blanco), y afuera_ es el deudor final, conforme a las Normas de Pago Suizas (SPC) denominación de campos. cr_Name y ud_Name son los dos campos que utilizan la mayoría de los flujos de trabajo.Utilice el archivo original para el PDF, no es el resultado de esta acción
La lectura del código SwissQR devuelve datos sobre el PDF, no pasa la PDF en sí mismo en adelante. Sigue haciendo referencia Archivo desde su activador para cualquier paso de Carga de archivo, correo electrónico o almacenamiento.
Configurar el panel de acciones: solo se requiere el archivo, el nombre del archivo es opcional.
Parámetros
Requerido en el Zapier UI: Archivo. El nombre del archivo es opcional.
| Parámetro | Requerido | Lo que hace | Ejemplo |
|---|---|---|---|
| File | Required | The PDF containing the Swiss QR-bill to decode. Map from your trigger or a previous step. | 1. File |
| File Name | Optional | Name for the response file. If left blank, the name is picked from the source URL. | invoice.pdf |
Producción
La acción devuelve los metadatos del archivo más un campo de carga útil, Texto del documento, a JSON cadena. Analícela para llegar al Swiss individual QR-Los campos de facturación se enumeran debajo de la tabla.
| Campo | Tipo | Lo que contiene |
|---|---|---|
File Name | String | Name of the generated response file, from File Name or picked from the source URL. |
File Extension | String | Extension of the response file, .json. |
Full File Name | String | Complete filename including extension. |
File Alternate Url | String | URL to the generated JSON response file. |
Document Id | String | Unique identifier for this processing run. |
File Size | Number | Size of the response file in bytes. |
Doc Text | String (JSON) | The decoded Swiss QR-bill payload as a JSON string. Parse it to reach IBAN, creditor, debtor, amount, currency, and reference fields. |
Campos de texto del documento (después de JSON.analizar gramaticalmente)
| Campo | Lo que contiene |
|---|---|
QRType, Version, CodingType | Swiss Payment Standards header data identifying this as an SPC QR payload and its version. |
IBAN | Creditor IBAN the payment settles to. |
cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country | Creditor (biller) name and address. |
ucr_Name, ucr_StreetOrAddressLine1, ucr_PostalCode, ucr_City, ucr_Country | Ultimate creditor fields, populated only when the creditor differs from the ultimate payee. |
Amount, Currency | Payment amount and currency (CHF or EUR). |
ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country | Ultimate debtor (payer) name and address. |
ReferenceType, Reference | Reference type (QRR, SCOR, or NON) and the reference number itself. |
UnstructuredMessage, BillingInfo | Free-text payment message and structured billing information, when present on the bill. |
¿Cómo configuro la lectura de códigos SwissQR en Zapier¿
- Agregar PDF4me como la aplicación de acción en tu Zap y elige Lea el código SwissQR.
- Conecta tu PDF4me cuenta o seleccione una conexión existente.
- Mapa Archivo a los suizos QR-factura PDF desde su activador o un paso anterior. Opcionalmente, mapee. Nombre del archivo.
- Pruebe el paso e inspeccione. Texto del documento en el panel de salida de datos, es un JSON cadena.
- Agregar un Código por Zapier (Ejecutar JavaScript) paso que recibe Doc Text, se ejecuta
JSON.parsey devuelve el campo específico que necesita (ud_Name,cr_Name,IBAN,Referencia, u otros). - Mapa que analizó el valor en Subir archivo (para cambiar el nombre), un Filtrar o Caminos paso (para enrutamiento) o una acción de hoja de cálculo/contabilidad.
¿Qué es el suizo? QR-Bill y ¿Por qué necesita un lector especial?
Los suizos QR-factura (QR-Rechnung) es el formato de Estándares de Pago Suizos que se convirtió en el único comprobante de pago suizo válido el 30 de septiembre de 2022, reemplazando los antiguos comprobantes de pago naranjas y rojos. Codifica acreedor, deudor, IBAN, cantidad y datos de referencia dentro de un QR código usando el SPC (Código de pago suizo) estructura, un orden de campo fijo que un código de barras genérico o QR El escáner lee como texto sin formato pero no puede asignarlo a campos con nombre. Lea el código SwissQR que decodifica eso. SPC estructura y la devuelve como se nombra JSON campos.
Configuraciones típicas
Ejemplos de flujo de trabajoCommon Zapier patterns using Read SwissQR Code.
Cambiar automáticamente el nombre de las facturas por el nombre del deudor.
- Un nuevo archivo en la carpeta activa (Dropbox, Google Drive, SharePoint) dispara contra un nuevo suizo QR-factura PDF.
- La función Read SwissQR Code se ejecuta con el archivo y el nombre del archivo asignados desde el activador, devolviendo el texto del documento.
- Un código por Zapier El paso analiza el texto del documento y devuelve ud_Name (el deudor).
- La opción "Subir archivo" guarda el mismo archivo. PDF contenido con el nombre analizado para que los archivos se puedan buscar por pagador.
Cotejar los pagos recibidos con los registros contables.
- Un correo electrónico o un activador de carpeta entrega un Swiss QR-factura PDF.
- Lee los extractos de código SwissQR Doc Text y luego un código por Zapier análisis de pasos IBAN, Cantidad y Referencia.
- Un paso de búsqueda en un sistema contable (QuickBooks, Xero o una base de datos personalizada) relaciona la referencia con una factura pendiente.
- Un paso posterior marca la factura como pagada y registra la transacción.
Ruta por importe o tipo de referencia
- El código SwissQR se ejecuta en una factura entrante y devuelve el texto del documento.
- Un código por Zapier El paso analiza Cantidad y Tipo de referencia.
- Un paso de Paths ramifica los pagos de alto valor a una cola de aprobación manual y QRR-Pagos referenciados a la contabilización automatizada.
Consejos prácticos
Doc Text always needs a parse step
There is no built-in field mapping for individual Swiss QR-bill values. Budget for a Code by Zapier step in every Zap that uses this action.
cr_ vs ud_ vs ucr_ is easy to mix up
cr_ is the creditor (who gets paid), ud_ is the ultimate debtor (who is paying), ucr_ is the ultimate creditor and is usually blank. Double-check which prefix your workflow actually needs.
ReferenceType tells you the reference format
QRR means a 27-digit QR reference, SCOR means a Creditor Reference (ISO 11649), NON means no structured reference, only UnstructuredMessage. Branch your parsing logic on ReferenceType if you support more than one format.
Amount can be null for open-amount bills
Some Swiss QR-bills are issued without a fixed Amount, letting the payer enter it. Handle a null or missing Amount in your Code by Zapier step rather than assuming it is always present.
The action reads, it does not validate compliance
This action decodes whatever SPC data is embedded in the QR code. It does not certify Swiss banking regulatory compliance, that responsibility stays with however the bill was originally issued.
Hoja de trucos
| Campo | Valor |
|---|---|
| Action | Read SwissQR Code |
| File | Required, Swiss QR-bill PDF |
| File Name | Optional |
| Output payload | Doc Text (JSON string) |
| Common parsed fields | IBAN, cr_Name, ud_Name, Amount, Currency, Reference |
| Parse step needed | Code by Zapier, JSON.parse(Doc Text) |
| Counterpart action | Create SwissQR Bill (generates the QR-bill instead of reading it) |
Preguntas frecuentes
Acciones relacionadas
Crear factura SwissQR
La acción contraparte genera un suizo QR-factura PDF de IBAN, acreedor y datos de importe en lugar de leer uno.
Documento clasificado
Ordenar los entrantes PDFs Primero por tipo, luego ejecute Read SwissQR Code solo en los clasificados como suizos. QR-facturas.
Analizar documento
Para facturas sin un sello suizo QR-factura, extraiga los datos de las partidas y del encabezado utilizando una plantilla de análisis mapeada.
Casos de uso y aplicaciones en la industria
- Swiss Banking & Financial Services
- Swiss Business & Professional Services
- Swiss E-commerce & Retail
- Swiss Government & Public Sector
- Procesamiento de pagosLea los códigos SwissQR para el procesamiento automatizado de pagos y la gestión de transacciones.
- Gestión de transaccionesExtraer datos de pago para un procesamiento y conciliación integral de las transacciones.
- Informes de cumplimiento: Introducir los datos de referencia y cantidad decodificados en los registros de auditoría interna.
- Servicio al clienteProcesar pagos y consultas de clientes con reconocimiento automatizado de códigos SwissQR.
- Procesamiento de facturas: Lea los códigos SwissQR de las facturas para el procesamiento automatizado de pagos y la contabilidad.
- Gestión de clientes: Extraer información de pago para la facturación del cliente y el seguimiento de pagos
- Gestión financiera: Automatice la lectura de códigos SwissQR para una gestión financiera integral.
- Automatización de documentosOptimice el procesamiento de documentos comerciales con la lectura integrada de códigos SwissQR.
- Procesamiento de pedidos: Lea los códigos SwissQR para el procesamiento automatizado de pedidos y la recaudación de pagos.
- Seguimiento de pagos: Extraer datos de pago para un seguimiento completo de pedidos y pagos.
- Experiencia del clienteMejore la experiencia de pago de sus clientes con el procesamiento automatizado de códigos SwissQR.
- Gestión de inventario: Vincular los datos de pago con la gestión de inventario y el procesamiento de pedidos.
- Servicios públicosLea los códigos SwissQR para servicios gubernamentales y procesamiento de pagos del sector público.
- Administración tributaria: Extraer datos de pago para el procesamiento de pagos de impuestos y tasas gubernamentales
- Gestión de registros: Introducir los datos de pago decodificados en el sistema interno de registro contable del sector público.
- Servicios digitalesModernice el procesamiento de pagos del sector público con la automatización del código SwissQR.