Documentação

Contratar a API

Processo comercial, modelo de cobrança pós-pago por relatório, credit line e lead time de ativação.

Quem pode usar

A API é destinada a organizações com necessidade de consulta programática de CNH em volume: frotas corporativas, despachantes integrados, plataformas de RH/people-ops, locadoras de veículos.

Processo de contratação

Solicitar acesso

Entre em contato com o time comercial em contato@doutormultas.com.br. Informe o volume estimado de consultas mensais e o caso de uso.

Aprovação e configuração

O time Minha CNH avalia a solicitação e, se aprovado, habilita o acesso pela interface de admin: define creditLineLimit, pricePerReport e limites de rate. Normalmente em até 2 dias úteis.

Notificação e acesso

Você recebe confirmação por e-mail. A secção API aparece nas configurações da sua organização, pronta para gerar chaves e configurar webhook.

Modelo de cobrança

O billing é pós-pago por relatório entregue.

ConceitoDescrição
pricePerReportValor deduzido do saldo por relatório entregue
creditBalanceSaldo atual da organização (pode ser negativo até o limite)
creditLineLimitValor mínimo permitido para o saldo (ex.: -500.00 = até R$500 a descoberto)
Período de faturamentoMensal; o time Minha CNH emite fatura externa e, após pagamento, credita o saldo

Estorno automático em falha

Relatórios que falham após todas as tentativas do pipeline geram um crédito de estorno (API_REPORT_REFUND) automaticamente, sem ação manual.

Restrições de acesso

  • Acesso habilitado por organização, não por usuário individual.
  • Uma organização sem API habilitada recebe 403 mesmo com chave válida.
  • Múltiplas chaves por organização são suportadas; cada chave pode ser revogada independentemente.

Próximo passo

Com acesso aprovado, veja como gerar sua primeira API key.