Pular para o conteúdo principal

Leia o código SwissQR em Make

Leia o código SwissQR é um Make módulo que lê suíço QR códigos de PDF faturas automaticamente, extraindo o valor total. QR-conta (QRCarga útil da fatura: IBAN, valor, moeda (CHF/EUR), credor, devedor e número de referência. Use-o para automatizar contas a pagar e conciliação de pagamentos para faturas suíças em Make Sem entrada manual de dados.

O que este módulo faz

PDF4meLeia o código SwissQR Detecta e decodifica automaticamente o suíço QR-conta (QR-Rechnung) carga útil de qualquer PDF fatura em seu Make cenário. Ele retorna todos os campos de pagamento estruturados e prontos para uso, IBAN, valor, moeda, nome e endereço do credor, detalhes do devedor, número de referência e informações adicionais de faturamento, para que seu fluxo de trabalho de contas a pagar, conciliação ou iniciação de pagamento possa ser executado sem que ninguém precise ler ou digitar manualmente os dados da fatura.

Artigos relacionados no blogue(1)

Autenticando seu API Solicitar

Todo PDF4me módulo em Make requer um válido ConexãoCrie ou selecione um que contenha o seu PDF4me API chave para que o cenário possa autenticar suíço QR decodificando solicitações com segurança.

Fatos importantes que você não deve perder

Todos os três tipos de referência suíços são suportados.
O módulo lida com QRR (27 dígitos) QR referência utilizada para correspondência bancária automática), SCOR (ISO 11649 referência do credor), e NON (sem referência). O campo Tipo de Referência na saída indica exatamente qual formato foi encontrado na fatura, para que sua lógica subsequente possa lidar corretamente com cada caso.
QR O código é encontrado automaticamente em qualquer página.
Você não precisa informar ao módulo qual página é a suíça. QR O código aparece. Ele examina todas as páginas do PDF e localiza o QR- Emita faturas automaticamente, independentemente de a fatura ter uma ou várias páginas. Isso significa que você pode processar faturas com várias páginas. PDFs sem qualquer pré-divisão ou configuração de número de página.
Informações adicionais podem conter dados contábeis da Swico S1.
Quando o emissor da fatura incluiu informações de faturamento estruturado Swico S1 no QR A carga útil, o campo Informações Adicionais, retorna-a juntamente com o texto da mensagem não estruturada. O Swico S1 pode incluir VAT Taxas, condições de pagamento e referências contábeis são dados adicionais que vão além dos campos de pagamento principais e são valiosos para a automação. AP reserva.
O módulo PDF4me Read SwissQR Code mostra a conexão definida como TestUser01 e o arquivo definido como Map, com os campos Nome do Arquivo e Documento mapeados na etapa 1.

Arquivo definido para Map passa o nome do arquivo e PDF buffer de qualquer módulo anterior. O módulo examina cada página e retorna o Swiss completo. QR-carga útil para pagamento de contas.

Parâmetros

Obrigatório: É necessário fornecer a conexão, o nome do arquivo e o documento. PDF deve conter um documento suíço válido QR-cobrança para o módulo que retorna os dados de pagamento.

ParâmetroObrigatórioO que fazExemplo
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

Saída

O módulo retorna o valor total suíço. QR-carga útil da fatura como campos mapeados individuais no Make pacote.

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

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

  1. Adicionar PDF4meLeia o código SwissQR para o seu Make cenário.
  2. Selecione Conexão (ou clique) Adicionar para criar um com o seu API chave).
  3. Mapa Nome do arquivo e Documento do módulo anterior: um monitor de anexos de e-mail, um arquivo de armazenamento em nuvem para obter informações ou HTTP download.
  4. Clique Salvar e execute o cenário. Os campos de saída: IBAN, Quantia, Moeda, Credor, Devedor, Referência, Tipo de referência, e Informações adicionais: estão todos disponíveis para mapeamento em módulos subsequentes.

Quando devo usar a função "Ler código SwissQR"? Make?

Exemplos de fluxo de trabalhoCommon Make scenario patterns using Read SwissQR Code.
Automatize as contas a pagar a partir de faturas suíças recebidas.
  1. O recurso de monitoramento de e-mail é acionado quando uma fatura de um fornecedor com endereço de e-mail suíço é enviada. QRA conta chegou.
  2. Leia trechos de código QR suíço IBANValor, referência e detalhes do credor.
  3. Um HTTP O módulo envia os dados de pagamento para o banco da empresa ou ERP API.
  4. Uma linha do Google Sheets é criada registrando a referência da fatura, o valor e o credor. AP Registrar.
Conciliar os pagamentos bancários recebidos com as faturas em aberto.
  1. Um gatilho programado é executado diariamente para processar o download do extrato bancário.
  2. Para cada pagamento não correspondido, o Read SwissQR Code extrai a referência da fatura enviada correspondente. PDF.
  3. A referência é comparada com os registros de faturas em aberto no banco de dados, e as faturas correspondentes são marcadas automaticamente como pagas.
  4. Um e-mail de resumo é enviado para o AR A equipe listou os pagamentos correspondentes e não correspondentes do dia.
Arquive as faturas por nome do credor usando QR dados
  1. A pasta de monitoramento do Dropbox é acionada quando uma nova fatura suíça é emitida. PDF é colocado na pasta da caixa de entrada.
  2. O recurso Ler Código QR da SwissQR extrai o nome e a referência do credor. QR carga útil.
  3. O Google Drive cria uma pasta para o credor (caso ela não exista) e carrega a fatura com a referência como nome do arquivo.
  4. Uma notificação do Slack alerta o AP equipe informada de que uma nova fatura foi emitida e está pronta para aprovação.

Perguntas frequentes

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

Obtenha ajuda