Criar nota QR suíça em n8n
O que este nó faz
PDF4meCriar nota QR suíça gera comprovantes de pagamento QR suíços totalmente compatíveis incorporados em PDF documentos através do seu n8n Fluxo de trabalho de automação. Forneça um PDF fatura via dados binários, base64, URL, ou nenhum documento de fundo, o nó gera uma fatura QR suíça padronizada com Detalhes do credor e do devedor, IBAN, números de referência, etiquetas multilíngues e formatos de saída configuráveis Em uma única etapa automatizada. Totalmente compatível com todos os bancos suíços. PostFinancee as Normas de Pagamento Suíças (SPS) especificação.
Artigos relacionados no blogue(2)
Autenticando seu API Solicitar
Todo PDF4me nó em n8n requer um válido Credencial para se conectar comCrie ou selecione um que contenha o seu PDF4me API chave para que o fluxo de trabalho possa autenticar com segurança as solicitações de geração de faturas QR suíças.
Fatos importantes que você não deve perder
banco suíço IBAN É obrigatório, o formato é rigorosamente validado.
O IBAN O campo deve conter um documento suíço válido. IBAN começando com CH seguido por 19 dígitos. Um valor inválido. IBAN faz com que o nó retorne um erro e interrompa o fluxo de trabalho. Sempre valide o IBAN Formate os dados antes de passá-los para o nó, especialmente ao mapeá-los dinamicamente a partir de um banco de dados ou entrada de formulário.
Use o tipo de dados de entrada "Nenhum" para gerar uma fatura QR independente sem fundo. PDF
Definir o Tipo de Dados de Entrada como "Nenhum" cria um recibo QR suíço limpo e independente, sem nenhum documento de fatura subjacente. Esta é a opção correta para lembretes de pagamento, avisos de assinatura vencida e qualquer fluxo de trabalho onde não haja um documento de fatura subjacente. PDF O código foi gerado. O resultado é uma fatura com código QR pronta para envio, no formato escolhido.
É necessário um endereço estruturado para a conciliação bancária automatizada.
Tanto o Credor quanto o Devedor Final oferecem opções de endereço Estruturado ou Combinado. O endereço Estruturado armazena os componentes separadamente — rua, número, CEP e cidade — e é obrigatório quando a fatura com QR Code será processada por sistemas bancários suíços automatizados ou softwares de conciliação de pagamentos. Utilize sempre o endereço Estruturado, a menos que haja um motivo específico para usar o endereço Combinado.
Campos para painel superior, conexão, tipo de entrada, detalhes de pagamento e endereço do credor.
Painel inferior: endereço do devedor, tipo de referência, idioma, formato, paginação e configuração de saída.
Parâmetros
Requerido no n8n UI: Credencial de conexão, Tipo de dados de entrada, Valor, Moeda, IBAN, Nome do Credor, Tipo de Endereço do Credor, Tipo de Endereço do Devedor Final, Tipo de Referência, Tipo de Idioma, Linha Separadora, Tipo de Formato e (quando o Tipo de Formato for PDFOpções de paginação. Todos os campos de endereço, código postal e cidade estão marcados como opcionais. UI mas são Altamente recomendado para notas QR suíças válidas., a especificação dos Padrões de Pagamento Suíços e o PDF4me API trate-os como efetivamente necessários para uso em produção. O payload de execução sempre os envia (como strings vazias, se estiverem em branco).
| Parâmetro | Obrigatório | O que faz | Exemplo |
|---|---|---|---|
| Input Data Type | Conditional | How the source PDF is supplied. None generates a standalone QR bill with no background document. Binary Data reads from a previous n8n node: the most common option. Base64 String accepts encoded file content. URL downloads from a public link. | Binary Data |
| Binary Property Name | Conditional | Name of the binary field from the previous node. Required when Input Data Type is Binary Data. Maps to the output binary field of a prior download or file node. | data |
| Base64 Content | Conditional | Base64-encoded PDF content. Required when Input Data Type is Base64 String. | JVBERi0xLjQK... |
| File URL | Conditional | Public URL to the source PDF file. Required when Input Data Type is URL. | https://example.com/invoice.pdf |
| File Name | Conditional | Filename of the source PDF input. Shown only when Input Data Type is Binary Data, Base64 String, or URL: hidden for None. Include the .pdf extension. | document.pdf |
| Amount | Yes | Payment amount for the Swiss QR bill. Enter without leading zeroes (per the node field description). Must be a positive number with up to two decimal places. | 1000 |
| Currency | Yes | Currency for the QR bill. Only two options accepted: CHF (Swiss Franc, standard for domestic Swiss payments) or EUR (cross-border transactions). | CHF |
| IBAN | Yes | Creditor's Swiss IBAN. Must start with CH followed by 19 digits and be linked to a valid PostFinance or Swiss bank account. An invalid IBAN halts the workflow. | CH0200700110003765824 |
| Creditor Name | Yes | Full name of the creditor company or individual as registered with the bank. Printed on the generated QR bill in the creditor section. | Test AG |
| Creditor Address Type | Yes | Address format for creditor information. Sent as code S (Structured: components stored separately for maximum SPS compliance) or K (Combined, two free-form lines). | Structured (S) |
| Creditor Address Line 1 | No | Street name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills: always provide it. When Address Type is Structured, enter the street name only. | Test Strasse |
| Creditor Address Line 2 | No | House number or secondary address detail. Used as the second address line when Creditor Address Type is Structured. | 1 |
| Creditor Postal Code | No | Swiss postal code for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must be a 4-digit Swiss postal code matching the creditor city. | 8000 |
| Creditor City | No | Swiss city name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must correspond to the postal code entered above. | Zurich |
| Ultimate Debtor Name | No | Full name of the party who will pay the bill. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. Appears in the payment section of the printed QR bill. | Test Debt AG |
| Ultimate Debtor Address Type | Yes | Address format for the ultimate debtor. Sent as code S (Structured: recommended for automated Swiss banking) or K (Combined, two free-form lines). | Structured (S) |
| Ultimate Debtor Address Line 1 | No | Street name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Test Deb Strasse |
| Ultimate Debtor Address Line 2 | No | House number or secondary address line for the debtor. Used as the second line when Ultimate Debtor Address Type is Structured. | 2 |
| Ultimate Debtor Postal Code | No | Swiss postal code for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | 8000 |
| Ultimate Debtor City | No | Swiss city name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Zurich |
| Reference Type | Yes | Sent as code NON (No Reference: simple payments), QRR (QR Reference, 27-digit numeric for PostFinance/Swiss bank reconciliation), or SCOR (Creditor Reference, ISO 11649 for SEPA-compatible cross-border payments). | NON |
| Language Type | Yes | Display language for QR bill labels and printed text. Options: English, German, French, Italian. Choose the language matching the recipient's Swiss region. | English |
| Separator Line | Yes | Visual separator between the invoice body and the QR bill tear-off section. Note the node field name is spelled "seperatorLine". Options: Line With Scissor (Swiss standard), Simple Line, No Line. | Line With Scissor |
| Format Type | Yes | Output file format for the generated QR bill. PDF is recommended for print-ready documents. PNG and JPEG for digital delivery. TIFF for archival quality. Empty or null for raw data output. | PDF |
| Paging Options | Conditional | Controls where the QR bill slip is placed in the output document. Required when Format Type is PDF. Options: First, Last, Add Page At End, Custom. | First |
| Page Number | Conditional | Specific page index for placing the QR bill. Shown and required only when Format Type is PDF and Paging Options is Custom. | 3 |
| Output File Name | No | Filename for the generated Swiss QR bill document. Default value is provided by the node. Include the extension matching your chosen Format Type. | swissqr_bill.pdf |
| Output Binary Field Name | No | Name of the binary field in the n8n output that holds the generated QR bill file. Default is data. Used to reference the file in subsequent workflow nodes. | data |
Opções avançadas
Todos os campos dentro do Opções avançadas A coleta de dados é opcional e oferece controle adicional sobre o conteúdo da fatura QR. Adicione-a através de Adicionar opção na interface do usuário do nó.
referênciaO número de referência real incorporado no código QR. Conteúdo obrigatório quando o Tipo de Referência for QRR (numérico de 27 dígitos) ou SCOR (ISO 11649 formato começando com RF).
mensagem não estruturadaNota de pagamento em formato livre impressa na fatura com QR Code, por exemplo "Fatura nº 2024-100, vencimento em 30 de novembro". Máximo de 140 caracteres quando combinada com billingInfo.
informações de faturamentoInformações de faturamento estruturadas de acordo com a especificação suíça de fatura QR, por exemplo, número da fatura, data da fatura, detalhes do IVA. Máximo de 140 caracteres quando combinado com unstructuredMessage.
av1Parâmetro de procedimento alternativo 1 (AV1). Reservado para futuros procedimentos alternativos de pagamento suíços.
av2Parâmetro de procedimento alternativo 2 (AV2). Reservado para futuros procedimentos alternativos de pagamento suíços.
perfisPersonalizado PDF4me Perfis de processamento. Aplique conjuntos de opções pré-configuradas para processamento avançado ou especializado de faturas por QR Code.
Opções de tipo de dados de entrada
Escolha como a fonte PDF entra no nó. Cada opção se adequa a um padrão de fluxo de trabalho diferente.
No menu suspenso Tipo de dados de entrada, quatro opções controlam como a fonte PDF é fornecido ao nó
NenhumNenhum documento de fundoGera um comprovante QR suíço independente, sem nenhum documento subjacente. PDFUse este formulário para lembretes de pagamento, avisos de assinatura ou qualquer caso em que não haja fatura. PDF existe a montante no fluxo de trabalho.
Dados bináriosArquivo do nó anterior, mais comumLê o PDF conteúdo binário diretamente da saída de um anterior n8n nós como o Google Drive Download, HTTP Solicitar ou ler arquivo binário. O campo Propriedade Binária especifica de qual campo de saída ler (padrão:
dados).String Base64Conteúdo do arquivo codificado em Base64Aceita o PDF como uma string codificada em base64. Use isso quando o arquivo chegar de um API resposta, um payload de webhook ou um campo de banco de dados que armazena documentos em base64 em vez de binário bruto.
URLBaixar a partir de um link públicoDisponibilizar um acesso público URL para o PDF arquivo. PDF4me baixa o arquivo diretamente do URL antes do processamento. O URL Deve ser aberto e não exigir autenticação para acesso.
Opções de tipo de endereço
Aplica-se a ambos. Tipo de endereço do credor e Tipo de endereço do devedor finalEscolha como os componentes do endereço serão armazenados nos dados do código QR.
EstruturadoRecomendado, campos de endereço separadosArmazena cada componente do endereço em seu próprio campo: nome da rua na Linha 1 do Endereço, número da casa na Linha 2 do Endereço, código postal e cidade separadamente. Este formato é exigido pela maioria dos sistemas bancários suíços para conciliação automática de pagamentos e é obrigatório para PostFinance processamento.
CombinadoDuas linhas de endereço de formato livreArmazena o endereço completo como duas linhas de formato livre combinadas, por exemplo, "Test Strasse 1" na linha 1 e "8000 Zurich" na linha 2. Mais simples de preencher, mas menos compatível com sistemas automatizados de conciliação bancária suíços. Use somente quando o formato estruturado não for viável.
Tipo de endereço do credor, estruturado vs. combinado
Tipo de endereço do devedor final: mesma opção que para o credor.
Opções de tipo de referência
Controla qual padrão de referência de pagamento está incorporado no código QR. Isso afeta a forma como o pagamento é associado à fatura no sistema do seu banco.
Tipo de referência: Sem referência, Referência por QR Code ou Referência do credor
Sem referênciaPor padrão, sem referência estruturada.Nenhuma referência de pagamento está incorporada no código QR. Use esta opção para pagamentos simples e pontuais, nos quais a conciliação é feita manualmente ou por meio de um sistema externo. O campo "Mensagem não estruturada" ainda pode ser usado para adicionar uma observação de pagamento em formato livre.
Referência QRconciliação bancária suíça numérica de 27 dígitosIncorpora uma referência numérica de 27 dígitos (semelhante à antiga referência ESR/ISR) no código QR. Esta é a opção padrão para faturas QR suíças nacionais vinculadas a PostFinance ou banco suíço IBANPermite a conciliação automática de pagamentos com seu extrato bancário. Requer o fornecimento de um valor no campo "Referência".
Referência do credorISO 11649, transfronteiriço SEPA pagamentosIncorpora um ISO 11649 Referência estruturada do credor no código QR. Use para SEPA-pagamentos transfronteiriços compatíveis ou quando o seu software de contabilidade exige referências ISO padronizadas. A referência começa com RF, seguida por um dígito verificador de dois dígitos e até 21 caracteres alfanuméricos.
Opções de tipo de formato
Controla o formato do arquivo da fatura QR gerada.
Menu suspenso Tipo de formato, PDF, PNG, JPEG, TIFF, ou Vazio (nulo)
PDFPadrão, pronto para impressãoGera uma saída com fidelidade total. PDF Documento pronto para impressão, envio por e-mail ou arquivamento. A opção padrão para fluxos de trabalho de faturas.
PNGEntrega web e digitalGera a fatura QR como um arquivo. PNG Imagem. Ideal para incorporar em páginas web, portais de clientes ou comunicações digitais onde um formato de imagem seja necessário.
JPEGImagem adequada para envio por e-mailGera a fatura QR em formato comprimido. JPEG imagem. Tamanho de arquivo menor que PNGAdequado para incorporação em e-mails ou para entrega otimizada para dispositivos móveis, onde o tamanho do arquivo é importante.
TIFFQualidade de arquivoGera a fatura com código QR em alta resolução. TIFF Imagem. Ideal para sistemas de gerenciamento de documentos, retenção de registros e fluxos de trabalho de arquivamento que exigem máxima fidelidade de imagem.
Vazio (nulo)Saída de dados brutosRetorna os dados brutos da fatura QR sem um formato de arquivo específico. Use quando um sistema subsequente lida com a conversão de formato ou ao integrar com um sistema. API que consome dados binários brutos diretamente.
Opções de paginação
Controla a posição do comprovante de pagamento com QR Code no documento de saída em relação às páginas da fatura existente.
Opções de paginação: Primeira, Última, Adicionar página ao final ou Personalizada
PrimeiroPor padrão, fatura com QR Code na página 1.Insere o comprovante de pagamento com QR Code suíço no início do documento impresso, na primeira página. Utilize esta função quando a seção de pagamento com QR Code precisar aparecer antes dos detalhes da fatura.
DurarFatura QR na última páginaInsere o comprovante de pagamento com QR Code suíço na última página do documento existente. Use quando o conteúdo da fatura deve aparecer primeiro e o comprovante de pagamento no final, sem adicionar uma nova página.
Adicionar página no finalPágina de fatura com QR Code mais comum e dedicadaAnexa uma nova página dedicada contendo a fatura com QR Code suíço ao final do documento da fatura. Esta é a configuração mais comum para a automatização de faturas na Suíça: o conteúdo da fatura é preservado em suas próprias páginas e o comprovante de pagamento com QR Code recebe sua própria página.
PersonalizadoPosicionamento específico da páginaPermite o posicionamento personalizado do código QR na fatura dentro do documento. Use quando o seu modelo de fatura tiver um espaço reservado para o código QR em uma página ou posição específica que não seja a primeira nem a última.
Campos de saída
| Campo | Tipo | O que contém |
|---|---|---|
fileName | String | Filename of the generated Swiss QR bill document, for example swissqr_bill.pdf. Map into an upload or email node as the destination filename. |
mimeType | String | MIME type of the output file, for example application/pdf. Useful for content type validation in downstream HTTP or storage nodes. |
fileSize | Number | Size of the generated QR bill file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow. |
success | Boolean | True when the Swiss QR bill was created successfully. False if an error occurred during generation. Use this field to route error handling branches in your workflow. |
message | String | Human-readable status message confirming success or describing the error encountered. Useful for logging and error notification steps. |
Configuração rápida
- Adicionar PDF4me para o seu n8n Fluxo de trabalho. Configurar Recurso para Fatura e Operações de Faturamento para Criar fatura SwissQR.
- Em Credencial para se conectar com, selecione o seu PDF4me credencial ou clique Criar nova credencial e cole o seu API chave.
- Definir Tipo de dados de entrada: conectar a saída binária de um nó anterior (Dados Binários), fornecer um Base64 string, forneça um público URLOu selecione "Nenhum" para um comprovante QR independente.
- Entre no Quantia, Moeda (Franco suíço para pagamentos em CHF), e IBAN (Crédito suíço válido) IBAN começando com CH).
- Preencha tudo Credor Campos: Nome, Tipo de Endereço (Recomenda-se o formato estruturado), Endereço (1ª linha), Endereço (2ª linha), CEP e Cidade.
- Preencha tudo Devedor final Campos com o nome completo e endereço da parte pagadora.
- Definir Tipo de referência (A opção padrão é "Sem referência") Tipo de idioma (inglês, alemão, francês ou italiano), e Linha Separadora (Alinhar com tesoura é o padrão suíço).
- Configurar Tipo de formato (PDF recomendado) e Opções de paginação (Adicionar página no final para anexar uma página de fatura com QR Code a uma fatura existente).
- Definir Nome do arquivo de saída para
swissqr_bill.pdfe Nome do campo binário de saída paradata. - Conecte a saída ao seu próximo nó: remetente de e-mail, upload para armazenamento em nuvem, gravação no banco de dados e execute o fluxo de trabalho.
Exemplos de fluxo de trabalho
Exemplos de fluxo de trabalhoCommon n8n workflow patterns using Create Swiss QR Bill.
Lote mensal de faturas → Fatura com QR Code suíço → envio por e-mail aos clientes
- Um gatilho de agendamento é acionado no primeiro dia de cada mês para iniciar o processo de faturamento.
- Um nó do Google Drive lista todas as faturas. PDFUm comprovante por cliente está na pasta de faturamento mensal.
- Um nó "Loop Over Items" itera por cada arquivo. Para cada um, um nó "Google Drive Download" recupera o conteúdo binário.
- PDF4me O Create Swiss QR Bill anexa um comprovante de pagamento QR compatível a cada fatura, utilizando o valor fornecido pelo cliente. IBANe o endereço foi mapeado a partir de um registro de cliente do Google Sheets. O tipo de idioma está definido como alemão. A opção de paginação é "Adicionar página ao final".
- Um nó do Gmail envia a fatura com código QR. PDF como anexo de e-mail para cada cliente. O nome do arquivo utiliza o ID do cliente para facilitar a referência.
Pedido de comércio eletrônico confirmado → Fatura com QR Code → salvar em SharePoint
- Um gatilho Webhook é acionado quando um pedido é confirmado na plataforma de comércio eletrônico.
- Um HTTP O nó de solicitação gera uma fatura. PDF de um HTML Modelo usando os dados do pedido.
- PDF4me O recurso Criar Fatura Suíça com QR Code anexa um comprovante QR Code compatível à fatura. PDFOs dados do valor e do devedor são mapeados a partir da carga útil do webhook. O Tipo de Referência está definido como Referência do Credor para fins de conciliação. O Tipo de Idioma é Francês para a Suíça francófona.
- Um produto da Microsoft SharePoint O nó carrega a fatura QR preenchida. PDF para a pasta de arquivo de Pedidos.
- Um HTTP O nó de solicitação atualiza o status do pedido para "Fatura enviada". CRM sistema.
Assinaturas em atraso → fatura QR independente → lembrete de pagamento
- Um gatilho de agendamento é acionado toda segunda-feira de manhã para verificar se há contas de assinatura em atraso.
- Um nó do PostgreSQL consulta todas as contas com saldos pendentes com mais de 14 dias.
- Um nó Loop Over Items processa cada assinante. PDF4me O processo para criar uma fatura QR suíça é realizado com o Tipo de Dados de Entrada definido como Nenhum, sem plano de fundo. PDF, gerando uma fatura QR independente e limpa. O nome e o endereço do devedor são mapeados a partir do registro do banco de dados. O Tipo de Referência é Sem Referência. O Tipo de Idioma é Italiano para a Suíça de língua italiana.
- Um produto da Microsoft Outlook O Node envia um e-mail de lembrete de pagamento para cada assinante com a fatura QR independente. PDF apegado.
- Um nó do PostgreSQL registra o carimbo de data/hora do envio do lembrete e incrementa a contagem de lembretes para cada conta.
Perguntas frequentes
Ações relacionadas
Dividir PDF por QR suíço
Dividir PDF Documentos em locais com código QR na Suíça para organização inteligente de lotes de documentos e extração individual de faturas.
Leia o código QR suíço
Extrair e analisar dados de pagamento incorporados em códigos QR suíços em PDF Faturas para conciliação automatizada e captura de dados.
Criar fatura ZUGFeRD
Gere faturas eletrônicas estruturadas com recursos incorporados. XML para faturamento eletrônico em conformidade com a UE, juntamente com fluxos de trabalho QR suíços.
Mesma tarefa em outras plataformas
Criar nota QR suíça (Make)
Mesma operação de QR Bill suíço que um Make módulo, mesmo SPS-Geração de comprovantes de pagamento em conformidade com as normas, IBAN Validação e campos estruturados de credor/devedor para construtores de cenários visuais.
Criar nota QR suíça (Zapier)
Mesma operação que um Zapier ação, ideal para SaaS Plataformas de faturamento que acionam a emissão de faturas por QR Code suíço através do Gmail, Slack, ferramentas de contabilidade e fluxos de trabalho baseados em webhooks.
Criar nota QR suíça (Power Automate)
Power Automate / Microsoft 365 fluxos, ideal para SharePoint bibliotecas de documentos, Outlook e-mails de faturamento e Dynamics Integrações do 365 Finance em ambientes empresariais suíços.