Utilização da API - Orientações

• Configuração de Proxy
• Configuração de Chamadas
• Arquivos de Retorno

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

 

Exemplo:
!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!