# Enriquecer empresa (individual)

Enriquece perfil de empresa individualmente com processamento assíncrono.

Custo: 1 crédito por registro enriquecido

Dados retornados:
- Cadastro: razão social, nome fantasia, data de fundação, CNAEs
- Localização: endereço completo, cidade, estado, CEP, geolocalização
- Contatos: telefones, emails, website oficial
- Informações: setor, descrição, número de funcionários, links públicos
- Estrutura corporativa: sócios, administradores, percentuais de participação
- Histórico: ex-sócios e ex-funcionários
- Filiais e equipe atual

Endpoint: POST /b2b/companies/enrich
Version: 1.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `contato` (object)

  - `contato.url_linkedin` (string)
    URL do perfil LinkedIn da empresa
    Example: "https://www.linkedin.com/company/exemplo"

  - `contato.cnpj` (string)
    CNPJ da empresa (apenas números)
    Example: "12345678000199"

  - `contato.empresa_id` (integer)
    ID da empresa (do endpoint de prospecção)
    Example: 98765

  - `url_webhook` (string)
    URL para notificação de conclusão
    Example: "https://seusite.com/webhook"

## Response 200 fields (application/json):

  - `id_processamento` (string)
    ID único do processamento
    Example: "00000000000000000000000000000000"

  - `status` (string)
    Enum: "completed", "processing", "failed"

  - `total` (integer)
    Total de contatos processados
    Example: 1

  - `sucesso` (integer)
    Quantidade de enriquecimentos bem-sucedidos
    Example: 1

  - `falhou` (integer)
    Quantidade de enriquecimentos que falharam

  - `contatos` (array)

  - `contatos.tipo_entrada` (string)
    Example: "linkedin_url"

  - `contatos.valor_entrada` (string)
    Example: "https://www.linkedin.com/company/exemplo-inc/"

  - `contatos.detalhes_contato` (object)

  - `contatos.detalhes_contato.sobre` (object)

  - `contatos.detalhes_contato.cadastro` (object)

  - `contatos.detalhes_contato.localizacao` (object)

  - `contatos.detalhes_contato.socios` (object)

  - `contatos.detalhes_contato.diretores` (object)

  - `contatos.detalhes_contato.gerentes` (object)

  - `contatos.detalhes_contato.funcionarios` (object)

  - `contatos.detalhes_contato.ex_funcionarios` (object)

  - `contatos.detalhes_contato.socios_antigos` (object)

  - `contatos.detalhes_contato.filiais` (object)

  - `contatos.detalhes_contato.representantes_legais` (object)

  - `contatos.detalhes_contato.participacoes_empresariais` (object)

  - `timestamp` (number)
    Example: 1760632949

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)
    Example: "no credits"

  - `error.description` (string)
    Example: "Você não possui saldo suficiente, disponível 0"

## Response 403 fields (application/json):

  - `error` (string)
    Example: "Invalid token"