Pestaña dentro de Parámetros (antes Ubicaciones), exclusiva de Admin. Administra las listas que alimentan los combos de la pantalla de Pago: tipos de identificación, provincias, ciudades y países.
Qué se administra
- País de la identificación: la lista de países que ofrece el combo "País de la identificación" del beneficiario. Es la lista de Cumplimiento (la que mandó el cliente, ver La lista de países del cliente, más abajo): casi toda sigue la norma ISO 3166-1, pero trae valores que la norma no tiene o ya retiró (Kosovo, las Antillas Holandesas), por eso la pantalla ya no la llama "ISO". Es global: la misma para todos e independiente de en qué país opera CIS Latam. Sale en el recibo A4 y en la columna del país del documento del reporte de Cumplimiento.
- Tipo de identificación, Provincia y Ciudad: por país operativo (Guatemala, por ahora). La ciudad depende de la provincia elegida — hay que crear primero la provincia.
Cada ítem tiene un código y una etiqueta. El código es lo que se guarda en la transacción; la etiqueta es lo que ve el operador en el combo.
Lo que se carga acá es lo que el operador ve en el desplegable correspondiente de Pago, para ese país: un tipo de identificación creado en Guatemala aparece en los pagos de Guatemala, y solo ahí. (La única excepción es la lista de países de la identificación, que es la misma para todos.)
En qué país abre la pantalla
La pestaña abre en su país: el de su asignación. Si tiene asignados varios países, abre en el primero que esté activo. Si ninguno de los suyos está activo, abre en el primer país activo de la lista.
El selector de país lista solamente los países activos. Un país inactivo no aparece: nadie opera en él, y lo que se cargara ahí no se vería en ningún pago. Si no hay ningún país activo, la pantalla avisa "No hay países activos". Quien puede leer la pestaña Países es mandado a activar uno desde ahí; quien no puede (tiene Catálogos pero no Países), a pedírselo a un administrador.
El selector se arma con el permiso de Catálogos solamente: no hace falta poder leer la pestaña Países. Si la lista de países no se puede cargar (por un corte, por ejemplo), la pantalla lo dice — "No se pudieron cargar los países" — en vez de afirmar que no hay países activos o quedarse cargando, y no ofrece crear ítems hasta que el país se cargue. El aviso trae un botón Reintentar: cuando el corte pasó, alcanza con apretarlo, sin recargar la página.
Cuando una lista está vacía
La pantalla dice qué lista está vacía y de qué país, para no quedarse con la duda de si está mirando lo que cree. Por ejemplo, "Guatemala no tiene tipos de identificación cargados" (o "provincias / departamentos", o "ciudades"). La lista de países de la identificación no depende de un país operativo, y en ese caso dice "No hay países cargados". Con permiso de escritura, el aviso sigue con "Creá el primer ítem desde el formulario".
Una lista vacía de tipos de identificación tiene una consecuencia concreta: en Pago, el desplegable "Tipo de identificación" queda sin opciones y no se puede completar el formulario ni pagar las transacciones de ese país. Es lo primero que hay que mirar si un operador avisa que "no puede elegir el tipo de documento".
Alta, edición y desactivación
Se puede crear un ítem nuevo, editar su etiqueta o código, y activarlo/desactivarlo. Ningún ítem se borra: si un código ya no corresponde (un municipio que cambió de nombre, un tipo de identificación que Cumplimiento pidió sacar), se desactiva. Desactivar un ítem lo saca de los combos de pago hacia adelante, pero no toca las transacciones que ya lo tenían guardado — esas siguen mostrando el código tal cual quedó cargado.
El código de un país
El código de un país de la lista es de exactamente 2 letras mayúsculas (GT, XK): es lo que se guarda en la transacción y el pago exige 2. Si se lo escribe en minúscula, la pantalla lo pasa a mayúsculas al guardar; uno de otra forma (tres letras, números) se rechaza y el aviso dice por qué.
No le cambie el código a un país de la lista. El código es lo que guardan los pagos y lo que usa el País emisor de un tipo de identificación (el DPI guarda GT): si se cambia, los pagos viejos se imprimen con el código de antes en lugar del nombre, y un tipo de identificación que tenía a ese país como emisor sigue pidiendo el código viejo, que ya no existe en la lista. Al editar el código de un país, la pantalla lo avisa junto al campo. Para corregir un nombre, edite la etiqueta; para volver atrás, vuelva a poner el código.
Cambiar el nombre de un país afecta también lo ya pagado
En la transacción se guarda el código del país, y el nombre se busca en esta lista cada vez que se imprime o se exporta. Por eso, cambiar la etiqueta de un país es retroactivo: el recibo que se reimprima y el reporte de Cumplimiento que se vuelva a bajar muestran el nombre nuevo, también para transacciones que ya se pagaron. El país es el mismo y su código no cambia; cambia cómo se escribe.
La capital se llama «Ciudad de Guatemala». El municipio
01-01(dentro del departamento «Guatemala») se llamaba «Guatemala», igual que el departamento; desde el 2026-10-07 se llama «Ciudad de Guatemala», como lo escribe el cliente en su lista de PDV. Un deploy lo renombró solo si nadie lo había editado. Como cualquier etiqueta, el cambio es retroactivo: el A4 que se reimprime y el reporte de Cumplimiento que se vuelve a bajar dicen el nombre nuevo para los pagos de ese municipio; el código guardado no cambia.
Vale igual para un cambio que hace usted desde esta pantalla y para los que trae una actualización del sistema (los 23 de abajo). Lo ya entregado no se corrige solo: un recibo en papel o un Excel que se bajó antes siguen diciendo lo que decían, y solo lo que se vuelva a imprimir o a bajar sale con el nombre nuevo. Si Cumplimiento ya presentó un reporte con el nombre viejo y lo vuelve a bajar, los dos archivos van a diferir en esa celda. Tiene el mismo efecto con el nombre de un tipo de identificación (por ejemplo, el del DPI).
La lista de países del cliente
Cumplimiento mandó su lista de 255 países, y es la que alimenta el combo del pago, el A4 y el reporte. El sistema partía de la lista ISO (249 países) y la llevó a la del cliente con una actualización: no hay que cargar nada a mano. Queda en 251 países. Qué hizo la actualización:
- Creó dos países que la lista ISO no traía: Kosovo (
XK) y Antillas Holandesas (AN), con el código que el cliente usa. Timor Oriental queda una sola vez (la hoja del cliente lo trae repetido). - Cambió el nombre de 23 países al que usa el cliente (tabla de abajo). El código de cada uno no cambia.
- Alineó la etiqueta del DPI con la del cliente: DPI (Documento Personal de Identificación).
Los 23 nombres, tal como los escribió el cliente, con sus faltas («Democratica» sin tilde): es el texto que va a su reporte. Si algún día quieren corregirlo, se edita la etiqueta desde esta pantalla.
| Código | Antes | Ahora | Código | Antes | Ahora |
|---|---|---|---|---|---|
AX | Åland | Islas Aland | NF | Isla Norfolk | Isla de Norfolk |
BN | Brunéi | Brunéi Darussalam | NL | Países Bajos | Holanda |
BQ | Bonaire, San Eustaquio y Saba | Bonaire | PN | Islas Pitcairn | Pitcairn |
CG | República del Congo | Congo | QA | Catar | Qatar |
CZ | Chequia | República Checa | RE | Reunión | Isla Reunión |
FK | Islas Malvinas | Islas Falkland (Malvinas) | SH | Santa Elena, Ascensión y Tristán de Acuña | Santa Elena |
GS | Georgia del Sur y las Islas Sandwich del Sur | Islas Georgias del Sur y Sándwich del Sur | SX | Sint Maarten (parte neerlandesa) | San Maarten |
KG | Kirguistán | República Kirguisa | SZ | Esuatini | Suazilandia |
KP | Corea del Norte | Corea, República Popular Democratica de | TF | Territorios Australes Franceses | Territorios Meridionales Franceses |
KR | Corea del Sur | Corea, República de | UM | Islas Ultramarinas Menores de Estados Unidos | Islas Ultramarinas Menores de los Estados Unidos |
MF | San Martín (parte francesa) | San Martín | VI | Islas Vírgenes de los Estados Unidos | Islas Vírgenes (EE.UU.) |
MK | Macedonia del Norte | Macedonia |
Lo que la actualización no hizo, a propósito:
- No desactivó nada. Antártida está en la norma y no en la lista del cliente: queda activa. Si Cumplimiento confirma que no la quiere, la desactiva un Admin desde acá.
- No pisó lo que alguien editó. Renombra solo donde la etiqueta sigue siendo la original y el país está activo: uno que usted renombró, o que desactivó, queda como está. Un país desactivado que se reactive después conserva el nombre de antes, y hay que cambiarlo a mano.
- No cargó cuatro entradas de la hoja, que esperan la respuesta del cliente: Chipre (del Norte), Irlanda del Norte y Somalilandia (no tienen código ISO, y el código de un país es de exactamente 2 letras) y «Santo Tomas» (no se sabe qué es: Santo Tomé y Príncipe ya viene aparte). No las cree por su cuenta: el código que se elija queda guardado en los pagos y viaja a un reporte regulatorio, y qué entidades figuran ahí lo decide Cumplimiento.
- No usa la columna «#» de la hoja del cliente: los desplegables siguen en orden alfabético.
- No toca ninguna transacción: los códigos que ya están guardados no cambian.
La actualización deja un evento Lista de países actualizada por un deploy en Auditoría, a nombre del sistema, con cuántos países creó y cuántos renombró, y cuáles (sus códigos: 2 país(es) creado(s): XK, AN · 23 renombrado(s): AX, BN, …). Si no tenía nada que cambiar, no deja evento.
Formato del número de un tipo de identificación
Cada tipo de identificación puede traer las reglas del formato de su número. Se ven en la columna Formato de la lista (quien solo puede mirar también las ve) y se editan desde el formulario, en la sección Formato del número:
- Caracteres permitidos: cualquiera, solo números, o letras y números.
- Largo mínimo y largo máximo, de 1 a 60. El máximo no puede ser menor que el mínimo.
- País emisor: si el documento lo emite un solo país, ese país. En Pago, el país de la identificación se completa solo y no se deja cambiar ("El DPI lo emite Guatemala."). Tiene que ser un país activo de la lista de países de la identificación. Cualquier país deja el país libre.
Por pedido del cliente, el DPI es de 13 números y lo emite Guatemala; el Pasaporte es de 7 a 13 letras o números y lo puede emitir cualquier país. Un tipo nuevo, o uno con todo en blanco, no valida nada: se puede dejar así mientras se define la regla.
Algunas cosas para tener presentes:
- Es un conjunto cerrado de campos, no una expresión regular. Así una regla mal escrita no puede dejar a todos sin poder pagar.
- Los cambios rigen desde el siguiente pago y no tocan los pagos ya hechos. Pago los hace respetar al cargar los datos (el formulario no deja guardar un número que no cumple) y el servidor lo vuelve a controlar.
- Si se endurece una regla, las transacciones pendientes con un número que ya no la cumple muestran el aviso en Pago y no se pueden pagar hasta que el operador lo corrija.
- Quedan en Auditoría: cambiar una regla cambia qué número puede pagar un cajero, así que el antes y el después de cada cambio queda registrado (son reglas, no datos personales).
- No desactive el país emisor de la lista de países (Guatemala, para el DPI): ver el apartado de abajo.
- Si una regla no es válida (un mínimo mayor que el máximo, un país emisor que no existe o está desactivado), el aviso sale junto al campo y no se guarda.
Si se desactiva Guatemala en la lista de países
Esta pantalla no lo impide: desactivar un país de la lista es una decisión que no le toca a la regla del formato. Lo que sí hace es avisarlo: al desactivar cualquier país de la lista, el cuadro de confirmación dice que, si algún tipo de identificación lo tiene como país emisor, dejará de poder guardarse y pagarse con ese tipo (también las transacciones que esperan el pago). Pero el DPI exige a Guatemala como país emisor y un país desactivado no se acepta, así que ningún DPI se puede guardar ni pagar: el servidor rechaza el país de la identificación al guardar los datos y al iniciar el pago, y el cajero no tiene cómo corregirlo desde Pago. La señal es un operador que avisa «no me deja guardar un DPI» y no tiene el número mal. Se arregla reactivando Guatemala en la lista de países de la identificación (el ítem GT); la regla del DPI no se toca. Al Pasaporte le pasa lo mismo solo con un pasaporte emitido por Guatemala: los de otros países se guardan igual. (El país operativo Guatemala, el de Países, es otra cosa y no interviene en esta regla.)
Los datos base ya vienen cargados
Los datos vienen precargados: la lista de países de la identificación, los 22 departamentos de Guatemala (códigos del INE), sus municipios y los tipos de identificación DPI y Pasaporte, con sus reglas de formato. Llegan con la propia actualización del sistema: no hay que cargarlos a mano ni pedirle a nadie que corra nada después de una actualización.
La lista de municipios es una lista de trabajo, todavía sin cotejar con la fuente oficial (INE/RENAP): puede faltar algún municipio o haber un nombre desactualizado. Se corrige desde esta pantalla, sin esperar a un cambio del sistema.
La carga solo agrega lo que falta. Si un administrador editó la etiqueta de un ítem o lo desactivó, una actualización posterior no lo pisa ni lo reactiva. Hay una excepción: el sistema reconoce cada ítem base por su código, así que si se le cambia el código a uno de ellos (por ejemplo DPI a DPI_GT), una actualización posterior vuelve a agregar el original al lado y habrá que desactivarlo. Por eso conviene editar la etiqueta y no el código.
Cuando Cumplimiento confirme sus propias listas, se ajustan desde esta pantalla — no hace falta un cambio de código.

