El siguiente es el manual para usuarios administradores del sistema de recibos.
La aplicación Recibos (Invoices) le permite dotar a otras aplicaciones de un sistema completo de recibos. En este sentido, los beneficios más importantes son:
Los estados, como su nombre lo indica, refieren a los estados procesales de un recibo. Estos estados pueden ser: pendiente, expirado, cancelado, aprobado y anulado. Más adelante los trataremos en profundidad.
Las credenciales son el modo en que la aplicación reconoce y se comunica con otras aplicaciones. Una aplicación que desee generar recibos deberá contar con una credencial.
Las gateways o pasarelas son las encargadas de cambiar los estados de un recibo.
Los auditores cumplen funciones similares a las pasarelas, pero sirven para el pago en efectivo y las cancelaciones, en lugar del pago online.
Veámos estos conceptos con un ejemplo: un usuario adquiere un producto o servicio en una Tienda virtual (una aplicación con tal fin). La Tienda virtual, que cuenta con una credencial, genera un recibo. El usuario, a través de una pasarela, realiza el pago del recibo. Internamente, la pasarela cambia el estado del recibo de pendiente a aprobado. A su vez, la aplicación Recibos avisa a la Tienda virtual el nuevo estado. Por último, con el pago aprobado, la Tienda virtual puede entregar el producto y actualizar el stock.
Los estados, como su nombre lo indica, refieren a los estados procesales de un recibo.
Un estado, o más precisamente, el cambio de estado de un recibo, es un acto administrativo realizado a través de una pasarela.
Es importante considerar que no todos los estados pueden sucederse entre sí. Por ejemplo, sólo puede expirar un recibo pendiente.
Los posibles estados de un recibo son:
| Estado | Descripción | Sucede a: |
|---|---|---|
| Pendiente | El recibo está pendiente de pago. Es el estado original con el que se crea un recibo. | |
| Expirado | El recibo ha superado su fecha de caducidad. | Pendiente |
| Cancelado | El recibo pendiente de pago ha sido cancelado. | Pendiente |
| Aprovado | El pago ha sido efectuado y el recibo quedó aprobado | Pendiente |
| Anulado | Se anula un recibo aprobado. | Aprovado |
Las credenciales son el modo en que la aplicación reconoce y se comunica con otras aplicaciones.
Una aplicación que desee generar recibos deberá contar con una credencial. A su vez, el sistema de Recibos puede avisar a las otras aplicaciones los cambios de estado de un recibo, de acuerdo a lo configurado en dicha credencial.
En el mismo sentido, los roles y permisos del sistema de recibos se otorgan a partir de estas credenciales. Por último, los balances y estadísticas tienen en cuenta las credenciales.
Para crear una credencial se requieren tres valores:
Es el texto con el que las aplicaciones que desean emitir recibos se darán a conocer. Algunas aplicaciones traen predefinida la clave, y otras dan la posibilidad de crearlas.
El nombre no tiene mayores consideraciones, puede ser cualquiera medianamente significativo.
Aquí se debe seleccionar el plugin que trae la aplicación para vincularse con Invoices.
Las credenciales se pueden eliminar sólo si no están siendo utilizadas.
Las gateways o pasarelas se utilizan para cambiar el estado de un recibo. Es decir, las pasarelas permiten cancelar recibos, pagar o anular pagos.
Las pasarelas pueden ser de tres tipos:
Las ejecuta un auditor. Se utilizan, por ejemplo, para el pago efectivo.
Las ejecuta un auditor o el mismo usuario. Se utilizan para el pago virtual que requiera aviso de pago, por ejemplo: una tranferencia bancaria donde no se tenga implementado el aviso de pago automático.
Las ejecuta el usuario y no requieren atención del auditor. Este es el caso del pago online propiamente dicho.
Para crear una pasarela se requiere cuatro valores:
Seleccione uno de los tipos de pasarelas.
Es el texto con el que la pasarela se dará a conocer, la misma es provista por la pasarela.
El nombre puede ser cualquiera con el cual los usuarios identifiquen la pasarela.
Aquí se debe seleccionar el plugin que trae la pasarela para vincularse con el sistema de Recibos.
Los estados posibles pueden ser Privado o Público, según se desee que la pasarela se utilice o quede desabilitada.
Las pasarelas se pueden eliminar sólo si no están siendo utilizadas. Si debe dejar de utilizar la pasarela y no puede ser eliminada, cambie su estado por "privado".
Las auditorías de la aplicación Recibos permiten crear roles y otorgar permisos.
Para agregar un auditor se debe vincular un Legajo con un rol. Para ello, el rol debe estar previamente creado.
Los auditores pueden cambiar su rol.
No hay resticciones para eliminar un auditor.
Los roles agrupan permisos. Es importante nombrar los roles de manera significativa, por ejemplo: Cajero, Tesorero, Contador, etc.
Para agregar un rol se debe tener en cuenta dos bloques: el principal y las credenciales.
Un nombre medianamente significativo.
Al momento, la aplicación cuenta con las siguientes opciones:
Seleccione todas las credenciales a las cuales se tendrá acceso con el rol.
Los roles pueden ser editados.
No hay resticciones para eliminar un rol.