Entrada inválida

entrada_invalida

Um ou mais campos não passaram na validação.

O que aconteceu

A requisição tem campos faltando, com tipo errado ou fora do formato. O corpo do erro traz a lista em erros, com campo e mensagem para cada um.

Por que costuma acontecer

• Campo obrigatório ausente — Idempotency-Key também é obrigatória nos POST que criam ou mudam estado, e a ausência dela aparece aqui.
• O corpo não é JSON válido.
• Um campo excedeu o tamanho máximo, ou um enum recebeu valor fora da lista.

Como resolver

• Percorra o array erros e mostre cada mensagem no campo correspondente do seu formulário — o campo usa notação de caminho, como signatarios.0.documento.
• Ramifique sempre pelo codigo, nunca pelo texto: o texto pode mudar, o código não.

Corpo de um 422

{
  "codigo": "entrada_invalida",
  "status": 422,
  "erros": [
    { "campo": "signatarios.0.email", "mensagem": "Obrigatório quando o canal é e-mail." }
  ]
}

Relacionados

• cpf_invalido — CPF ou CNPJ inválido
• arquivo_nao_e_pdf — O arquivo não é um PDF

Ramifique sempre pelo campo codigo da resposta — ele é estável. Nunca pelo texto da mensagem nem por esta URL.