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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Reconciliations

> Compara las transacciones con las liquidaciones de los proveedores para resolver discrepancias y confirmar payouts correctos

La conciliación es un proceso que compara tus transacciones con los documentos de liquidación de los proveedores de pago para:

* Identificar y resolver discrepancias
* Asegurar que todas las transacciones procesadas estén correctamente liquidadas
* Mantener registros financieros precisos

El proceso de conciliación funciona de la siguiente manera:

**1. Recopilar los archivos de liquidación**

Reúne los archivos de liquidación de cada proveedor de pago.

**2. Comparar los archivos**

Compara esos archivos con las transacciones procesadas a través de Yuno.

**3. Verificar los saldos**

Verifica los saldos de cuenta con tus adquirentes.

**4. Comprobar los registros**

Comprueba que todos los registros sean precisos, consistentes y estén actualizados.

![Pestaña de resumen de Reconciliations del dashboard de Yuno que muestra la tasa de conciliación, el número de transacciones conciliadas y los desgloses por proveedor, cuenta y moneda](https://mintcdn.com/yuno-3979e326/m5ay49t24ir2tLEj/images/reference/reconciliations/image1.png?fit=max\&auto=format\&n=m5ay49t24ir2tLEj\&q=85\&s=7ca7dea33b7b5c734629eda5f217e345)

## Por qué importa la conciliación

La conciliación te ayuda a identificar y resolver discrepancias en el procesamiento de tus pagos. Aunque algunas discrepancias son inofensivas, factores como el momento del pago, los depósitos y las transacciones pendientes pueden afectar los saldos de tu cuenta bancaria. La conciliación periódica te permite:

* Detectar y prevenir errores de saldo
* Identificar posible fraude
* Dar seguimiento a los pagos fallidos
* Asegurar registros financieros precisos

Los objetivos clave de la conciliación son:

* Verificar que los comercios reciban todos los pagos de las transacciones exitosas de Yuno
* Asegurar el cumplimiento de los términos de pago entre comercios y adquirentes
* Monitorear los costos de procesamiento de adquirencia y validarlos frente a los términos acordados
* Mantener la integridad de los datos y los estados correctos de las transacciones en el dashboard de Yuno

Para obtener mejores resultados, realiza la conciliación a diario. Si la conciliación diaria no es viable, intenta conciliar semanalmente o, como mínimo, mensualmente.

## Cómo facilita Yuno la conciliación

Yuno ofrece un proceso integral de conciliación de transacciones que te ayuda a:

* Asegurar la correcta acreditación de los pagos
* Verificar el cumplimiento de los términos de pago
* Dar seguimiento a los costos de procesamiento

Nuestro sistema orquesta y gestiona los datos de Yuno, los socios y los comercios para ejecutar una conciliación precisa.

### Estado de conciliación

Cada transacción puede tener uno de los siguientes estados de conciliación:

| Estado | Descripción |
| :- | :- |
| Reconciled | La transacción se encontró en la liquidación del proveedor y se acreditará en tu cuenta bancaria |
| Non reconcilable | La transacción no se puede conciliar porque no cumple los criterios de conciliación. No se tomará ninguna otra acción |
| Not reconciled | La transacción está pendiente de identificarse en una liquidación. Revisa el subestado para ver si aún está dentro de los términos de pago |
| Conflict | Se encontró una transacción coincidente en la liquidación, pero tiene discrepancias con el registro procesado |

### Máquina de estados

![Diagrama de las transiciones de estado de conciliación: Not reconciled (Pending o Missing) pasa automáticamente a Reconciled, a Non reconcilable o a Conflict (discrepancia de Amount, Date o Key)](https://mintcdn.com/yuno-3979e326/m5ay49t24ir2tLEj/images/reference/reconciliations/image2.png?fit=max\&auto=format\&n=m5ay49t24ir2tLEj\&q=85\&s=201840979a3177e4a390c6519efafc6c)

### Reportes

Yuno ofrece tres reportes de conciliación:

1. **Reconciliation Overview**
   * Muestra el estado y el subestado de conciliación
   * Incluye el ID de conciliación de cada transacción

2. **Settlements & Fees**
   * Lista todas las transacciones incluidas en las transferencias bancarias a tu cuenta
   * Incluye los detalles de conciliación de cada transacción

3. **Settlement Payouts report**
   * Lista los payouts (transferencias bancarias) que cada proveedor de pago informa haber pagado a tus cuentas de comercio
   * Disponible mediante la API de Reports para los comercios que usan el nuevo motor de conciliación de Yuno; todavía no hay una pestaña en el dashboard. Consulta [Settlement Payouts](https://docs.y.uno/reference/reports/reports-fields.md#settlement-payouts)

### Obtener datos de conciliación por API

Para dar seguimiento a los montos liquidados por proveedor, cuenta y moneda desde tu backend (por ejemplo, para la contabilidad), solicita los reportes de conciliación mediante la API de Reports: [crea el reporte](https://docs.y.uno/reference/reports/create-a-report.md), [verifica que esté listo](https://docs.y.uno/reference/reports/retrieve-a-report.md) y [descárgalo](https://docs.y.uno/reference/reports/download-a-report.md). Consulta [Build reports](https://docs.y.uno/es/docs/direct-integration-use-cases/build-reports.md) para ver el flujo completo.

* Usa [Settlements & Fees](https://docs.y.uno/reference/reports/reports-fields.md#settlements--fees) para las líneas de liquidación y las comisiones de cada transacción.
* Usa [Settlement Payouts](https://docs.y.uno/reference/reports/reports-fields.md#settlement-payouts) para los montos brutos, las comisiones y los montos netos de cada transferencia que un proveedor informa haber pagado a tus cuentas de comercio. Solicitarlo para una organización que aún no usa el nuevo motor de conciliación devuelve un error 400.

> [!NOTE]
>
> Los campos `balance` que devuelve [Get Account Details](https://docs.y.uno/reference/banking-connectivity/accounts/get-account-details-banking.md) pertenecen a cuentas bancarias creadas mediante [Banking Connectivity](https://docs.y.uno/reference/banking-connectivity.md). No son saldos mantenidos con tus adquirentes o proveedores de pago.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.