Pular para o conteúdo principal
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.
  • correlationId – O identificador de correlação com escopo de requisição, o mesmo valor do header X-Request-Id da resposta. Cite esse valor em uma solicitação de suporte.
  • 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 Núclea

A Núclea, 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. Ela também carrega lastError, os códigos registrados unidos em uma única string, ou null quando não há nenhum. eslcErrors também pode carregar o código de ocorrência que uma IF Domicílio retorna. Cada valor chega literalmente da rede, então leia-o como vocabulário da contraparte, não como um código da Lerian. A Núclea define 85 desses códigos. A tabela abaixo cobre os que mudam o que você faz a seguir.
A Núclea pode recusar um envio de arquivo de forma síncrona com um de quatro códigos: ESLC0119, ESLC0123, ESLC0140 e ESLC0161. A tabela acima informa a correção de cada código. Operações do SLC descreve o orçamento de tentativas de transmissã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 Núclea mantém para o adquirente.
  • Números de controle duplicados – Um número de controle ou um nome de arquivo repete um que a Núclea 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 Núclea 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.
A Núclea envia um código dessas famílias em uma linha de um arquivo de retorno ou no veredito dela sobre um envio. O Lerian SLC o registra em eslcErrors na operação. Cite o código ao abrir o caso com a Núclea, porque é o identificador que o suporte da Núclea usa.