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 

   

 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!