Leia o código QR suíço usando n8n Ação

PDF4me Leia o código QR suíço Extrai e analisa dados de pagamento de códigos QR suíços incorporados em PDF documentos através de n8n Fluxos de trabalho de automação. Processo PDFs de distância n8n gatilhos, dados binários, strings base64 ou públicos URLpara decodificar automaticamente faturas QR suíças e recuperar informações de pagamento estruturadas, incluindo detalhes do credor/devedor, IBANExtrai dados de códigos QR suíços com precisão, incluindo valores de pagamento, moeda, números de referência e informações de faturamento, em total conformidade com os padrões de pagamento suíços. Essa solução é ideal para processamento automatizado de pagamentos, conciliação de faturas, integração com sistemas contábeis, fluxos de trabalho financeiros e conformidade regulatória que exigem a extração precisa de dados de códigos QR suíços.

Artigos relacionados no blogue(1)

PDFs de faturas QR suíças: renomeie por credor, valor ou referência no n8n!

Renomeie PDFs no n8n usando dados de código QR suíço: extraia o nome do credor, cidade, país, valor ou referência de pagamento de faturas com código QR suíço e salve cada arquivo com esse valor como nome. Ideal para faturas e conciliação de pagamentos.

Ler publicação →

Configurar

Adicione o PDF4me "Ler código QR suíço" para o seu n8n fluxo de trabalho e configure os parâmetros necessários. Para obter instruções de configuração inicial, consulte nosso n8n Guia de integração.

Pré-requisitos:

• PDF4me API credenciais
• n8n acesso ao fluxo de trabalho

Get Your API Key

Configuração:

1. Adicionar PDF4me nó para fluxo de trabalho
2. Selecione a ação "Ler código QR suíço".
3. Configure os parâmetros de entrada (veja abaixo)

Parâmetros

Lista completa de parâmetros para a ação Ler código QR suíço. Configure esses parâmetros para extrair os dados do código QR suíço.

Importante: Os parâmetros marcados com um asterisco (***) são obrigatórios e devem ser fornecidos para que a ação funcione corretamente.

Parâmetro	Tipo	Descrição	Exemplo
Tipo de dados de entrada***	String	Seleção do formato de entrada do código QR • Escolha o formato de entrada dos dados do seu código QR • PDF4me Suporta vários tipos de entrada para processamento de código QR suíço. • Opções: Dados binários, Base64 Corda, ou URL	Binary Data
Campo binário de entrada	Binário	Entrada de imagem de código QR binário (Obrigatório se os dados forem binários) • Consulte o arquivo de imagem do código QR anterior. n8n nó ou upload • PDF4me Processa imagens binárias com reconhecimento automático de código QR. • Obrigatório quando o tipo de dados de entrada for "Dados binários"	{{ $binary.data }}
Conteúdo do documento Base64	String	Base64 Entrada de código QR codificado (Obrigatório se) Base64 Corda) • Fornecer dados de imagem do código QR como uma string codificada em base64 • PDF4me Decodifica e processa automaticamente o conteúdo do código QR. • Obrigatório quando o tipo de dados de entrada for "Base64 Corda"	UEsDBBQABgAI...
URL do arquivo	String	Código QR público URL Entrada (Obrigatório se) URL) • Fornecer uma permissão pública/aberta URL para o arquivo de imagem do código QR • PDF4me baixa e processa o arquivo de URL • Obrigatório quando o tipo de dados de entrada for "URL"	https://abc.com/qr.png
Nome do arquivo de saída***	String	Nome do arquivo de saída de dados QR suíço • Especifique o nome para o arquivo gerado. JSON arquivo com dados extraídos • Deve incluir a extensão .json • PDF4me garante a validação exclusiva de nomes e formatos.	swissqr_code_data.json
Assíncrono***	Boolean	Processamento assíncrono • Ativar o processamento assíncrono para leitura de códigos QR suíços • verdadeiro = processamento em segundo plano para melhor desempenho • falso = processamento síncrono para resultados imediatos • Ideal para operações de alto volume	true

Opções avançadas

Os seguintes parâmetros estão disponíveis na seção Opções Avançadas e são opcionais:

Parâmetro	Tipo	Descrição	Exemplo
Perfis personalizados	String	Perfis de configuração personalizados • Defina opções adicionais usando perfis personalizados • JSONformato semelhante a - contendo parâmetros predefinidos • Ativa configurações avançadas de leitura de código QR suíço • Opcional para requisitos específicos	{ "outputDataFormat": "json", "validateSwissStandards": true }

Saída

Parâmetros de saída

Parâmetro	Tipo	Descrição	Exemplo
nome_do_arquivo	String	PDF4me Nome do arquivo de dados QR suíço - O nome completo do arquivo gerado com sucesso. JSON Arquivo contendo dados extraídos de códigos QR suíços com a extensão .json apropriada. PDF4me Garante nomes exclusivos e valida a conformidade do formato do arquivo para uma integração perfeita com os processos subsequentes.	swissqr_code_data.json
tipo mime	String	PDF4me JSON dados MIME tipo - O MIME tipo do gerado JSON Arquivo contendo dados de código QR suíço, indicando o formato de arquivo para o correto manuseio em aplicações web e sistemas de arquivos.	application/json
tamanho do arquivo	Número	PDF4me JSON tamanho do arquivo em bytes - O tamanho exato do arquivo gerado JSON arquivo em bytes, fornecido por PDF4me Para planejamento de armazenamento, otimização de largura de banda e monitoramento de transferência de arquivos. Essencial para gerenciamento de documentos corporativos e automação de fluxo de trabalho.	1024
sucesso	Boolean	PDF4me Indicador suíço de status de leitura de QR Code - Indicador booleano que sinaliza o sucesso ou a falha do processo de leitura do código QR suíço. PDF4me retornos true para uma leitura bem-sucedida e false para quaisquer erros, permitindo um tratamento robusto de erros em fluxos de trabalho automatizados.	true
dados swissQr	Object	PDF4me Dados QR suíços extraídos - Dados estruturados completos extraídos do código QR suíço, incluindo informações de pagamento, detalhes do credor e dados da transação. Contém todas as informações relevantes de acordo com os padrões do código QR suíço.	{"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 Resposta à ação

O PDF4me Leia o código QR suíço API Retorna uma resposta que pode ser visualizada em vários formatos. Escolha a visualização que melhor se adapta às suas necessidades:

JSON

JSON Formato de resposta

O bruto JSON resposta do 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": ""
  }
}

Table

Visualização em tabela

Dados de resposta em formato de tabela estruturada:

Parâmetro	Valor
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": ""}

Schema

Visão do esquema

A estrutura de dados e os tipos de resposta:

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

Indicadores de tipo:

• AB = String
• # = Número
• ☑ = Boolean
• {} = Object

Binary

Visualização de Dados Binários

O verdadeiro JSON Dados e metadados do arquivo:

data
─────────────────────────────
File Name: swissqr_code_data.json
File Extension: json
Mime Type: application/json
File Size: 1.0 KB

Acesso a dados binários:

• n8n Objeto Binário: $binary.data.data
• Base64 ContenteDisponível para uso direto.
• Operações com arquivosPronto para download, envio por e-mail ou armazenamento.

Casos de uso

Processamento de Pagamentos e Serviços Bancários Suíços

• Processe automaticamente pagamentos de contas com QR Code suíço, lendo informações de pagamento de faturas, recibos e documentos de pagamento para permitir a conciliação automática de pagamentos e a integração contábil.
• Extraia detalhes de pagamento de códigos QR suíços incorporados em faturas e contas para facilitar o processamento automatizado de pagamentos e reduzir a entrada manual de dados nos sistemas bancários e financeiros suíços.
• Processar confirmações de pagamento e registros de transações através da leitura de códigos QR suíços para verificar valores de pagamento, informações do destinatário e referências de transação para fins de conformidade financeira na Suíça.

Gestão de negócios e faturas na Suíça

• Leia códigos QR suíços em faturas comerciais e documentos de pagamento para extrair informações do cliente, valores de pagamento e detalhes da transação para processos automatizados de contabilidade e escrituração.
• Processar pagamentos e documentos oficiais do governo suíço através da leitura de códigos QR suíços para extrair informações de pagamento e garantir a conformidade com as regulamentações financeiras e os requisitos de declaração de impostos suíços.
• Extraia dados de pagamento de códigos QR suíços em contas de serviços públicos, faturas de serviços e pagamentos de assinaturas para permitir o processamento automatizado de pagamentos e a gestão de contas de clientes.

Comércio eletrônico e transações digitais na Suíça

• Processar pagamentos online e transações de comércio eletrônico através da leitura de códigos QR suíços em recibos digitais e confirmações de pagamento, permitindo o processamento automatizado de pedidos e fluxos de trabalho de atendimento ao cliente.
• Extrair informações de pagamento de códigos QR suíços em aplicativos de pagamento móvel e carteiras digitais para facilitar a verificação de transações e o registro financeiro automatizado.
• Processe pagamentos de assinaturas e cobranças recorrentes lendo códigos QR suíços para extrair detalhes de pagamento e permitir o gerenciamento automatizado de faturamento para clientes e empresas na Suíça.

Obtenha ajuda

n8n Integration GuideGet your API Keyn8n SampleGetting Started