Lista de erros do SISBAJUD

Formato do erro A Lerian SISBAJUD Mensageria e o Lerian SISBAJUD executor usam os mesmos códigos de erro, de SBJ-0001 a SBJ-0014, com os mesmos status HTTP. Uma recusa de licença responde 403 com um código LCS-. Um erro de operação usa problem details RFC 9457, com o media type application/problem+json:

{
  "type": "https://errors.lerian.studio/v1/SBJ-0001",
  "title": "Bad Request",
  "status": 400,
  "detail": "institutionId path parameter must be a valid non-nil UUID.",
  "code": "SBJ-0001"
}

Definições de campos

code – Um identificador estável para o erro, na forma SBJ-NNNN. Baseie sua lógica neste valor.
type – Uma URI que identifica o erro no catálogo de erros da Lerian. Construída como https://errors.lerian.studio/v1/<code>.
title – O texto do status HTTP (por exemplo, Bad Request).
status – O código de status HTTP.
detail – Orientação para esta ocorrência do erro. Para respostas 5xx, o detail traz o texto estático internal error, então use code para basear sua lógica.
errors – Lista opcional de detalhes de validação por campo, cada um com um message e um location.

Algumas recusas acontecem antes de a requisição chegar a uma operação, por exemplo um método não suportado ou um limite de taxa. Elas respondem com o mesmo code e title em um corpo JSON simples. A API de execução, que o executor chama na Mensageria, é diferente: as suas respostas 409 e 422 usam um corpo de problema sem código SBJ-.

Erros do cliente

`code`	Descrição	Status
SBJ-0001	A requisição tem sintaxe malformada. Verifique os identificadores do path, o formato do timestamp e os comprimentos dos campos.	400
SBJ-0003	Falha na autenticação. Envie um bearer token válido.	401
SBJ-0004	A identidade do chamador não tem permissão para este recurso.	403
SBJ-0005	O recurso não existe. Verifique o identificador no path.	404
SBJ-0007	A requisição conflita com o estado atual do recurso, como uma criação duplicada ou uma requisição que já alcançou um estado terminal.	409
SBJ-0012	Uma operação de chave não pode seguir, e a mesma requisição falha de novo. Nada mudou.	409
SBJ-0010	O payload da requisição, ou o conteúdo do arquivo que a requisição solicitou, está acima do tamanho aceito.	413
SBJ-0006	A sintaxe está correta, mas o serviço não consegue processar a requisição. Um valor está fora do conjunto aceito, ou o recurso está no estado errado para a operação.	422
SBJ-0009	O chamador enviou requisições demais na janela atual. Aguarde o número de segundos do header `Retry-After` e envie a requisição novamente.	429
SBJ-0011	Um erro de cliente fora dos códigos acima, como um método HTTP não suportado. A resposta mantém o seu status original, então leia o status HTTP da resposta.	Outro `4xx`

Erros do servidor

`code`	Descrição	Status
SBJ-0002	O serviço falhou inesperadamente. Um erro de servidor sem outro código também responde `SBJ-0002`. Envie a requisição novamente, e entre em contato com o suporte se a falha continuar. Para uma rotação de chave, leia Credenciais e rotação de chaves antes de enviá-la novamente.	500
SBJ-0008	Uma dependência que este endpoint precisa está indisponível. Entre em contato com sua equipe de plataforma se a falha continuar.	503
SBJ-0013	O resultado de uma rotação de chave não é conhecido. Não envie a rotação novamente.	500
SBJ-0014	A chave foi rotacionada, mas uma etapa posterior da rotação falhou. Não envie a rotação novamente. Entre em contato com o suporte.	500

SISBAJUD Mensageria · Instituições

SISBAJUD Mensageria · Ordens e arquivos

SISBAJUD Mensageria · Monitoramento

SISBAJUD Mensageria · Arquivos de retorno

SISBAJUD Mensageria · Solicitações LGPD

SISBAJUD Mensageria · Segurança

SISBAJUD Mensageria · Conformidade

SISBAJUD Mensageria · Dead letter do Lerian STA

SISBAJUD executor · Instituições e conector Midaz

SISBAJUD executor · Ordens que precisam de atenção

SISBAJUD executor · Roteamento de ledger

SISBAJUD executor · Segurança

SISBAJUD executor · Auditoria

Tratamento de erros

Lista de erros do SISBAJUD

Erros do cliente

Erros do servidor

​Erros do cliente

​Erros do servidor

Erros do cliente

Erros do servidor