Documentação da API LeadCNPJ

Endpoints · Sistema

Atualiza empresa privada da integração

Atualiza apenas campos enviados. CNPJ não pode ser alterado; null limpa campo opcional. Não modifica dados públicos nem os campos já copiados em contatos.

Parâmetros

Nome	Em	Obrigatório	Descrição
cnpj	path	sim	CNPJ numérico sem pontuação.
Idempotency-Key	header	sim	Reutilize ao repetir o mesmo pedido. Outro corpo com a mesma chave: 409.

Body da requisição

Campo	Tipo	Descrição
razao_social	string
nome_fantasia	string
email	string
telefone	string
site	string
cidade	string
uf	string

Exemplo:

{
    "nome_fantasia": "Novo nome"
}

Respostas

Status	Descrição
200	Registro consultado ou atualizado.
401	Chave inválida.
403	Escopo, permissão ou limite do CRM não permite a operação.
404	Recurso inexistente ou fora da visão.
409	Cadastro duplicado ou conflito de idempotência/identificador externo.
422	Campos inválidos, desconhecidos ou supressão de dados.
429	Limite de chamadas.
503	Migração ou verificação indisponível.

Exemplo curl

curl -X PATCH https://leadcnpj.com.br/api/v1/sistema/crm/empresas/11222333000181 \
  -H "Authorization: Bearer leadcnpj_system_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"nome_fantasia":"Novo nome"}'

Exemplo de resultado (200)

Dados fictícios. Campos sem informação podem ser null.

{
    "data": {
        "id": 42,
        "cnpj": "11222333000181",
        "razao_social": "Empresa Exemplo Ltda",
        "nome_fantasia": "Novo nome",
        "email": "comercial@example.com",
        "telefone": "1133334444",
        "site": "https://example.com",
        "cidade": "São Paulo",
        "uf": "SP",
        "criado_em": "2026-10-16 09:00:00",
        "atualizado_em": "2026-10-16 09:00:00"
    },
    "meta": {
        "creditos_consumidos": 0,
        "consultado_em": "2026-10-16T09:00:00-03:00",
        "timezone": "America/Sao_Paulo"
    }
}