> ## 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.

# Cobro de facturas desde tu sistema de gestión

> Conecta tu sistema de facturación con OnePay y automatiza el cobro. Tú generas la factura, OnePay se encarga de cobrarla.

## El problema

Generas facturas en tu sistema de gestión — SAEplus, Wispro, Siigo, Wisphub, Mikrowisp u otro — pero cobrarlas es un proceso manual: enviar links, hacer seguimiento, verificar pagos y actualizar estados. Cada factura pendiente es tiempo que tu equipo dedica a perseguir pagos en lugar de enfocarse en tu negocio.

## La solución

Conecta tu sistema de gestión con OnePay y delega todo el proceso de cobro. Tu sistema crea la factura vía API y OnePay hace el resto:

* **Envía el cobro** al cliente por WhatsApp, email o SMS
* **Hace seguimiento** con recordatorios automáticos
* **Recibe el pago** por cualquier método (PSE, tarjeta, Nequi, Efecty, etc.)
* **Te notifica** cuando el pago se completa
* **Concilia** automáticamente con tu sistema de gestión

***

## ¿Cómo funciona?

Tres actores participan en el flujo:

|                           | Descripción                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| **Tu sistema de gestión** | El software donde generas tus facturas (SAEplus, Wispro, Siigo, Wisphub, Mikrowisp, etc.) |
| **OnePay**                | Recibe la factura, crea el cobro y gestiona todo el proceso de pago                       |
| **Tu cliente**            | Recibe el cobro y paga a través de OnePay                                                 |

```mermaid theme={null}
sequenceDiagram
    participant SG as Sistema de Gestion
    participant OP as OnePay
    participant CF as Cliente Final
    Note over SG,CF: Flujo principal de facturacion
    SG->>OP: 1. POST /invoices (Crear factura)
    Note right of OP: OnePay crea internamente un cobro asociado a la factura creada.
    OP->>CF: 2. Envia link/cobro al cliente final (WhatsApp, email, etc.)
    CF->>OP: 3. Paga la factura (via OnePay)
    OP->>OP: 4. Actualiza estado de factura = Pagada
    OP-->>SG: 5. Webhook notificacion de pago exitoso
    alt El sistema necesita modificar el valor o datos de la factura
        SG->>OP: 6. PUT /invoices/{invoice} (Actualizar factura)
        Note right of OP: OnePay crea un nuevo cobro con el valor actualizado.
        OP->>CF: 7. Envia nuevo cobro al cliente final
    end
    alt El pago se hizo por otro proveedor externo
        SG->>OP: 8. DELETE /invoices/{invoice} (Eliminar factura)
        Note right of OP: OnePay elimina el cobro asociado y detiene el seguimiento de pago.
    end
```

***

## El flujo paso a paso

### 1. Tu sistema envía la factura a OnePay

Cuando se genera una factura en tu sistema, se envía a OnePay con los datos básicos: monto, referencia, datos del cliente y el proveedor de origen. OnePay crea automáticamente un cobro asociado y queda listo para enviarlo.

### 2. OnePay cobra al cliente

OnePay envía el link de pago al cliente por los canales que tengas configurados — WhatsApp, email, SMS — y se encarga del seguimiento con recordatorios automáticos según las reglas de cobranza de tu comercio.

### 3. El cliente paga

Tu cliente abre el link y paga con el método que prefiera: PSE, tarjeta de crédito, Nequi, Daviplata, Efecty, entre otros.

### 4. OnePay te notifica y concilia

Cuando el pago se completa, OnePay te notifica vía webhook y, según tu sistema de gestión, puede conciliar automáticamente — por ejemplo, creando un recibo de caja en Siigo.

### 5. ¿Cambió algo en la factura?

Si necesitas modificar el monto o los datos de una factura que aún no se ha pagado, actualízala vía API. OnePay cancela el cobro anterior y envía uno nuevo al cliente con los datos corregidos.

Si la factura se pagó por otro medio o ya no aplica, elimínala vía API. OnePay detiene el seguimiento y cancela el cobro pendiente.

***

## ¿Listo para integrar?

Consulta la [introducción técnica de facturas](/client/invoices/index) para entender los detalles de implementación, estados, webhooks y las funcionalidades avanzadas como pagos parciales y splits.