# Análise TIPI - Manual do Usuário

# Utilização da API - Orientações

# Configuração de Proxy

O sistema possui três tipos de arquivos de configuração, um para o proxy, outro para as chamadas e um terceiro para a configuração de um e-mail, para o qual será enviado um aviso, caso ocorra um problema durante o processo.

  
**proxy.txt**

  
Este arquivo não poderá ter o seu nome alterado e sua ausência implicará na não utilização de informações de proxy nas tentativas de comunicação.

  
Caso de fato não exista a necessidade de configuração de proxy o arquivo poderá ser omitido, mas aconselhamos mantê-lo presente, porém, alterando seus parâmetros para não utilizar proxy.

  
**Estrutura do arquivo proxy.txt**  
Ativo=sim  
IP=192.111.2.3  
Porta=1122  
Tipo=4  
Usuario=xxxx  
Senha=yyyy

A alteração da primeira linha para "não" ou "nao" é o suficiente para desativar a utilização do proxy.

# Configuração de Chamadas

Esse arquivo configura os parâmetros que serão utilizados nas chamadas ao webservice e deve existir somente um e com o nome config.txt.

 O arquivo poderá ser utilizado para configurar uma ou mais chamadas.

**Estrutura do arquivo de chamada**

 Chamada para o serviço de TIPI:  
  **Usuário|Senha|Paginação|NCM|Pasta**  
\- Paginação é um inteiro de 1 a 50 e quantidade de NCM's que serão retornadas por chamada.  
\- NCM – O código da NCM a partir do qual a busca se iniciará.  
\- Pasta – O local onde o retorno será salvo.

# Arquivos de Retorno

**Nome dos arquivos de retorno**

Cada chamada ao web service produzirá um arquivo de retorno que será nomeado da seguinte forma:

 **Resultado\_"data AAAAMMDD".txt**

A data refere-se à geração do arquivo.

**Conteúdo dos arquivos**

Os arquivos TXT seguem o seguinte formato, separados por vírgula e delimitados por exclamação:

  **!CODNCM!,!SEQ!,!DESCNCM!,!II!,!IPI!,!ICMS!,!ATO!,!DTINICIAL!,!DTFINAL!**

SEQ – O valor 1 representa os dados da NCM propriamente dita, os demais números representam as exceções da NCM em questão.

DTINICIAL – Data de início da vigência

DTFINAL – Data de término da vigência

<span style="text-decoration: underline;">Exemplo:</span>  
!84243090!,!3!,!Máquinas para jatear com solução abrasiva a face metalizada de placas para produção de circuito impresso!,!2.00!,!!,!!,!Decreto nº 7.660, DOU de 26.12.2011!,!2010-05-03!,!31/12/2011!