Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Lea el código QR suizo usando n8n acción

PDF4me Lea el código QR suizo extrae y analiza datos de pago de códigos QR suizos integrados en PDF documentos a través de n8n Flujos de trabajo de automatización. Proceso PDFs lejos n8n disparadores, datos binarios, cadenas base64 o público URLs para decodificar automáticamente los billetes QR suizos y recuperar información de pago estructurada, incluidos los detalles del acreedor/deudor, IBANImportes de pago, moneda, números de referencia e información de facturación, cumpliendo plenamente con los estándares de pago suizos. Esta solución es ideal para el procesamiento automatizado de pagos, la conciliación de facturas, la integración con sistemas contables, los flujos de trabajo financieros y el cumplimiento normativo que requieren la extracción precisa de datos de códigos QR suizos.

Entradas de blog relacionadas(1)

Configuración​

Añade el PDF4me Nodo "Leer código QR suizo" en su n8n flujo de trabajo y configure los parámetros necesarios. Para obtener instrucciones de configuración inicial, consulte nuestra n8n Guía de integración.

Requisitos previos:

  • PDF4me API credenciales
  • n8n acceso al flujo de trabajo
Get Your API Key

Configuración:

  1. Agregar PDF4me nodo a flujo de trabajo
  2. Seleccione la acción "Leer código QR suizo".
  3. Configure los parámetros de entrada (véase más abajo).
Lea el código QR suizo

Parámetros​

Lista completa de parámetros para la acción Leer código QR suizo. Configure estos parámetros para extraer los datos del código QR suizo.

Importante: Los parámetros marcados con un asterisco (***) son obligatorios y deben proporcionarse para que la acción funcione correctamente.

ParámetroTipoDescripciónEjemplo
Tipo de datos de entrada***StringSelección del formato de entrada del código QR
• Elija el formato de entrada de datos de su código QR
• PDF4me Admite múltiples tipos de entrada para el procesamiento de códigos QR suizos.
• Opciones: Datos binarios, Base64 Cuerda o URL		Binary Data
Campo binario de entradaBinarioEntrada de imagen de código QR binario (Obligatorio si se trata de datos binarios)
• Consulte el archivo de imagen del código QR anterior. n8n nodo o carga
• PDF4me Procesa imágenes binarias con reconocimiento automático de códigos QR.
• Obligatorio cuando el tipo de datos de entrada es "Datos binarios".		{{ $binary.data }}
Contenido del documento Base64StringBase64 Entrada de código QR codificado (Obligatorio si Base64 Cadena)
• Proporcione los datos de la imagen del código QR como una cadena codificada en base64.
• PDF4me decodifica y procesa automáticamente el contenido del código QR.
• Obligatorio cuando el tipo de datos de entrada es "Base64 Cadena"		UEsDBBQABgAI...
URL del archivoStringCódigo QR público URL Aporte (Obligatorio si URL)
• Proporcionar un permiso público/abierto URL al archivo de imagen del código QR
• PDF4me descarga y procesa el archivo desde URL
• Obligatorio cuando el tipo de datos de entrada es "URL"		https://abc.com/qr.png
Nombre del archivo de salida***StringNombre del archivo de salida de datos QR suizos
• Especifique el nombre para el generado JSON archivo con datos extraídos
• Debe incluir la extensión .json
• PDF4me garantiza la validación de nombres y formatos únicos.		swissqr_code_data.json
Asíncrono***BooleanProcesamiento asíncrono
• Habilitar el procesamiento asíncrono para la lectura de códigos QR suizos
• verdadero = procesamiento en segundo plano para un mejor rendimiento
• falso = procesamiento síncrono para obtener resultados inmediatos
• Ideal para operaciones de alto volumen		true

Opciones avanzadas​

Los siguientes parámetros están disponibles en la sección Opciones avanzadas y son opcionales:

ParámetroTipoDescripciónEjemplo
Perfiles personalizadosStringPerfiles de configuración personalizados
• Configure opciones adicionales mediante perfiles personalizados.
• JSONformato similar que contiene parámetros predefinidos
• Permite configurar los ajustes avanzados de lectura de códigos QR suizos.
• Opcional para requisitos especializados		{ "outputDataFormat": "json", "validateSwissStandards": true }

Producción​

Parámetros de salida​

ParámetroTipoDescripciónEjemplo
Nombre del archivoStringPDF4me Nombre del archivo de datos QR suizos - El nombre de archivo completo del archivo generado correctamente JSON Archivo que contiene datos de códigos QR suizos extraídos con la extensión .json adecuada. PDF4me Garantiza una nomenclatura única y valida el cumplimiento del formato de archivo para una integración perfecta con los procesos posteriores.swissqr_code_data.json
tipo mimeStringPDF4me JSON datos MIME tipo - El MIME tipo del generado JSON Archivo que contiene datos de código QR suizo, indicando el formato de archivo para su correcto manejo en aplicaciones web y sistemas de archivos.application/json
Tamaño del archivoNúmeroPDF4me JSON Tamaño del archivo en bytes - El tamaño exacto del generado JSON archivo en bytes, proporcionado por PDF4me Para la planificación del almacenamiento, la optimización del ancho de banda y la monitorización de la transferencia de archivos. Imprescindible para la gestión documental empresarial y la automatización del flujo de trabajo.1024
éxitoBooleanPDF4me Indicador de estado de lectura de códigos QR suizos - Indicador booleano que señala el éxito o el fracaso del proceso de lectura del código QR suizo. PDF4me devoluciones true para una lectura exitosa y false para cualquier error, lo que permite un manejo de errores robusto en flujos de trabajo automatizadostrue
Datos QR suizosObjectPDF4me Datos QR suizos extraídos - Datos estructurados completos extraídos del código QR suizo, incluyendo información de pago, detalles del acreedor y datos de la transacción. Contiene toda la información relevante según los estándares del código QR suizo.{"ucr_PostalCode": "", "ucr_City": "", "ucr_Country": null, "Amount": 30, "Currency": "CHF", "ud_AddressType": "S", "ud_Name": "Heinz Muster", "ud_StreetOrAddressLine1": "Tödistrasse", "ud_BuildNoOrAddressLine2": "1", "ud_PostalCode": "8000", "ud_City": "Zürich", "ud_Country": "Switzerland", "ReferenceType": "QRR", "Reference": "210000000003139471430009017", "UnstructuredMessage": "for individuals", "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300", "av1_Parameters": "", "av2_Parameters": ""}

N8N Respuesta a la acción​

El PDF4me Lea el código QR suizo API Devuelve una respuesta que se puede visualizar en varios formatos. Elija la vista que mejor se adapte a sus necesidades:

JSON Formato de respuesta

El crudo JSON respuesta de la API:

{
  "fileName": "swissqr_code_data.json",
  "mimeType": "application/json",
  "fileSize": 1024,
  "success": true,
  "swissQrData": {
    "ucr_PostalCode": "",
    "ucr_City": "",
    "ucr_Country": null,
    "Amount": 30,
    "Currency": "CHF",
    "ud_AddressType": "S",
    "ud_Name": "Heinz Muster",
    "ud_StreetOrAddressLine1": "Tödistrasse",
    "ud_BuildNoOrAddressLine2": "1",
    "ud_PostalCode": "8000",
    "ud_City": "Zürich",
    "ud_Country": "Switzerland",
    "ReferenceType": "QRR",
    "Reference": "210000000003139471430009017",
    "UnstructuredMessage": "for individuals",
    "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300",
    "av1_Parameters": "",
    "av2_Parameters": ""
  }
}

Casos de uso​

Procesamiento de pagos y servicios bancarios en Suiza​

  • Procese automáticamente los pagos de facturas con código QR suizo leyendo la información de pago de facturas, recibos y documentos de pago para permitir la conciliación de pagos automatizada y la integración contable.
  • Extraiga los detalles de pago de los códigos QR suizos integrados en facturas y recibos para facilitar el procesamiento automatizado de pagos y reducir la entrada manual de datos en los sistemas bancarios y financieros suizos.
  • Procese las confirmaciones de pago y los registros de transacciones mediante la lectura de códigos QR suizos para verificar los importes de los pagos, la información del destinatario y las referencias de las transacciones, en cumplimiento con la normativa financiera suiza.

Gestión de negocios y facturas en Suiza​

  • Lea los códigos QR suizos de las facturas comerciales y los documentos de pago para extraer información del cliente, importes de pago y detalles de las transacciones para procesos automatizados de contabilidad y teneduría de libros.
  • Tramitar pagos y documentos oficiales del gobierno suizo mediante la lectura de códigos QR suizos para extraer la información de pago y garantizar el cumplimiento de las normativas financieras y los requisitos de declaración de impuestos suizos.
  • Extraiga datos de pago de códigos QR suizos en facturas de servicios públicos, facturas de servicios y pagos de suscripciones para habilitar el procesamiento automatizado de pagos y la gestión de cuentas de clientes.

Comercio electrónico y transacciones digitales en Suiza​

  • Procese pagos en línea y transacciones de comercio electrónico mediante la lectura de códigos QR suizos de recibos digitales y confirmaciones de pago para habilitar el procesamiento automatizado de pedidos y los flujos de trabajo de atención al cliente.
  • Extraer información de pago de códigos QR suizos en aplicaciones de pago móvil y monederos digitales para facilitar la verificación de transacciones y el registro automatizado de información financiera.
  • Procese los pagos de suscripción y la facturación recurrente mediante la lectura de códigos QR suizos para extraer los detalles de pago y habilitar la gestión automatizada de la facturación para clientes y empresas suizas.

Obtén ayuda​

n8n Integration GuideGet your API Keyn8n SampleGetting Started