Este fluxo é uma interpretação sugerida dos manuais do Dataprev para o Crédito do Trabalhador. Os manuais prevalecem sobre esta página. Sua instituição valida o fluxo e o implementa sobre as APIs da Lerian. Veja como ler os diagramas.
Participantes
- Sua instituição. A instituição financeira que detém os empréstimos e concede o novo.
- Lerian. Lerian Consignado. Troca as requisições com o Dataprev e expõe a API que sua instituição usa.
- Dataprev. Opera o sistema do Crédito do Trabalhador: os leilões de empréstimo e o registro dos empréstimos consignados.
Diagrama
Passo a passo
Cada contrato a quitar deve ser um contrato que a Lerian mantém para sua instituição: registrado pela Lerian, ou importado com
POST /v1/consignado/contracts/{numero_contrato}/import. Qualquer outro contrato responde 404, e a Lerian não chama o Dataprev. O mesmo vale para um contrato que a leitura de acompanhamento da Lerian mostra no Dataprev como excluído, encerrado ou fechado por renegociação. Com garantia do FGTS, um refinanciamento quita um contrato. Quando temGarantias é false, deixe de fora os três valores de garantia do FGTS e nunca envie 0. A Lerian os recusa com 422 antes de chamar o Dataprev.
Adicione o bloco opcional booking para contabilizar o novo contrato no Lender. A Lerian nunca o envia ao Dataprev. O bloco tem loan_product_version, expected_disbursement_date, formalization_deadline e margin_snapshot, e um origination_fee_amount opcional. Envie todos os membros e deixe origination_fee_amount de fora quando não houver tarifa. Com o bloco, competenciaInicioDesconto é obrigatório. O resultado de valorEmprestimo menos valorIOF e menos a tarifa deve ser igual a valorPago mais valorTroco, ou a requisição responde 422 DECLARED_TERMS_INCONSISTENT. A Lerian responde 422 com os códigos de contabilização da averbação a qualquer outra contabilização que o Lender recusaria. Sem o bloco, o novo contrato existe apenas no Dataprev, e o Lender não contabiliza nada.
A Lerian informa ao Dataprev o saldo devedor do novo contrato. Para cada contrato quitado, ela envia um saldo final de 0,00.
Você pode reverter apenas um refinanciamento que a Lerian registrou.
A Lerian publica três fatos para um refinanciamento que passa por ela. consignado.refinanciamento.efetivado leva o novo contrato, os contratos quitados e as condições aceitas. Com booking, ele leva também novo_contrato, no formato de consignado.contract.registered. consignado.refinanciamento.revertido diz que uma reversão excluiu o novo contrato, inclusive uma feita no portal do Dataprev que a leitura de acompanhamento da Lerian encontra. consignado.refinanciamento.recusado diz que o refinanciamento foi recusado ou não executou nada, e nomeia os contratos que continuam ativos. Um refinanciamento feito fora da Lerian não publica nada.
Com booking, a Lerian publica novo_contrato apenas com condições que o Dataprev confirmou. Se o Dataprev confirma outra competenciaInicioDesconto, a requisição responde 503 OUTCOME_UNKNOWN e a Lerian estaciona o comando. A recuperação publica efetivado apenas quando a leitura do novo contrato mostra as condições contabilizadas.
Se a resposta não resolver o comando, a Lerian o estaciona em outcome_unknown e responde 503 OUTCOME_UNKNOWN. Não envie o comando de novo sob uma nova chave. A mesma chave encontra RAIL_COMMAND_OUTCOME_UNRESOLVED, que significa que a Lerian ainda não conhece o resultado. Leia o comando com GET /v1/consignado/rail-commands.
Se a recuperação não conseguir decidir, o back office da sua instituição fecha o comando estacionado com POST /v1/consignado/rail-commands/{id}/close. Envie outcome (accepted ou refused) e portal_evidence, que informa o que o portal do Dataprev mostra. A chamada responde 204. Um fechamento como accepted faz a Lerian ler o novo contrato no Dataprev uma vez. Um fechamento como refused não lê nada, libera o número do novo contrato e publica consignado.refinanciamento.recusado com reason_code GW-BANCO-RECUSADO. Um comando estacionado há menos de 5 minutos responde 409 RAIL_COMMAND_NOT_CLOSEABLE.
Quando nada rodou no Dataprev, a Lerian fecha o comando como recusado. Um 503 DATAPREV_UNAVAILABLE cujo detalhe diz isso significa que a chamada nunca saiu da Lerian, ou que o Dataprev respondeu apenas OZ, o código da virada de competência. Um 422 com os códigos do Dataprev em upstream significa que os códigos provam que nada rodou. Envie uma requisição corrigida sob uma nova chave. O código RAIL_COMMAND_ALREADY_REFUSED significa que o comando sob a chave antiga foi fechado como recusado, pelo Dataprev ou antes de chegar a ele.
Como saber que terminou
A linha 4 devolve o número do novo contrato e os contratos quitados, e a Lerian publica
consignado.refinanciamento.efetivado.