Índice do Campo | Obrigatório | Nome do Elemento | Nome do campo na PHC | Notas Técnicas | Notas |
4.1. | Documentos comerciais a clientes (SalesInvoices) | Devem ser exportados os documentos indicados no campo 4.1.4.7. — Tipo de documento (InvoiceType). | Documentos de faturação do tipo 1, 2 e 3 | ||
4.1.1. | Sim | Número de registos de documentos comerciais (NumberOfEntries) | Campo calculado | Deve conter o número total de documentos, incluindo os documentos cujo valor do campo 4.1.4.2.1 — Estado atual (InvoiceStatus) seja do tipo "A" ou "F". | |
4.1.2. | Sim | Total dos débitos (TotalDebit) | Campo calculado | Deve conter a soma de controlo do campo 4.1.4.18.11 – Valor a débito (DebitAmount), dela excluindo os documentos em que o campo 4.1.4.2.1. – Estado atual do documento (InvoiceStatus) seja do tipo "A" ou "F". | |
4.1.3. | Sim | Total dos créditos (TotalCredit) | Campo calculado | Deve conter a soma de controlo do campo 4.1.4.18.12 – Valor a crédito (CreditAmount), dela excluindo os documentos em que o campo 4.1.4.2.1. – Estado atual do documento (InvoiceStatus) seja do tipo "A" ou "F". | |
4.1.4. | Documento de venda (Invoice) | ||||
4.1.4.1. | Sim | Identificação única do documento de venda (InvoiceNo | Faturas: Ft2.tiposaft + "espaço" + Ft.ftano + Identificador atribuído pela aplicação + Ft.ndoc + "/" + ft.fno Recibos Adiantamento: TSRD.tiposaft + espaço + rd.rdano + tsrd.idserie + rd.ndoc + / + rd.rno Autofaturação: cm1.tiposaft + "espaço" + fo.foano + Identificador atribuído pela aplicação + Fo.doccode + "/" + fo.adoc | Esta identificação é composta sequencialmente pelos seguintes elementos: o código interno do tipo de documento atribuído pela aplicação, um espaço, o identificador da série do documento, uma barra (/) e o número sequencial desse documento dentro dessa série. Não podem existir registos com a mesma identificação. Não pode ser utilizado o mesmo código interno de tipo de documento em diferente tipo de documento (InvoiceType). | Caso o documento não tenha o campo de Tipo para SAFT configurado, vai buscar esse informação a sua configuração. (td.tiposaft). Quando o documento é uma série importada de outra aplicação preenche com o valor do campo InvoiceNoOri (FT3/RD) Caso seja um documento importado, deve preencher com: InvoiceNoOri na tabela de Documentos de Faturação - Informação Complementar (ft3), . InvoiceNoOri na tabela de Recibos de Adiantamento (rd), |
4.1.4.2. | Sim | Código Único do Documento (ATCUD) | Este campo deve conter o Código Único do Documento. O campo deve ser preenchido com «0» (zero) até à sua regulamentação. | ||
4.1.4.3 | Sim | Situação do documento (DocumentStatus) | |||
4.1.4.3.1 | Sim | Estado atual do documento (InvoiceStatus | Deve ser preenchido com: "N" — Normal; "S" — Autofacturação; "A" — Documento anulado; "R" – Documento de resumo doutros documentos criados noutras aplicações e gerado nesta aplicação; "F" — Documento faturado: | Caso ft.anulado fica com o valor "A" Caso a configuração: "Série para registo manual de documentos originalmente produzidos em software externo" (td.docsext) ativa fica com o valor "R" Caso nenhumas das opções acima referidas fica com o valor "N" | |
4.1.4.3.2 | Data e hora do estado atual do documento (InvoiceStatusDate | ft.usrdata + ft.usrhora ou ft3.anuldata+ft3.anulhora | Data da última gravação do estado do documento ao segundo. Tipo data e hora: "AAAA -MM -DDThh:mm:ss". | Se o documento for anulado é preenchido com os campos Data da anulação do registo e Hora da anulação do registo | |
4.1.4.3.3 | Motivo da alteração de estado (Reason) | ft3.motanul (Faturação) ou rd.motanul (Recibos Adiantamento) | Deve ser indicada a razão que levou à alteração de estado do documento. | É preenchido com o valor definido nos campos: ft3.motanul (Faturação) , rd.motanul (Recibos Adiantamento), fo2.motanul (Compras) | |
4.1.4.3.4. | Sim | Código do utilizador (SourceID) | ft.usrinis ou ft3.ANULINIS | Utilizador responsável pelo estado atual do documento. | Se o documento for anulado é preenchido com o campo Utilizador que anulou o registo |
4.1.4.3.5. | Sim | Origem do documento (SourceBilling) | Deve ser preenchido com: "P" – Documento produzido na aplicação; "I" – Documento integrado e produzido noutra aplicação; "M" – Documento proveniente de recuperação de emissão manual; | Caso a configuração do documento tenha a opção: "Série para registo manual de documentos produzidos externamente" (td.docsext) fica com o valor "I" Caso a configuração do documento tenha a opção: "Série para documentos importados" (td.docsimport) fica com o valor "I" Caso a configuração do documento tenha a opção: "Série para cópias de documentos originais" (td.copydocori) fica com o valor "M" Caso nenhumas das opções acima referidas fica com o valor "P" | |
4.1.4.4 | Sim | Chave do documento (Hash) | ft.assinatura (caso seja assinado) | Assinatura nos termos da Portaria n.º 363/2010, de 23 de junho. | |
4.1.4.5 | Sim | Chave de controlo (HashControl) | ft.versaochave (caso seja assinado) | Versão da chave privada utilizada na criação da assinatura do campo 4.1.4.3. — Chave do documento (Hash). | |
4.1.4.6 | Período contabilístico (Period) | getMesFiscal(MONTH(ft.fdata)) | Deve ser indicado o mês do período de tributação de "1" a "12", contado desde a data do seu início. | Mês fiscal da data do documento. Este elemento só está visível caso: - O módulo de Contabilidade esteja ativo e o parâmetro geral: "Contabilidade de gabinete: Activar ligação (Tem que reiniciar a aplicação!)" esteja inativo. | |
4.1.4.7 | Sim | Data do documento de venda (InvoiceDate) | ft.fdata | Data de emissão do documento de venda. | |
4.1.4.8 | Sim | Tipo de documento (InvoiceType) | FT2.tiposaft | "Deve ser preenchido com: "FT" — Fatura, emitida nos termos do artigo 36.º do Código do IVA; "FS" — Fatura simplificada, emitida nos termos do artigo 40.º do Código do IVA; "FR" — Fatura-recibo; "ND" — Nota de débito; "NC" — Nota de crédito; "VD" — Venda a dinheiro e fatura/recibo; (a) "TV" — Talão de venda; (a) "TD" — Talão de devolução; (a) "AA" — Alienação de ativos; (a) "DA" — Devolução de ativos. (a) Para o setor Segurador, ainda pode ser preenchido com: "RP" — Prémio ou recibo de prémio; "RE" — Estorno ou recibo de estorno; "CS" — Imputação a co-seguradoras; "LD" — Imputação a co-seguradora líder; "RA" — Resseguro aceite. (a) Para os dados até 2012 -12 -31. | Caso o campo ft2.tiposaft vazio vai o valor de td.tiposaft. No ficheiro de autofacturação é preenchido com cm1.tiposaft. |
4.1.4.9. | Sim | Regimes especiais (SpecialRegimes) | |||
4.1.4.9.1. | Sim | Indicador de autofaturação (SelfBillingIndicator) | Deve ser preenchido com "1" se respeitar a autofacturação e com "0" (zero) no caso contrário. | É preenchido com "0". Caso seja referente a Auto-Faturação aparece com "1". | |
4.1.4.9.2. | Sim | Indicador de regime de IVA de Caixa(CashVATSchemeIndicator) | É preenchido com "1" se ft2.reexgiva=1. | Indicador da existência de adesão ao regime de IVA de Caixa. Deve ser preenchido com "1" se houver adesão e com "0" (zero) no caso contrário. | |
4.1.4.9.3. | Sim | Indicador de faturação emitida em nome e por conta de terceiros (ThirdPartiesBillingIndicator) | Deve ser preenchido com "1" se respeitar a faturação emitida em nome e por conta de terceiros e com "0" (zero) no caso contrário. | É preenchido com "0" | |
4.1.4.10 | Sim | Código do utilizador (SourceID) | ft.ousrinis | Utilizador que gerou o documento. | |
4.1.4.11 | Código CAE (EACCode) | e1.cae ou td.cae ou tdsr.cae Documento importado: ft3.cae | Deve ser indicado o código CAE da atividade relacionada com a emissão deste documento. | É preenchido com o CAE da ficha completa da empresa. Passa a existir também na configuração de documentos de recibos de adiantamento e dossiers internos, se estiver preenchido na configuração dos documentos, é exportado esse. Se o Código CAE estiver vazio na configuração dos documentos, usa o da ficha completa da empresa, que tem de estar preenchido. | |
4.1.4.12 | Sim | Data de gravação do documento (SystemEntryDate) | ft.ousrdata+ ft.ousrhora Se documentoto importado: ft3.oridata + ft3.orihora | Data da gravação do registo ao segundo, no momento da assinatura. Tipo data e hora: "AAAA -MM -DD Thh:mm:ss". | |
4.1.4.13 | Sim | Identificador da transação (TransactionID) | O preenchimento é obrigatório, no caso de se tratar de um sistema integrado de contabilidade e faturação, ainda que o tipo de ficheiro (TaxAccountingBasis) não deva conter as tabelas relativas à contabilidade. Deve ser indicada a chave única da tabela 3. Movimentos contabilísticos (GeneralLedgerEntries) da transação onde foi lançado este documento, respeitando a regra aí definida para o campo 3.4.3.1 — Chave única do movimento contabilístico (TransactionID). | Corresponde ao campo TransactionID dos movimentos contabilísticos, quando é um sistema integrado. | |
4.1.4.14 | Sim | Identificador do cliente (CustomerID) | cl.clstamp | Chave única da tabela 2.2. – Tabela de clientes (Customer) respeitando a regra aí definida para o campo 2.2.1. Identificador único do cliente (CustomerID). | No caso de se tratar de um cliente de venda a dinheiro preenche com: No + "/" + Ncont (caso esteja preenchido). (Dados do registo) Nos documentos de facturação cuja configuração lança os movimentos no 2º cliente, aparece o nº do 2º cliente. |
4.1.4.15. | Local de descarga (ShipTo) | Informação do local e data de descarga onde os artigos vendidos são colocados à disposição do cliente, ou de quem este indicar no caso de operações triangulares. | |||
4.1.4.15.1. | Identificador da entrega (DeliveryID) | ft.MATRICULA | No caso de operações triangulares, deve ser indicado o local de entrega e o NIF de quem recebeu. | ||
4.1.4.15.2. | Data da entrega (DeliveryDate) | Não estamos a preencher | |||
4.1.4.15.3. | Identificador do armazém de destino (WarehouseID) | Não estamos a preencher | |||
4.1.4.15.4. | Localização dos bens no armazém de destino (LocationID) | Não estamos a preencher | |||
4.1.4.15.5. | Morada (Address) | ||||
4.1.4.15.5.1. | Número de polícia (BuildingNumber) | Não estamos a preencher | |||
4.1.4.15.5.2. | Nome da rua (StreetName) | Não estamos a preencher | |||
4.1.4.15.5.3. | Sim | Morada detalhada (AddressDetail) | szadrs.morada | Deve incluir o nome da rua, número de polícia e andar, se aplicável. | Com base no campo ft.descar |
4.1.4.15.5.4. | Sim | Localidade (City) | szadrs.local | Com base no campo ft.descar | |
4.1.4.15.5.5. | Sim | Código postal (PostalCode) | szadrs.codpost | Com base no campo ft.descar | |
4.1.4.15.5.6. | Distrito (Region) | szadrs.distrito | Com base no campo ft.descar Caso desconhecido preenche "Desconhecido" | ||
4.1.4.15.5.7. | Sim | País (Country) | szadrs.codpais | Deve ser preenchido de acordo com a norma ISSO 3166 — 1 -alpha -2. | Com base no campo ft.descar |
4.1.4.16. | Local de carga (ShipFrom) | Informação do local e data de carga onde se inicia a expedição dos artigos vendidos para o cliente. | |||
4.1.4.16.1. | Local de descarga (ShipTo) | ft.matricula | |||
4.1.4.16.2. | Identificador da entrega (DeliveryID) | Não estamos a preencher | |||
4.1.4.16.3. | Data de receção (DeliveryDate) | Não estamos a preencher | |||
4.1.4.16.4. | Identificador do armazém de partida (WarehouseID) | Não estamos a preencher | |||
4.1.4.16.5. | Localização dos bens no armazém de partida (LocationID) | Não estamos a preencher | |||
4.1.4.16.5.1. | Número de polícia (BuildingNumber) | Não estamos a preencher | |||
4.1.4.16.5.2. | Nome da rua (StreetName) | Não estamos a preencher | |||
4.1.4.16.5.3. | Sim | Morada detalhada (AddressDetail) | szadrs.morada | Deve incluir o nome da rua, número de polícia e andar, se aplicável. | Com base no campo ft.carga |
4.1.4.16.5.4. | Sim | Localidade (City) | szadrs.local | Com base no campo ft.carga | |
4.1.4.16.5.5. | Sim | Código postal (PostalCode) | szadrs.codpost | Com base no campo ft.carga | |
4.1.4.16.5.6. | Distrito (Region) | szadrs.distrito | Com base no campo ft.carga Caso desconhecido preenche "Desconhecido" | ||
4.1.4.16.5.7. | Sim | País (Country) | szadrs.codpais | Deve ser preenchido de acordo com a norma ISO 3166 – 1 -alpha -2. | Com base no campo ft.carga |
4.1.4.17 | Data e hora de fim de transporte (MovementEndTime) | Tipo de data e hora: "AAAA -MM -DDThh:mm:ss" em que o "ss" pode ser "00", na ausência de informação concreta. | Não estamos a preencher | ||
4.1.4.18 | Sim | Data e hora para o início de transporte (MovementStartTime) | ft.cdata + ft.chora | Tipo de data e hora: "AAAA -MM -DDThh:mm:ss" em que o "ss" pode ser "00", na ausência de informação concreta. | Nas séries de documentos de faturação que tenham a configuração "Preenche e valida o Local de Carga e o Local de Descarga." ativa quando o utilizador lança os registos, a |
SAF-T: Documentos Comerciais a Clientes (SalesInvoices)
- Atualizado em Sep 23, 2026
- Publicado em Aug 6, 2026
Este artigo foi útil?