Criar novo dossiê

post

https://g8y4cp2a08.execute-api.us-west-2.amazonaws.com/dev/v3/dossies

Cria um novo dossiê de consulta assíncrona sobre um CPF ou CNPJ.

O dossiê agregará os relatórios solicitados. Atualmente estão disponíveis os relatórios CAR (Cadastro Ambiental Rural) e INCRA (Sistema Nacional de Cadastro Rural).

Busca de Propriedades no CAR

Para o relatório CAR, você pode controlar onde buscar o CPF/CNPJ usando o parâmetro tipo_busca:

tipo_busca: 2 (padrão) - Busca apenas onde a pessoa é proprietária/titular
tipo_busca: 1 - Busca apenas onde a pessoa é cadastrante (quem registrou no CAR)
tipo_busca: 0 - Busca em ambos (proprietário OU cadastrante)

Recomendação: Use tipo_busca: 2 (padrão) para verificar propriedades de fato pertencentes à pessoa. O cadastrante pode ser um terceiro (despachante, contador, etc).

Webhook (RECOMENDADO)

Forneça webhook_url para receber notificação automática quando o dossiê estiver pronto. Isso elimina a necessidade de fazer polling (consultas repetidas) para verificar o status.

Quando o dossiê estiver completo, faremos um POST para o seu webhook_url com:

{
  "dossie_id": "uuid",
  "status": "COMPLETE",
  "cpf_cnpj": "12345678900",
  "car_count": 3
}

Vantagens do webhook:

Notificação instantânea quando pronto
Economia de requests (melhor para você e para nós)
Implementação mais simples (sem loops de polling)