Leia o código SwissQR em Zapier

Leia o código SwissQR é um Zapier ação por PDF4me que decodifica o suíço QR-bilhete embutido em um PDF e devolve o credor, o devedor, IBAN, quantidade e dados de referência como JSONUse-o para renomear faturas automaticamente, conciliar pagamentos com registros contábeis ou encaminhar documentos por valor ou referência sem a necessidade de entrada manual de dados.

Artigos relacionados no blogue(1)

Contas de QR Code suíças acumuladas no Dropbox? Renomeie-as automaticamente no Zapier com o Code by Zapier.

Renomeie automaticamente PDFs de faturas SwissQR no Zapier: Novo arquivo na pasta → PDF4me Ler código SwissQR → Código gerado pelo Zapier (analisar JSON, extrair devedor/credor) → Carregar arquivo. Sem etapa de localização de arquivo. Passo a passo com capturas de tela do Dropbox. Funciona com SharePoint e Google Drive.

Ler publicação →

O que esta ação faz

PDF4me Leia o código SwissQR leva um PDF contendo um suíço QR-conta (QR-Fatura) e retorna seus dados de pagamento estruturados, dentro de um Zap. Mapeie o Arquivoe a ação retorna Texto do documento, um JSON corda com IBAN, credor, credor final, devedor, valor, moeda e campos de referência. Analise-o com um código por Zapier Etapa para impulsionar a renomeação de faturas, a conciliação de pagamentos ou a automação contábil.

Autenticando seu API Solicitar

Para acessar o PDF4me Web API através ZapierCada solicitação deve incluir credenciais de autenticação adequadas.

Get your API Key

Fatos importantes que você não deve perder

O texto do documento é um JSON string, não campos individuais

A ação retorna um campo, Texto do documento, contendo toda a carga útil decodificada como um JSON string. Você precisa de um código por Zapier (Executar JavaScript) passo a passo para JSON.parse isso antes de mapear valores individuais como IBAN ou ud_Name.

Os nomes dos campos usam os prefixos cr_/ucr_/ud_

cr_ é o credor, ucr_ é o credor final (geralmente em branco), e fora_ é o devedor final, em conformidade com os Padrões de Pagamento Suíços (SPC) nomenclatura de campos. cr_Nome e ud_Name São os dois campos mais utilizados nos fluxos de trabalho.

Use o arquivo original para o PDF, não o resultado desta ação

A leitura do código SwissQR retorna dados sobre o PDF, não passa no PDF si mesma em diante. Continue fazendo referência a Arquivo a partir do seu gatilho para qualquer etapa de Upload de Arquivo, e-mail ou armazenamento.

Configurar painel de ações: somente o arquivo é obrigatório, o nome do arquivo é opcional.

Parâmetros

Requerido no Zapier UI: Arquivo. O nome do arquivo é opcional.

Parâmetro	Obrigatório	O que faz	Exemplo
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

Saída

A ação retorna os metadados do arquivo mais um campo de carga útil. Texto do documento, um JSON string. Analise-a para chegar ao suíço individual. QR-campos da fatura listados abaixo da tabela.

Campo	Tipo	O que contém
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 do documento (após JSON.parse)

Campo	O que contém
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.

Como faço para configurar a leitura do código SwissQR em Zapier?

1. Adicionar PDF4me como o aplicativo de ação no seu Zap e escolha Leia o código SwissQR.
2. Conecte seu PDF4me Crie uma conta ou selecione uma conexão existente.
3. Mapa Arquivo para os suíços QR-conta PDF a partir do seu gatilho ou de uma etapa anterior. Opcionalmente, mapeie. Nome do arquivo.
4. Teste a etapa e inspecione Texto do documento No painel de saída de dados, é um JSON corda.
5. Adicionar um Código por Zapier (Executar JavaScript) etapa que recebe o texto do documento, executa JSON.parsee retorna o campo específico que você precisa (ud_Name, cr_Nome, IBAN, Referência, ou outros).
6. Mapa que analisou o valor em Carregar arquivo (para renomear), um Filtro ou Caminhos etapa (para roteamento) ou uma ação em planilha/contabilidade.

O que é o suíço QR-Bill e por que precisa de um leitor especial?

Os suíços QR-conta (QRO formato de comprovante de pagamento suíço (Rechnung) tornou-se o único comprovante de pagamento válido na Suíça em 30 de setembro de 2022, substituindo os antigos comprovantes laranja e vermelho. Ele codifica o credor, o devedor, IBAN, quantidade e dados de referência dentro de um QR código usando o SPC (Código de Pagamento Suíço) estrutura, uma ordem de campo fixa que um código de barras genérico ou QR O scanner lê o texto bruto, mas não consegue mapeá-lo para campos nomeados. O comando "Read SwissQR Code" decodifica isso. SPC estrutura e a retorna como nomeada JSON campos.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Zapier patterns using Read SwissQR Code.

Renomear automaticamente as faturas pelo nome do devedor.

1. Um gatilho para Novo Arquivo na Pasta (Dropbox, Google Drive, SharePoint) dispara contra um novo suíço QR-conta PDF.
2. A função "Ler código SwissQR" é executada com o arquivo e o nome do arquivo mapeados a partir do gatilho, retornando o texto do documento.
3. Um código por Zapier A etapa analisa o texto do documento e retorna ud_Name (o devedor).
4. O upload do arquivo salva o mesmo PDF Conteúdo com o nome analisado para que os arquivos possam ser pesquisados por pagador.

Conciliar os pagamentos recebidos com os registros contábeis.

1. Um gatilho de e-mail ou pasta entrega um suíço QR-conta PDF.
2. A leitura do código SwissQR extrai o texto do documento e, em seguida, o código. Zapier análise de etapas IBANValor e Referência.
3. Uma etapa de pesquisa em um sistema de contabilidade (QuickBooks, Xero ou um banco de dados personalizado) relaciona a Referência a uma fatura em aberto.
4. Uma etapa subsequente marca a fatura como paga e registra a transação.

Rota por valor ou tipo de referência

1. A função "Read SwissQR Code" é executada em uma fatura recebida e retorna o texto do documento.
2. Um código por Zapier A etapa analisa o valor (Amount) e o tipo de referência (ReferenceType).
3. Uma etapa do Paths direciona pagamentos de alto valor para uma fila de aprovação manual e QRR-pagamentos referenciados para lançamento automático.

Dicas práticas

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.

Folha de dicas

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)

Perguntas frequentes

What does Read SwissQR Code actually return?+

The action returns Doc Text, a JSON string containing the decoded Swiss QR-bill fields: QRType, Version, CodingType, IBAN, creditor fields (cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country), ultimate creditor fields (ucr_*), Amount, Currency, ultimate debtor fields (ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country), ReferenceType, Reference, UnstructuredMessage, and BillingInfo. It also returns file metadata (File Name, File Extension, Full File Name, File Alternate Url, Document Id, File Size) for the generated JSON response file.

Do I need a separate step to parse the output?+

Yes. Doc Text is a single JSON string, not individually mapped fields. Add a Code by Zapier (Run JavaScript) step, run JSON.parse on the Doc Text value, and return the specific field you need such as data.ud_Name or data.IBAN so later steps in the Zap can map it directly.

What is the Swiss QR-bill and why does it need a special reader?+

The <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/qr-bill.html" target="_blank" rel="noopener noreferrer">Swiss QR-bill (QR-Rechnung)</a> is the Swiss Payment Standards format that became the only valid Swiss payment slip on 30 September 2022. It encodes structured payment data (IBAN, creditor, debtor, amount, reference) inside a QR code using the SPC data format, a fixed field order that a generic barcode or QR scanner cannot parse into named fields without knowing that structure.

Can I use the extracted data to rename or route the PDF?+

Yes. A common pattern parses Doc Text for ud_Name (debtor) or cr_Name (creditor) and uses that value as the filename in an Upload File step, or checks Reference or Amount in a Filter or Paths step to route the invoice. Use the original File field from your trigger for the file content, this action's output only carries data, not the PDF. See <a href="https://www.iso20022.org/" target="_blank" rel="noopener noreferrer">ISO 20022</a> for background on the structured payment messaging standard the Swiss QR-bill builds on.

Ações relacionadas

Criar fatura SwissQR

A ação de contrapartida gera um suíço QR-conta PDF de IBAN, credor e dados de valor em vez de ler um.

Classificar documento

Classificar entrada PDFs Primeiro, classifique por tipo e, em seguida, execute a leitura do código SwissQR apenas nos códigos classificados como suíços. QR-contas.

Analisar documento

Para faturas sem código suíço QR-bill, extrai os dados do item de linha e do cabeçalho usando um modelo de análise mapeado.

Casos de uso e aplicações industriais

Swiss Banking & Financial Services

• Processamento de PagamentosLeia os códigos SwissQR para processamento automatizado de pagamentos e gestão de transações.
• Gestão de TransaçõesExtrair dados de pagamento para processamento e conciliação abrangentes de transações.
• Relatórios de ConformidadeInserir dados decodificados de referência e valor em registros internos de auditoria.
• Atendimento ao ClienteProcessar pagamentos e consultas de clientes com reconhecimento automático de código SwissQR.

Swiss Business & Professional Services

• Processamento de faturasLeia os códigos SwissQR das faturas para processamento automatizado de pagamentos e contabilidade.
• Gestão de ClientesExtrair informações de pagamento para faturamento e rastreamento de pagamentos de clientes.
• Gestão FinanceiraAutomatize a leitura de códigos SwissQR para uma gestão financeira completa.
• Automação de DocumentosSimplifique o processamento de documentos comerciais com a leitura integrada de códigos SwissQR.

Swiss E-commerce & Retail

• Processamento de PedidosLeia os códigos SwissQR para processamento automatizado de pedidos e cobrança de pagamentos.
• Rastreamento de PagamentosExtrair dados de pagamento para um rastreamento completo de pedidos e pagamentos.
• Experiência do clienteMelhore a experiência de pagamento do cliente com o processamento automatizado de códigos SwissQR.
• Gestão de estoqueVincular dados de pagamento ao gerenciamento de estoque e ao processamento de pedidos.

Swiss Government & Public Sector

• Serviços PúblicosLeia os códigos SwissQR para serviços governamentais e processamento de pagamentos do setor público.
• Administração TributáriaExtrair dados de pagamento para o processamento de impostos e taxas governamentais.
• Gestão de RegistrosInserir dados de pagamento decodificados nos registros internos da contabilidade do setor público.
• Serviços digitaisModernize o processamento de pagamentos do setor público com a automação do SwissQR Code.

Obtenha ajuda

Zapier IntegrationGet your API KeyZapier Documentation