> For the complete documentation index, see [llms.txt](https://docs.mensajerodigital.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mensajerodigital.app/pagares/obligaciones.md).

# Obligaciones

Los créditos que los pagarés respaldan: consúltelos, impórtelos desde el core con un CSV, cambie su estado cuando se desembolsan, entran en mora o se pagan, y revise su historial.

La pestaña **Obligaciones** reúne los **créditos** de la entidad que los pagarés respaldan: los que nacieron de una solicitud en un formulario, los importados del sistema de cartera (core) y los creados a mano.

{% hint style="info" %}
La cartera real vive en el core de su entidad. Aquí está lo necesario para saber **qué garantiza cada pagaré**, por eso lo normal es sincronizarla importando un archivo.
{% endhint %}

## Cómo acceder

1. Ingrese al módulo **Pagarés**.
2. Abra la pestaña **Obligaciones**.

<figure><img src="https://2099257791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LT3uJQOuTNAS8sLraYy%2Fuploads%2FsoCRksSZIa6QU6Gbt281%2FCaptura%20de%20pantalla%202026-09-15%20a%20la(s)%203.07.24%E2%80%AFp.m..png?alt=media&amp;token=be040dd6-a5da-4a90-a355-a7282a8091ed" alt=""><figcaption></figcaption></figure>

## Qué muestra cada obligación

| Columna            | Qué verá                                                                                                 |
| ------------------ | -------------------------------------------------------------------------------------------------------- |
| **Obligación**     | El número y, si vino de un archivo, *sincronizada (csv)*.                                                |
| **Titular**        | Nombre e identificación.                                                                                 |
| **Saldo capital**  | El saldo actual.                                                                                         |
| **Mora**           | Días de mora, en rojo si tiene.                                                                          |
| **Estado**         | El estado del crédito. Pase el cursor para ver quién lo decidió y el motivo.                             |
| **Respaldada por** | El pagaré que la respalda y por cuánto. Si necesita uno y no lo tiene, la etiqueta ámbar **Sin pagaré**. |
| **Acciones**       | Botones de ícono: **Cambiar estado**, **Crear pagaré** (solo si le falta) e **Historial de estados**.    |

Puede filtrar por texto (número, titular o identificación) y por **Estado**.

## Crear una obligación a mano

Haga clic en **Nueva obligación** y complete el **Número de la obligación**, la **Identificación** y el **Nombre del titular**, el **Valor desembolsado** (el saldo de capital arranca en ese mismo valor), el **Estado** y, si quiere, la **Fecha de vencimiento**. Luego haga clic en **Crear obligación**.

{% hint style="info" %}
El alta manual es la excepción. Si el crédito existe en el core, es mejor importarlo: así se mantiene sincronizado.
{% endhint %}

## Importar obligaciones desde un archivo CSV

{% stepper %}
{% step %}

### Descargue la plantilla

Haga clic en **Qué columnas lleva**. Verá la lista de columnas con su descripción, un ejemplo y si se actualiza al reimportar. Haga clic en **Descargar plantilla** para obtener un archivo listo para llenar.

<figure><img src="https://2099257791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LT3uJQOuTNAS8sLraYy%2Fuploads%2FNi1kzsS6yS1zkjPTNqk1%2FCaptura%20de%20pantalla%202026-09-15%20a%20la(s)%203.17.03%E2%80%AFp.m..png?alt=media&amp;token=90f26f83-7df3-40fc-ad17-153783e1df7e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Llene el archivo

Reemplace la fila de ejemplo por sus datos, una obligación por fila.
{% endstep %}

{% step %}

### Impórtelo

Haga clic en **Importar CSV**, seleccione el archivo y confirme. Al terminar verá cuántas obligaciones se crearon y cuántas se actualizaron, y la lista de las filas que no entraron con su motivo.
{% endstep %}
{% endstepper %}

### Columnas del archivo

| Columna                     | Obligatoria | Qué lleva                                                                              | Al reimportar |
| --------------------------- | ----------- | -------------------------------------------------------------------------------------- | ------------- |
| **id\_externo**             | No          | Identificador del crédito en el core. Con él, reimportar actualiza en vez de duplicar. | —             |
| **numero\_obligacion**      | Sí          | Número con que la entidad conoce el crédito.                                           | —             |
| **titular\_identificacion** | Sí          | Cédula o NIT, sin puntos. Debe ser la del otorgante del pagaré que lo respalde.        | Se actualiza  |
| **titular\_nombre**         | No          | Nombre del titular.                                                                    | Se actualiza  |
| **valor\_desembolsado**     | No          | Monto desembolsado.                                                                    | Solo al crear |
| **saldo\_capital**          | No          | Saldo de capital a hoy. Si falta al crear, toma el valor desembolsado.                 | Se actualiza  |
| **saldo\_intereses**        | No          | Intereses causados sin pagar.                                                          | Se actualiza  |
| **tasa\_interes**           | No          | Tasa pactada, en porcentaje.                                                           | Solo al crear |
| **plazo\_meses**            | No          | Plazo en meses.                                                                        | Solo al crear |
| **fecha\_desembolso**       | No          | DD/MM/AAAA o AAAA-MM-DD.                                                               | Solo al crear |
| **fecha\_vencimiento**      | No          | DD/MM/AAAA o AAAA-MM-DD.                                                               | Se actualiza  |
| **dias\_mora**              | No          | Días de mora a hoy.                                                                    | Se actualiza  |
| **estado\_obligacion**      | No          | VIGENTE, EN\_MORA, CANCELADA o CASTIGADA. Si falta, entra como VIGENTE.                | Se actualiza  |

### Ejemplo

```csv
id_externo;numero_obligacion;titular_identificacion;titular_nombre;valor_desembolsado;saldo_capital;estado_obligacion
100045;CR-2026-0045;8127266;Ana María Gómez;12.500.000;9.800.000;VIGENTE
100046;CR-2026-0046;1020304050;Carlos Gómez;5.000.000;0;CANCELADA
```

{% hint style="success" %}

* **Reimportar no duplica.** La fila se reconoce por `id_externo` o, si no viene, por `numero_obligacion`.
* Se acepta separador **punto y coma** o **coma**. Los montos pueden llevar puntos de miles (12.500.000) y los decimales, coma (1,8).
* Si edita en Excel, guárdelo como **CSV UTF-8** para no perder las tildes.
  {% endhint %}

{% hint style="warning" %}
**El archivo manda.** Si una obligación cambió de estado a mano y luego llega un archivo con otro estado, gana el archivo, porque el core es la fuente de verdad de la cartera. El cambio queda registrado en el historial como *Importación de cartera*.
{% endhint %}

## Cambiar el estado de una obligación

No siempre la cartera llega por archivo. Cuando un crédito se desembolsa, entra en mora o se paga, puede cambiar su estado desde aquí. Necesita el permiso **Vincular obligaciones a pagarés**.

1. En la fila de la obligación, haga clic en el ícono **Cambiar estado**. <img src="https://2099257791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LT3uJQOuTNAS8sLraYy%2Fuploads%2F1AG0hQyjQDyFUgTh7Yc0%2FCaptura%20de%20pantalla%202026-09-15%20a%20la(s)%203.18.54%E2%80%AFp.m..png?alt=media&amp;token=0af6b2f4-6f6b-467c-8c81-f875585597ac" alt="" data-size="line">
2. Escoja el **Nuevo estado**. Debajo verá qué va a pasar antes de confirmar.
3. Escriba el **Motivo**, por ejemplo *pagó la última cuota el 10 de septiembre*.
4. Haga clic en **Cambiar estado**.

<figure><img src="https://2099257791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LT3uJQOuTNAS8sLraYy%2Fuploads%2FkUGRAqFsVnTyy9jj68Aq%2FCaptura%20de%20pantalla%202026-09-15%20a%20la(s)%203.18.00%E2%80%AFp.m..png?alt=media&amp;token=f42f1781-d321-40f6-abc5-09fb4a8e9088" alt=""><figcaption></figcaption></figure>

### Cambios permitidos

| Estado actual | Puede pasar a                   | Cuándo                                          |
| ------------- | ------------------------------- | ----------------------------------------------- |
| Aprobada      | Vigente                         | Se desembolsó el crédito.                       |
| Vigente       | En mora · Cancelada             | El titular se atrasó · pagó todo.               |
| En mora       | Vigente · Cancelada · Castigada | Se puso al día · pagó todo · se da por pérdida. |
| Castigada     | Cancelada                       | Se recuperó después de castigarla.              |
| Cancelada     | Vigente                         | Para deshacer una cancelación por error.        |

{% hint style="info" %}
Las solicitudes que todavía no se han decidido **no se aprueban ni se rechazan desde aquí**, sino desde la pestaña [Solicitudes](/pagares/solicitudes-de-credito.md), que además cierra el radicado.
{% endhint %}

### Qué arrastra cada cambio

* **Cancelada**: el saldo de capital, los intereses y la mora quedan en cero. Si la obligación está respaldada por un pagaré, aparece marcada la casilla **Liberar el cupo del pagaré PAG-…**, que libera ese cupo en el mismo paso. **El pagaré no se cancela solo**: si queda sin obligaciones, el sistema le ofrece abrir su ficha para cancelarlo si ya no lo va a usar.
* **Castigada**: no libera nada, porque el pagaré es justamente el título con que se cobra. Si está firmado en blanco, habrá que [diligenciarlo](/pagares/diligenciar-un-pagare-en-blanco.md) antes de cobrarlo.
* **De En mora a Vigente**: los días de mora quedan en cero.
* **De Aprobada a Vigente sin pagaré**: se le advierte que quedará como un crédito sin garantía.
* **De Cancelada a Vigente**: el saldo sigue en cero hasta el próximo archivo, y si al cancelar se liberó un pagaré, hay que volver a vincularlo desde su ficha.

## Historial de estados

Haga clic en el ícono **Historial de estados** de cualquier obligación. Verá su hoja de vida en orden: de dónde salió (un formulario, un alta manual o una importación) y cada cambio de estado con la fecha, el origen (*Cambio manual*, *Bandeja de Solicitudes* o *Importación de cartera*), el usuario, el motivo y lo que arrastró (por ejemplo, *Aprobada por $3.500.000* o *Liberó PAG-2026-00000001*).

%% Aquí imagen del historial de una obligación %%

## Crear el pagaré que falta

Si una obligación muestra **Sin pagaré**, use el ícono **Crear pagaré** para abrir la creación con sus datos. Consulte [Crear un pagaré](/pagares/crear-un-pagare.md).