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

# Integración con Siigo

> Guía paso a paso para integrar OnePay con Siigo, incluyendo configuración, administración y solución de problemas comunes.

**Puntos clave:**

* Obtención de credenciales API en Siigo

* Configuración en OnePay

* Creación y administración de métodos de pago en Siigo

* Importación y sincronización de facturas

* Requisitos para que una factura sea leída y enviada a cobro en OnePay

* Funcionamiento del módulo de facturas en OnePay

* Solución de problemas frecuentes

***

### **1. Obtención de credenciales API en Siigo**

Para conectar Siigo con OnePay, es necesario obtener las credenciales API:

1. Inicia sesión en Siigo.

2. Dirígete a la parte superior derecha y haz clic en el icono de "Configuración".

3. Busca la opción "Alianzas e Integraciones".

4. Selecciona "Credenciales de integración a plataformas digitales (Siigo API)".

5. Elige "Pasarela de pagos" como tipo de integración.

6. Obtén el usuario API y el Access Key.

### **2. Configuración en OnePay**

Una vez que tienes las credenciales API:

1. Comparte el usuario API y el Access Key con el equipo de soporte de OnePay para completar la integración.

2. Verifica que la conexión esté activa y funcionando correctamente.

### **3. Creación y administración de métodos de pago en Siigo**

Para asegurar una correcta conciliación de pagos:

1. En Siigo, accede a "Configuración" > "Contabilidad" > "Generales".

2. Selecciona "Formas de Pago en Documentos".

3. Crea métodos de pago según los que utilizará OnePay, como "OnePay Tarjeta de Crédito" o "OnePay Cuenta Bancaria".

4. Guarda los cambios para que OnePay pueda sincronizar esta información.

### **4. Importación y sincronización de facturas**

OnePay importa automáticamente las facturas de Siigo con deuda activa:

* Se sincronizan dos veces al día (9:00 a.m. y 12:00 p.m.).

* Solo se importan facturas creadas en los últimos dos días y con un número de celular válido.

* Para forzar una importación inmediata, accede a "Cobrar" en OnePay y haz clic en "Crear pagos desde Siigo".

### **5. Requisitos para que una factura sea leída y enviada a cobro en OnePay**

Para que OnePay pueda leer y enviar una factura a cobro, debe cumplir con los siguientes requisitos:

* La factura debe estar creada como una venta a crédito.

* Debe tener una deuda pendiente.

* El cliente asociado a la factura debe contar con un número de celular válido registrado en Siigo.

* La factura debe haber sido creada dentro de los últimos dos días.

### **6. Funcionamiento del módulo de facturas en OnePay**

El módulo de facturas en OnePay permite monitorear los estados de creación y conciliación de los recibos de caja. Los estados más comunes son:

* **Creado:** La factura fue importada exitosamente desde Siigo.

* **Conciliado:** El pago fue realizado en OnePay y la factura ha sido cerrada en Siigo.

* **Fallido:** Hubo un error en la conciliación, posiblemente porque la factura ya se pagó manualmente en Siigo o tiene datos incorrectos.

* **Cancelado:** La factura fue anulada en el proceso.

* **Pagado en sistema externo:** Indica que el pago se realizó fuera de OnePay.

### **7. Solución de problemas frecuentes**

* **No se importan las facturas:** Verifica que sean facturas de venta a crédito y que incluyan un número de celular válido.

* **No se concilian los pagos:** Asegúrate de que se hayan configurado correctamente los métodos de pago en Siigo.

* **Error en credenciales API:** Comprueba que el usuario API y el Access Key sean correctos y válidos.

### **8. Cómo funciona la integración entre OnePay y Siigo**

La integración entre OnePay y Siigo automatiza el proceso de cobro y conciliación de pagos:

1. OnePay lee las facturas con deuda desde Siigo.

2. Se envían las solicitudes de cobro a los clientes con los datos extraídos de Siigo.

3. Cuando el cliente realiza el pago, OnePay lo registra y genera un recibo de caja en Siigo para cerrar la deuda.

4. El módulo de facturas en OnePay actualiza el estado de cada transacción para monitorear el proceso.