Erros

Respostas de erro seguem um formato consistente. Os code permanecem em inglês (estáveis para integração); as message estão em português.

{
  "error": {
    "code": "INVALID_NIF",
    "message": "O NIF do comerciante é inválido.",
    "request_id": "req_xxx"
  }
}

Códigos comuns

• UNAUTHORIZED — autenticação em falta
• INVALID_API_KEY — chave inválida ou revogada
• VALIDATION_ERROR — corpo do pedido inválido
• INVALID_NIF — NIF inválido
• IDEMPOTENCY_CONFLICT — mesma chave, payload diferente
• RATE_LIMITED — limite de pedidos excedido