Skip to main content
Formato de erro O Lerian SLC retorna erros como problem details da RFC 9457, com o media type application/problem+json:
Definições de campo
  • type – Um URI que identifica o erro no catálogo de erros da Lerian, construído como https://errors.lerian.studio/v1/<code>.
  • title – O texto do status HTTP, por exemplo Conflict ou Unprocessable Entity. Vem do status, não do nome do erro.
  • status – O código de status HTTP, repetido da linha de status da resposta.
  • detail – Uma explicação específica dessa ocorrência. Uma resposta com status 500 ou acima carrega o texto fixo internal error, então decida com base em code em vez de analisar esse campo.
  • code – O identificador estável de máquina, no formato SLC-NNNN. Decida com base nesse campo.
  • errors – Uma lista de detalhes por campo, cada um com location, message e o value responsável pelo erro. Uma falha de validação de schema lista uma entrada por campo.

​
Erros de plataforma e requisição

Esses códigos podem chegar de qualquer endpoint. Cada um descreve a requisição, a credencial ou a disponibilidade do serviço, e não a operação de liquidação em si.

​
Erros de operação de liquidação

Esses códigos vêm do domínio de operações. Descrevem a instrução de liquidação que você enviou, a operação original que um cancelamento visa, ou a resposta que uma conciliação recebeu da contraparte.

​
Códigos de rejeição da Nuclea

A Nuclea, a câmara de compensação que opera o SLC, responde a um envio ou a um arquivo de retorno com seus próprios códigos de erro de negócio, no formato ESLCNNNN. O Lerian SLC os registra na operação e os devolve sem alteração. A resposta de detalhe da operação carrega eslcErrors, um array dos códigos registrados que fica vazio quando a operação não tem nenhum, e lastError, os códigos registrados unidos em uma única string. Cada valor de código chega literalmente da rede, então leia-o como vocabulário da Nuclea, não como um código da Lerian. A Nuclea define 85 desses códigos em seu manual de layout do SLC. A tabela abaixo cobre os que mudam o que você faz a seguir.
Quatro desses códigos chegam até você em uma recusa síncrona de envio de arquivo: ESLC0119, ESLC0123, ESLC0140 e ESLC0161. Eles chegam no evento operation.forward_rejected, em rejectionCode, em vez de no arquivo de retorno. Cada um é uma condição de registro ou credenciamento que se aplica a todos os arquivos que o participante envia, e uma alteração de registro na Nuclea resolve a condição. O arquivo em si não precisa de edição.
Os demais códigos O restante do catálogo descreve o registro enviado ou o registro do participante. As maiores famílias são:
  • Domínio e formato de campo – Um valor está fora do domínio que o layout permite, ou um segmento carrega o formato errado. Códigos de moeda, tipos de pessoa, instituidores de arranjo e códigos de ocorrência aparecem aqui.
  • Registro e credenciamento – Um CNPJ, um ISPB ou um relacionamento de participante difere do que a Nuclea mantém para o adquirente.
  • Números de controle duplicados – Um número de controle ou um nome de arquivo repete um que a Nuclea já registrou.
  • Datas e períodos de relatório – Uma data de pagamento, uma data de referência ou um intervalo de relatório está fora do que o tipo de produto permite.
  • Estado do registro e códigos de ocorrência – O código de ocorrência não é adequado ao estado atual do registro, como um registro liquidado ou um cancelado.
  • Períodos de devolução – O registro está dentro de um período de devolução, e a Nuclea nomeia o tipo de arquivo que carrega a correção.
  • Limites e volumes – Um valor de pagamento, uma contagem de arquivos ou uma contagem de registros está acima do máximo aceito.
Um código de qualquer uma dessas famílias chega até você no arquivo de retorno, por meio de eslcErrors na operação. Cite o código ao abrir o caso com a Nuclea, porque é o identificador que o suporte da Nuclea usa.