8.4- Estrutura de dados
Cabeçalho (Header)
Esta tabela contém as informações relativas ao sujeito passivo que gera o
SAFT(PT)
Índice Obrigatório Campo Detalhes Formato XSD
1.1. * AuditFileVersion Versão do ficheiro de auditoria. A Texto 10
versão encontra-se no portal da AT
1.2. * CompanyID Registo comercial da empresa . Texto 50
Concatenação do n. de conservatória
c/ o n. do registo comercial. Quando
não existente, colocar NIF
1.3. * TaxRegistrationNumb NIF especifico do país Inteiro 9
er
1.4. * TaxAccountingBasis Tipo de Sistema C- contabilidade E- Texto 1
101
Faturação emitida por terceiros F –
Faturação I – contabilidade integrada
c/ faturação P – Faturação Parcial
R- Recibos S – Auto-Faturação T –
Documentos de Transporte ( ou C F
e I) - ver manual
1.5. * CompanyName Denominação social Texto 100
1.6. BusinessName Designação social Texto 60
1.7. * CompanyAdress Endereço da empresa Texto 200
1.7.1. Building Number Número de policia Texto 10
(n. processo de edificação)
1.7.2. StreeName Nome da Rua Texto 200
1.7.3 * AddressDetail Morada completa Texto 210
1.7.4. * City Localidade Texto 50
1.7.5 * PostalCode Código postal Texto 8
1.7.6. Region Distrito Texto 50
1.7.7. * Country País : (PT) Texto 2
1.8. * FiscalYear Regras do Código IRC (Exemplo: período de Inteiro 4
tributação de 01- 10-2012 a 30-09-2013
corresponde a FiscalYear = 2012).
1.9. * StartDate Data do inicio do perido do ficheiro Data
1.10. * EndDate Data do fim do perido do ficheiro Data
1.11. * CurrencyCode Moeda padrão Exempo: EUR Texto 3
1.12. * DateCreated Data de criação do ficheiro Data
1.13. * TaxEntry Identificar o establecimento ou 'Global'. Texto 20
Em contabilidade colocar Sede
1.14. * ProductCompanyTaxI NIF do produtor do software Texto 20
D
102
1.15. * SoftwareCertificateNu Indentifcação do produtor do software. Inteiro
mber Colocar nº do certificado . Senão '0'
1.16. * ProductID Nome do software Texto 255
'Nome da aplicação / Nome da empresa
produtora'
1.17. * ProductVersion Versão da aplicação Texto 30
1.18. HeaderComment Comentários adicionais Texto 30
1.19. Telephone N. telefone Texto 20
1.20. Fax Texto 20
1.21. Email Email usado na empresa Texto 60
1.22 Website Site da empresa Texto 60
Tabelas mestres (MasterFiles)
Contém dados que são obrigatórios tanto em aplicações de faturação como
em aplicações de contabilidade.
As tabelas seguintes fazem parte da estrutura de MasterFiles , podem ser
resumidas à seguinte estrutura de organização do XML.
O esquema XML é definido pela seguindo ordem:
<MasterFiles>
<Customer>
</Customer>
<Product>
</Product>
<TaxTable>
</TaxTable>
</MasterFiles>
103
Tabela de Clientes (Customer)
Esta tabela todos os clientes envolvidos no período de exportação do ficheiro.
Índice Obrigatório Campo Detalhes Formato XSD
2.2.1. * CustomerID Identificador único do cliente Texto 30
2.2.2. * AccountID Código da Conta Corrente ou Texto 30
'Desconhecido'
2.2.3. * CustomerTaxID 'Consumidor final ' ou NIF Texto 30
2.2.4. * CompanyName Consumidor final ' ou nome empresa Texto 100
do cliente
2.2.5. * Contact Nome do contacto na empresa Texto 50
2.2.6. * BillingAddress Morada de faturação
2.2.6.1. BuildingNumber Número de policia Texto 10
(n. processo de edificação)
2.2.6.2. StreetName Nome da rua Texto 200
2.2.6.3. * AddressDetail Morada detalhada ou 'Desconhecido' Texto 210
2.2.6.4. * City Localidade ou 'Desconhecido' Texto 50
2.2.6.5. * PostalCode Código postal do cliente ou Texto 20
'Desconhecido'
2.2.6.6. * Region Distrito Texto 50
2.2.6.7. * Country País : (PT) ou 'Desconhecido' Texto 12
2.2.7. ShipToAddress Existindo necessidade fazer mais que
uma referencia
2.2.7.1. BuildingNumber Numero de Policia Texto 10
2.2.7.2. StreetName Nome da rua Texto 200
104
2.2.7.3. * AddressDetail Morada detalhada ou 'Desconhecido' Texto 210
2.2.7.4. * City Localidade Texto 50
2.2.7.5. * PostalCode Código Postal ou 'Desconhcido' Texto 20
2.2.7.6. Region Distrito Texto 50
2.2.7.7. * Country Deve ser preenchido de acordo com a Texto 12
norma ISO 3166 - 1-alpha-2. Ou
'Desconhecido'
2.2.7.8. Telephone N. telefone Texto 20
2.2.7.7. Fax Texto 20
2.2.7.7. Email Email usado na empresa Texto 60
2.2.7.7. * SelfBillingIndicator Auto-faturação cliente-fornecedor Inteiro
Sim(1) Não(0)
Para entendermos como se processa o XML , o exemplo da estrutura
apresentada para Clientes, acima, permite-nos gerar os elementos XML
preenchidos por exemplo da seguinte forma:
105
<Customer>
<CustomerID>999999999</CustomerID>
<AccountID>Desconhecido</AccountIDAccountID>
<CustomerTaxID>888888888</CustomerTaxID>
<CompanyName>Onidesk, TI</CompanyName>
<Contact>JOSE FRANCO</Contact>
<BillingAddress>
<AddressDetail>RUA TTTT N. 910</AddressDetail>
<City>Avenida Marchal Carmona</City>
<PostalCode>1100-786 LISBOA</PostalCode>
<Country>PT</Country>
</BillingAddress>
<Telephone>219999999</Telephone>
<Fax>219999991</Fax>
<Email>geral@onidesk.com</Email>
</Customer>
Tabela Fornecedores (Supplier)
Esta tabela contém todos os fornecedores envolvidos no exercício de
faturação, no período de exportação do ficheiro.
106
Índice Obrigatório Campo Detalhes Formato XSD
107