Guia

de Utilização do
WebService para Consulta
de Dados dos Contribuintes
Versão 1.0

Copyright @2017

Serviço de Tecnologias de Informação e Comunicação das Finanças Públicas

 ÍNDICE Pág.

1. INTRODUÇÃO .......................................................................................... 3

2. BREVES CONSIDERAÇÕES ....................................................................... 3

3. MÉTODOS DE ACESSO ............................................................................. 4

3.1 MÉTODO SOAP ................................................................................ 4
3.2 MÉTODO REST ................................................................................ 7

4. CONSIDERAÇÕES FINAIS .......................................................................... 9

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 2 de 9
1. INTRODUÇÃO

Este guia representa uma tentativa que visa dar resposta as possíveis inquietações
com que poderão confrontar- se, num primeiro momento da utilização da plataforma
WebService dos dados relativos aos contribuintes.

2. BREVES CONSIDERAÇÕES

A plataforma WebService de consulta de contribuintes foi desenvolvida para facultar

a partilha de informação dos mesmos com os mais diversos parceiros do MinFin. A
mesma dispõe de dois serviços:

1º Serviço: Consulta para obter informações do determinado Contribuinte com base

no NIF inserido:
 Input (parâmetros de entrada):
o numeroNif
 Output (Parâmetros de saída):
o numeroNif
o nomeContribuinte
o estadoContribuinte
o tipoContribuinte

2º Serviço: Consultar Lista de histórico das alterações ocorridas nos

contribuintes num determinado período:

 Input (parâmetros de entrada):

o dataInicio (DD-MM-YYYY)
o dataFim (DD-MM-YYYY)
 Output (Parâmetros de saída):
o numeroNif
o nomeContribuinte
o estadoContribuinte
o tipoContribuinte
o tipoOperacao

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 3 de 9
3. MÉTODOS DE ACESSO

Foi providenciado dois métodos de acesso e nos quais é requerida a autenticação

com Nome do Utilizador e Palavra-passe para validação:

3.1 MÉTODO SOAP

Aceda por intermédio dos links abaixo, respectivamente: do serviço de

Consultar Lista de histórico das alterações nos contribuintes por período e do
serviço de consulta para Obter informações do determinado Contribuinte:
https://services.minfin.gov.ao/tributario/contribuinte/nif/ws/v1/listar?WSDL
https://services.minfin.gov.ao/tributario/contribuinte/nif/ws/v1/obter?WSDL

Para o efeito, basta conformar as configurações básicas do Request Método

SOAP utilizando a ferramenta SOAPUI, conforme os passos abaixo:

1º Passo: Criar o projecto SOAP

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 4 de 9
 2º Passo: Preencha o end point do WSDL (Web Services Description Language)
e as credencias de acesso ao serviço

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 5 de 9
 3º Passo: Na janela similar ao de cima, faça duplo click em Request1 no navegador
Projects. Posteriormente, tal como sinalizado abaixo, clique em [edit o current] e
suprima o “:443” e substitua os símbolos “?” por datas:

4ºPasso: Executar o critério

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 6 de 9
5º Passo: Confira o resultado

3.2 MÉTODO REST

Explore usando os links abaixo, respectivamente: do serviço de consulta para Obter

informações do determinado Contribuinte, e Serviço de Consultar Lista de histórico
das alterações nos contribuintes por período:
https://services.minfin.gov.ao/tributario/contribuinte/nif/v1/obter?numeroNif=7401
020114
https://services.minfin.gov.ao/tributario/contribuinte/nif/v1/listar?dataInicio=17-10-
2016&dataFim=10-11-2016

Por conseguinte, basta adequar as configurações básicas do Request

Método REST utilizando a ferramenta SOAPUI, conforme os passos abaixo:

1º Passo: Criar o projecto REST

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 7 de 9
2º Passo: Preencha o Uniform Resource Identifier (URI) e as credencias

3º Passo: Insira as credencias e ajuste o parâmetro de pesquisa

4º Passo: Executar o critério e confira o resultado

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 8 de 9
4. CONSIDERAÇÕES FINAIS

Em caso de sugestões e contribuições, remeta para: dsi.gestao@minfin.gv.ao;

Para as questões de acessos / reset de senhas, contacte: suporte@minfin.gv.ao.

Guia de Utilização do Web Service para Consulta de Dados de Contribuintes – V. 1.0

Preliminar, Sujeito a Alterações – Restrito e Confidencial
Página 9 de 9