Gerador e validador de QR-fatura suíça: secção de pagamento, PDF e controlo do QR
Introduza a conta, a referência e as moradas: a ferramenta constrói o texto do QR, verifica-o regra a regra, desenha o talão de pagamento (recibo e secção de pagamento, 210 × 105 mm, cruz suíça ao centro do código) e exporta-o em PDF A4. Verifica também o texto de um QR existente. Gratuito, sem conta, e nada sai do seu navegador.
Ferramenta interativa
Passe do cálculo à gestão completa
Tenha as suas referências à mão e depois automatize-as nos seus orçamentos, propostas e contas.
Guia da ferramenta
Como criar uma QR-fatura com esta ferramenta
1. Conta, tipo de referência e número
Introduza o IBAN da sua conta (os espaços são aceites): a ferramenta reconhece um QR-IBAN (identificação do banco de 30000 a 31999) e escolhe então a referência QR; com um IBAN normal, escolha a referência do credor « RF » ou nenhuma referência. Para uma referência, introduza um número (o da sua fatura, por exemplo) e prima « Calcular o dígito de controlo »: a ferramenta completa os zeros e o dígito de controlo (27 dígitos para uma referência QR) ou acrescenta « RF » e a chave ISO 11649 (referência do credor).
2. Endereços, montante, mensagem
A sua morada é obrigatória, em formato estruturado: nome, rua, número, código postal, localidade e país. A do devedor é facultativa: se a deixar vazia, o talão imprime um campo « A pagar por » a preencher à mão; da mesma forma, sem montante (doação, montante escolhido pelo devedor), está previsto um campo de 40 × 15 mm. A mensagem (« Informações adicionais ») e a informação de faturação codificada não excedem 140 carateres em conjunto. A caixa « aviso » produz um talão informativo a 0.00 com a menção « NÃO UTILIZAR PARA PAGAMENTO » na língua escolhida.
3. Exportar: PDF A4, SVG, texto do QR
O PDF A4 coloca o talão no fundo da página (210 × 105 mm, linhas de corte com tesoura); a parte superior da página inclui, se desejar, a sua morada, a do destinatário e um texto livre que não entra no QR. O ficheiro SVG contém apenas o talão, em formato vetorial. O texto do QR pode ser copiado para ser utilizado noutro programa de faturação. Imprima sempre a 100 % (« tamanho real »).
O que a ferramenta controla, regra a regra
O mesmo motor (um serviço PHP e o JavaScript desta página, que dão resultados idênticos num corpus de ensaio) aplica as regras abaixo, extraídas das Swiss Implementation Guidelines for the QR-bill. Um erro é assinalado com o número de linha do QR e o campo em causa; um aviso assinala um desvio tolerado ou a vigiar.
| Elemento | Regra controlada | Capítulo da IG |
|---|---|---|
| Estrutura | Pelo menos 31 linhas, no máximo 34; separador «LF» ou «CR+LF» (um só tipo, nunca «CR» sozinho); no máximo 997 bytes UTF-8 (QR versão 25, nível M). | 4.1.4, 6.2 |
| Cabeçalho | «SPC», versão «0200», codificação «1». | 4.2.2 |
| IBAN | 21 carateres sem espaços, maiúsculas, país CH ou LI, chave módulo 97 exata. | 4.2.2 |
| Endereços | Apenas tipo «S»; nome 70, rua 70, número 16, código postal 16, localidade 35 carateres no máximo; código postal, localidade e país obrigatórios; país = código ISO 3166-1 (249 códigos). | 4.2.2, 4.3.1 |
| Beneficiário final | As 7 linhas permanecem vazias (uso futuro). | 4.2.2 |
| Montante e moeda | De 0.01 a 999999999.99, duas casas decimais, ponto decimal, sem zero à esquerda; 0.00 reservado ao aviso «não pagar»; CHF ou EUR. | 3.5.3, 4.2.2, 4.4 |
| Referência | QRR: 27 dígitos, dígito de controlo módulo 10 recursivo, não apenas zeros, com um QR-IBAN. SCOR: « RF » + 2 dígitos de controlo (módulo 97-10) + 1 a 21 carateres alfanuméricos, com um IBAN normal. NON: referência vazia. | 2.12, 4.2.2, 4.3.2, Anexo B |
| Mensagem e faturação | No máximo 140 carateres no conjunto; informação de faturação que começa por «//»; procedimentos alternativos de no máximo 100 carateres, no máximo dois. | 4.2.2, 4.3.3 |
| Carateres | Latim básico, Latin-1, latim estendido A, Ș ș Ț ț e o sinal do euro (U+20AC); nada mais. | 4.1.1 |
| A partir da versão 2.4 | A referência QR (QRR) já não é admitida em EUR (erro na versão 2.4, aviso na 2.3); em EUR, uma mensagem que acompanha uma referência estruturada nem sempre é transmitida (aviso). | 2.10, 2.12, 4.3.3 (IG 2.4) |
Que versão da norma, lida quando?
Os documentos foram descarregados e lidos a 7 de novembro de 2026 no sítio da SIX (six-group.com); são os únicos textos em que esta página se apoia.
| Documento | Data do documento | Aplicação |
|---|---|---|
| Implementation Guidelines QR-bill v2.3 (em inglês) | 20 de novembro de 2023 | Em vigor desde 21 de novembro de 2025 (a página da SIX indica 22 de novembro de 2025 para os novos requisitos); válida até novembro de 2027. |
| Implementation Guidelines QR-bill v2.4 | 24 de fevereiro de 2026 | Introduzida com a atualização SIC de 13 de novembro de 2026, válida a partir de 14 de novembro de 2026. |
| Style Guide QR-bill v1.1 | 19 de dezembro de 2025 (indicado pela SIX) | Em vigor desde 1 de janeiro de 2026. |
| Exemplos de dados SIX (arquivo «samples-data-schema») | março de 2021 | Anteriores à v2.3: 9 exemplos em 18 ainda usam o endereço «K». |
Pontos em que as fontes não coincidem
(1) Data de entrada em vigor da v2.3: 21 de novembro de 2025 no documento, 22 de novembro de 2025 na página da SIX. (2) A página da SIX escreve que « a introdução do endereço estruturado continua prevista para novembro de 2026 », embora a v2.3 já suprima o tipo « K » e as fichas da SIX de 2025 peçam que só se emitam moradas estruturadas a partir de 21 de novembro de 2025, com um breve período de transição para as faturas já enviadas; a única data de novembro de 2026 que encontramos nessas fichas é aquela em que os bancos devem ter adaptado as ordens permanentes e os modelos (13 de novembro de 2026). Não conseguimos explicar a frase da página da SIX; esta página aplica o texto das diretrizes: apenas « S ». (3) O anexo A da v2.3 imprime, para o seu exemplo n.º 4, a referência RF72 0191 2301 0040 5JSH 0438, cuja chave de controlo não passa o módulo 97; a chave correta é 24, como no exemplo de dados n.º 17 publicado pela SIX. O exemplo carregável na ferramenta usa a chave corrigida. (4) O Style Guide imprime « NE PAS UTILISER PUR LE PAIEMENT » e « Pagabile da » para o italiano de « Payable to »: a página segue as diretrizes (« POUR », « Pagabile a »).
A secção de pagamento: dimensões e disposição
O recibo mede 62 × 105 mm e situa-se à esquerda da secção de pagamento de 148 × 105 mm: em conjunto 210 × 105 mm, na parte inferior da página A4. As margens são de 5 mm. O código QR mede 46 × 46 mm, na menor versão possível (nível de correção de erros M, nunca mais de 997 bytes), com uma zona livre de 5 mm e, ao centro, a cruz suíça de 7 × 7 mm, cuja geometria segue o ficheiro oficial da SIX. Os títulos são em 11 pontos a negrito, as rubricas em 8 pontos a negrito e os seus valores em 10 pontos (6 e 8 pontos no recibo), em Helvetica, um dos quatro tipos de letra admitidos, a preto. Os campos vazios (« A pagar por » de 65 × 25 mm, montante de 40 × 15 mm, ou 52 × 20 e 30 × 10 mm no recibo) são marcados por marcas de canto de 3 mm. As posições do texto foram medidas nos exemplos à escala 1:1 do Style Guide, com uma precisão de alguns décimos de milímetro.
O IBAN é impresso em grupos de 4 carateres, a referência QR em grupos de 5 (começando pelos 2 primeiros dígitos) e a referência RF em grupos de 4. O montante leva a moeda antes de si, um espaço como separador de milhares e duas casas decimais. Para uma morada fora da Suíça, o código do país precede o código postal.
O que não é verificado
Nenhum banco nem balcão dos correios recebeu estes talões: nunca diga que são « aceites pelos bancos » antes do seu próprio teste. Também não estão verificados: a existência do banco (a lista oficial de identificadores não está integrada), a exatidão da morada, a correspondência entre o nome introduzido e o titular da conta (a norma exige que coincidam), a apresentação na sua impressora e no seu papel, os leitores de QR de todo o software bancário, o conteúdo da informação de faturação (a sua sintaxe é a do organismo que a definiu, por exemplo a Swico) e os procedimentos alternativos (eBill), cuja impressão não foi comparada com um exemplo publicado. O QR desta página foi relido com um descodificador independente e comparado módulo a módulo com outra biblioteca de geração; isto prova que o código se lê e se calcula corretamente, não que o seu banco o aceite.
Privacidade, proteção de dados e limites
Para onde vão os seus dados?
Em lado nenhum: esta página não envia nenhum dado de fatura, não o conserva no seu navegador e não chama nenhum serviço de geração de QR. O código é calculado por um codificador escrito para esta página. Uma QR-fatura contém nomes, moradas e um IBAN: o ficheiro PDF e o texto do QR são seus, e a sua divulgação é da sua responsabilidade.
O que a ferramenta não faz
Não lê uma imagem de QR (cole o texto lido pela sua aplicação bancária), não gere o envio por e-mail nem a numeração de faturas, não produz uma fatura completa (TVA, linhas de detalhe) e só imprime os tipos de letra standard: as letras fora do francês, do alemão e do italiano podem perder os acentos no papel. Não substitui o seu programa de faturação nem os conselhos do seu banco. Para orçamentar uma obra antes de a faturar, veja o software Soumission da Art Construction e o índice ACIP (Art Construction Indice de Prix); a ferramenta 3.3 sobre adendas ajuda a calcular um suplemento antes de o faturar.
Perguntas frequentes sobre a QR-fatura (FAQ)
1. Os dados da minha fatura são enviados à Art Construction?
Não. O formulário, o cálculo do código QR, a pré-visualização e os ficheiros PDF e SVG são produzidos no seu navegador: nenhuma rota do sítio recebe IBAN, morada, montante nem mensagem, e a página não escreve nada no seu navegador (nem cookie, nem armazenamento local). Um talão contém dados pessoais (nomes, moradas, IBAN): divulgue apenas o necessário (lei federal sobre a proteção de dados, LPD).
2. O meu banco aceitará esta secção de pagamento?
Não sabemos: o talão produzido aqui não foi experimentado nem num banco, nem num balcão dos correios. O conteúdo do QR é verificado segundo as regras das diretrizes da SIX (ver a lista mais abaixo) e o desenho segue as cotas do Style Guide, mas só um ensaio real o prova. Antes de enviar faturas em série, imprima uma, pague-a em e-banking com um pequeno montante e verifique se todos os dados (IBAN, referência, montante, moradas) são retomados corretamente. A SIX propõe também um portal de validação na sua página « ferramentas »; não o utilizámos para esta página.
3. Que versão da norma é aplicada?
As « Swiss Implementation Guidelines for the QR-bill » (IG) versão 2.3, válidas desde 21 de novembro de 2025 (a página da SIX indica 22 de novembro de 2025 para os novos requisitos) e até novembro de 2027, e a versão 2.4, válida a partir de 14 de novembro de 2026. Ambas foram lidas em 7 de novembro de 2026 em six-group.com, com o Style Guide 1.1 (em vigor desde 1 de janeiro de 2026). A versão 2.4 não traz nenhuma alteração técnica para a faturação em CHF; em EUR, apenas IBAN + referência do credor ou IBAN sem referência continuam possíveis. Escolha a versão no formulário: por predefinição, a que está em vigor na data do seu dispositivo.
4. Porque é que o meu endereço «combinado» (tipo K) é recusado?
Porque a versão 2.3 da norma suprimiu o tipo de morada « K »: só a morada estruturada « S » (nome, rua, número, código postal, localidade, país separados) é admitida no QR. As fichas da SIX de 2025 deixam apenas um curto período de transição para as faturas já emitidas com « K »; uma nova QR-fatura tem de estar em « S ». Os 18 exemplos de dados publicados pela SIX em 2021 misturam ainda os dois tipos: os 9 em « S » são reconhecidos como válidos por esta página, os 9 em « K » são recusados por essa razão.
5. Qual é a diferença entre IBAN e QR-IBAN, referência QR e referência RF?
Um QR-IBAN é um IBAN suíço ou do Listenstaine cujas posições 5 a 9 (identificação do banco) valem de 30000 a 31999: só se utiliza com uma referência QR de 27 dígitos cujo último é um dígito de controlo (módulo 10 recursivo). Um IBAN normal utiliza-se com uma referência do credor « RF » (ISO 11649, 5 a 25 carateres, chave módulo 97) ou sem referência. O botão « Calcular o dígito de controlo » completa o número da sua fatura. A partir da versão 2.4, a referência QR deixa de ser admitida em EUR.
6. Posso imprimir o PDF em papel normal?
Para pagar em e-banking ou com a aplicação do seu banco, o PDF basta. Para um pagamento ao balcão ou por ordem em papel, a norma exige um talão de 210 × 105 mm em papel branco perfurado de 80 a 100 g/m², impresso à escala exata (« tamanho real »), com uma perfuração entre a fatura e o talão e entre o recibo e a secção de pagamento. Um talão que não respeite as dimensões pode ser recusado ou cobrado com encargos adicionais (IG, capítulo 3.8).
7. Porque é que algumas letras perdem o acento no PDF?
O PDF utiliza o tipo de letra standard Helvetica (um dos quatro tipos admitidos), que não contém todas as letras que a norma tolera no QR (latim alargado A: č, ł, ő...). Essas letras são impressas sem acento; a página assinala-as e o QR mantém o texto exato. As letras do francês, do alemão e do italiano são todas desenhadas.
8. A cruz suíça é de utilização livre?
A norma precisa que a SIX Interbank Clearing detém os direitos sobre a imagem da cruz branca ao centro do QR e que qualquer desvio às diretrizes constitui uma violação dos seus direitos. A cruz desta página retoma a geometria do ficheiro oficial publicado pela SIX (7 × 7 mm): utilize-a como previsto nas diretrizes, para verdadeiras QR-faturas conformes, e não para outros fins.
