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.

04-12-2014

Incluso de soluo de comunicao do Inventrio de Existncias adequada s

entidades que tm diversos sistemas de gesto de stocks e por isso tm a
informao de Inventrio dispersa por vrios ficheiros.

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 .......................................................................................... 6
3 COMUNICAO DE INVENTRIO POR ENVIO DE FICHEIRO DE TEXTO ................................... 7
4 COMUNICAO DE INVENTRIO POR ENVIO DE FICHEIRO XML ........................................... 8
5 FICHEIROS DE TEXTO, CASOS ESPECIAIS ........................................................................ 9

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.

Entidades com mltiplos ficheiros de Inventrio

As entidades que gerem os stocks em diferentes sistemas podero ter dificuldades em
construir um nico ficheiro com toda a informao dos seus stocks. Estas empresas podero,
no momento da comunicao do inventrio, indicar mais do que um ficheiro. Que podero ser
de tipo variado (xml ou texto). A aplicao da AT, juntar a informao dos vrios ficheiros num
nico, o qual ser enviado para a AT.
No so permitidas comunicaes parcelares de inventrio

4 de Dezembro de 2014

4/9

Manual de Integrao de Software

Comunicao de Inventrio de Existncias AT

Sempre que h uma comunicao de inventrio, a AT interpreta essa comunicao como

incluindo a totalidade das existncias. Por esta razo, sempre que a AT recebe uma
comunicao de Inventrio, considera qualquer comunicao anterior como tendo sido
substituda. O contribuinte pode, numa mesma comunicao indicar vrios ficheiros, conforme
descrito acima. Mas esses vrios ficheiros que constituem o Inventrio tm de ser indicados na
mesma ocasio.
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.

4 de Dezembro de 2014

5/9

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. 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.

4 de Dezembro de 2014

6/9

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 exatamenteigual 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 clculoo seu aspecto o que aseguir 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

4 de Dezembro de 2014

7/9

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_2.xsd"
disponvel no endereo abaixo:
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/E3791404-8FFD-4A88-AB292DDDBDC60CD7/0/Stock_1_2.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_02"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns:StockHeader>
<ns:FileVersion>1_02</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>

4 de Dezembro de 2014

8/9

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.

4 de Dezembro de 2014

9/9