Pessoa jurídica

O monitoramento de pessoa jurídica acompanha mudanças em fontes vinculadas a um CNPJ. Use esta funcionalidade para identificar alterações relevantes no perfil de uma empresa, como novos processos, mudanças em fontes empresariais, registros restritivos, indicadores financeiros ou outros módulos habilitados para a conta.

Criar monitoramento de CNPJ

Veja os parâmetros necessários para criar um monitoramento de pessoa jurídica pela API.

Quando usar

Use o monitoramento de pessoa jurídica quando sua operação precisa acompanhar mudanças recorrentes no perfil de uma empresa. Casos comuns:

identificar novos processos vinculados ao CNPJ;
acompanhar mudanças em fontes cadastrais ou restritivas;
acompanhar alterações em indicadores empresariais;
receber alertas quando houver novidade relevante;
reduzir consultas manuais recorrentes em bases selecionadas.

O monitoramento de CNPJ não acompanha movimentações internas de cada processo encontrado. Para acompanhar movimentações de um processo específico, use o monitoramento de processo por número CNJ.

Identificador principal

A chave principal é o CNPJ. Exemplo:

00.000.000/0001-00

A API aceita CNPJ com ou sem pontuação, mas o documento precisa ser válido e localizado para monitoramento.

Fluxo recomendado

Consulte a configuração

Liste fontes disponíveis, preços por checagem e frequências aceitas.

Valide o CNPJ

Confirme que o CNPJ é válido, localizado e pode ser monitorado.

Selecione fontes e frequências

Escolha quais fontes serão acompanhadas e defina uma frequência para cada uma.

Crie o monitoramento

Informe razão social ou nome interno, CNPJ, fontes selecionadas e e-mail de notificação.

Acompanhe eventos

Use o detalhe para consultar checagens, fontes, eventos e últimas alterações salvas.

Configuração

Antes de criar, consulte a configuração do monitoramento de pessoa jurídica. Ela retorna:

produto de monitoramento;
frequências disponíveis;
fontes habilitadas para a conta;
preço por checagem de cada fonte;
tipo operacional da fonte.

Configuração

Consulte fontes, preços e frequências disponíveis para monitoramento de CNPJ.

Fontes disponíveis

As fontes retornadas na configuração podem variar conforme plano, permissões e datasets habilitados. Cada fonte possui um id, usado como source_id na criação. Exemplo de fonte:

{
  "id": "company_processes",
  "source_type": "virtual_process_group",
  "name": "Processos",
  "price_per_check": 0.35,
  "active": true,
  "datasets_count": 4
}

Campo	Descrição
`id`	Identificador da fonte. Use em `sources[].source_id`.
`source_type`	Tipo da fonte, como `dataset` ou `virtual_process_group`.
`name`	Nome amigável da fonte.
`price_per_check`	Preço por checagem daquela fonte.
`active`	Indica se a fonte está disponível.
`datasets_count`	Total de datasets consolidados, quando aplicável.

Validação inicial

Antes da criação, valide se o CNPJ pode ser monitorado.

{
  "name": "EMPRESA EXEMPLO LTDA",
  "tax_id": "00000000000000"
}

Validar pessoa jurídica

Confirme se o CNPJ é aceito para monitoramento.

O monitoramento não deve ser criado quando o CNPJ for inválido, não localizado ou impedido por política interna.

Criação do monitoramento

Para criar o monitoramento, informe:

Campo	Descrição
`name`	Razão social ou nome interno do monitoramento.
`tax_id`	CNPJ monitorado, com ou sem pontuação.
`sources`	Fontes que serão monitoradas.
`notification_email`	E-mail que receberá alertas.

Cada fonte recebe sua própria frequência.

{
  "name": "EMPRESA EXEMPLO LTDA",
  "tax_id": "00000000000000",
  "sources": [
    {
      "source_id": "company_processes",
      "frequency_id": "daily"
    }
  ],
  "notification_email": "alertas@example.com"
}

Ao criar, a checagem inicial é enviada para execução em segundo plano.

Estrutura de `sources[]`

Campo	Descrição
`source_id`	ID da fonte retornada na configuração.
`frequency_id`	ID da frequência escolhida em `result.monitoring.frequencies[]`.

Uma mesma fonte não deve ser enviada mais de uma vez. Se precisar mudar frequência ou fontes, cancele o monitoramento atual e crie uma nova configuração conforme sua regra operacional.

Frequência por fonte

No monitoramento de pessoa jurídica, cada fonte pode ter sua própria frequência. Exemplo:

Fonte	Frequência
Processos	Diário
Protestos	Semanal
Dívida ativa	Semanal
Score de crédito	Mensal

Isso permite ajustar custo e frequência conforme a criticidade de cada fonte.

Processos vinculados ao CNPJ

Quando a fonte de processos estiver selecionada, a Lazy Data consulta bases processuais disponíveis para localizar processos vinculados ao CNPJ. Nesse caso, o monitoramento acompanha a existência de novos processos em relação ao snapshot salvo. Ele não acompanha movimentações internas dos processos encontrados.

Monitoramento de processo

Use o monitoramento processual para acompanhar movimentações de um processo específico por número CNJ.

Eventos

Um evento é registrado quando a Lazy Data identifica uma alteração relevante em uma fonte monitorada. Exemplos:

novo processo encontrado para o CNPJ;
mudança no resultado de uma fonte selecionada;
alteração em indicador empresarial;
novo registro ou alteração em fonte restritiva;
snapshot inicial registrado na primeira checagem.

Quando nada muda em uma checagem recorrente, não há evento de novidade para notificar.

Mudanças por fonte

No detalhe do monitoramento, eventos de pessoa jurídica podem retornar mudanças em changes. Cada mudança pode conter:

Campo	Descrição
`source_id`	Fonte onde a alteração foi detectada.
`source_name`	Nome amigável da fonte.
`type`	Tipo da mudança, como `initial` ou `update`.
`summary`	Resumo da alteração detectada.
`checked_at`	Data da checagem.
`details`	Detalhes relevantes extraídos da fonte.
`new_process_count`	Quantidade de novos processos, quando a fonte for processual.
`new_processes`	Lista resumida de novos processos, quando aplicável.

Notificações

As notificações são enviadas para o e-mail configurado em notification_email. Quando houver mais de uma novidade na mesma checagem, a Lazy Data pode agrupar as alterações em um único e-mail. Se nenhuma mudança for detectada, nenhuma notificação de novidade é enviada.

Cobrança

A cobrança ocorre por checagem executada em cada fonte monitorada. O custo mensal estimado depende de:

fontes selecionadas;
preço por checagem de cada fonte;
frequência de cada fonte;
descontos e regras comerciais aplicáveis;
cobrança condicionada ao retorno, quando configurada.

O retorno do monitoramento expõe:

Campo	Descrição
`price_per_check`	Preço de referência por checagem no monitoramento.
`checks_count`	Total de checagens executadas.
`events_count`	Total de eventos registrados.
`charged_total`	Valor total debitado.
`last_checked_at`	Data da última checagem.
`next_check_at`	Próxima checagem prevista.

Como cada fonte pode ter frequência própria, nem todas as fontes são verificadas em todas as execuções.

Saldo, plano e limites

Se não houver saldo, limite mensal ou permissão suficiente no momento da checagem, o monitoramento pode ser pausado automaticamente. Quando a condição for resolvida, monitoramentos recuperáveis podem ser retomados e ter a próxima checagem recalculada.

Status possíveis

Status	Descrição
`active`	Monitoramento ativo e elegível para próximas checagens.
`checking`	Checagem em execução.
`paused_insufficient_balance`	Pausado por saldo insuficiente.
`paused_monthly_limit`	Pausado por limite mensal atingido.
`paused_plan_restricted`	Pausado por restrição de plano, conta ou subconta.
`error`	Monitoramento com falha não recuperada.
`canceled`	Monitoramento cancelado e sem novas checagens.

Detalhes no painel

Ao abrir os detalhes do monitoramento, o painel pode exibir:

nome do monitoramento;
CNPJ monitorado;
razão social, quando disponível;
e-mail de notificação;
fontes monitoradas;
frequência de cada fonte;
preço e estatísticas por fonte;
próxima checagem;
checagens realizadas;
eventos registrados;
últimas mudanças detectadas.

Detalhar monitoramento

Consulte status, fontes, estatísticas e eventos registrados.

Cancelamento

Um monitoramento cancelado deixa de gerar novas checagens e novas notificações. O histórico salvo permanece disponível conforme as regras de retenção da conta.

Cancelar monitoramento

Encerre um monitoramento ativo quando ele não precisar mais ser acompanhado.

Boas práticas

Selecione apenas fontes relevantes para o objetivo do acompanhamento.
Use frequência diária apenas para empresas críticas.
Use frequências maiores para indicadores menos urgentes.
Valide o CNPJ antes de criar o monitoramento.
Mantenha o e-mail de notificação atualizado.
Monitore saldo e limite mensal para evitar pausas automáticas.
Trate 409 como monitoramento já existente e reutilize o id retornado.

Próximos passos

Configuração

Liste fontes, preços e frequências disponíveis.

Validar pessoa jurídica

Confirme se o CNPJ pode ser monitorado.

Criar monitoramento

Crie o acompanhamento recorrente do CNPJ.

Códigos de erro

Consulte erros de CNPJ, fontes, frequência, cobrança e provedor.

Primeiros passos

Utilidades

Funcionalidades

Webhook

Criar monitoramento de CNPJ

Quando usar

Identificador principal

Fluxo recomendado

Configuração

Configuração

Fontes disponíveis

Validação inicial

Validar pessoa jurídica

Criação do monitoramento

Estrutura de `sources[]`

Frequência por fonte

Processos vinculados ao CNPJ

Monitoramento de processo

Eventos

Mudanças por fonte

Notificações

Cobrança

Saldo, plano e limites

Status possíveis

Detalhes no painel

Detalhar monitoramento

Cancelamento

Cancelar monitoramento

Boas práticas

Próximos passos

Configuração

Validar pessoa jurídica

Criar monitoramento

Códigos de erro

Criar monitoramento de CNPJ

​Quando usar

​Identificador principal

​Fluxo recomendado

​Configuração

Configuração

​Fontes disponíveis

​Validação inicial

Validar pessoa jurídica

​Criação do monitoramento

​Estrutura de sources[]

​Frequência por fonte

​Processos vinculados ao CNPJ

Monitoramento de processo

​Eventos

​Mudanças por fonte

​Notificações

​Cobrança

​Saldo, plano e limites

​Status possíveis

​Detalhes no painel

Detalhar monitoramento

​Cancelamento

Cancelar monitoramento

​Boas práticas

​Próximos passos

Configuração

Validar pessoa jurídica

Criar monitoramento

Códigos de erro

Quando usar

Identificador principal

Fluxo recomendado

Configuração

Fontes disponíveis

Validação inicial

Criação do monitoramento

Estrutura de `sources[]`

Frequência por fonte

Processos vinculados ao CNPJ

Eventos

Mudanças por fonte

Notificações

Cobrança

Saldo, plano e limites

Status possíveis

Detalhes no painel

Cancelamento

Boas práticas

Próximos passos