MANUAL DE INTEGRAO DE SOFTWARE

Comunicao do Inventrio de Existncias AT

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

HISTRICO DE ALTERAES
DATA

ALTERAES

24-11-2014

Elaborao do manual de comunicao do Inventrio de Existncias AT.

Av. Eng. Duarte Pacheco, 28 - 18., Lisboa

Email: portal-qt@at.gov.pt

Tel: (+351) 21 383 4200

www.portaldasfinancas.gov.pt

Fax: (+351) 21 383 4646

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

ndice
1 INTRODUO ............................................................................................................... 4
2 INFORMAO A COMUNICAR .......................................................................................... 5
3 COMUNICAO DE INVENTRIO POR ENVIO DE FICHEIRO DE TEXTO ................................... 6
4 COMUNICAO DE INVENTRIO POR ENVIO DE FICHEIRO XML ........................................... 7
5 FICHEIROS DE TEXTO, CASOS ESPECIAIS ........................................................................ 8

Av. Eng. Duarte Pacheco, 28 - 18., Lisboa

Email: portal-qt@at.gov.pt

Tel: (+351) 21 383 4200

www.portaldasfinancas.gov.pt

Fax: (+351) 21 383 4646

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

1 Introduo
O presente documento tem como objetivo definir indicaes quanto ao modo como se far a
comunicao do Inventrio de Existncias Autoridade Tributria e Aduaneira, adiante
designada por AT.
As regras que regem a elaborao de inventrios esto definidas legalmente e no so objeto
deste documento.
Na construo do modelo de comunicao dos inventrios de existncias estabeleceu-se como
princpio fundamental a simplicidade e a desnecessidade de suporte de custos adicionais pelas
empresas em desenvolvimentos informticos.
Em face desse objetivo principal, apresentamos duas opes de formato de ficheiro para
comunicao dos inventrios:
i) Ficheiro de texto com os campos separados por ponto e vrgula
A comunicao do ficheiro de Inventrio de Existncias foi desenhada de modo a permitir
s empresas sem recursos informticos cumprir esta obrigao utilizando apenas um
ficheiro de texto, conforme descrito a seguir neste documento. Uma vez construdo
manualmente esse ficheiro, bastar submet-lo no portal e-fatura (upload). A AT
disponibiliza um ficheiro modelo (csv) que pode ser usado diretamente numa folha de
clculo para a elaborao do Inventrio.
ii) Formato xml
As entidades com existncias significativas e todas as que disponham de recursos
informticos tero vantagem na submisso de um ficheiro xml: ser mais rpida a
submisso de ficheiro, e maior a garantia de sucesso dessa operao. Este ficheiro xml,
que dever estar de acordo com a estrutura indicada frente neste documento, ser
submetido no portal e-fatura.
Empresas sem existncias
As empresas sem existncias e obrigadas por a lei a comunicar o Inventrio, declararo no
portal e-fatura que no tm existncias. No precisam, portanto, de construir ficheiro vazio.
Artigos fora de stock
Os artigos que na data do inventrio no existem em stock (esto esgotados, por ex.) no
devem constar dos ficheiros que so comunicados AT.
Dispensa
Esto dispensadas de efetuar a comunicao dos inventrios as empresas com um volume de
negcios do exerccio anterior ao da comunicao no excede 100 000.

26 de Novembro de 2014

4/8

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

2 Informao a comunicar
A informao a comunicar igual para todas as entidades, e definida legalmente.
Relativamente a cada item, as entidades devero obrigatoriamente indicar:
Tipo
(ProductCategory)
TEXTO 1 CARATER

Identificador do
Produto
(ProductCode)
TEXTO 60 CARATERES

Descrio

Identificador do tipo de produto. Deve ser preenchido com uma das

seguintes letras:
M mercadorias
P matrias-primas, subsidirias e de consumo
A produtos acabados e intermdios
S subprodutos, desperdcios e refugos
T produtos e trabalhos em curso
Cdigo nico do produto na lista de produtos, que s dever aparecer
uma vez em cada ficheiro. Este cdigo dever corresponder ao
mesmo cdigo utilizado no ficheiro SAF-T (PT) da faturao, quando
aplicvel. No caso de tipos de produtos no transacionveis e que
sejam inexistentes ao nvel da tabela de Produtos do SAF-T (PT),
dever garantir-se uma codificao nica para cada produto.
Descrio do produto

(ProductDescription)
TEXTO 200 CARATERES
Cdigo do produto
(ProductNumberCode)
TEXTO 60 CARATERES

Cdigo EAN. Deve ser utilizado o cdigo EAN (cdigo de barras) do

produto. Quando este no existir, preencher com o valor do campo
Identificador do Produto

Quantidade

Quantidade de existncia final relativa ao perodo a que reporta.

(ClosingStockQuantity)
DECIMAL
Unidade

Unidade de medida usada (exemplo: Kg, Cm, M3, Unidades)

(UnitOfMeasure)
TEXTO 20 CARATERES

Em local prprio, as entidades devero ainda indicar, para alm da sua identificao fiscal:
Ano: a que se refere o Inventrio, utilizando as regras do Cdigo do IRC, no caso de perodos
contabilsticos no coincidentes com o ano civil;
Data do Inventrio, data de referncia do inventrio. Correspondente ao fim do perodo de
tributao.

26 de Novembro de 2014

5/8

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

3 Comunicao de Inventrio por envio de ficheiro de texto

As entidades que no tenham recursos informticos disponveis e optarem pelo envio de um
ficheiro de texto, podero construir esse ficheiro manualmente de acordo com o exemplo que a
AT disponibiliza em:
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/5AE5AA55-643B-48A9-ADE358CB775A58A9/0/Inventario.csv
Este ficheiro exemplo tem a estrutura correta e est pronto para submisso (faltando apenas a
substituio dos dados exemplo por dados reais).
As regras a seguir na criao deste tipo de ficheiro so as seguintes:
a. A primeira linha composta pelos nomes dos campos, e tem de ser exatamente igual
ao exemplo Inventario.csv
b. O carter ; (ponto e virgula) utilizado como separador das colunas;
c. O carter , (vrgula) utilizado como separador decimal.

Ficheiro Exemplo (Inventario.csv)

Quando o ficheiro exemplo visualizado numa folha de clculo o seu aspecto o que a seguir se
apresenta. Depois de editado, dever ser gravado, mantendo o formato csv:

A mesma informao, visualizada num editor de texto aparecer da seguinte forma:

ProductCategory;ProductCode;ProductDescription;ProductNumberCode;ClosingStock
Quantity;UnitOfMeasure
M;1234;Batatas;11111115;500,4567;Kg
M;5678;Alface;22222220;100;Caixa
P;P1123;MaGolden;33333335;50;Caixa
S;L0001;Caroos;44444440;200;kg
P;K0001;BalanastipoABC;555555;30;Unidade

26 de Novembro de 2014

6/8

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

4 Comunicao de Inventrio por envio de ficheiro xml

O ficheiro XML a submeter, dever respeitar o esquema de validaes "Stock_1_1.xsd"
disponvel no endereo abaixo:
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/A956EB7D-6FDF-441B-B5E4B471B29C2FCB/0/Stock_1_1.xsd
Este ficheiro dever conter as seguintes tabelas:
1 - Cabealho (StockHeader);
2 - Tabela de Inventrio (Stock);

Exemplo de ficheiro no formato XML

<?xml version="1.0" encoding="UTF-8" ?>
<ns:StockFile xmlns:doc="urn:schemas-basda-org:schema-extensions:documentation"
xmlns:ns="urn:StockFile:PT_1_01"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns:StockHeader>
<ns:FileVersion>1_01</ns:FileVersion>
<ns:TaxRegistrationNumber>123456789</ns:TaxRegistrationNumber>
<ns:FiscalYear>2014</ns:FiscalYear>
<ns:EndDate>2014-12-31</ns:EndDate>
<ns:NoStock>false</ns:NoStock>
</ns:StockHeader>
<ns:Stock>
<ns:ProductCategory>M</ns:ProductCategory>
<ns:ProductCode>1234</ns:ProductCode>
<ns:ProductDescription>Batatas</ns:ProductDescription>
<ns:ProductNumberCode>11111115</ns:ProductNumberCode>
<ns:ClosingStockQuantity>500.4567</ns:ClosingStockQuantity>
<ns:UnitOfMeasure>Kg</ns:UnitOfMeasure>
</ns:Stock>
<ns:Stock>
<ns:ProductCategory>M</ns:ProductCategory>
<ns:ProductCode>5678</ns:ProductCode>
<ns:ProductDescription>Alface</ns:ProductDescription>
<ns:ProductNumberCode>22222220</ns:ProductNumberCode>
<ns:ClosingStockQuantity>100</ns:ClosingStockQuantity>
<ns:UnitOfMeasure>Caixas</ns:UnitOfMeasure>
</ns:Stock>
</ns:StockFile>

26 de Novembro de 2014

7/8

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

5 Ficheiros de texto, casos especiais

As indicaes que se seguem respeitam apenas aos casos excecionais em que haja artigos
que na sua descrio contenham aspas () ou pontos e vrgula (;). Estas indicaes valem
apenas para os ficheiros de texto (csv).

No caso excecional de haver necessidade de utilizar o carter ; (ponto e vrgula) dentro

de uma coluna, essa coluna dever estar entre aspas;

No caso de se utilizar o carter " (aspas) como elemento de informao constante em

alguma das colunas, essa coluna dever estar entre aspas e adicionalmente o carter "
(aspas) dever ser especificado usando duas aspas.

Para quem use uma folha de clculo para construir o inventrio estes casos no levantam
problemas. Como se v no exemplo abaixo, usando aspas e pontos e vrgula dentro das
descries de um artigo, a folha de clculo grava o ficheiro corretamente, sem ser necessrio
qualquer indicao:

ProductCategory;ProductCode;ProductDescription;ProductNumberCode;ClosingStock
Quantity;UnitOfMeasure
M;1234;Batatas;11111115;500,4567;Kg
M;5678;Alface;22222220;100;Caixa
P;P1123;"Ma""Golden""";33333335;50;Caixa
S;L0001;"Caroos;Cascas";44444440;200;kg
Como se pode observar nas linhas 4 e 5 a existncia de carateres ponto e vrgula e aspas d
origem a que a folha de clculo coloque toda a informao dessa coluna entre aspas.
Adicionalmente, na linha 4 o carter aspas aparece usando duas aspas.

26 de Novembro de 2014

8/8