Rapipago con base en Gire
Antes de comenzar con la configuración, es importante tener en cuenta que es posible operar con Rapipago con base en Gire de dos formas:
- Integración semi-automática. Esta modalidad aplica cuando utilizás Rapipago con base en Gire generando códigos de barras. Vas a trabajar con dos archivos principales: el de presentación de deudas y el de rendición de cobranzas.
Basándonos en la documentación oficial de la entidad, desarrollamos un proceso que genera un archivo con el formato requerido por Rapipago. Mes a mes, podés generar el archivo de presentación de deudas directamente desde nuestro software y entregarlo a la entidad.
Rapipago procesará los débitos informados y te devolverá el archivo de rendición, que podrás cargar en ISPCube para que las cobranzas se registren automáticamente y de forma masiva en el sistema. Para más información sobre como generar el archivo de presentación, e importar el archivo de rendiciones, dirigite a la sección «Generación» de este apartado.
¡Importante! Rapipago es un medio de pago que opera con distintos convenios según el cliente, y por eso las estructuras de los archivos de presentación y rendición pueden variar. Lo ideal es que el convenio que tengas esté basado en el estándar de Rapipago con base en Gire, ya que eso facilita la integración y el procesamiento correcto de los archivos en el sistema.
Nota. Si ya tenés en uso Rapipago y querés configurarlo en el sistema, te solicitaremos un archivo de presentación y uno de rendición. Se deberá indicar para ambos las posiciones del identificador de cliente y del importe, en al menos una línea del archivo.
- Integración automática. Permite ofrecer a tus clientes un botón de pago en el portal de clientes y/o en la app móvil para que puedan pagar el servicio. En esta modalidad no intervienen archivos de intercambio, sino que las cobranzas impactan en el sistema mediante webhooks.
.

Lo primero que vas a tener que hacer es ingresar al formulario de configuración del medio de pago. Para ello, ingresá a Pagos | Configuración y, una vez que estés dentro del apartado, buscá dentro del sector bancos, «Rapipago con base en Gire» .
Una vez localizado hacé click sobre el ícono «Editar» para acceder a su formulario de configuración.
Recordatorio: ISPCube es un sistema multiempresa, podrás configurar hasta cinco empresas distintas.
Esto tiene impacto en la configuración de los medios de pago, ya que será factible configurar una cuenta distinta para cada empresa.Ejemplo: el ISP posee dos empresas configuradas en el sistema, al momento de configurar el medio Rapipago con base en Gire, visualizará dos tabs, Rapipago con base en Gire 1 y Rapipago con base en Gire 2. En cada uno de esos tabs, se encontrará el formulario de configuración del medio de pago. También podrá optar por configurar una sola cuenta Rapipago con base en Gire y asignarla a todas sus empresas, desestimando el segundo tab.
¡Importante!
Al completar y guardar la información del formulario, no te olvides de activar el switch «Activar Rapipagoconbaseengire 1» (inciso 25) para poder comenzar a utilizarlo.

Nota: esta imagen se relaciona con un escenario en el que existen configuradas dos empresas dentro de ISPCube, por ello se visualiza Rapipago con base en Gire 1 y Rapipago con base en Gire 2.
1) Rapipago con base en Gire 1. Tab disponible para configurar la entidad «Rapipago con base en Gire». Recordá que vas a tener disponibles tantos tabs como empresas tengas configuradas en ISPCube.
2) Rapipago con base en Gire 2. Tab disponible configurar la entidad «Rapipago con base en Gire 2». Recordá que vas a tener disponibles tantos tabs como empresas tengas configuradas en ISPCube.
.
Generales
3) Comisión. Comisión pactada con la entidad por la prestación del servicio. Completando este valor, podrás ver reflejado en el tablero de finanzas la comisión cobrada por la entidad. Este campo es de carácter opcional.
4) Código. Código asignado a la empresa por la entidad para operar con el servicio. Código de 4 caracteres. Este dato lo brinda el medio de pago.
5) Versión del archivo. Este campo depende del convenio que tengas con Rapipago y se utiliza para conformar parte del nombre del archivo.Ejemplos:
– Sin completar el campo Versión de archivo: FCddmmYYVV.1234 (“FC” fijo + fecha actual + “VV” fijo + código “1234”).
– Completando el campo Versión de archivo: FCddmmYY79.1234 (“FC” fijo + fecha actual + versión del archivo “79” + código fijo “1234”).6) API Key. API key provista por Gire. Este campo deberá configurarse para poder operar mediante la modalidad botón de pago. Ver punto 21.
7) Token. Token provisto por Gire. Este campo deberá configurarse para poder operar mediante la modalidad botón de pago. Ver punto 21.
Aclaración: Las opciones «Calcular cliente» y «Utilizar archivo simple» que describimos a continuación, fueron incorporadas para asegurar compatibilidad con clientes que migraron desde la versión anterior del sistema. Sin embargo, como se indicó al comienzo de este documento, recomendamos configurar el medio de pago utilizando el estándar de Rapipago con base en Gire siempre que sea posible.
8) Calcular cliente. Activando este switch, el sistema obtiene el código de cliente a partir de la factura asociada a cada pago. Esto es necesario en convenios donde Rapipago no envía el código de cliente, sino los datos de la factura. Esta configuración aplica solo para el archivo de rendición.
9) Utilizar archivo simple. Activando este switch, el sistema utiliza un formato alternativo en el que, en lugar del código de cliente, se usa el DNI. Esto es necesario en convenios cuyos archivos de presentación y rendición no siguen el formato estándar de Rapipago basado en Gire. Esta configuración aplica tanto al archivo de presentación como al de rendición.
10) Posición del identificador. Es la posición en la línea del archivo, donde se encuentra el código del cliente al que se imputará el pago. Se utiliza para obtener el código del cliente al cuál se le va a insertar el pago. Esta configuración afecta únicamente el procesamiento del archivo de rendición.
Ejemplo de valores por defecto para diferentes convenios:
– Archivo estándar: 25
– Con el switch activo de “Utilizar archivo simple”: 26
– Con el switch activo de “Calcular cliente”: no se utiliza (en el archivo de rendición llegan los datos de la factura asociada al cliente).
11) Generar a todos los clientes. Al habilitar este switch, el sistema generará un botón de pago o un código de Rapipago con base en Gire (según las configuraciones establecidas en este formulario), para todos los clientes, independientemente de la entidad asignada en sus formularios de alta.
12) Presenta FX. Podrás definir positiva o negativamente la presentación de facturas X.
Nota: Recordá que este punto esta relacionado con la configuración de plantillas. Si no vas a presentar Fx en Rapipago, dicha variable no debería estar configurada en el diseño de las mismas.
13) Empresas asociadas. Definí cuál de tus empresas asociar a la cuenta Rapipago con base en Gire que estás configurando. Vas a poder asociar múltiples empresas a una misma cuenta, pero no será posible configurar distintas cuentas del mismo medio a una misma empresa.
14) Deuda a enviar. Permite definir el tipo de deuda que se presentará a Rapipago con base en Gire. Las opciones disponibles son: Deuda actual / Deuda al facturar / Importe factura (importe de la última factura mensual).
Nota: La deuda a incluir en el botón de pago se configura en otro campo. Ver punto 23.
– Deuda actual: Presenta a Rapipago la deuda actual del cliente en el momento de generar la presentación. Por ejemplo, si en el momento de generar la presentación de deudas a Rapipago con base en Gire, el cliente tiene una deuda de $20.000, el monto que se presentará a Rapipago será exactamente $20.000.
– Deuda al facturar: El monto que se presentará a Rapipago incluirá tanto la deuda pendiente del cliente en el momento de la facturación, como el importe de su última factura mensual. Por ejemplo, si se emite una factura por $20.000 el 1ro de enero y en ese momento la deuda del cliente era de $10.000, el monto total que se presentará a Rapipago será de $30.000. Este monto permanecerá fijo, independientemente de los movimientos que la cuenta corriente del cliente sufra hasta la próxima presentación.
– Importe factura: Se presentará a Rapipago el importe de la última factura mensual.
15) Nombre para mostrar. Podrás asignarle un nombre personalizado al medio de pago, para que se muestre en el botón de pago dentro de la app y el portal de clientes.
Por defecto, los botones de pago muestran el nombre de la entidad (en este caso, Rapipago con base en Gire). Si querés que se muestre el nombre personalizado, deberás completar este campo.
Nota. Para que el nombre asignado se refleje en el botón de pago, además de configurarlo acá, deberás tener activo el switch “Texto personalizado para botón de pago” en la configuración de la app y el portal. Para más información, te recomendamos ingresar al módulo Configuración > App y portal.
También podrás utilizarlo en plantillas, donde aparece bajo el nombre “Nombre para mostrar”. Este campo es opcional.
.
Códigos y fechas
16) Códigos por Cliente. El sistema nos permitirá indicar si queremos generar uno o dos códigos por cliente.
¡Importante! Los códigos por clientes están relacionados con la configuración de recargos.
Si tu configuración es “Recargo mes en curso”, tendrás habilitada la opción de dos códigos.
Por el contrario, si tu configuración es “Recargo próxima facturación” o no tenés configurado ningún recargo, tendrás disponible el uso de un solo código. Para más información, dirigite al módulo Recargos.
17) Fecha de validez código 1. Configurá acá la primera fecha de validez del código. Podrás seleccionar entre los parámetros: Primer Vencimiento / Segundo Vencimiento / Fin de mes / Personalizada.
18) Fecha personalizada. Este campo se habilita si en el campo anterior definiste la fecha de validez como «Personalizada». Permite indicar con un valor numérico el día en que vence dicho código.
También podrás tildar el box «Fecha correspondiente al mes próximo», el cual indica que no se contemplará esa fecha para el mes en curso, sino para el siguiente mes.
19) Permitir edición de fecha. Permite la edición de fecha de validez al momento de generar el archivo de presentación a Rapipago.
En caso de que definas dos códigos por cliente en el inciso 16, dispondrás de los mismos campos (17, 18 y 19), para configurar tu segundo código.
¡Importante! Una vez configurado el código de Rapipago con base en Gire, podrás insertarlo en la plantilla de la factura correspondiente utilizando la variable %rapipago_con_base_en_gire_codebar%. Para más información sobre como insertar variables en tus templates, dirigite a Configuración > Plantillas.
Tené en cuenta que los códigos de barra de Rapipago con base en Gire son dinámicos: cualquier cambio en la configuración del medio impactará de forma inmediata en el renderizado del código de barras.
20) Habilitar Webhooks. Deberás habilitar este switch para que los pagos recibidos impacten en el sistema. Este campo es exclusivo del proceso del botón de pago.
.
Botón de pago
21) Generar botón de pago en el portal cliente. Si activás este switch, podrás incluir el botón de pago de Rapipago con base en Gire en el portal de clientes. Al activarlo verás un nuevo campo donde deberás seleccionar el monto a cobrar con el botón de pago. Ver punto 23.
22) Generar botón de pago app móvil. Si activás este switch, podrás incluir el botón de pago Rapipago con base en Gire en la app de clientes. Al activarlo, verás un nuevo campo donde deberás seleccionar el monto a cobrar con el botón de pago: Deuda total, importe de factura, libre. Ver punto 23.
23) Cobro con botón de pago. Si activaste el botón de pago en el portal de clientes y/o en la app móvil, se habilitará este campo donde deberás definir el monto a cobrar. Las opciones disponibles son:– Deuda Total: Permite al cliente abonar el monto total de su deuda.
– Importe Factura: Permite al cliente abonar el importe de su última factura mensual.
– Libre: Esta opción permite al cliente elegir el saldo a abonar, ya sea la deuda vencida, el importe de su última factura mensual, el total o ingresar un monto manual.24) Configurar. Guarda los parámetros previamente configurados.
25) Activar. Activá el medio de pago para comenzar a utilizarlo. Caso contrario, quedará configurado el formulario pero no tendrá impacto en el sistema.
Una vez realizada la configuración, podrás ver la entidad creada en el panel lateral izquierdo de la pantalla, dentro del menú Pagos | Rapipago con Base en Gire.

Desde allí, podrás acceder a la herramienta para generar y presentar archivos de débito, así como para gestionar el procesamiento de cobranzas.

- Generar
- Cargar cobros
- Panel lateral
.
.
1. Generar
En esta pestaña se podrá generar el archivo de deudas para ser presentado en Rapipago con base en Gire:
Requisitos para la generación del archivo de presentación de deudas:
– La deuda del cliente involucrado debe ser mayor a $0. Claramente si el cliente no presenta deuda no será informado en el archivo.
– El cliente no debe ser considerado como «Gratis».
– Debe existir al menos un comprobante del tipo de presentación que se desee realizar en dicho envío (no cuentan facturas anuladas).
– No serán incluidos en el proceso clientes eliminados.

- a. ¿Sobre qué cuenta deseás operar?. Permite seleccionar con cuál de las entidades configuradas (Rapipago con base en Gire 1, 2, 3, 4 o 5) querés operar.
- b. Período a cobrar. Corresponde al mes sobre el cual vas a generar los archivos de intercambio.
- c. Año. Corresponde al año sobre el cual vas a generar los archivos de intercambio.
- d. Fecha. Corresponde a la fecha de validez del código establecida en la configuración de la entidad. Este campo solo será editable si, después de definir una fecha de vencimiento, activaste el switch de «Permitir edición de fecha».
- e. Generar archivo. Una vez configurados todos los campos anteriores, estarás en condiciones de generar el archivo txt de intercambio.
Nota: Si tenés activado el switch «Utilizar archivo simple» en la configuración de la entidad, el identificador del cliente en el archivo se generará usando su número de documento.

En cambio, si utilizás el convenio estándar de Rapipago basado en Gire, o si tenés activado el switch «Calcular cliente» en la configuración de la entidad, el identificador del cliente en el archivo se generará usando el código del cliente.
.
2. Cargar cobros
Después de presentar el archivo de deudas a Rapipago (generado en el paso anterior), Rapipago te devolverá un archivo de cobranza que deberás cargar en este paso. De esta manera, las cobranzas impactarán en el sistema:

- a. Cargar archivo de cobranza. Permite cargar el archivo de cobranza proporcionado por Rapipago. El archivo a cargar es formato .txt.
.

Una vez subido el mismo, podrás visualizar un resumen del proceso y descargarlo:

Nota. Las cobranzas exitosas quedarán registradas en el listado de Finanzas > Caja.
Si algún pago no pudo ser asociado a un cliente, podrás gestionarlo desde Pagos > Pagos sin asociar.
.
3. Panel lateral
En esta columna podrás ver y, si es necesario, editar los datos configurados de la entidad:

- Muestra/oculta un resumen de los datos configurados de la entidad.
- b. Editar configuración. Permite acceder a la configuración de la entidad y editar su información.
.
