SAF-T PT: abrir o ficheiro SAF-T em tabelas
O SAF-T (PT) é o ficheiro XML que os programas de faturação e de contabilidade certificados exportam para a Autoridade Tributária. O contabilista pede-o todos os meses, o auditor recebe-o, e quem quer ver as vendas de um cliente fica com um único XML de vários megabytes onde estão uma dúzia de tabelas diferentes. Este artigo está escrito em português de Portugal, porque o ficheiro é português; os menus da aplicação estão em português do Brasil e dizem «arquivo» onde aqui se diz «ficheiro».
Grátis para usar. O ficheiro é lido no seu navegador e não é enviado para lado nenhum. Versão para Windows — 4.9 MB, sem instalação: detalhes. Pro — US$ 29 uma vez: preço.
O que está dentro do ficheiro
A raiz é AuditFile, com o espaço de nomes urn:OECD:StandardAuditFile-Tax:PT_1.04_01. Dentro:
Header— a empresa, o NIF, o exercício e o período, e o tipo de ficheiro (TaxAccountingBasis: F de faturação, C de contabilidade, I integrado);MasterFiles— clientes, fornecedores, produtos, a tabela de impostos e, nos ficheiros de contabilidade, o plano de contas;GeneralLedgerEntries— diários, lançamentos e as suas linhas a débito e a crédito;SourceDocuments— as faturas com as linhas e os totais, e os outros documentos.
Importado no Excel (pelo Power Query), o ficheiro dá uma árvore de tabelas ligadas entre si que é preciso expandir à mão, e as faturas repetem-se tantas vezes quantas as linhas.
As tabelas que se obtêm
O ficheiro é reconhecido pelo espaço de nomes e abre como uma base de dados com várias tabelas; só aparecem as secções que existem no ficheiro:
| Tabela | Uma linha por |
|---|---|
| Faturas | fatura: InvoiceNo, ATCUD, data, tipo (FT, FS, FR, NC…), estado, cliente, número de linhas, NetTotal, TaxPayable, GrossTotal |
| Linhas das faturas | linha, com o número, a data, o tipo e o cliente da fatura ao lado: produto, quantidade, preço unitário, valor, taxa de IVA |
| Clientes, Fornecedores, Produtos e serviços, Impostos, Plano de contas | registo dessa tabela mestre, com os nomes de campos do esquema (CustomerTaxID, CompanyName…) |
| Lançamentos contábeis | linha a débito ou a crédito, pela ordem do ficheiro: lançamento, data, período, conta, DebitAmount, CreditAmount |
Abre primeiro a tabela das faturas. As outras escolhem-se em «Leitura do arquivo», que também tem o botão para abrir todas de uma vez, cada uma no seu separador.
Verificações habituais
- Faturação por mês ou por cliente: uma tabela dinâmica sobre as Faturas, por
PeriodeCustomerID. - Documentos anulados: filtre
InvoiceStatus= A. - Notas de crédito: filtre
InvoiceType= NC. - IVA por taxa: agrupe as Linhas das faturas pela coluna da percentagem de imposto.
- Faturas sem ATCUD: filtre a coluna
ATCUDpor vazios. - Equilíbrio dos lançamentos: a soma de
DebitAmounttem de ser igual à deCreditAmount.
Qualquer tabela exporta-se para Excel ou CSV em «Exportação».
Limites
As tabelas do modelo são só de leitura: o SAF-T é assinado documento a documento (Hash) e corrige-se no programa que o gerou. Em «Leitura do arquivo», «Modelo» → «XML comum» dá a leitura normal do XML, em que se escolhe qualquer elemento como linha. Ficheiros de centenas de megabytes leem-se em fluxo, sem carregar o documento inteiro (XML grande).
Perguntas frequentes
Valida o ficheiro contra o esquema da AT?
Não automaticamente. Para verificar a estrutura, use o botão «XSD» com o ficheiro de esquema oficial; o modelo de tabelas não valida.
Serve para o SAF-T de contabilidade?
Sim: os lançamentos (GeneralLedgerEntries) e o plano de contas aparecem como tabelas quando existem no ficheiro.
O ficheiro é enviado para algum servidor?
Não. O SAF-T tem todos os clientes e faturas da empresa; é lido no seu navegador e não sai do computador.
Grátis para usar. Seu arquivo não é enviado a nenhum servidor. Versão para Windows — 4.9 MB, sem instalação: detalhes. Pro — US$ 29 uma vez: preço.