Índice
Para quién es este artículo: Aplica a los clubes que operan en Panamá y deben emitir factura electrónica.
¿Qué es esta integración?
La integración con la fiscalidad de Panamá permite emitir facturas electrónicas desde Golfmanager cumpliendo la normativa de la DGI (Dirección General de Ingresos). Cuando se factura, Golfmanager envía el documento a un procesador autorizado (PAC, "Factura Panamá"), que lo certifica ante la DGI y devuelve el CUFE (Código Único de Factura Electrónica) y el identificador de la factura.
La factura electrónica es la forma legal de facturar en Panamá. Para emitirla, se usa un PAC (proveedor autorizado) que certifica el documento ante la DGI. El CUFE es el código único que identifica cada factura electrónica.
¿Qué problema resuelve?
Cumplir la normativa fiscal panameña emitiendo facturas electrónicas válidas, sin procesos manuales.
Procesa y certifica la factura y obtiene el CUFE.
Mantiene la coherencia entre lo facturado en Golfmanager y lo declarado a la DGI.
Deja rastro de cada operación (cada factura procesada queda registrada con su resultado).
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con el procesador autorizado (PAC, "Factura Panamá") y, a través de él, con la DGI:
Golfmanager genera la factura y la envía a procesar.
El procesador la certifica ante la DGI y devuelve el CUFE y el identificador de la factura.
Golfmanager guarda el CUFE, el identificador y el XML autorizado en la factura.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Datos de la factura (emisor, receptor, conceptos, impuestos, forma de pago) | Golfmanager → Procesador → DGI | Procesar la factura electrónica |
CUFE, identificador y XML autorizado | DGI → Procesador → Golfmanager | Guardar la factura certificada |
Requisitos previos (antes de activar la integración)
Operar en Panamá y estar obligado a la factura electrónica.
Tener contratado el servicio "Factura Panamá" (procesador autorizado) y sus datos de conexión (usuario, clave y endpoint).
Tener el módulo instalado, junto con el módulo de facturación.
Tener el RUC del emisor y los datos del establecimiento y el punto de facturación.
Permisos de gestión de sistema/facturación para configurar.
Cómo se configura (paso a paso)
Paso 1 — Datos del emisor y del servicio
Accede a Golfmanager con un usuario administrador.
Entra en Configuración > Factura Panamá.
Introduce el RUC Emisor.
Introduce el Usuario y la Clave de Factura Panamá.
Introduce el Endpoint (dirección del servicio del procesador).
Introduce el Establecimiento y el Punto de facturación.
Deja el Modo de producción desactivado para empezar (pruebas). Hay una versión de cada dato para prueba y otra para producción.
Guarda los cambios. El usuario y la clave se almacenan cifrados.
Paso 2 — Impuestos y códigos de producto
Comprueba que tus impuestos usan los códigos de Panamá (ITBMS, ISC u OTI).
Asigna a cada producto su Código de producto Panamá.
Paso 3 — Datos fiscales de los clientes
Entra en la ficha del cliente.
Rellena la Identificación nacional (RUC/cédula) y el Dígito verificador.
Rellena el Código de ubicación, la Provincia, el Distrito y el Corregimiento/Cantón.
Guarda los cambios.
Paso 4 — Forma de pago y prueba
En cada factura, indica la forma de pago (efectivo, tarjeta, transferencia, etc.).
Procesa una factura de prueba y comprueba que obtienes el CUFE.
Cuando todo funcione, activa el Modo de producción con las credenciales reales.
⚠️ Recomendación: empieza siempre en modo de prueba con las credenciales de test, procesa una factura de ejemplo y pasa a producción solo cuando todo funcione.
Explicación de cada campo
A continuación se describe cada campo de la integración: dónde está, qué significa, su impacto en el sistema y un ejemplo de uso (qué ocurre cuando se utiliza y cómo se comporta el sistema). Los datos del emisor y del servicio tienen una versión de prueba y otra de producción.
A) Configuración del emisor (Configuración > Factura Panamá)
1. Modo de producción
Descripción: interruptor que indica si se trabaja en pruebas (desactivado) o en producción (activado).
Impacto en el sistema: determina qué juego de datos se usa (los de prueba o los de producción) y si las facturas son reales ante la DGI. Por defecto, desactivado.
Ejemplo de uso: lo activas cuando terminas de validar la integración.
Qué ocurre cuando se utiliza: desactivado, las facturas se procesan contra el entorno de pruebas; activado, son reales.
Comportamiento del sistema: según el interruptor, Golfmanager usa el RUC, usuario, clave, endpoint, establecimiento y punto de prueba o de producción.
2. RUC Emisor
Descripción: el RUC (identificación fiscal) de tu club/empresa como emisor.
Impacto en el sistema: es obligatorio. Identifica al emisor en la factura electrónica.
Ejemplo de uso: introduces el RUC de tu empresa.
Qué ocurre cuando se utiliza: las facturas salen a nombre de ese RUC.
Comportamiento del sistema: si falta, al procesar aparece "Falta el RUC del emisor en la configuración de Factura Panamá".
3. Usuario y 4. Clave (Factura Panamá)
Descripción: las credenciales del servicio del procesador autorizado, que te facilita tu proveedor.
Impacto en el sistema: obligatorias para autenticarse con el PAC. Se guardan cifradas.
Ejemplo de uso: las copias del proveedor y las pegas.
Qué ocurre cuando se utiliza: cada factura se envía al procesador autenticada con estas credenciales.
Comportamiento del sistema: si son incorrectas, el procesador rechaza la operación; el detalle del error queda en el registro de transacciones.
5. Endpoint
Descripción: la dirección del servicio del procesador a la que Golfmanager envía las facturas.
Impacto en el sistema: obligatorio. Determina a qué servidor (prueba o producción) se conecta.
Ejemplo de uso: pegas la URL que te indica tu proveedor.
Qué ocurre cuando se utiliza: el procesado viaja a esa dirección.
Comportamiento del sistema: si falta, aparece "Falta el endpoint en la configuración de Factura Panamá"; si es incorrecto o el servicio no responde, el procesado falla.
6. Establecimiento y 7. Punto
Descripción: el establecimiento (local) y el punto de facturación, que identifican dónde y desde qué punto se emite.
Impacto en el sistema: obligatorios. Forman parte de la numeración del comprobante.
Ejemplo de uso: los introduces con los valores que te indica el procesador/DGI.
Qué ocurre cuando se utiliza: la factura electrónica sale con ese establecimiento y punto.
Comportamiento del sistema: si falta alguno, aparece "Falta el establecimiento…" o "Falta el punto en la configuración de Factura Panamá".
B) Datos fiscales del cliente (ficha del cliente)
8. Identificación nacional (RUC/cédula)
Descripción: el RUC o la cédula del receptor de la factura.
Impacto en el sistema: es imprescindible para procesar la factura de ese cliente.
Ejemplo de uso: rellenas el RUC/cédula del cliente.
Qué ocurre cuando se utiliza: la factura se emite a nombre de ese receptor.
Comportamiento del sistema: si falta, aparece "Cliente no tiene ID nacional para factura Panamá" y no se procesa.
9. Dígito verificador
Descripción: el dígito verificador (DV) asociado a la identificación del cliente.
Impacto en el sistema: requerido para validar la identificación.
Ejemplo de uso: lo rellenas junto al RUC/cédula.
Qué ocurre cuando se utiliza: acompaña a la identificación del receptor.
Comportamiento del sistema: si falta, aparece "Cliente no posee digito verificador (facturapanama)".
10. Código de ubicación, 11. Provincia, Distrito y Corregimiento/Cantón
Descripción: los datos geográficos del cliente que exige la factura electrónica.
Impacto en el sistema: obligatorios para procesar; identifican la ubicación del receptor.
Ejemplo de uso: rellenas el código de ubicación y la provincia/distrito/corregimiento del cliente.
Qué ocurre cuando se utiliza: la factura incluye esa información regional.
Comportamiento del sistema: si falta el código de ubicación, aparece "Cliente requiere un código de ubicación de factura Panamá"; si falta la provincia/distrito/corregimiento, "Falta información regional de factura Panamá de cliente".
C) Productos e impuestos
12. Código de producto Panamá
Descripción: el código del producto/servicio que se envía al procesador en cada línea.
Impacto en el sistema: es obligatorio en cada línea de la factura.
Ejemplo de uso: en un green fee, asignas su código de producto de Panamá en la ficha del producto.
Qué ocurre cuando se utiliza: cada línea sale con su código.
Comportamiento del sistema: si un producto no tiene código, aparece "Producto no tiene código de factura Panamá" y no se procesa.
13. Código de impuesto (ITBMS / ISC / OTI)
Descripción: la clave del impuesto según Panamá: ITBMS (transferencia de bienes y servicios, p. ej. 7%, 10%, 15% o exento), ISC (selectivo al consumo) u OTI (otros impuestos).
Impacto en el sistema: obligatorio en cada impuesto de la factura; define el desglose de impuestos.
Ejemplo de uso: en tu impuesto de IVA usas el código de ITBMS que corresponda.
Qué ocurre cuando se utiliza: la factura desglosa el impuesto correctamente.
Comportamiento del sistema: si falta o el código no es válido, aparece "Código de impuesto faltante, use uno de los impuestos validos ISC, ITBMS u OTI".
D) Factura
14. Forma de pago
Descripción: cómo se cobró la factura (efectivo, crédito, tarjeta de crédito/débito, transferencia, cheque, vale, tarjeta de regalo, punto de pago, etc.).
Impacto en el sistema: la factura electrónica la requiere.
Ejemplo de uso: seleccionas "Efectivo" o "Tarjeta de crédito" en la factura.
Qué ocurre cuando se utiliza: el comprobante refleja esa forma de pago.
Comportamiento del sistema: si no la indicas, el procesado puede fallar o el procesador rechazar la factura.
15. CUFE y 16. ID de factura Panamá (resultado, solo lectura)
Descripción: el CUFE (código único) y el identificador de la factura que devuelve el procesador tras certificarla.
Impacto en el sistema: confirman que la factura está certificada. No se escriben a mano.
Ejemplo de uso: aparecen tras pulsar "Procesar factura SAT".
Qué ocurre cuando se utiliza: cuando la factura tiene CUFE, es un comprobante fiscal válido.
Comportamiento del sistema: Golfmanager guarda el CUFE, el identificador y el XML autorizado, y registra la operación en el listado de transacciones de Factura Panamá.
Cómo se usa en el día a día (paso a paso)
Crea o abre la factura en Golfmanager.
Comprueba que estén los datos fiscales del cliente (RUC/cédula, dígito verificador, ubicación) y la forma de pago.
Pulsa la acción "Procesar factura SAT" en el detalle de la factura.
Revisa el resultado: si todo es correcto, la factura se certifica y Golfmanager guarda su CUFE e identificador.
ℹ️ Una vez procesada y con CUFE, la factura es un documento fiscal válido. Cualquier corrección debe seguir el procedimiento que admita la normativa (no se modifica sin más). El PDF/QR del comprobante lo gestiona el procesador; Golfmanager guarda el XML autorizado y el CUFE.
Conceptos fiscales clave
Concepto | Qué es |
CUFE | Código Único de Factura Electrónica que identifica el documento |
RUC | Identificación fiscal del emisor (y del cliente, si aplica) |
Establecimiento y Punto | Identifican el local y el punto de facturación en la numeración |
ITBMS / ISC / OTI | Los impuestos de Panamá (transferencia de bienes y servicios, selectivo al consumo, otros) |
Forma de pago | Cómo se cobró la factura (efectivo, tarjeta, transferencia…) |
Limitaciones a tener en cuenta
Depende del procesador y de la DGI: si el servicio no está disponible, no se puede procesar en ese momento.
Los datos fiscales deben estar completos (RUC, dígito verificador, ubicación, código de producto, impuesto y forma de pago); si faltan, el procesado falla.
Una factura con CUFE es un documento fiscal: su corrección sigue el procedimiento normativo (no se edita sin más).
El módulo procesa facturas; la anulación o nota de crédito se gestiona según el procedimiento de la DGI/tu procesador.
El PDF/QR del comprobante lo genera el procesador; Golfmanager guarda el XML autorizado y el CUFE.
Opera en USD y es específica de Panamá. No mezcles prueba con producción.
Preguntas frecuentes
Al procesar aparece "Falta la configuración de Factura Panamá" o que falta el RUC, el establecimiento, el punto o el endpoint.
Falta algún dato de conexión del modo en uso. Entra en Configuración > Factura Panamá y completa el RUC Emisor, el usuario, la clave, el endpoint, el establecimiento y el punto (los de prueba si estás en pruebas, los de producción si estás en producción) y guarda.
Me sale "Producto no tiene código de factura Panamá".
Ese producto no tiene asignado su código de Panamá. Rellena el "Código de producto Panamá" en la ficha del producto y vuelve a procesar.
Me sale "Código de impuesto faltante, use uno de los impuestos validos ISC, ITBMS u OTI".
El impuesto aplicado no tiene un código válido de Panamá. Revisa que tus impuestos usan los códigos de ITBMS, ISC u OTI y vuelve a procesar.
Me indica que faltan datos del cliente (ID nacional, dígito verificador o ubicación).
El receptor debe tener RUC/cédula, dígito verificador y datos de ubicación. Completa en la ficha del cliente la identificación nacional, el dígito verificador, el código de ubicación y la provincia/distrito/corregimiento, y vuelve a procesar. Los mensajes posibles son "Cliente no tiene ID nacional…", "Cliente no posee digito verificador…", "Cliente requiere un código de ubicación…" y "Falta información regional…".
Me sale que el cliente no tiene dirección, email o nacionalidad.
El procesador exige esos datos del receptor. Completa en la ficha del cliente la calle/dirección, el email y la nacionalidad, y vuelve a procesar.
La factura no se procesa por falta de forma de pago.
La factura electrónica requiere la forma de pago. Selecciónala en la factura (efectivo, tarjeta, transferencia, cheque, etc.) y vuelve a procesar.
No se obtiene el CUFE / el procesador no responde.
Puede que el servicio del procesador o la DGI no estén disponibles, o que el documento haya sido rechazado. Revisa el detalle del error en el registro de transacciones y reintenta cuando el servicio esté disponible.
El procesador rechaza la factura.
Suele deberse a datos fiscales incompletos o incorrectos (del cliente, de los impuestos o de los productos). El mensaje devuelto por el procesador indica el motivo; corrige el dato que señala y vuelve a procesar.
¿Puedo anular una factura o hacer una nota de crédito desde Golfmanager?
El módulo se encarga de procesar las facturas y obtener el CUFE. La anulación o la nota de crédito se gestionan según el procedimiento de la DGI y de tu procesador. Consulta con tu proveedor cómo proceder en cada caso.
¿Golfmanager genera el PDF y el código QR de la factura?
No. Golfmanager guarda el XML autorizado y el CUFE; el PDF/QR del comprobante lo genera y entrega el procesador autorizado. Consulta con tu proveedor cómo obtenerlo o enviarlo al cliente.
¿Cómo hago una prueba antes de facturar de verdad?
Deja el Modo de producción desactivado y usa las credenciales y datos de prueba; procesa una factura de ejemplo y comprueba que obtienes el CUFE. Cuando todo funcione, activa el Modo de producción con las credenciales reales.
¿En qué moneda se emiten las facturas?
En dólares estadounidenses (USD).
¿Qué impuestos admite?
Los de Panamá: ITBMS (con tarifas como 7%, 10% o 15%, además de exento), ISC (selectivo al consumo) y OTI (otros impuestos). Cada impuesto de tu Golfmanager debe usar el código correspondiente.
¿Puedo editar una factura que ya tiene CUFE?
No. Una factura con CUFE es un documento fiscal válido e inalterable. Cualquier corrección debe seguir el procedimiento que admita la normativa.
¿Dónde veo el resultado de cada factura procesada?
En la propia factura (CUFE e identificador) y en el registro de transacciones de Factura Panamá, donde queda el resultado, el XML autorizado y, si lo hubo, el mensaje de error.
¿Quién es el procesador y de dónde saco las credenciales?
Es el servicio "Factura Panamá" (un PAC autorizado) que contratas aparte. Tu proveedor te facilita el usuario, la clave y el endpoint, tanto de prueba como de producción.
Buenas prácticas recomendadas
Completa los datos fiscales de los clientes (RUC/cédula, dígito verificador, ubicación) antes de facturar.
Asigna el código de Panamá a los productos y revisa que los impuestos usan ITBMS/ISC/OTI.
Revisa los datos del emisor y del servicio (establecimiento y punto) al implantar.
Procesa una factura de prueba y comprueba el CUFE antes de operar en real.
Indica siempre la forma de pago en la factura.