ESPECIFICAÇÕES TÉCNICAS

Código de Barras Bidimensional

Código QR

Portaria n.º 195/2020

Versão 1.0
Agosto 2020
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

HISTÓRICO DE ALTERAÇÕES

VERSÃO DATA ALTERAÇÕES

1.0 13-08-2020 Criação do documento

Página 1 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

ÍNDICE

1. Introdução ............................................................................................................... 3

2. Código de barras bidimensional (código QR) ................................................... 4

3. Composição da mensagem a constar no código QR ....................................... 4

4. Estrutura e conteúdos do código QR ................................................................. 5

5. Exemplos de construção do código QR ........................................................... 13

5.1. Exemplo 1 – Fatura .......................................................................................... 13

5.2. Exemplo 2 – Fatura simplificada .................................................................... 14

5.3. Exemplo 3 – Fatura pró-forma ........................................................................ 16

5.4. Exemplo 4 – Documento de transporte ........................................................ 18

Página 2 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

1. Introdução

O Decreto-Lei n.º 28/2019, de 15 de fevereiro, veio consolidar e modernizar as normas

relativas à faturação, introduzindo aspetos inovadores como o código único de
documento e o código de barras bidimensional (código QR), que visam a simplificação
na comunicação de faturas por parte de pessoas singulares para determinação das
respetivas despesas dedutíveis em sede de IRS, incrementando, simultaneamente, o
controlo das operações realizadas pelos sujeitos passivos, tendo em vista combater a
economia informal, a fraude e a evasão fiscal.

O código de barras bidimensional (código QR) deve constar, obrigatoriamente, nas

faturas e outros documentos fiscalmente relevantes, emitidos por programas
certificados pela Autoridade Tributária e Aduaneira (AT), nos termos do artigo 4.º do
Decreto-Lei n.º 28/2019, de 15 de fevereiro.

O presente documento define as especificações técnicas para a geração do código de

barras bidimensional (código QR), previstas Portaria n.º 195/2020, de 13 de agosto.

Os produtores de programas de faturação certificados pela AT, devem garantir a correta

geração do código QR, respeitando as especificações técnicas constantes no presente
documento, devendo ainda garantir a sua perfeita legibilidade dentro do corpo do
documento, independentemente do suporte em que seja apresentado ao cliente.

Em documentos com mais do que uma página, o código de barras bidimensional (código
QR) pode constar na primeira ou na última página.

Para apoiar os produtores de programas de faturação na implementação do código QR

nos seus programas, são identificados no presente documento os campos que devem
integrar na mensagem, com as respetivas instruções de preenchimento, bem como um
exemplo para cada campo.

São ainda disponibilizados exemplos de construção de código QR, contemplando

diversos tipos de documentos e diferentes mensagens.

Página 3 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

2. Código de barras bidimensional (código QR)

A elaboração do código de barras bidimensional (código QR) deve obedecer às

seguintes especificações:

a) Taxa de Recuperação de Erro (ECC): “M”;

b) Tipo: Byte;
c) Pontos por módulo (Size): 2;
d) Versão: v=9 (valor mínimo);
e) Dimensões de imagem: mínimo 30x30 milímetros;
f) Margem de Segurança (Margin): 0,25 cm.

3. Composição da mensagem a constar no código QR

Na criação da mensagem a incorporar no código QR devem ser observadas as

seguintes regras:

a) Cada campo será formado pela concatenação do valor da coluna “Código”,

constante na tabela do ponto 4, «:» (dois pontos) e o respetivo valor da coluna
“Descrição”, sem espaços;

b) Os campos assim criados, e sempre pela ordem indicada na tabela do ponto 4,

deverão ser concatenados com o separador «*» (asterisco);

c) O separador decimal deve ser o «.» (ponto) e nos campos monetários deverão
existir sempre duas (2) casas decimais;

d) Os campos assinalados com «+» são de criação obrigatória;

e) Os campos assinalados com «++», são opcionais, mas deverão ser criados
sempre que para eles exista informação;

Página 4 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

f) Nos campos opcionais, na ausência de informação não deverá ser criado o

respetivo campo;

g) Na criação dos campos com os códigos I1 a I8, J1 a J8 e K1 a K8,

representativos dos espaços fiscais para efeitos de IVA (por exemplo, PT, PT-
AC e PT-MA), deverá ter-se em atenção que pelo menos um espaço fiscal terá
sempre que existir;

h) Na composição do campo com o código I1, no caso de documento que deva

constar na tabela 4.2, 4.3 ou 4.4 do SAF-T(PT), emitido sem indicação da taxa
de IVA, deverá ser preenchido com «I1»«:»«0»;

i) Nenhum valor da coluna “Descrição” poderá ultrapassar o tamanho máximo

definido na tabela do ponto 4;

j) Na composição do campo com o código “S”, sempre que necessário, os

elementos que o compõem serão concatenados com «;» (ponto e virgula) sem
espaços.

4. Estrutura e conteúdos do código QR

Na geração do código QR, deverá ser respeitada a estrutura definida na tabela seguinte.

Página 5 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

Tamanho
Código Descrição Instruções Exemplo Obrigatório
Máximo
NIF do Preencher com o NIF do
A 9 A:123456789 +
emitente emitente sem prefixo do País.
Separador 1 * +
Preencher com o NIF do
Adquirente. Na emissão de
NIF do
B 30 documento a “Consumidor B:999999990 +
adquirente
Final” preencher com
999999990.
Separador 1 * +
Preencher de acordo com o
País do
C 12 campo Country da tabela de C:PT +
adquirente
clientes do SAF-T(PT).
Separador 1 * +
Tipo de Preencher de acordo com a
D 2 D:FT +
documento tipologia do SAF-T(PT).
Separador 1 * +
Estado do Preencher de acordo com a
E 1 E:N +
documento tipologia do SAF-T(PT).
Separador 1 * +
Data do Utilizar o formato
F 8 F:20191231 +
documento YYYYMMDD.
Separador 1 * +
Identificação
Preencher de acordo com a G:FT
G única do 60 +
tipologia do SAF-T(PT). AB2019/0035
documento
Separador 1 * +
Preencher com o código H:CSDF7T5H-
H ATCUD 70 +
único de documento. 0035
Separador 1 * +
Preencher de acordo com as
notas técnicas do campo
TaxCountryRegion do SAF-
T(PT).
I1 Espaço fiscal 5 No caso de documento sem I1:PT +
indicação da taxa de IVA, que
deva constar na tabela 4.2,
4.3 ou 4.4 do SAF-T(PT),
preencher com «0» (I1:0).

Página 6 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

Tamanho
Código Descrição Instruções Exemplo Obrigatório
Máximo
Separador 1 * ++
Valor total da base tributável
isenta de IVA (incluindo as
operações tributáveis em
sede do Imposto do Selo,
Base sejam isentas ou não de
I2 tributável 16 Imposto do Selo). I2:12000.00 ++
isenta de IVA
Formatar com duas casas
decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total da base tributável
sujeita à taxa reduzida de
Base IVA.
tributável de
I3 16 Formatar com duas casas I3:15000.00 ++
IVA à taxa
reduzida decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
reduzida no documento.
Total de IVA à Formatar com duas casas I4:900.00
I4 16 ++
taxa reduzida decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total da base tributável
sujeita à taxa intermédia de
Base IVA.
tributável de
I5 16 Formatar com duas casas I5:50000.00 ++
IVA à taxa
intermédia decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
intermédia no documento.
Total de IVA à
I6 taxa 16 Formatar com duas casas I6:6500.00 ++
intermédia decimais, com “.” como
separador decimal e sem
separador de milhares.

Página 7 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

Tamanho
Código Descrição Instruções Exemplo Obrigatório
Máximo
Separador 1 * ++
Valor total da base tributável
Base sujeita à taxa normal de IVA.
tributável de Formatar com duas casas I7:80000.00
I7 16 ++
IVA à taxa decimais, com “.” como
normal separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
normal no documento.
Total de IVA à Formatar com duas casas I8:18400.00
I8 16 ++
taxa normal decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Preencher de acordo com as
notas técnicas do campo
J1 Espaço fiscal 5 J1:PT-AC ++
TaxCountryRegion do SAF-
T(PT).
Separador 1 * ++
Valor total da base tributável
isenta de IVA (incluindo as
operações tributáveis em
sede do Imposto do Selo,
Base sejam isentas ou não de
J2 tributável 16 Imposto do Selo). J2:10000.00 ++
isenta
Formatar com duas casas
decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total da base tributável
sujeita à taxa reduzida de
Base IVA.
tributável de
J3 16 Formatar com duas casas J3:25000.56 ++
IVA à taxa
reduzida decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++

Página 8 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

Tamanho
Código Descrição Instruções Exemplo Obrigatório
Máximo
Valor total do IVA à taxa
reduzida no documento.
Total de IVA à Formatar com duas casas J4:1000.02
J4 16 ++
taxa reduzida decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total da base tributável
Base sujeita à taxa intermédia de
tributável de IVA. Formatar com duas
J5 16 J5:75000.00 ++
IVA à taxa casas decimais, com “.” como
intermédia separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
intermédia no documento.
Total de IVA à
J6 taxa 16 Formatar com duas casas J6:6750.00 ++
intermédia decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total da base tributável
Base sujeita à taxa normal de IVA.
tributável de Formatar com duas casas J7:100000.00
J7 16 ++
IVA à taxa decimais, com “.” como
normal separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
normal no documento.
Total de IVA à Formatar com duas casas J8:18000.00
J8 16 ++
taxa normal decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Preencher de acordo com as
notas técnicas do campo
K1 Espaço fiscal 5 K1:PT-MA ++
TaxCountryRegion do SAF-
T(PT).
Separador 1 * ++

Página 9 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

Tamanho
Código Descrição Instruções Exemplo Obrigatório
Máximo
Valor total da base tributável
isenta de IVA (incluindo as
operações tributáveis em
sede do Imposto do Selo,
Base sejam isentas ou não de
K2 tributável 16 Imposto do Selo). K2:5000.00 ++
isenta
Formatar com duas casas
decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total da base tributável
sujeita à taxa reduzida de
Base IVA.
tributável de
K3 16 Formatar com duas casas K3:12500.00 ++
IVA à taxa
reduzida decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
reduzida no documento.
Total de IVA à Formatar com duas casas
K4 16 K4:625.00 ++
taxa reduzida decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total da base tributável
sujeita à taxa intermédia de
Base IVA.
tributável de
K5 16 Formatar com duas casas K5:25000.00 ++
IVA à taxa
intermédia decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
intermédia no documento.
Total de IVA à
K6 taxa 16 Formatar com duas casas K6:3000.00 ++
intermédia decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++

Página 10 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

Tamanho
Código Descrição Instruções Exemplo Obrigatório
Máximo
Valor total da base tributável
Base sujeita à taxa normal de IVA.
tributável de Formatar com duas casas K7:40000.00
K7 16 ++
IVA à taxa decimais, com “.” como
normal separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do IVA à taxa
normal no documento.
Total de IVA à Formatar com duas casas K8:8800.00
K8 16 ++
taxa normal decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total relativo a
operações não sujeitas / não
Não sujeito / tributáveis em IVA.
L não tributável 16 Formatar com duas casas L:100.00 ++
em IVA decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor total do Imposto do Selo
no documento.
Imposto do Formatar com duas casas M:25.00
M 16 ++
Selo decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * +
Valor total de IVA e Imposto
do Selo - campo TaxPayable
do SAF-T(PT).
Total de
N 16 Formatar com duas casas N:64000.02 +
impostos
decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * +

Página 11 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

Tamanho
Código Descrição Instruções Exemplo Obrigatório
Máximo
Valor do total do documento -
campo GrossTotal do SAF-
Total do T(PT).
O documento 16 Formatar com duas casas O:513600.58 +
com impostos decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * ++
Valor do total das retenções
na fonte - campo
WithholdingTaxAmount do
Retenções na SAF-T(PT).
P 16 P:100.00 ++
fonte Formatar com duas casas
decimais, com “.” como
separador decimal e sem
separador de milhares.
Separador 1 * +
Preencher de acordo com a
4 carateres do
Q 4 Portaria n. 363/2010, de 23 de Q:kLp0 +
Hash
junho.
Separador 1 * +
Nº do Preencher com o n.º do
R 4 R:9999 +
certificado certificado atribuído pela AT.
Separador 1 * ++
Campo de preenchimento S:TB;PT00000
livre, em que pode, por 000000000000
exemplo, ser indicada 000000;51350
Outras informação para pagamento 0.58
S 65 (ex: de IBAN ou Ref MB, com ++
informações (ou
o separador «;»). S:MB;entidade
Este campo não pode conter ;referência;val
o caracter asterisco (*). or)

Nota: As remissões a “SAF-T(PT)” devem ser entendidas como referências à estrutura de dados a que
se refere o n.º 1.º da Portaria n.º 321-A/2007, de 26 de março.

Página 12 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

5. Exemplos de construção do código QR

5.1. Exemplo 1 – Fatura

 Mensagem com os elementos da tabela acima, com indicação do IBAN e

valores de IVA nos espaços fiscais PT, PT-AC e PT-MA:

A:123456789*B:999999990*C:PT*D:FT*E:N*F:20191231*G:FT
AB2019/0035*H:CSDF7T5H-
0035*I1:PT*I2:12000.00*I3:15000.00*I4:900.00*I5:50000.00*I6:6500.00*I7:80
000.00*I8:18400.00*J1:PT-
AC*J2:10000.00*J3:25000.56*J4:1000.02*J5:75000.00*J6:6750.00*J7:10000
0.00*J8:18000.00*K1:PT-
MA*K2:5000.00*K3:12500.00*K4:625.00*K5:25000.00*K6:3000.00*K7:40000.
00*K8:8800.00*L:100.00*M:25.00*N:64000.02*O:513600.58*P:100.00*Q:kLp
0*R:9999*S:TB;PT00000000000000000000000;513500.58

Figura 1 - Exemplo de código QR [47,096mm] e [452 caracteres]

(Size=2, ECC=M, Margin= 2 (0,25cm), Module[versão]=17 -> 85x85)

Página 13 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

5.2. Exemplo 2 – Fatura simplificada

 Fatura simplificada emitida com os campos da tabela abaixo:

Código Descrição Exemplo Obrigatório

A NIF do emitente A:123456789 +
B NIF do adquirente B:999999990 +
C País do adquirente C:PT +
D Tipo de documento D:FS +
E Estado do documento E:N +
F Data do documento F:20190812 +
G Identificação única do documento G:FS CDVF/12345 +
H ATCUD H:CDF7T5HD-12345 +
I1 Espaço fiscal I1:PT +
I7 Base tributável de IVA à taxa normal I7:0.65 ++
I8 Total de IVA à taxa normal I8:0.15 ++
N Total de impostos N:0.15 +
O Total do documento com impostos O:0.80 +
Q 4 carateres do Hash Q:YhGV +
R Nº do certificado R:9999 +
S Outras informações S:NU;0.80 ++

Página 14 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

 Mensagem criada:

A:123456789*B:999999990*C:PT*D:FS*E:N*F:20190812*G:FS
CDVF/12345*H:CDF7T5HD-
12345*I1:PT*I7:0.65*I8:0.15*N:0.15*O:0.80*Q:YhGV*R:9999*S:NU;0.80

Figura 2 - Exemplo de código QR [30,162mm] e [141 caracteres]

(Size=2, ECC=M, Margin= 2 (0,25cm), Module[versão]=9 -> 53x53)

Página 15 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

5.3. Exemplo 3 – Fatura pró-forma

 Fatura pró-forma emitida com os campos da tabela abaixo:

Código Descrição Exemplo Obrigatório

A NIF do emitente A:500000000 +
B NIF do adquirente B:123456789 +
C País do adquirente C:PT +
D Tipo de documento D:PF +
E Estado do documento E:N +
F Data do documento F:20190123 +
G Identificação única do documento G:PF G2019CB/145789 +
H ATCUD H:HB6FT7RV-145789 +
I1 Espaço fiscal I1:PT +
I2 Base tributável isenta I2:12345.34 ++
I3 Base tributável de IVA à taxa reduzida I3:12532.65 ++
I4 Total de IVA à taxa reduzida I4:751.96 ++
I5 Base tributável de IVA à taxa intermédia I5:52789.00 ++
I6 Total de IVA à taxa intermédia I6:6862.57 ++
I7 Base tributável de IVA à taxa normal I7:32425.69 ++
I8 Total de IVA à taxa normal I8:7457.91 ++
N Total de impostos N:15072.44 +
O Total do documento com impostos O:125165.12 +
Q 4 carateres do Hash Q:r/fY +
R Nº do certificado R:9999 +

Página 16 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

 Mensagem criada:

A:500000000*B:123456789*C:PT*D:PF*E:N*F:20190123*G:PF
G2019CB/145789*H:HB6FT7RV-
145789*I1:PT*I2:12345.34*I3:12532.65*I4:751.96*I5:52789.00*I6:6862.57*I7:
32425.69*I8:7457.91*N:15072.44*O:125165.12*Q:r/fY*R:9999

Figura 3 - Exemplo de código QR [32,279mm] e [209 caracteres]

(Size=2, ECC=M, Margin= 2 (0,25cm), Module[versão]=10 -> 57x57)

Página 17 de 18
 Especificações Técnicas
Código de Barras Bidimensional – Código QR

5.4. Exemplo 4 – Documento de transporte

 Documento de transporte não valorizado emitido com os campos da tabela

abaixo:

Código Descrição Exemplo Obrigatório

A NIF do emitente A:500000000 +
B NIF do adquirente B:123456789 +
C País do adquirente C:PT +
D Tipo de documento D:GT +
E Estado do documento E:N +
F Data do documento F:20190720 +
G Identificação única do documento G:GT G234CB/50987 +
H ATCUD H:GTVX4Y8B-50987 +
I1 Espaço fiscal I1:0 +
N Total de impostos N:0.00 +
O Total do documento com impostos O:0.00 +
Q 4 carateres do Hash Q:5uIg +
R Nº do certificado R:9999 +

 Mensagem criada:

A:500000000*B:123456789*C:PT*D:GT*E:N*F:20190720*G:GT
G234CB/50987*H:GTVX4Y8B-50987*I1:0*N:0.00*O:0.00*Q:5uIg*R:9999

Figura 4 - Exemplo de código QR [30,162mm] e [116 caracteres]

(Size=2, ECC=M, Margin= 2 (0,25cm), Module[versão]=9 -> 53x53)

Página 18 de 18