Suframa
Objeto que realiza consulta de CPF / CNPJ
Visão Geral
O objeto Suframa é utilizado para consultar informações cadastrais relacionadas à Superintendência da Zona Franca de Manaus (SUFRAMA) durante a execução de um robô.
Esse objeto permite realizar consultas utilizando CNPJ ou CPF, retornando dados relacionados ao cadastro do contribuinte no sistema da SUFRAMA. Essa consulta é útil em processos que exigem validação de cadastro de empresas ou pessoas vinculadas à SUFRAMA.
Opcionalmente, a consulta pode ser realizada utilizando acesso pessoal ao sistema CADSUF, permitindo autenticação no portal quando necessário.
Funcionamento
O objeto Suframa realiza uma consulta no sistema da SUFRAMA utilizando o documento informado.
Fluxo de funcionamento:
O robô executa o objeto Suframa.
O valor informado no campo CNPJ ou CPF é utilizado para realizar a consulta.
O sistema acessa os dados disponíveis no cadastro da SUFRAMA.
As informações retornadas podem ser utilizadas em etapas posteriores do fluxo do robô.
Caso configurado, o robô pode utilizar acesso pessoal ao sistema CADSUF para realizar a consulta autenticada.
Quando usar
Quando for necessário consultar dados cadastrais na SUFRAMA.
Quando o robô precisar validar registros de empresas ou pessoas vinculadas à SUFRAMA.
Quando processos automatizados exigirem verificação de cadastro no sistema CADSUF.
Quando não usar
Não utilizar quando o processo não exigir consulta de dados no sistema da SUFRAMA.
Configuração
Título
Nome do objeto dentro do fluxo do robô.
Nome Identificador do Objeto
Identificador único do objeto dentro do robô.
CNPJ ou CPF
Documento utilizado para realizar a consulta no sistema da SUFRAMA.
Usar acesso pessoal para o SUFRAMA - CADSUF
Quando habilitado, utiliza acesso autenticado ao sistema CADSUF para realizar a consulta.
Exemplos
Exemplo simples
Fluxo básico para consultar dados na SUFRAMA:
Inserir o objeto Suframa no fluxo do robô.
Informar o CNPJ ou CPF no campo correspondente.
Executar o robô.
Após a execução, o robô obtém as informações disponíveis no cadastro da SUFRAMA.
Exemplo aplicado
Cenário: um robô precisa validar o cadastro de empresas que operam na Zona Franca de Manaus.
Fluxo:
O robô recebe o CNPJ de uma empresa.
O objeto Suframa realiza a consulta no sistema da SUFRAMA.
O robô verifica os dados retornados para validar o cadastro da empresa.
As informações podem ser utilizadas em relatórios ou validações internas.
Retornos
Erros comuns e como evitar
Documento inválido
Ocorre quando o valor informado no campo CNPJ ou CPF não corresponde a um documento válido.
Como evitar:
Garantir que o documento informado esteja corretamente formatado.
Dados não encontrados
Pode ocorrer quando não existem registros para o documento informado.
Como evitar:
Verificar se o CNPJ ou CPF informado está correto.
Boas práticas
Validar o CNPJ ou CPF antes de realizar a consulta.
Utilizar os dados retornados para validação de cadastro ou enriquecimento de informações.
Utilizar acesso autenticado quando necessário para consultas mais completas.
Manter nomes claros no campo Título para facilitar a manutenção do fluxo do robô.
Last updated
Was this helpful?