Corretor On API

Todas as requisições exigem o header:

x-api-key: <sua-chave>

Requisições sem chave ou com chave inválida retornam 401 Unauthorized.

Processa uma tabela comercial em PDF vinculada a um empreendimento. A API verifica automaticamente o estado do empreendimento, estrutura os dados necessários e sincroniza preços e fluxos de pagamento em uma única chamada.

Campo	Tipo	Obrigatório	Descrição
empreendimento_id	number	Sim	ID do empreendimento cadastrado no Corretor On.
url_tabela	string	Sim	URL pública e acessível do arquivo PDF da tabela comercial.

Exemplo

curl -X POST "https://api-llm-tabelas.corretoron.com.br/api/extrair-precos"   -H "Content-Type: application/json"   -H "x-api-key: <sua-chave>"   -d '{
    "empreendimento_id": 177,
    "url_tabela": "https://exemplo.com/tabela.pdf"
  }'

Quando o processamento é concluído, a API retorna o status da execução, as métricas de unidades e as contagens explícitas de preços persistidos.

{
  "status": "sucesso",
  "empreendimento_id": 177,
  "unidades_processadas": 24,
  "unidades_inseridas": 0,
  "unidades_atualizadas": 0,
  "tempo_processamento_segundos": 42.8,
  "timestamp": "2026-05-29T19:30:00",
  "precos_processados": 24,
  "precos_salvos": 24,
  "precos_inseridos": 24,
  "precos_atualizados": 0,
  "precos_atuais_salvos": 24,
  "precos_sem_correspondencia": 0,
  "precos_bloqueados_baixa_confianca": 0,
  "fluxos_salvos": 24,
  "fluxos_nao_encontrados": 0,
  "resumo": null,
  "validacao_detalhes": null,
  "mensagem_erro": null
}

Campo	Tipo	Descrição
status	string	Indica se a extração foi concluída com sucesso.
empreendimento_id	number	ID do empreendimento informado na requisição.
unidades_processadas	number	Total de unidades identificadas ou já existentes para o empreendimento.
unidades_inseridas	number	Total de unidades novas criadas durante a execução, quando aplicável.
unidades_atualizadas	number	Total de unidades atualizadas durante a execução, quando aplicável.
precos_processados	number	Total de registros de preço reconhecidos na tabela antes da expansão para unidades.
precos_salvos	number	Total de registros de preço efetivamente persistidos ou atualizados no histórico.
precos_inseridos	number	Total de novos registros criados em property_price_history.
precos_atualizados	number	Total de registros existentes atualizados em property_price_history.
precos_atuais_salvos	number	Total de preços atuais salvos ou atualizados em property_unit_prices.
precos_sem_correspondencia	number	Total de preços extraídos que não encontraram unidade correspondente.
precos_bloqueados_baixa_confianca	number	Total de preços bloqueados pela política de segurança antes da persistência.
fluxos_salvos	number	Total de fluxos de pagamento associados aos preços salvos.
mensagem_erro	string | null	Detalhe funcional quando a extração não puder ser concluída.

Status	Quando ocorre
401	Chave de API ausente ou inválida.
422	PDF inacessível, URL inválida, payload fora do formato esperado ou nenhuma informação funcional salva.
500	Erro inesperado durante o processamento da tabela.