Histórico da Página
Objetivo
Consulta de dados cadastrais de empresas no sistema do Sintegra.
Considerações
- Políticas que utilizem esse acesso devem ser construídas com contingência de erros de comunicação com as entidades externas.
- O site do Sintegra pode estar indisponível devido problemas de conexão ou manutenção.
- O serviço TOTVS Mashup utilizado para realizar o acesso ao Sintegra pode estar sobrecarregado, com problemas ou em manutenção.
- A entidade de solução de imagens (captchaSolver) pode estar com sobrecarga de uso de seus servidores.
- Em média, um acesso leva 1 minuto e 20 segundos para ser concluído. Esse tempo pode ser maior ou menor dependendo do Estado e situação de carga dos serviços usados.
- Este acesso pode ser configurado para utilização através de proxy. Vide propriedades de Proxy.
- A consulta no sistema de alguns estados estão com problemas no momento, consulte a lista de estados disponíveis para saber quais estão funcionando.
Estados Disponíveis
AL – Alagoas
AP – Amapá
AM – Amazonas
BA – Bahia
CE – Ceará
DF – Distrito Federal
ES – Espírito Santo
GO - Goiás
MT – Mato Grosso
MG – Minas Gerais
PA – Pará
PB – Paraíba
PR – Paraná
PE – Pernambuco
PI – Piauí
RS – Rio Grande do Sul
SC – Santa Catarina
SP – São Paulo
TO – Tocantins
Propriedades Configuráveis do Acesso
Sem Formato |
---|
sintegra.auditAccess=true sintegra.proxyAddress=proxy.sp01.local sintegra.proxyDomain=sp01 sintegra.proxyPassword=sWjwX9VYtK4AiB97oCkJQyjrNLYFHv2+Dg\=\=D1pn58GhaA\=\= sintegra.proxyPort=8080 sintegra.proxyUser=frederico.jabulka sintegra.useProxy=true |
Preenchimento da HashMap de Entrada
Dados de Entrada do Acesso
- UF: Sigla da Unidade da Federação da empresa a ser consultada.
- CNPJ: CNPJ da empresa a ser consultada.
- IE: Inscrição Estadual da empresa. Obrigatório apenas se a empresa consultada possuir mais de uma.
Dados de Saída do Acesso
RAZAO: Razão Social
CNPJ: CNPJ
INSCRICAO: Inscrição Estadual
DT_INSCRICAO: Data Inscrição
ATIVIDADE: Atividade
SITUACAO: Situação
DT_SITUACAO: Data Situação
ESTADO: Estado
CIDADE: Cidade
BAIRRO: Bairro
LOGRADOURO: Logradouro
NUMERO: Número
COMPLEMENTO: Complemento
CEP: CEP
REGIME_ICMS: Regime ICMS
TELEFONE: Telefone
EMAIL: E-Mai
OBSERVACOES: Observações
Tratamento de erro
Os possíveis erros do acesso são:
- LayoutException: Problemas relacionados a layout de envio e a leitura da pagina retornada da consulta.
- InfraException: Problemas relacionados a comunicação com entidades externas e solução de imagem de segurança.
- ConfigException: Problemas relacionados a parametrização e configuração do acesso.
Informações adicionais
O plugin Sintegra consiste na construção de um novo acesso do Intellector de consulta automatizada a dados do Sintegra - Sistema Integrado de Informações sobre Operações Interestaduais com Mercadorias e Serviços - hoje disponível para consultas manuais no endereço: http://www.sintegra.gov.br/
Foi implementada uma comunicação ao sistema Mashup da Totvs, no qual pode ser modelada, na forma de fluxo, qualquer consulta a qualquer site na web. A ferramenta está disponível em: http://mashups.totvs.com.br. A ferramenta já possui consulta ao site do Sintegra, e é possível a execução online através do Intellector Server.
O novo acesso possui o mapeamento dos estados e atributos de cada um para possibilitar a navegação automatizada sobre o fluxo. Este mapeamento será armazenado em um arquivo XML, que poderá ser atualizado de acordo com alterações do fluxo no Mashup. Esse mapeamento também é responsável por relacionar as variáveis de entrada e saída do acesso com as variáveis de entrada e saída no fluxo do Mashup.
A consulta ao Sintegra é diferente para cada UF, e a maioria possui imagem de segurança (captcha) para evitar acessos automatizados. Atualmente, o sistema de Mashup ainda não possibilita a resolução de imagens de segurança. Consequentemente, essa etapa normalmente requer intervenção manual do usuário para interpretar e informar o código da imagem de segurança. Para possibilitar a consulta automatizada, será utilizada a solução implementada no acesso da Receita Federal para solução automática desses captchas.
A execução do acesso poderá ser feita de duas formas: pelo plugin, sendo executado diretamente a partir do Intellector Server ou a partir de uma política implementada no Intellector Cliente (Compilador). Em ambas, o resultado deverá ser o mesmo.
Como dados de entrada para a consulta, temos os seguintes campos:
CNPJ
Inscrição Estadual (IE)
UF
Sendo o CNPJ e UF de preenchimento obrigatório. Sendo assim, o IE torna-se opcional.
Como dados de saída da consulta, temos os seguintes atributos:
Atividade Principal
Bairro
CEP
Cidade
CNPJ
Complemento
Data Inscrição
Data Situação
E-Mail
Estado
Inscrição Estadual
Logradouro
Número
Observações
Razão Social
Regime ICMS
Situação
Telefone
Os campos que não apresentarem conteúdo não serão exibidos no layout de saída.
Para configurar as propriedades do acesso é preciso acessar a tela Configurar Plugin do Intellector Server em Plugins de Acesso : Listar Plugins : Pesquisar : Configurar. Os campos presentes devem ser preenchidos/alterados com os dados conforme abaixo:
Sem Formato |
---|
sintegra.auditAccess= sintegra.proxyAddress= sintegra.proxyDomain= sintegra.proxyPassword= sintegra.proxyPort= sintegra.proxyUser= sintegra.useProxy= |
Descrevendo cada campo, temos:
auditAccess - assume os valores "true", para que as informações do acesso sejam armazenadas no banco de dados para posterior auditoria, se necessário; ou "false", caso o armazenamento dessas informações não seja desejado.
proxyAddress - deve ser preenchido com o endereço do proxy da rede utilizada pelo sistema. Como exemplo, podemos citar: proxy.sp01.local.
proxyDomain - é o valor definido para o domínio da rede. Exemplo: sp01
proxyPassword - deve ser preenchido com o valor da senha utilizada no acesso ao proxy. Entretanto, o valor deve estar criptografado como medida de segurança. Para criptografar a senha pode ser usado o componente de criptografia presente na tela. Basta selecionar o botão Criptografar, preencher com o valor da senha e confirmar a operação de criptografia. Copiar o valor gerado e colar no campo "proxyPassword".
proxyPort - corresponde a porta utilizada pelo "proxyAddress". Exemplo: 8080.
proxyUser - nome do usuário configurado para o proxy correspondente.
useProxy - assume os valores "true", para que os dados sejam filtrados pelo proxy; ou "false" que desativa a utillização do proxy para o acesso executado.
Esses dados também podem ser previamente configurados no arquivo sintegra.properties situado na pasta resourses do .jar do acesso, como abaixo:
Sem Formato |
---|
sintegra.auditAccess=true sintegra.proxyAddress=proxy.sp01.local sintegra.proxyDomain=sp01 sintegra.proxyPassword=sWjwX9VYtK4AiB97oCkJQyjrNLYFHv2+Dg\=\=D1pn58GhaA\=\= sintegra.proxyPort=8080 sintegra.proxyUser=frederico.jabulka sintegra.useProxy=true |
O arquivo XML de entrada e saída da consulta ao acesso Sintegra deverá ter o seguinte layout:
O conjunto de parâmetros de entrada deve ser:
Bloco de código | ||
---|---|---|
| ||
<entrada> <field description="CNPJ a ser consultado" type="String" format="">CNPJ</field> <field description="Inscrição Estadual a ser consultada" type="String" format="">IE</field> <field description="Unidade Federativa a ser consultada" type="String" format="">UF</field> </entrada> |
Observar que não estamos incluindo o campo de código de imagem de segurança como campo de entrada, por ser um campo interno do acesso e seu valor será determinado em tempo de execução.
Interface de saída do acesso:
Bloco de código | ||
---|---|---|
| ||
<!-- contem todas as saidas disponiveis pelo Acesso Sintegra --> <saida id="CONSULTA_SINTEGRA" counter="" > <register description="CNPJ" type="String" format="">CNPJ</register> <register description="Inscrição Estadual" type="String" format="">INSCRICAO</register> <register description="Razão Social" type="String" format="">RAZAO</register> <!-- Endereço --> <register description="Logradouro" type="String" format="">LOGRADOURO</register> <register description="Número" type="String" format="">NUMERO</register> <register description="Complemento" type="String" format="">COMPLEMENTO</register> <register description="Bairro" type="String" format="">BAIRRO</register> <register description="Cidade" type="String" format="">CIDADE</register> <register description="Estado" type="String" format="">ESTADO</register> <register description="CEP" type="String" format="">CEP</register> <register description="Telefone" type="String" format="">TELEFONE</register> <register description="E-Mail" type="String" format="">EMAIL</register> <!-- Informações Complementares --> <register description="Situação Cadastral Vigente" type="String" format="">SITUACAO</register> <register description="Data desta Situação Cadastral" type="String" format="">DATASITUACAO</register> <register description="Atividade Econômica" type="String" format="">ATIVIDADE</register> <register description="Regime de Apuração de ICMS" type="String" format="">REGIMEICMS</register> <register description="Observações" type="String" format="">OBSERVACOES</register> <register description="Data da Inscrição" type="String" format="">DATAINSCRICAO</register> </saida> |
Segue abaixo algumas telas que permitem visualizar a execução de alguns dos requisitos descritos acima.
Configuração de Propriedades
Executar Plugin de Acesso
Executar Política
Mensagens de Exceções
O Mashup não foi capaz de solucionar o captcha.
Captcha não solucionado por "esbarrar" no proxy
CNPJ informado é inválido
Sobrecarga do sistema para consulta