Skip to content

Países es una pestaña de Parámetros (antes Ubicaciones), exclusiva de Admin.

El alta de un país pide código ISO de 2 letras, nombre y formato de recibo (que arranca en Tirilla 58 mm, ver más abajo) — el módulo Caja arranca siempre apagado y se activa después, editando el país ya creado.

Un país nuevo y la Tesorería que ve toda la Holding ​

Un país se da de alta activo. La Holding es global y se ve completa solo con una asignación de Tesorería (o de Admin) en cada país que cuenta (no existe una asignación «todos los países»), así que apenas se da de alta un país activo, quien tenía Tesorería en todos los demás pasa a ver el saldo de Prefondeo Soterex y sus dos extractos con el aviso de parcial, sin el país nuevo. Se arregla sumándole una asignación de Tesorería en el país nuevo (en Asignación de Roles). Lo mismo pasa al reactivar un país.

Esto le pasa también al Admin que da de alta el país: el alta no lo asigna a él, así que su propia tarjeta de Prefondeo Soterex pasa a «de sus países» hasta que se agregue una asignación suya, con el rol Admin, en el país nuevo. Un país inactivo y sin ningún movimiento no cuenta como uno que falta; uno inactivo que ya tiene asientos, envíos o pagos, sí.

Formato de recibo ​

Cada país define cómo sale por defecto la papeleta de pago, el comprobante que firman el cliente y el operador. Se elige en el campo Formato de recibo, tanto al crear el país como al editarlo, y figura en la columna Recibo del listado. Hay dos formatos:

FormatoQué es
A4Una hoja vertical con dos copias iguales —cliente y agencia— separadas por una línea de corte. Además de lo que trae la tirilla, imprime el país de emisión de la identificación, la provincia, la ciudad y la dirección del beneficiario y la ciudad de la agencia. La declaración del cliente es la de la tirilla, de cuatro incisos
Tirilla 58 mmLa tirilla angosta de siempre, para la impresora térmica del mostrador
  • Un país nuevo arranca en Tirilla 58 mm, que es lo que imprime hoy cualquier país. Pasarlo a A4 es una decisión del Admin. Guatemala ya está en A4.
  • El cambio vale desde la próxima vez que se abra una transacción, también para las que ya estaban pagadas: pasa la marca predeterminado al otro botón. Cada botón sigue bajando su propio formato, así que una reimpresión de la misma papeleta no cambia de formato por esto.
  • No impide imprimir el otro formato. La papeleta tiene dos botones siempre visibles, Imprimir papeleta tirilla e Imprimir papeleta A4, y quien puede ver una transacción puede usar los dos (ver Pago). El campo define cuál de los dos lleva la marca predeterminado, no cuál está permitido.
  • Cambiarlo queda registrado en Auditoría con el valor anterior y el nuevo, como el resto de los cambios de un país.
  • Desactivar o reactivar un país no toca su formato.

Activar el módulo Caja de un país ​

Al editar un país se puede activar el módulo Caja. Con el módulo Caja activo, es obligatorio indicar la moneda local (código ISO 4217 de 3 letras, por ejemplo GTQ) — sin eso, la caja no tendría en qué moneda mostrar sus saldos. También se puede indicar si el país paga en moneda local o en dólares: Guatemala, por ejemplo, no tiene autorización de cambio de divisa y paga en dólares — en ese caso, el tipo de cambio deja de ser un dato obligatorio para operar.

Activar el módulo Caja de un país es lo que habilita, para ese país, las pantallas de Caja, Apertura/cierre, Fondeo, Tipo de cambio y el reporte de Cajas — antes de activarlo, esas pantallas no tienen nada que gestionar para ese país.

Apagar el módulo Caja deja sin operar a las cajas de todas las estaciones activas del país: dejan de aparecer en Saldos y no se pueden abrir. Por eso el sistema no lo permite mientras alguna de esas cajas esté abierta o tenga plata adentro, en cualquier moneda: el aviso dice qué hacer (cerrarlas y dejarlas en cero con un ajuste de motivo «Retiro por baja de caja», los mismos pasos de Estaciones / PDV) y no dice cuánto hay. Con las cajas cerradas y en cero se apaga sin problema.

Comisiones: el tarifario por país ​

Comisiones es otra pestaña de Parámetros, exclusiva de Admin y con el mismo permiso que Países. Es el tarifario con el que CIS calcula la comisión de cada transacción que llega desde Soterex: Soterex ya no manda la comisión (si la mandara, se ignora), la calcula CIS según el país de destino.

Cómo se calcula ​

Cada país tiene una lista de tramos. Un tramo cubre los montos de Desde a Hasta (los dos incluidos; sin «Hasta» es «sin tope») y cobra un monto fijo, un porcentaje del monto, o los dos. Para una transacción, el sistema busca el tramo que contiene el monto y calcula:

comisión = fijo + monto × porcentaje / 100, redondeada a 2 decimales (0,005 sube a 0,01)

Por ejemplo: un tramo «desde 0.01 en adelante, fijo 50.00, 0 %» cobra 50.00 sobre cualquier monto (es el tarifario provisional de Guatemala, ver «Los avisos»). Un tramo «desde 0.01 en adelante, fijo 0, 1 %» cobraría 5.00 sobre 500.00. Un tramo «de 100.01 a 500.00, fijo 2.00, 0.5 %» cobra 2.00 + 1.50 = 3.50 sobre 300.00.

La comisión se guarda en la transacción cuando se crea. Cambiar el tarifario vale solo para las transacciones que lleguen después: no toca ninguna transacción ya creada (pendiente, pagada o cancelada).

Qué se ve ​

Arriba, un selector de País (arranca en el primer país activo) y, si el usuario puede escribir, el botón + Nuevo tramo. Abajo, la tabla de los tramos de ese país, por monto mínimo, activos e inactivos: Desde, Hasta (o sin tope), Fijo, Porcentaje, Estado (Activo o Inactivo, y Provisional si lo es), Descripción y las acciones Editar y Desactivar (o Reactivar).

Cargar un tramo ​

+ Nuevo tramo abre un formulario con:

CampoQué poner
DesdeEl monto mínimo del tramo, con hasta 2 decimales
HastaEl monto máximo, con hasta 2 decimales. Vacío es sin tope. No puede ser menor que Desde
Comisión fijaUn monto, con hasta 2 decimales. Puede ser 0
Porcentaje (%)De 0 a 100, con hasta 4 decimales. Puede ser 0
Descripción (opcional)Una línea de hasta 255 caracteres, para recordar de dónde sale el tramo
ActivoMarcado, el tramo se aplica desde ahora a las nuevas transacciones

Los montos se escriben sin comas y no admiten negativos. Fijo 0 y porcentaje 0 es un tramo sin comisión: se permite (puede ser una política), pero la pantalla lo avisa. Un tramo cargado desde acá no es provisional.

Extremos incluidos: tocarse es solaparse ​

Como «Desde» y «Hasta» cuentan, dos tramos activos del mismo país no pueden cubrir el mismo monto, y eso incluye tocarse en un extremo:

  • «0.01 a 100.00» y «100.00 a 200.00» chocan: el monto 100.00 sería ambiguo.
  • «0.01 a 100.00» y «100.01 a 200.00» no chocan: son contiguos, a un centavo de diferencia. Así se cargan dos tramos seguidos.

Si se intenta guardar un tramo que choca, el sistema lo rechaza, dice con qué tramo se solapa, y ese tramo queda marcado Se solapa en la tabla. Un tramo inactivo no cuenta: puede solaparse con otros, pero al reactivarlo se vuelve a comprobar. Si dos Admin cargan tramos a la vez en el mismo país, el sistema los atiende de a uno.

Editar, desactivar y reactivar ​

  • Editar abre el mismo formulario con los valores actuales. El sistema solo guarda lo que cambió; si no se cambió nada, dice No había cambios para guardar y no registra nada.
  • No hay borrar. Un tramo se desactiva, y se puede reactivar, así queda la historia de qué tarifario rigió y quién lo cambió. Desactivar y reactivar piden confirmación. Al desactivar, el tramo deja de aplicarse a las nuevas transacciones (las ya creadas conservan su comisión) y la confirmación avisa si es el único tramo activo.
  • Editar los valores de un tramo provisional lo deja de marcar como provisional (se entiende que un Admin lo revisó y ya es suyo); si su descripción decía PROVISIONAL — reemplazar… y no se escribe otra, esa descripción se borra para no contradecir el estado. Desactivarlo o reactivarlo no cambia esa marca.

Los avisos ​

Arriba de la tabla, la pantalla avisa de lo que puede salir mal. Los avisos se recalculan con cada alta, edición, desactivación o reactivación:

AvisoColorQué significa
No hay ningún tramo activoRojoNingún monto tiene comisión: toda solicitud de Soterex se rechaza con el código 2026 y no se crea la transacción. Hay que activar o cargar un tramo
Hay montos sin comisiónRojoEl tarifario tiene huecos: la lista dice qué rangos (por ejemplo, de 100.01 a 200.00 o desde 500.01 en adelante). Una solicitud con un monto de esos rangos se rechaza con el código 2026 y no se crea la transacción. Avisa y no impide guardar
Este tarifario es PROVISIONALÁmbarHay un tramo activo cargado por el sistema como valor de arranque (en Guatemala, 50.00 USD fijos por transacción, para cualquier monto). No es la tabla de Tesorería: hay que reemplazarlo cuando Tesorería la defina. Mientras tanto es lo que se cobra, también en producción. El aviso lista cuál es y desaparece cuando ya no queda ningún tramo activo marcado como provisional
N tramos activos no cobran comisiónGrisHay tramos con fijo 0 y porcentaje 0. Está bien si es una política; si no, conviene revisarlo

El sistema carga el tarifario provisional en todos los ambientes, producción incluida (decisión del 2026-10-05): un solo tramo de 50.00 USD fijos por transacción, para cualquier monto, marcado Provisional con la descripción PROVISIONAL — reemplazar por la tabla de Tesorería. Solo se carga si Guatemala no tiene ningún tramo, activo o inactivo: un tarifario que ya se cargó, o un provisional que alguien editó o desactivó, no se pisa en una actualización. El tarifario real lo define Tesorería; cuando lo tenga, se carga desde esta pantalla (se edita el tramo provisional o se cargan los tramos nuevos y se desactiva el provisional) y el aviso desaparece.

Dos cosas a tener presentes con el provisional:

  • Con montos menores a 50 USD la comisión es mayor que el monto (una transacción de 20.00 queda con comisión 50.00). El sistema no lo rechaza: da de alta, paga y descuenta igual que cualquier otra. La comisión nunca sale de la caja (ver Caja); la descuenta el Prefondeo Soterex. Si hace falta que los montos chicos cobren menos, se carga un tramo para ese rango.
  • Si se desactivan todos los tramos de un país, o queda un monto sin cubrir, toda solicitud de Soterex con ese monto se rechaza con el código 2026 y no se crea la transacción. Es lo que avisan los dos avisos rojos de arriba.

Cada alta, edición, desactivación y reactivación de un tramo queda registrada en la Auditoría, con quién lo hizo, el país y los valores (en una edición, cada campo con su antes y su después).

Documentación viva — se actualiza junto con el código, no es un anexo aparte.