Erros

Os erros da API usam um único envelope JSON. Guarde o identificador de correlação ao entrar em contato com o suporte da Morus.

{
  "code": "VAL-1005",
  "message": "Erro de validação",
  "timestamp": "2026-09-15T15:30:00Z",
  "correlationId": "01K56Y9K4QPH9D8FJY5E3QJ2N7",
  "details": ["tenant.name: não deve estar em branco"]
}

Status	Significado	Tratamento recomendado
400	Sintaxe ou dados inválidos	Corrija a requisição antes de repetir
401	Token ausente, inválido ou expirado	Renove o token uma vez e repita
403	A credencial não tem acesso	Revise as permissões da credencial
404	O recurso não existe na empresa da credencial	Não presuma que outra empresa é proprietária do recurso
409	Conflito de estado ou idempotência	Analise o erro e o estado atual do recurso
412	ETag desatualizado	Consulte, concilie e repita com o novo ETag
428	O header If-Match obrigatório está ausente	Consulte o recurso e envie seu ETag
429	Limite de requisições excedido	Repita com espera exponencial limitada e variação aleatória
5xx	Falha temporária do servidor	Quando aplicável, repita com a mesma chave de idempotência

Defina um limite de tempo para todas as chamadas. Limite as repetições automáticas e adicione uma variação aleatória para evitar que vários processos repitam no mesmo instante.