MANUAL TÉCNICO
Information Miner Service – Infominsrv
Versão SRV4
Página |2
1.0 – SOBRE ESTE DOCUMENTO:
Este manual técnico descreve a interface para acesso ao sistema de consulta INFOMINSRV.
2.0 – INTRODUÇÃO:
O InfominSRV consiste em um aplicativo WEB que pode ser acessado através de qualquer
cliente HTTP. Através de uma chamada HTTP usando o método GET, fornecendo os parâmetros
apropriados, podem ser realizados diversos tipos de consulta.
*A interface de acesso foi projetada para maior simplicidade possível e que pudesse ser acessada por
qualquer sistema operacional com qualquer cliente disponível.
3.0 – INTERFACE DE CHAMADA
Para maior clareza vamos usar a seguinte convenção:
-IHOST -> Nome do host onde se encontra o serviço Infominsrv. Quando da real aplicação deverá ser
substituído pelo nome do servidor real.
-SERV -> Caminho do serviço dentro do servidor. Deverá ser substituído pelo path real.
Exemplo de chamada:
http://IHOST/SERV/login.php?contrato=001&usuario=001&senha=12345
Na chamada acima podemos ver os seguintes componentes:
ÍTEM
DESCRIÇÃO
http://
Protocolo
IHOST
Nome do host
SERV
Nome do serviço
login.php
Página
?
Marcador de inicio dos parâmetros
contrato, usuario , senha
Nome dos parâmetros
=001, =002, =123
Valores dos parâmetros
&
Separador de parâmetros
Página |3
4.0 – LOGIN
Antes de poder usar o serviço de consulta é necessário executar o login no serviço.
A página de login retorna apenas dois resultados possíveis:
1) Erro: Falha ao logar no serviço
2) Certo: OK PHPSESSID=1865465b65465c4654b6d5
Quando ocorre um login correto, na linha seguinte ao OK, virá o identificador da sessão, que deverá
ser informado nas chamadas das consultas subseqüentes.
Logo um aplicativo para usar o serviço Infominsrv deverá, após uma chamada ao login, guardar a linha de
sessão e usá-la nas próximas chamadas.
A chamada ao LOGIN é feita da seguinte forma:
http://IHOST/SERV/login.php?contrato=nnnn&usuario=nnnn&senha=aaaa
Onde os parâmetros têm os seguintes significados:
ÍTEM
contato
usuario
DESCRIÇÃO
Código do contrato de quem está
consultando.
Código do usuário do contrato
senha
Senha do usuário
Em caso de dados corretos, haverá um retorno TXT com o seguinte formato:
OK PHPSESSID=725663enmso8u69mu56f3vuod3
5.0 – CONSULTAS
Para executar uma consulta, a página a ser chamada é EXEC, e os parâmetros são os seguintes:
ÍTEM
DESCRIÇÃO
Número do serviço de busca:
1: CPF/CNPJ
2: DDD/TELEFONE
servico
3: CNPJ/CEP
4: ENDERECO
6: NOME
7: MASTER
8: LOCALIZADOR
modo
-PREV: Primeiro Registro.
-PROX: Próximo Registro.
Página |4
Além dos parâmetros da consulta deve-se informar também a sessão. Logo a chamada da consulta de
CPF/CNPJ seria algo como:
http://IHOST/SERV/exec.php?PHPSESSID=725663enmso8u69mu56f3vuod3&modo=PREV&servico=1&cnpj=02
788106000127&uf=RJ&retorno=1
A resposta será algo como:
212437655002788106000127MMD MAILING INFORMACOES CADASTRAIS LTDA EPP
AV
AVENIDA
DAS AMERICAS
0016150LJ129
BARRA DA TIJUCA
22790704RIO DE JANEIRO
RJAV AVENIDA
DAS
AMERICAS
0016150LJ 129
BARRA DA
TIJUCA
22790704RIO DE JANEIRO
RJ
t5e14i2010/12/21
11:08:10
7
Página |5
Onde a primeira linha contém o primeiro registro de resultado da busca e a segunda linha contém o
número de registros ainda disponíveis.
Para receber o próximo registro, basta refazer a pesquisa apenas com o parâmetro de sessão e o
modo=PROX.
Caso não exista nenhum dado na base, o retorno será vazio. No caso a variável retorno esteja
inicializada com 1, o retorno será a string INFORMACAO NAO ENCONTRADA
O registro possui a seguinte estrutura:
Posições
1a2
3 a 10
11 a 24
25 a 104
105 a 112
113 a 136
137 a 226
227 a 133
234 A 283
284 A 323
324 A 331
332 A 381
382 A 383
384 A 391
392 a 415
416 a 505
506 a 512
513 a 562
563 a 602
603 a 610
611 a 660
661 a 662
661 a 716
Tamanho
2
8
14
80
8
24
90
8
50
40
8
50
2
8
24
90
8
50
40
8
50
2
55
Campo
DDD
TELEFONE
CNPJ
NOME
LOG
LOG COMP
ENDERECO
NUMERO
COMP
BAIRRO
CEP
CIDADE
UF
LOG2
LOG COMP2
ENDERECO2
NUMERO2
COMP2
BAIRRO2
CEP2
CIDADE2
UF2
PROTOCOLO
Página |6
6.0 – MASTER
O serviço MASTER possui além da localização, o histórico da participação societária, nome da mãe, sexo,
data de nascimento.
Posições
1a2
3 a 10
11 a 24
25 a 104
105 a 112
113 a 136
137 a 226
227 a 133
234 A 283
284 A 323
324 A 331
332 A 381
382 A 383
384 A 391
392 a 415
416 a 505
506 a 512
513 a 562
563 a 602
603 a 610
611 a 660
661 a 662
663 a 742
743 a 743
744 a 751
752 a 961
962 a 34961
34962 a
35017
Tamanho
2
8
14
80
8
24
90
8
50
40
8
50
2
8
24
90
8
50
40
8
50
2
80
1
8
210
34000
Campo
DDD
TELEFONE
CNPJ
NOME
LOG
LOG COMP
ENDERECO
NUMERO
COMP
BAIRRO
CEP
CIDADE
UF
LOG2
LOG COMP2
ENDERECO2
NUMERO2
COMP2
BAIRRO2
CEP2
CIDADE2
UF2
MÃE
SEXO
DATA DE NASCIMENTO
E-MAIL
PARTICIPAÇÃO SOCIETÁRIA
55
PROTOCOLO
Os Campos EMAILS e PARTICIPAÇÂO SOCIETÁRIA trazem mais de uma informação, concatenadas pelo
caractere “|”. Esses dados dependem do tamanho do histórico em nossa base.
A resposta será algo como:
212437655002788106000127MMD MAILING INFORMACOES CADASTRAIS LTDA EPP
AV
AVENIDA
DAS AMERICAS
0016150LJ129
BARRA DA TIJUCA
22790704RIO DE JANEIRO
RJAV AVENIDA
DAS
AMERICAS
0016150LJ 129
BARRA DA
TIJUCA
22790704RIO DE JANEIRO
RJ
00083904069772|SOCIO-GERENTE|1998-10-06|50.00|1,00086898019791|SOCIO-GERENTE|1998-1006|50.00|1
b59m742010/12/16 22:05:24
Página |7
6.0.1 – PARTICIPAÇÃO SOCIETÁRIA
O campo participação societária traz concatenado todos os sócios do CNPJ pesquisado, esses dados
vem separados pelo caractere “,”.
CPF/CNPJ
DATA ENTRADA
QUALIFICAÇÃO
TIPO (1 CPF, 0 CNPJ)
7.0 – CONSULTAS DE CHEQUE
Para executar uma consulta, a página a ser chamada é EXEC, e os parâmetros são os seguintes:
INFORMANDO SOMENTE O DOCUMENTO
Respostas: BACEN
Cheques Informados por Associado; Consulta(s) Anterior(es).
INFORMANDO DOCUMENTO + CMC7
Respostas: BACEN
Cheques Sustados;
Cheques Informados por Associado; Consulta(s) Anterior(es);
Cheques Sustados para Banco, Agência, Cheque e Conta Corrente porém para outro Documento;
Talão Sustado para Banco, Agência, Cheque e Conta Corrente porém para outro Documento.
ÍTEM
DESCRIÇÃO
servico
Número do serviço de busca: 5
modo
CHQ
cnpj
CPF ou CNPJ
cmc71
Primeiro campo do código de barras do cheque.
cmc72
Segundo campo do código de barras do cheque.
cmc73
Terceiro campo do código de barras do cheque.
qtdecheques
Quantidade de cheques.
natoper
Natureza de operação (vide tabela de natureza de operação)
valor
Valor com 2 casas decimais, mesmo que sejam valores inteiros é necessário
adicionar zero nas casas decimais.
personalidade
1 – Pessoa Física. 2 – Pessoa Jurídica.
ddd
telefone
Valor com dois números.
Valor com 8 números sem espaço nem ponto
Além dos parâmetros da consulta deve-se informar também a sessão. Logo a chamada
de consulta de CPF/CNPJ seria algo como:
Página |8
http://IHOST/SERV/exec.php?PHPSESSID=03020d050b0034d00dbac3209&modo=CHQ&cnpj=08760588705&
cmc71=11111111&cmc72=2222222222&cmc73=333333333333&qtdecheques=nn&natoperacao=nn&valor=
nnnnn&personalidade=n&ddd=nn&telefone=nnnnnnnn
A linha de resposta é muito extensa e possui comprimento variado.
8.0 – LOCALIZADOR
O serviço LOCALIZADOR retorna até cinco linhas de endereços por vez para o parâmetro de entrada
fornecido:
02788106000127MMD MAILING INFORMACOES CADASTRAIS LTDA EPP
DAS AMERICAS
0016150LJ 129 SS
TIJUCA
22790704RIO DE JANEIRO
RJ1 a 2 anos
cidjma2011/05/04 15:12:29
02788106000127MMD MAILING INFORMACOES CADASTRAIS LTDA EPP
PEDRO TELES
0000097LJ B
21320120RIO DE JANEIRO
RJ1 a 2 anos
02788106000127MMD MAITING INFORMACOES
TELES
0000097B
21320120RIO DE JANEIRO
RJ3 a 4 anos
02788106000127MMD MAILING INFORMACOES CADASTRAIS LTDA EPP
PEDRO TELES
0000097LJ A
21320120RIO DE JANEIRO
RJ4 a 5 anos
3
AV
AVENIDA
BARRA DA
R
RUA
PRACA SECA
cidjma2011/05/04 15:12:29
R
RUA
PEDRO
PRACA SECA
cidjma2011/05/04 15:12:29
R
RUA
PRACA SECA
cidjma2011/05/04 15:12:29
A Última linha do retorno referisse ao total de registro de ainda existem em nossa base de dados.
A string de consulta do LOCALIZADOR e a exemplificada abaixo:
http://IHOST/SERV/exec.php?PHPSESSID=cidjma0ujap1firb0mp7pl7oq6&servico=8&modo=PREV&cnpj=02788
106000127&retorno=1
Onde:
PHPSESSID = é o identificador da sessão aberta ao efetuar o login;
servico = é o número que identifica o serviço LOCALIZADOR, o número 8;
modo = PROV traz o registro inicial e PROV traz os próximos 5 registros, caso existam.
cnpj = é o documento de busca;
Retorno = 1 para mostrar uma frase padrão para registro não encontrado;
A estrutura de saída de cada linha de registro encontrada é a seguinte:
Página |9
Posições
1 a 14
14 a 94
94 a 102
102 a 126
126 a 216
216 a 223
223 a 273
273 a 313
313 a 321
321 a 371
371 a 373
373 a 393
393 a 448
Tamanho
14
80
8
24
90
7
50
40
8
50
2
20
55
Campo
CNPJ
NOME
LOG
LOG COMP
ENDERECO
NUMERO
COMPLEMENTO
BAIRRO
CEP
CIDADE
UF
FAIXA
PROTOCOLO
* No processamento via string não retornamos o mapa de localização. Somente na versão web, via
Infominweb.