Índice
Para quién es este artículo: aplica a los clubes que operan en República Dominicana y deben emitir comprobantes fiscales electrónicos (e-CF / e-NCF).
¿Qué es esta integración?
La integración con la Hacienda (DGII) de República Dominicana permite emitir comprobantes fiscales electrónicos (e-CF) desde Golfmanager cumpliendo la normativa dominicana. Cuando se firma una factura, Golfmanager la genera en formato electrónico (XML) y la envía al firmador de Voxel, que la firma digitalmente y devuelve los datos fiscales (el código de seguridad y el código QR) que se incorporan a la factura.
El firmador de Voxel es un pequeño programa (middleware) que se instala en un equipo del club. Recibe la factura electrónica, la firma con el certificado digital (que custodia el propio firmador) y la procesa hacia la Hacienda dominicana, devolviendo los datos fiscales que deben figurar en la factura.
¿Qué problema resuelve?
Cumplir la normativa fiscal dominicana: emite comprobantes fiscales electrónicos válidos sin procesos manuales.
Añade el QR y los datos fiscales (código de seguridad, NCF, fecha de firma) a la factura automáticamente.
Evita errores de clasificación fiscal al asociar tipos de factura, impuestos y formas de pago a sus denominaciones legales dominicanas.
Controla la numeración NCF (series, rangos, caducidad y avisos de agotamiento).
Deja rastro de cada intento de firma (correcto o fallido) en un registro de transacciones.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con el firmador de Voxel (instalado en la red del club) y, a través de él, con la Hacienda dominicana:
Golfmanager genera la factura en formato electrónico (XML) al confirmarla.
Al firmar, envía ese XML al firmador de Voxel de la red local.
El firmador la firma digitalmente y la procesa hacia la Hacienda.
El firmador devuelve el código de seguridad, con el que Golfmanager construye el QR y lo guarda en la factura.
El firmador se comunica por la red local del club (se configura su dirección IP).
¿Qué información se intercambia?
Información | Dirección | Para qué |
Factura en formato electrónico (XML) | Golfmanager → Firmador → Hacienda | Firmar y declarar el comprobante |
Código de seguridad (identificador) | Firmador → Golfmanager | Construir el QR y los datos fiscales |
Resultado del envío (correcto / error) | Firmador → Golfmanager | Confirmar la firma y dejar registro |
Requisitos previos (antes de activar la integración)
Tener el firmador de Voxel instalado y en marcha en un equipo del club, con su certificado digital cargado, accesible desde Golfmanager por su dirección IP.
Tener el módulo de Hacienda República Dominicana instalado (pídeselo a tu consultor de Golfmanager), junto con los módulos de facturación y clientes.
Tener configuradas las series NCF (rango de numeración y caducidad) para cada tipo de comprobante.
Tener asociadas las denominaciones legales de tipos de factura, impuestos y formas de pago. Sin esto, la firma dará error.
Tener la fecha de empresa y los datos fiscales del club (RNC) cumplimentados.
Permisos de facturación para configurar y firmar.
Cómo se configura (paso a paso)
Paso 1 — Instalar el módulo
Pide a tu consultor de Golfmanager que instale el módulo Hacienda Rep. Dominicana.
Paso 2 — Conexión con el firmador
Ve a Configuración > Facturación > Hacienda República Dominicana.
Introduce la Dirección IP del firmador de Voxel (el equipo donde está instalado; el puerto ya está implícito en el sistema, solo necesitas la IP).
Selecciona el Tipo de factura por defecto.
Decide si activas Firmar automáticamente al confirmar.
Guarda los cambios.
Paso 3 — Datos fiscales de la empresa
En la ficha de la empresa, comprueba que el RNC está cumplimentado y rellena la fecha de empresa (obligatoria para emitir comprobantes).
Guarda los cambios.
Paso 4 — Configurar las series NCF
En la configuración de las series de numeración de facturas, define para cada serie: número inicial, número final, caducidad, si está activa, y opcionalmente la alerta de números restantes y el email de alerta.
Guarda los cambios.
ℹ️ Cada serie corresponde a un tipo de comprobante (e-NCF). Cuando una serie llega a su número final o a su fecha de caducidad, deja de poder emitir y hay que dar de alta una nueva.
Paso 5 — Asociar las denominaciones legales
Indica a qué categoría fiscal dominicana corresponde cada elemento:
En cada tipo de factura, rellena Tipo factura Hacienda RD.
En cada forma de pago, rellena ID de forma de pago Hacienda RD.
En cada impuesto, rellena Código Hacienda RD.
Guarda en cada caso.
⚠️ Importante: si falta alguna de estas asociaciones, al intentar firmar la factura el sistema dará un error indicándolo. Conviene configurarlas todas antes de empezar.
Paso 6 — Datos del cliente
En la ficha de cada cliente, marca si su documento es extranjero (pasaporte/NIF extranjero) o nacional (RNC).
Si procede, asígnale un tipo de factura propio (sobrescribe el tipo por defecto para ese cliente).
Guarda los cambios.
Detalle de cada campo de configuración
A continuación se explica cada campo: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso. Se agrupan en: conexión, series NCF, denominaciones legales, y empresa/cliente.
Conexión y comportamiento (Configuración > Facturación > Hacienda República Dominicana)
Dirección IP del firmador de Voxel
Nombre del campo: Dirección IP del firmador (offline) de facturas.
Descripción: la IP del equipo de la red local donde está instalado el firmador de Voxel.
Impacto en el sistema: es por donde Golfmanager envía las facturas a firmar. Sin ella, no se puede firmar.
Comportamiento del sistema: si está vacía, al firmar aparece el aviso "La IP del firmador no está configurada". El puerto va implícito.
Ejemplo de uso / qué ocurre: pones la IP del equipo del firmador y guardas; a partir de ahí las facturas pueden firmarse.
Tipo de factura por defecto
Nombre del campo: Tipo de factura por defecto. Campo obligatorio.
Descripción: el tipo de factura que se aplica cuando no se especifica otro.
Impacto en el sistema: determina la serie/numeración y la denominación fiscal de las facturas que no tengan un tipo concreto.
Comportamiento del sistema: si no está definido, al guardar clientes/facturas el sistema avisa de que falta un tipo de factura por defecto.
Ejemplo de uso / qué ocurre: seleccionas "Factura de consumo electrónica" como predeterminada para las ventas a consumidor final.
Firmar automáticamente al confirmar
Nombre del campo: Firmar automáticamente al confirmar. Es un interruptor (activado/desactivado, por defecto desactivado).
Descripción: decide si cada factura se firma sola en cuanto se confirma.
Impacto en el sistema: activado, automatiza la firma; desactivado, hay que firmar a mano con el botón.
Comportamiento del sistema: con la firma automática, si el firmador no está accesible la factura no se firmará y se avisará; tendrás que reintentar la firma manualmente.
Ejemplo de uso / qué ocurre: lo activas para no tener que pulsar "Firmar" en cada factura; lo dejas desactivado si prefieres revisar antes de firmar.
Series NCF (en cada serie de numeración de facturas)
Número inicial
Nombre del campo: Número inicial.
Descripción: el primer número del rango autorizado de la serie.
Impacto en el sistema: marca desde dónde empieza a numerar la serie.
Comportamiento del sistema: si el contador queda por debajo del inicio, el sistema avisa de que el valor es inferior al inicio de la serie.
Ejemplo de uso / qué ocurre: pones el primer número del rango que te ha autorizado la DGII.
Número final
Nombre del campo: Número final.
Descripción: el último número del rango autorizado de la serie.
Impacto en el sistema: marca el límite de la serie.
Comportamiento del sistema: al alcanzarlo, la serie deja de poder emitir ("La serie ha alcanzado el último valor") y hay que crear una nueva.
Ejemplo de uso / qué ocurre: pones el último número del rango autorizado; cuando se agote, das de alta otra serie.
Caducidad
Nombre del campo: Caducidad.
Descripción: la fecha de vencimiento de la serie NCF.
Impacto en el sistema: después de esa fecha, la serie no puede emitir más comprobantes.
Comportamiento del sistema: al confirmar una factura con la serie caducada, el sistema avisa de que "La serie ha caducado". Esta fecha también se imprime en la factura.
Ejemplo de uso / qué ocurre: pones la fecha de vencimiento que te indica la DGII para ese rango.
Activa
Nombre del campo: Activa.
Descripción: indica si la serie está en uso.
Impacto en el sistema: solo las series activas pueden emitir.
Comportamiento del sistema: si la serie no está activa, al confirmar facturas con ella el sistema avisa de que "La serie no está activa".
Ejemplo de uso / qué ocurre: activas la serie en vigor y desactivas las que ya no uses.
Alerta de números restantes
Nombre del campo: Alerta de números restantes.
Descripción: cuántos números antes de agotar la serie quieres recibir un aviso.
Impacto en el sistema: sirve para anticiparte al agotamiento de la serie.
Comportamiento del sistema: cuando quedan ese número de comprobantes para llegar al final, se envía un aviso al email de alerta.
Ejemplo de uso / qué ocurre: pones 50 para que te avisen cuando falten 50 comprobantes y tramitar otra serie a tiempo.
Email de alerta
Nombre del campo: Email de alerta.
Descripción: la dirección a la que se envía el aviso de agotamiento de la serie.
Impacto en el sistema: es el destinatario del aviso anterior.
Comportamiento del sistema: recibe el correo cuando se alcanza el umbral de "alerta de números restantes".
Ejemplo de uso / qué ocurre: pones el email del administrador del club para que reciba el aviso.
Denominaciones legales
Tipo factura Hacienda RD (en cada tipo de factura)
Nombre del campo: Tipo factura Hacienda RD.
Descripción: asocia el tipo de factura de Golfmanager con la denominación legal dominicana.
Impacto en el sistema: define qué clase de e-CF se declara.
Comportamiento del sistema: si un tipo de factura no tiene esta asociación, al firmar el sistema avisa de que "el tipo de factura no está asociado a ningún tipo de Hacienda RD".
Opciones: Factura comercial electrónica (crédito fiscal); Factura de consumo electrónica; Factura de abono electrónica (nota de crédito); Nota de débito electrónica; Comprobante electrónico para regímenes especiales; Comprobante electrónico gubernamental.
ID de forma de pago Hacienda RD (en cada forma de pago)
Nombre del campo: ID de forma de pago de la Hacienda RD.
Descripción: relaciona cada forma de pago con su denominación legal dominicana.
Impacto en el sistema: clasifica el medio de pago en el comprobante.
Comportamiento del sistema: sin asociar, la factura puede no firmarse correctamente.
Opciones: Efectivo; Cheque, transferencia o depósito; Tarjeta de débito o crédito; Venta a crédito; Bonos o certificados de regalo; Nota de crédito.
Código Hacienda RD (en cada impuesto)
Nombre del campo: Código Hacienda RD.
Descripción: asocia cada impuesto a su denominación legal dominicana.
Impacto en el sistema: determina cómo se declara cada impuesto de la factura.
Comportamiento del sistema: si un impuesto de la factura no tiene código, al firmar el sistema avisa de que "el impuesto no tiene un código de la Hacienda dominicana asociado".
Opciones: ITBIS; ISC (impuesto selectivo al consumo); Ad Valorem; Exento; Propina legal; CDT (contribución al desarrollo de las telecomunicaciones).
Empresa y cliente
Fecha de empresa
Nombre del campo: Fecha de empresa (en la ficha de la empresa).
Descripción: fecha de referencia fiscal del club para la DGII.
Impacto en el sistema: es obligatoria para emitir comprobantes; se copia en cada factura al crearse.
Comportamiento del sistema: si falta, el sistema avisa de que "la fecha de empresa es obligatoria".
Ejemplo de uso / qué ocurre: la rellenas una vez con la fecha que corresponda y las facturas la heredan.
Documento extranjero (en la ficha del cliente)
Nombre del campo: Documento extranjero (NIF/pasaporte extranjero).
Descripción: indica si el documento del cliente es extranjero en lugar de un RNC nacional.
Impacto en el sistema: hace que el documento del cliente se declare correctamente como extranjero.
Comportamiento del sistema: ajusta el tratamiento fiscal del cliente en el comprobante.
Ejemplo de uso / qué ocurre: lo marcas en un cliente con pasaporte extranjero.
Tipo de factura del cliente (en la ficha del cliente)
Nombre del campo: Tipo de factura.
Descripción: el tipo de factura preferido para ese cliente (sobrescribe el tipo por defecto).
Impacto en el sistema: las facturas de ese cliente usan este tipo en lugar del global.
Comportamiento del sistema: si está vacío, se usa el tipo por defecto de la configuración.
Ejemplo de uso / qué ocurre: a un cliente empresa le asignas "Factura comercial electrónica (crédito fiscal)".
Cómo se usa en el día a día
Firmar una factura
Hay varias formas, según la configuración:
Automática: si activaste "Firmar automáticamente al confirmar", cada factura se firma sola al confirmarla.
Manual (una factura): en el detalle de la factura, en el menú de acciones, pulsa "Firmar factura". Golfmanager la envía al firmador y, si todo va bien, la factura queda firmada con su QR y código de seguridad. Verás el mensaje "Factura firmada correctamente".
Masiva (varias facturas): en el listado de facturas, selecciona varias y usa la acción de firmar facturas. El sistema te indica cuántas se firmaron correctamente.
Descargar el XML
En el detalle de la factura también está la acción "Descargar Voxel XML", que descarga el documento electrónico que se enviaría al firmador. Es útil para revisión o soporte. Solo está disponible si la factura está confirmada.
ℹ️ Una factura solo se puede firmar una vez. Una vez firmada, queda registrada su fecha de firma y, si intentas firmarla de nuevo, el sistema avisa de que "ya está firmada".
Las series NCF (numeración y caducidad)
Cada serie de numeración corresponde a un tipo de comprobante (e-NCF) y tiene un rango autorizado (número inicial y final), una fecha de caducidad y un estado activa/inactiva. Golfmanager controla automáticamente:
Que la serie esté activa y no caducada al emitir.
Que no se sobrepase el número final.
El envío de un aviso por email cuando quedan pocos números (según la "alerta de números restantes").
Cuando una serie se agota o caduca, hay que dar de alta una nueva con su rango y caducidad.
Qué aparece en la factura
Tras firmarse, la versión impresa o descargable (PDF) y el ticket de TPV incluyen:
El NCF / e-NCF (número del comprobante).
La caducidad de la secuencia (vencimiento de la serie).
El RNC del club y, si aplica, el del cliente.
El código QR fiscal.
La fecha de firma y el código de seguridad devuelto por el firmador.
Consultar las transacciones
El módulo guarda un registro de Transacciones HaciendaRD con cada intento de firma. Cada registro muestra:
La factura asociada.
El documento enviado (XML de la petición).
Si fue correcto o fallido.
La respuesta recibida del firmador.
Es la primera pantalla a revisar cuando una factura no se ha firmado correctamente. Se accede desde el menú de Facturación.
Limitaciones a tener en cuenta
Depende del firmador de Voxel: debe estar instalado, encendido y accesible por su IP, con su certificado digital cargado. Si no responde, no se pueden firmar facturas.
El certificado digital lo custodia el firmador, no Golfmanager; su vigencia se gestiona en el propio firmador.
Cada factura se firma una sola vez. Tras la firma queda bloqueada para nuevos envíos.
Hay que mapear las denominaciones legales (tipo de factura, impuesto, forma de pago) antes de firmar.
Las series NCF tienen rango y caducidad: hay que renovarlas antes de que se agoten o venzan.
Las facturas proforma e internas no se firman ni generan e-CF.
Es específica de República Dominicana: no aplica a otros países.
Preguntas frecuentes
¿Golfmanager envía las facturas directamente a la DGII?
No directamente: Golfmanager genera la factura electrónica y la envía al firmador de Voxel de la red local, que es quien la firma con el certificado digital y la procesa hacia la Hacienda dominicana. Golfmanager guarda el resultado y los datos fiscales (QR, código de seguridad).
¿Qué es el firmador de Voxel y dónde se instala?
Es un pequeño programa (middleware) que se instala en un equipo del club, en la red local. Custodia el certificado digital y firma las facturas. En Golfmanager solo configuras su dirección IP.
¿Cómo firmo una factura?
Tres formas: automáticamente al confirmar (si activas esa opción), manualmente con el botón "Firmar factura" en el detalle, o de forma masiva seleccionando varias facturas en el listado.
¿Puedo firmar una factura dos veces?
No. Una factura solo se firma una vez. Si lo intentas de nuevo, el sistema avisa de que "ya está firmada". Queda registrada su fecha de firma.
Al firmar, sale un aviso de que falta asociar una denominación. ¿Qué hago?
Falta el código fiscal dominicano en algún elemento. Revisa que el tipo de factura tenga su "Tipo factura Hacienda RD", que cada impuesto tenga su "Código Hacienda RD" y que cada forma de pago tenga su "ID de forma de pago Hacienda RD". Asócialos y vuelve a firmar.
Sale "El tipo de factura no está asociado a ningún tipo de Hacienda RD". ¿Qué reviso?
El tipo de factura usado no tiene relleno el campo Tipo factura Hacienda RD. Edítalo, selecciona la denominación que corresponda y guarda.
Sale "El impuesto no tiene un código de la Hacienda dominicana asociado". ¿Qué reviso?
Algún impuesto de la factura no tiene relleno el Código Hacienda RD. Ve a Impuestos, asígnale el código (ITBIS, ISC, etc.) y vuelve a firmar.
Sale "No se pudo contactar con el firmador de Voxel". ¿Qué hago?
El firmador está apagado o la IP es incorrecta. Comprueba que el firmador está encendido y accesible en la red y que la IP configurada es correcta; después vuelve a firmar.
Sale "La IP del firmador no está configurada". ¿Qué reviso?
Falta la dirección IP del firmador en la configuración. Ve a Configuración > Facturación > Hacienda República Dominicana e introdúcela.
Sale un "Voxel error: …". ¿Qué significa?
Es un error que devuelve el propio firmador (por ejemplo, un dato del comprobante que la Hacienda no acepta o un problema del certificado). Revisa el detalle en Transacciones HaciendaRD, corrige lo indicado y vuelve a firmar.
Sale "La serie ha caducado". ¿Qué hago?
La serie NCF ha superado su fecha de caducidad. Da de alta una nueva serie con su rango y una caducidad futura, y márcala como activa.
Sale "La serie ha alcanzado el último valor". ¿Qué hago?
La serie ha llegado a su número final y no puede emitir más. Crea una nueva serie con un rango nuevo autorizado por la DGII.
Sale "La serie no está activa". ¿Qué reviso?
La serie está marcada como inactiva. Edítala y márcala como activa (o usa otra serie que sí lo esté).
Sale "La fecha de empresa es obligatoria". ¿Qué reviso?
Falta la fecha de empresa en la ficha del club. Rellénala y vuelve a intentarlo; las facturas la heredan al crearse.
¿Cómo sé si una serie NCF se está agotando?
Configura en la serie la alerta de números restantes y un email de alerta: cuando queden esos comprobantes para llegar al final, el sistema envía un aviso a ese correo para que tramites una nueva serie a tiempo.
¿Qué tipos de comprobante admite?
Factura comercial electrónica (crédito fiscal), Factura de consumo electrónica, Factura de abono electrónica (nota de crédito), Nota de débito, Comprobante de régimen especial y Comprobante gubernamental. Cada tipo de factura de Golfmanager se asocia a uno de ellos.
¿Cómo gestiono las notas de crédito?
Usa un tipo de factura asociado a Factura de abono electrónica (nota de crédito). La nota de crédito debe referenciar la factura original; Golfmanager incluye esa referencia en el comprobante.
¿Puedo facturar a consumidor final sin RNC del cliente?
Sí. Para ventas a consumidor final se usa la factura de consumo electrónica; el comprobante se emite sin RNC del cliente (el QR se construye con los datos de la empresa y la factura).
Un cliente tiene pasaporte extranjero. ¿Cómo lo configuro?
En su ficha, marca el campo de documento extranjero. Así el documento se declara como extranjero en lugar de como RNC nacional.
¿Qué datos fiscales aparecen en la factura firmada?
El NCF, la caducidad de la secuencia, el RNC del club (y del cliente si aplica), el código QR, la fecha de firma y el código de seguridad.
¿Para qué sirve "Descargar Voxel XML"?
Descarga el documento electrónico que se enviaría al firmador, útil para revisión o soporte. Solo está disponible si la factura está confirmada.
Una factura no se ha firmado. ¿Dónde miro qué pasó?
En Transacciones HaciendaRD (menú de Facturación): cada intento de firma deja el XML enviado, si fue correcto o fallido y la respuesta del firmador. Ahí está el detalle del error.
¿Las facturas proforma o internas se firman?
No. Las facturas proforma e internas no generan comprobante electrónico ni se pueden firmar; usan su numeración interna.
¿La firma automática puede fallar?
Sí: si tienes activada la firma automática y el firmador no está accesible al confirmar, la factura no se firmará y se avisará. En ese caso, vuelve a firmarla manualmente cuando el firmador esté disponible.
¿Quién renueva o gestiona el certificado digital?
El certificado digital lo custodia el firmador de Voxel, no Golfmanager. Su carga y vigencia se gestionan en el propio firmador; si caduca, las firmas fallarán hasta renovarlo.
Buenas prácticas recomendadas
Configura todas las denominaciones legales (tipos de factura, impuestos y formas de pago) antes de empezar a firmar.
Mantén el firmador de Voxel siempre activo y con una IP estable en la red, y su certificado vigente.
Vigila las series NCF: configura la alerta de números restantes y renueva antes de que se agoten o caduquen.
Marca correctamente a los clientes extranjeros para que el comprobante salga bien.
Decide si usas la firma automática (al confirmar) o manual, según tu flujo de trabajo.
Ante un fallo, revisa primero Transacciones: ahí está el detalle del envío y la respuesta del firmador.