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

# Conciliación Asobancaria

> Descarga y procesa archivos de conciliación en formato Asobancaria para reconciliar pagos.

El **archivo Asobancaria** es un reporte estandarizado de transacciones financieras utilizado en Colombia para la conciliación de pagos. OnePay genera este archivo periódicamente con el detalle de todos los movimientos procesados.

## ¿Cómo obtener el archivo?

El archivo de conciliación está disponible a través de un servidor **SFTP** al que puedes conectarte con las credenciales que te provee el equipo de soporte.

<Note>
  Para activar el acceso al servidor SFTP y recibir tus credenciales, comunícate con el equipo de soporte de OnePay.
</Note>

### Pasos para acceder

<Steps>
  <Step title="Solicita acceso al equipo de soporte">
    Escribe a soporte indicando tu nombre de empresa y el entorno (producción o sandbox).
    El equipo te enviará: host SFTP, usuario, contraseña y ruta del directorio.
  </Step>

  <Step title="Conéctate al servidor SFTP">
    Usa cualquier cliente SFTP (FileZilla, WinSCP, o línea de comandos) con las credenciales recibidas.
  </Step>

  <Step title="Descarga el archivo">
    Los archivos se generan con frecuencia diaria y se nombran con la fecha de corte.
    Ejemplo: `ONEPAY_20250120.txt`
  </Step>

  <Step title="Procesa el archivo">
    Importa el archivo en tu sistema de conciliación o ERP usando el formato descrito abajo.
  </Step>
</Steps>

## Formato del archivo

El archivo sigue el estándar **Asobancaria** con campos de ancho fijo separados por pipes (`|`).

| Columna | Campo                | Descripción                                        |
| ------- | -------------------- | -------------------------------------------------- |
| 1       | `fecha`              | Fecha de la transacción (`YYYYMMDD`)               |
| 2       | `hora`               | Hora de la transacción (`HHMMSS`)                  |
| 3       | `referencia`         | ID interno de la transacción en OnePay             |
| 4       | `referencia_externa` | Tu identificador externo (`external_id`)           |
| 5       | `tipo`               | Tipo de movimiento (`DEBITO`, `CREDITO`)           |
| 6       | `monto`              | Monto en centavos                                  |
| 7       | `moneda`             | Código de moneda (`COP`)                           |
| 8       | `estado`             | Estado de la transacción (`APROBADO`, `RECHAZADO`) |
| 9       | `descripcion`        | Descripción del movimiento                         |

### Ejemplo de línea

```txt theme={null}
20250120|143022|9e02966f-2ddf-4ee7-a391-5b5b7653e232|REF-001|CREDITO|1000000|COP|APROBADO|Pago mensualidad
```

## Estados posibles

| Estado      | Descripción                        |
| ----------- | ---------------------------------- |
| `APROBADO`  | Transacción procesada exitosamente |
| `RECHAZADO` | Transacción rechazada por el banco |
| `PENDIENTE` | En proceso de liquidación          |
| `DEVUELTO`  | Reversión o devolución aplicada    |

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Con qué frecuencia se genera el archivo?">
    El archivo se actualiza una vez al día, con corte a las 11:59 PM hora Colombia.
  </Accordion>

  <Accordion title="¿Cuántos días de histórico están disponibles?">
    El servidor SFTP conserva los últimos 90 días de archivos.
  </Accordion>

  <Accordion title="¿Puedo automatizar la descarga?">
    Sí. Puedes programar un script con un cliente SFTP (p. ej. `sftp` o `lftp`) para descargar automáticamente el archivo cada día.
  </Accordion>
</AccordionGroup>

<Warning>
  Las credenciales SFTP son confidenciales. No las compartas ni las incluyas en tu código fuente. Usa variables de entorno.
</Warning>