---
title: "Validação do NIF dos Clientes e Fornecedores via Web Service (AO)"
slug: "1774265457"
tags: ["NIF", "Fornecedores", "Clientes"]
updated: 2026-08-28T10:13:11Z
published: 2026-08-28T10:13:11Z
canonical: "help.ila.cegid.com/1774265457"
---

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

# Validação do NIF dos Clientes e Fornecedores via Web Service (AO)

- [ ] PT
- [x] AO
- [ ] MZ
- [ ] CV

- [ ] CS
- [ ] Evolution

- [ ] Web
- [ ] Desktop

---

É possível validar o NIF dos clientes e fornecedores através de um Web Service da AGT.

Esta funcionalidade está disponível nos módulos PHC CS Documentos Eletrónicos desktop, Gestão e POS, nas gamas Advanced e Enterprise e com subscrição PHC ON ativa.

---

## Configurações

A configuração é feita no nó **Documento Eletrónico** através dos seguintes parâmetros:

- **AO: Utiliza o webservice da AGT para validação do NIF de clientes e fornecedores:** ao ativar este parâmetro, nos **Clientes** e **Fornecedores** passa a estar disponível a opção **Validado na AGT**, permitindo que ao inserir o NIF, o mesmo seja validado pela AGT e o respetivo nome do Cliente/Fornecedor preenchido de forma automática;
- **AO: Webservice Comunicação da AGT – URL de validação do NIF**: preencher com o URL [*https://sifphml.minfin.gov.ao/sigt/contribuinte/comercial/v1/obter*](https://sifphml.minfin.gov.ao/sigt/contribuinte/comercial/v1/obter)*;*
- **AO: Webservice de validação do NIF, Password**: preencher com a password requisitada à AGT;
- **AO: Webservice de validação do NIF, Utilizador:** preencher com o utilizador requisitado à AGT.

---

## Validação

A validação do **NIF** e **Nome** associado pode ser efetuada nos seguintes ecrãs:

- Gestão de Clientes;
- Faturação a Clientes;
- Gestão de Fornecedores;
- Compras a Fornecedores;
- Correção e validação de NIFs (Opção **Validação** dos NIFs utilizando o WebService da AGT – Clientes ou Fornecedores).

Esta funcionalidade permite que ao criar um cliente/fornecedor ou documento de faturação/compra, o NIF seja validado pela AGT e o respetivo nome do Cliente/Fornecedor seja preenchido de forma automática.

**Gestão de Clientes/Fornecedores**

Nos ecrãs **Gestão de Clientes/Fornecedores**, ao preencher o campo **N.º Contribuinte**, podem existir **dois** cenários possíveis de acordo com o **País de Origem**:

1. Se for **Nacional**, a aplicação estabelece ligação via Web Service com a AGT. Caso o NIF seja válido na AGT, a opção **Validadona AGT** fica ativa e o campo **Nome** é preenchido de forma automática. Se não for válido, não poderá utilizar esta opção, mas poderá inserir manualmente o nome;
2. Se for **U.E./Outros**, a aplicação **não estabelece** ligação via Web Service com a AGT. A opção **Validado na AGT** fica desativa e é necessário preencher de forma manual o nome.

Com a opção **Cliente Genérico** ativa, a opção **Validado na AGT** deixa de estar disponível.

Nas **opções diversas** dos ecrãs Gestão de Clientes/Fornecedores, estão disponível a opção **Validação dos NIFs utilizando o WebService da AGT** e permite validar todos os **NIFs** e **Nomes** associados a todos os registos de clientes/fornecedores ativos. Se forem apresentados nomes diferentes dos que estão associados à ficha do cliente/fornecedor, os mesmos são atualizados e a opção **Validado na AGT** fica ativa.

No final, é apresentado o relatório de validação dos NIFs.

**Faturação a Clientes/Compras a Fornecedores**

Nos ecrãs **Faturação a Clientes/Compras a Fornecedores**, ao inserir um documento (com série **Tipo para SAF-T** definido), podem existir **dois** cenários possíveis ao selecionar o cliente/fornecedor de acordo com o **País de Origem**:

1. Se for **Nacional** (ficha do cliente/fornecedor), a aplicação estabelece ligação via Web Service com a AGT, verifica o NIF e do Nome:
  - Se o **nomenão estiver correto**, o mesmo é corrigido de forma automática na ficha de cliente/fornecedor e no documento de faturação/compra. A opção **Validado na AGT** fica ativa
  - Se o **NIF não for válido** na AGT, não poderá criar o documento de faturação/compra e deverá verificar o NIF inserido. A opção **Validado na AGT** fica inativa
2. Se for **U.E./Outros** (ficha do cliente/fornecedor), a aplicação **não estabelece l**igação via Web Service com a AGT e é possível criar o documento de faturação/compra. A opção **Validado na AGT** fica inativa.