> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualización del contrato de API del gateway de Consignado

> Tres operaciones nuevas de Consignado, un portal de formalización opcional, una reversión de refinanciamiento más acotada y el prefijo CLT en los códigos de error.

<Badge stroke icon="calendar-days" iconType="regular">2 de septiembre de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de la referencia de API</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Acción requerida</Badge>

## Afecta a

***

Equipos que se integran con la API de Lerian Consignado — Dataprev, y equipos que operan su despliegue.

## Qué cambió

***

**Tres operaciones son nuevas.** Registrar una corrección a un contrato registrado y descargar el recurso corregido que la corrección nombra: esto repara una CCB equivocada o una confirmación de desembolso con evidencia equivocada, y no cruza ninguna frontera gubernamental. Excluir un contrato de tu institución porque el trabajador lo portó hacia afuera, la contraparte del lado de origen de la averbação de portabilidad que ya tenías.

**La reversión de refinanciamiento es más acotada y su cuerpo de solicitud cambió.** El campo opcional `dataRefinanciamento` ya no existe. La ventana de 7 días hábiles ahora se evalúa contra el registro propio del gateway sobre cuándo se confirmó el refinanciamiento, nunca contra una fecha en la solicitud. Solo un refinanciamiento que este gateway registró se puede revertir a través de él; cualquier otro se rechaza con `404` antes de llamar a Dataprev.

**El portal de formalización es opcional.** Un tenant con una URL base de portal del trabajador registrada sigue recibiéndola inyectada como el contacto de tipo 0 de cada propuesta de oferta. Un tenant sin ella ahora presenta la oferta de todas formas, llevando solo los contactos propios del cliente, y la oferta se rechaza solo cuando no hay ni un portal registrado ni un solo contacto. Una oferta también puede llevar su propio `portalBaseUrl` para anular el portal registrado del tenant en ese envío únicamente. Los contactos de tipo 0 proporcionados por el cliente siguen prohibidos en todos los casos.

**Los códigos de error ahora usan el prefijo `CLT-`.** Los números no cambian: lo que era `MYS-0006` es `CLT-0006`.

**Correcciones a la guía de operaciones publicada.** El gateway ejecuta once bucles programados, no ocho: los tres que faltaban son el poller de descubrimiento de portabilidad y los dos bucles de recuperación de resultados, ambos deshabilitados de forma predeterminada. El stream de comandos de Lender lleva tres claves, no dos, y las claves usan un guion bajo en el segmento de recurso (`consignado_margin.requested`). Los 25 hechos de negocio tienen un sitio de emisión en producción; la afirmación anterior de que dos resultados de portabilidad dependían de una declaración en el manifiesto era incorrecta. `AWS_REGION` no tiene valor predeterminado, de forma deliberada, para que el AWS SDK pueda resolver tu propia región.

## Impacto

***

**Clasificación: Acción requerida.**

## Qué debes hacer

***

<Steps>
  <Step>Elimina `dataRefinanciamento` de las solicitudes de reversión de refinanciamiento, y confirma que cada refinanciamiento que pretendes revertir se registró a través de este gateway.</Step>
  <Step>Actualiza cualquier manejo de errores que coincida con el prefijo `MYS-` para que coincida con `CLT-` en su lugar.</Step>
  <Step>Si tu tenant no tiene una URL base de portal registrada, confirma que cada propuesta de oferta lleva al menos un contacto de tipo 1 a 4.</Step>
  <Step>Habilita los bucles de recuperación de averbação y de comandos de riel en cualquier despliegue que envía comandos de riel, y configura `AWS_REGION` de forma explícita para la región en la que tus datos deben permanecer.</Step>
</Steps>

### Plazo

Antes de tu próximo despliegue de integración de Consignado.