Documentation Index

Fetch the complete documentation index at: https://help.ila.cegid.com/llms.txt

Use this file to discover all available pages before exploring further.

Explore as funcionalidades disponíveis para aproveitar todo o potencial da nova plataforma de ajuda!

Como configurar a extensão SAF-T?

Prev Next
  • PT

  • ES

  • AO

  • CV

  • MZ

  • ST

  • GW

  • Professional

  • Executive

  • Public Sector

  • Omnia

  • Evolution


Para garantir a correta importação dos dados de um ficheiro SAF-T de faturação, é necessário efetuar um conjunto de configurações relativas à importação.

Estas configurações deverão ser efetuadas antes da primeira importação ou sempre que exista necessidade de alterar os parâmetros da importação, assim como deve ser realizada para os clientes que integrem as vendas através da importação de ficheiros SAF-T.

As configurações que têm de ser lidas no ERP serão lidas a partir da Empresa Modelo, contudo, não é obrigatório que a informação introduzida seja desta empresa. Apenas terá de garantir que todos os dados inseridos na configuração são comuns a todos os clientes que partilham o mesmo modelo.

Configurar Extensão

Para configurar a extensão SAF-T de vendas, siga as seguintes etapas:

Etapa 1: Criar modelo

  1. Aceder a Aplicação | Grupo Configurações | Extensões | SAF-T ou Ambiente de Trabalho | [Cliente] | Menu Açõesdos Bancos | Configurar;
  2. Selecionar um modelo já existente e clicar em Editar ou fazer duplo clique sobre a linha;
  3. Clicar em Duplicar;
  4. No campo Cliente Modelo será indicada a empresa modelo predefinida, no entanto poderá selecionar outra empresa para a configuração que pretende criar;
  5. Indicar o nome pretendido no campo Modelo;
  6. Selecionar a opção Modelo por Defeito, caso pretenda que o modelo seja atribuído automaticamente aos novos clientes. Só pode existir um modelo por predefinição por cada extensão.

Etapa 2: Definir Parâmetros do Processamento

  1. Na área Importação ativar as opções que pretende que sejam já selecionadas no menu de importação (estas opções podem posteriormente ser alteradas no menu Importação Vendas antes de cada importação):
    • Pastas de Sistema: quando ativa, é possível escolher qual das versões do leitor de QRCode utilizar ou se pretende usar todas. Todas as versões permitem a definição do n.º de iterações (mínimo de 1 e máximo de 20) e procuram em todas as páginas do documento. A diferença entre as versões é tecnológica, sendo que a versão 2 utiliza um componente mais avançado; Nota: esta opção pode ter impacto na performance da importação;
    • Cegid Docs;
  2. No campo Documentos sem Dados, poderá selecionar um dos seguintes campos:
    • Importar: o documento é importado e assume o estado Pendente (comportamento atual). Neste caso, poderá efetuar um match manual com o documento do e-fatura na contabilização do documento;
    • Descartar: o documento é importado e assume o estado Descartado;
    • Ignorar: o documento é ignorado e não é importado pela aplicação;
  3. Ativar a opção Contabilização Automática se pretender que os documentos sejam integrados automaticamente na contabilidade do ERP durante a importação. Se ocorrer algum erro durante a contabilização, os documentos serão colocados como Rascunho nos movimentos da contabilidade e deverão ser finalizados manualmente no ERP. Nesta situação, é aconselhável configurar o balanceamento automático dos documentos. Deverá determinar se pretende que a contabilização automática seja efetuada sempre ou apenas nos casos em que tem anexo;
  4. Ativar a opção Normaliza N.º Documento se pretender que o n.º do documento seja normalizado através da verificação de padrões (TipoDoc Serie/NumDoc) ou tipos normalizados (FT, FS, FR, NC, ND, etc.);
  5. Definir o Ano Retenção a considerar nas retenções dos documentos:
    • Ano da Data do Lançamento: o ano da retenção a considerar será o ano da data de lançamento;
    • Ano da Data do Documento: o ano da retenção a considerar será o ano da data do documento;
  6. Definir a Data de Lançamento a considerar na contabilização dos documentos:
    • Data do Documento: a Data de Lançamento a considerar na contabilização será igual à Data do Documento;
    • Último Dia do Mês da Data de Documento: a Data de Lançamento a considerar na contabilização será o último dia do mês da Data do Documento;
  7. Ativar a opção Mês de Referência em docs. de períodos anteriores se pretender que a Data de Lançamento seja o último dia do Mês de Referência definido no Ambiente de Trabalho, quando o documento é de um período anterior. Por exemplo, um documento com data de 15/02/2021 ficaria com data de lançamento de 31/03/2021, caso o mês de março fosse o mês de referencia definido no ambiente de trabalho;
  8. Escolher uma das seguintes opções:
    • Balancear p/ Conta de IVA: o documento é automaticamente balanceado e a diferença do balanceamento é inserida na conta de IVA;
    • Conta Balanceamento: o documento é automaticamente balanceado e a diferença do balanceamento é introduzido na conta definida neste passo. Caso a percentagem de IVA não dedutível for igual a 100% e esta conta não estiver preenchida o balanceamento será feito para a base do IVA (conta que tem associada a classe de IVA);
  9. Indicar o Valor Máximo que será automaticamente balanceado. Por exemplo, se for definido como valor máximo 0,01, os documentos só serão balanceados se o erro de balanceamento for igual ou inferior a este valor. Se o erro for 0,02, os documentos não serão balanceados.

Etapa 3: Definir Parâmetros de criação de Clientes

  1. Ativar a opção Criar Clientes no ERP se pretender que a ficha dos clientes seja criada no ERP. Se optar por não criar as entidades no ERP, estas serão mapeadas para a entidade indiferenciada e os lançamentos serão realizados nesta;
  2. Definir o Tipo de Regra a usar na codificação dos novos clientes: - NIF: o código do cliente será o seu número de identificação fiscal; - Sequência: será atribuído um código numérico sequencial ao cliente. Se esta opção estiver selecionada, deverá indicar no campo Máscara o n.º de dígitos do código com o carácter #. Por exemplo, a máscara #### irá devolver um código sequencial com 4 dígitos (0001, 0002, 0003, ..., 9999); - Máscara: além do exemplo anterior, permite também usar tokens adicionais na sua construção, tais como: # (sequência numérica), D (token Espaço Fiscal) e H (token de País). Exemplo de preenchimento do campo Máscara: DH####; - Customer ID: será atribuído o código do cliente indicado na tabela de clientes do ficheiro SAF-T; - Fórmula: esta opção permite personalizar as regras de codificação de entidades a partir de todos os tokens, campos e fórmulas que o PAA dispõe;
  3. Dependendo da opção selecionada no passo anterior, serão apresentados campos diferentes: - Sequência ou Máscara: preencher o campo Máscara conforme um dos exemplos indicados anteriormente; - Fórmula: indicar fórmula de construção do código do cliente. Ao clicar no botão ..., será aberto o editor de fórmulas, onde poderá personalizar o código recorrendo aos tokens, campos e fórmulas disponibilizados pela aplicação. Além disto, deverá indicar o N.º Dígitos a atribuir ao código do cliente;
  4. Definir o Valor Mínimo e Valor Máximo para o código do cliente (opcional). Quando preenchidos, o código sequencial irá iniciar a numeração a partir do valor mínimo e não irá ultrapassar o valor máximo. Se o valor definido for 0, não há limite mínimo definido;
  5. Ativar a opção Pesquisar dados públicos das Entidades se pretender que os dados dos clientes indicados no ficheiro sejam substituídos pelos dados fiscais sempre que essa informação for pública;
  6. Preencher os campos Cond. Pag., Moeda, Espaço Fiscal, Local Op., Código Postal e País com os valores a considerar na criação da ficha do cliente, caso não exista nenhuma informação no ficheiro;
  7. Indicar no campo Código ERP o código do cliente Indiferenciado no ERP;
  8. Definir a regra de agrupamento de documentos no campo Docs. Clientes Indiferenciados: - Não Agrupar: os documentos não serão agrupados; - Um documento por linha: os documentos serão agrupados e a contabilização fará a distinção de cada documento ao apresentar no movimento uma linha por cada documento de venda; - Por total dos documentos: os documentos serão agrupados, mas, neste caso, apenas irá existir uma linha com o somatório dos totais dos documentos e os respetivos totais de IVA no movimento da contabilidade. Apenas serão agrupados documentos emitidos ao Cliente Indiferenciado no mesmo Dia, por Tipo de Documento Fiscal e Série. O Número de Documento Externo de um documento agrupado terá o formato TipoDocFiscal Série/AAAAMMDD (por exemplo: FR 2024/20240131);
  9. Ativar a opção Lança na Conta de Terceiros se pretender que os saldos do cliente indiferenciado sejam lançados na respetiva conta de terceiros. Caso contrário, o lançamento será realizado pela conta do proveito em contrapartida de caixa/banco;
  10. Na tabela "Nomes de Clientes Indiferenciados", definir os nomes dos terceiros que pretende que sejam considerados como clientes indiferenciados.

Etapa 4: Definir Parâmetros de Ligação à Contabilidade

  1. Ativar a opção Integra com Contas Correntes se pretender que a conta crie pendentes no módulo de Logística. Quando a conta é lançada nos movimentos da contabilidade, deverá garantir que se utiliza um documento contabilístico definido para integrar nas contas correntes, caso contrário o pendente não será criado;
  2. Definir no campo Tipo de Conta o tipo de conta a utilizar na criação do pendente;
  3. No campo Estado, definir o estado da conta corrente na integração da conta com a Tesouraria (quando cria pendentes);
  4. Define o Tipo de Regra a usar no token de ligação da contabilidade dos novos clientes: - Sequência: será atribuído um token numérico sequencial ao cliente; - Igual ao Código: quando selecionado, o token de ligação à contabilidade será igual ao código do cliente definido anteriormente; - Token Fixo: será definido o mesmo token de ligação à contabilidade comum a todos os clientes; - Fórmula: poderá personalizar os tokens de ligação à contabilidade a partir de todos os tokens, campos e fórmulas que o PAA dispõe;
  5. Dependente do tipo de regra selecionado anteriormente, serão apresentados diferentes campos: - Fórmula: indicar a fórmula de construção do código do cliente no respetivo campo. Ao clicar no botão ..., será aberto o editor de fórmulas, onde poderá personalizar o token utilizando tokens, campos e fórmulas disponibilizados pela aplicação; - Valor Fixo: indicar o token de ligação à contabilidade a atribuir a todos os clientes no campo Valor Fixo;
  6. Definir o Valor Mínimo e Valor Máximo para os token de ligação (opcional). Quando preenchidos, a numeração sequencial irá iniciar no valor mínimo e não irá ultrapassar o valor máximo. Se o valor definido for 0, não há limite mínimo definido; Nota: Este campo está disponível quando as opções Sequencial ou Fórmula são selecionadas;
  7. No campo Seg. Terceiro, definir o segmento de terceiro a considerar na criação das contas dos clientes no Plano de Contas.

Etapa 5: Definir Parâmetros de criação de Artigos

  1. Ativar a opção Criar Artigos no ERP se pretender que os artigos sejam criados no ERP;
  2. Preencher os campos Tipo Artigo, Código IVA e Unidade com os valores a considerar na criação do artigo, caso não exista nenhuma informação no ficheiro.

Etapa 6: Definir Mapeamentos das Contas de Descontos

No campo Desconto Financeiro, definir a conta do desconto no Plano de Contas.

Etapa 7: Definir Mapeamentos entre os Impostos e as Contas de Retenção

Nesta secção, definir os mapeamentos entre os tipos de impostos do ficheiro SAF-T e as respetivas contas no Plano de Contas.

  • Tipo de Imposto: Indicação do tipo de imposto que se pretende mapear;
  • Descrição: Descrição do tipo de imposto;
  • Origem: Origem de dados a que se pretende associar a conta. Para cada tipo de imposto, as origens a considerar nesta configuração são as seguintes: - Fatura - Vendas. - Recibos - Vendas; - Documentos - Vendas; - Documentos - Recebimentos;
  • Conta Retenção: Conta do tipo de imposto no Plano de Contas.

Etapa 8: Definir Mapeamentos dos Tipos de Documentos

  1. Indicar o Tipo de Documento Fiscal;
  2. Definir o Tipo de Documento interno correspondente ao tipo de documento fiscal;
  3. Definir o Template a usar para cada tipo de documento fiscal. Esta opção só é aplicável caso não seja utilizado o Assistente de Contabilização ECHO;
  4. Definir a Natureza do Tipo de Documento Fiscal. Por exemplo, ao definir o tipo de documento fiscal FT como sendo de natureza C,tal  significa que na contabilização do documento, a conta de proveito irá ficar a crédito;
  5. Ativar a opção Gerar Liquidação para que os tipos de documentos sejam automaticamente liquidados na contabilização do documento. No entanto, se uma entidade estiver definida para fazer liquidação, essa configuração irá sobrepôr à do documento, ou seja, se um documento fiscal do tipo FT não estiver configurado para gerar liquidação mas a entidade que emitiu o documento tem a liquidação ativa, será gerada a liquidação para o documento FT emitido;
  6. Ativar a opção Ignorar para descartar os tipos de documentos durante a importação.

Etapa 9: Definir Mapeamentos entre os Tipos de Artigo SAF-T e ERP

Nesta secção, definir os mapeamentos entre os tipos de artigo indicados no ficheiro SAF-T e os respetivos tipos de artigo do ERP:

  • Tipo de Artigo SAF-T: Tipo de artigo indicado no ficheiro SAF-T;
  • Descrição: Descrição do tipo de artigo do ficheiro SAF-T;
  • Tipo de Artigo ERP: Descrição do tipo de artigo do ERP.

Etapa 10: Definir Estados a aplicar aos Documentos

  1. No campo Importação com Erros, definir o estado caso existam erros na importação;
  2. No campo Importação com Sucesso, definir o estado caso a importação seja realizada com sucesso;
  3. No campo Importado Anulado, definir o estado de um documento pendente anulado;
  4. No campo Contabilização com Erros, definir o estado do documento caso existam erros na contabilização;
  5. No campo Contabilização com Sucesso, definir o estado do documento caso a contabilização seja realizada com sucesso;
  6. No campo Contabilizado Anulado, definir o estado de um documento contabilizado anulado.

Etapa 11: Selecionar Clientes pretendidos

Na área Clientes, indicar os clientes que pretende aplicar o modelo configurado.

Etapa 12: Finalizar configurações

  1. Ao clicar em Gravar ou Gravar e Sair, estas configurações serão aplicadas a todos os clientes selecionados;
  2. Se existir outra extensão da mesma categoria já ativa, o PAA poderá desativá-la e ativar a nova extensão. Para tal, basta indicar que pretende ativar a nova extensão na caixa de diálogo que será apresentada após clicar em Gravar;
  3. Os clientes ficarão automaticamente com a extensão ativa.

Ativar Extensão

Após efetuar todas as configurações necessárias, deverá ativar a extensão de vendas SAF-T em lote ou por cliente.

Para ativar a extensão SAF-T, siga os seguintes passos:

Ativar por cliente

  1. Aceder a Aplicação | Grupo Início | Clientes;
  2. Selecionar o cliente pretendido e clicar em Editar ou fazer duplo clique sobre a linha do Cliente;
  3. No separador Configurações, em Origens de Dados ativar a extensão SAF-T;
  4. Indicar o modelo de configuração que pretende usar nesta extensão;
  5. Clicar em Gravar ou Gravar e Sair.

Ativar em lote

  1. Aceder a Aplicação | Grupo Tabelas | Extensões;
  2. Selecionar a extensão SAF-T e clicar em Editar ou fazer duplo clique sobre a linha;
  3. Na grelha Clientes, selecionar os clientes onde pretende ativar a extensão;
  4. Indicar o modelo de configuração que pretende utilizar nesta extensão em cada cliente;
  5. Clicar em Gravar ou Gravar e Sair. Se existir outra extensão da mesma categoria já ativa, o PAA poderá desativá-la e ativar a nova extensão. Para tal, basta indicar que pretende ativar a nova extensão na caixa de diálogo que será apresentada após clicar em Gravar ou Gravar e Sair.
Só é possível ter uma extensão ativa por cada categoria.

Exemplos de Codificação de Clientes com fórmulas

Quando é utilizado o tipo de regra Fórmula para criar entidades, é necessário parametrizar dois campos para definir a regra de criação do código.

Este código é constituído por duas partes:

  • Prefixo fixo: definido no campo Fórmula;
  • Número de dígitos do código: definidos no campo N.º Dígitos.

Neste tipo de regra, é necessário preencher no mínimo um destes campos.

De seguida, são apresentados alguns exemplos de codificação de clientes utilizando a opção Fórmula.

Exemplo 1: Código igual ao NIF

Esta fórmula corresponde à seleção do N.º Fiscal no campo Tipo de Regra.

  • Fórmula: [NIFOrigem]
  • N.º Dígitos: 0 (não há sequência)

Exemplo 2: Código sequencial

Esta fórmula corresponde à seleção da opção Sequência no campo Tipo de Regra. Este exemplo pressupõe uma sequência numérica com quatro dígitos.

  • Fórmula: não é preenchido
  • N.º Dígitos: 4

Exemplo 3: Máscara

Esta fórmula corresponde à seleção da opção Máscara no campo Tipo de Regra.

O seguinte exemplo demonstra um código constituído pelo Espaço Fiscal, País e uma sequência numérica com quatro dígitos.

  • Fórmula: [D] + [H]
  • N.º Dígitos: 4

Exemplo 4: Código igual ao CustomerID

Esta fórmula corresponde à seleção do CustomerID no campo Tipo de Regra.

  • Fórmula: [OrigemUQ]
  • N.º Dígitos: 0 (não há sequência)

Exemplo 5: Código igual aos seis últimos dígitos do NIF

  • Fórmula: SafeSubString([NIFOrigem], 3, 6) - O resultado obtido serão os seis dígitos do NIF a contar a partir do dígito da terceira posição
  • N.º Dígitos: 0 (não há sequência)

Exemplos de criação de Tokens com fórmulas

De seguida, são apresentados três exemplos de criação de tokens de ligação à contabilidade utilizando a opção Fórmula.

Exemplo 1: Token igual ao código do cliente

Esta fórmula equivale à seleção da opção Igual ao Código no campo Tipo de Regra.

  • Fórmula: [CodigoPRI]

Exemplo 2: Número sequencial

Esta fórmula equivale à seleção da opção Sequência no campo Tipo de Regra. Neste caso, ao maior valor existente no ERP será somado um.

  • Fórmula: [NumeradorTokenEntidade]

Exemplo 3: Token Fixo

Neste caso, basta fixar o valor pretendido no campo Fórmula.

  • Fórmula: '1234'
Os tokens de ligação à contabilidade só podem ser constituídos por algarismos. Assim, deverá garantir que, quando escolhe a opção Igual ao Código ou usa o código da entidade na Fórmula, este é constituído apenas por números.

Por exemplo, se pretender usar como Token CBL o NIF da entidade e se esta for intracomunitária, na configuração do token deve selecionar fórmula no tipo de regra e usar a seguinte fórmula para remover as letras do país do NIF: Replace([NIFOrigem], [PaisOrigem], '').