Credenciales de la autoridad tributaria

En Hotelmente FACTURA → Configuración FACTURA, en estos paneles:
- Qué factura FACTURA: qué pagos reciben factura.
- Numeración y ambiente: Pruebas o Producción, sucursal, punto de venta, rangos autorizados y otros códigos de su país.
- Envío a la autoridad tributaria: quién transmite para su país (lo define Hotelmente).
- Credenciales para el envío: su usuario, contraseña o llave de API, y su archivo de certificado con su PIN.

Solo un propietario puede cambiarlos. Guarde cada panel con su botón: Guardar qué facturar, Guardar configuración fiscal, Guardar credenciales.

En Configuración FACTURA → Qué factura FACTURA, marque las fuentes:
- Pagos de Hotelmente PAY.
- Reservas directas: sitio web o motor de reservas, teléfono, sin reserva previa, correo y WhatsApp.
- Booking.com, Expedia y Airbnb: pagos registrados en Cloudbeds para esas reservas.
- Otros canales: agencias de viaje, otras OTA y clientes corporativos.

Luego indique Facturar pagos desde: solo los pagos de esa fecha en adelante se facturan automáticamente; los anteriores se pueden facturar desde la página Facturas. Cada fuente muestra cuántos pagos tuvo en los últimos 30 días. Haga clic en Guardar qué facturar.

Numeración y ambiente tiene un campo Ambiente: Pruebas (sandbox) o Producción. Permanezca en Pruebas hasta que sus primeros documentos sean aceptados en el ambiente de pruebas de la autoridad. Los documentos de prueba muestran la leyenda AMBIENTE DE PRUEBAS y no tienen valor fiscal.

La mayoría de las autoridades entrega credenciales distintas para pruebas y producción. Al cambiar, reemplace también las credenciales.

Hotelmente pide:
- Usuario de API de ATV (tiene la forma [email protected]).
- Contraseña de API de ATV.
- Archivo de llave criptográfica (.p12).
- PIN de la llave (4 dígitos).

Requisito: estar inscrito en el RUT con al menos una actividad económica. Desde 2025 la oficina virtual de Hacienda es TRIBU-CR; el usuario, la contraseña y la llave se generan en su módulo Tico Factura (las etiquetas de Hotelmente conservan el nombre ATV). Guías oficiales: producción www.hacienda.go.cr/docs/GuiaCredencialesProduccionparaTicoFacturayotrossistemas.pdf y pruebas www.hacienda.go.cr/docs/GuiaparaCredencialesEntornodepruebas.pdf

• Paso 1: Entre a la oficina virtual de Hacienda (TRIBU-CR).
• Paso 2: En el bloque Tico Factura, haga clic en Crear usuario y elija No, voy a utilizar otro programa. El usuario y la contraseña de API llegan al correo registrado en el RUT y aparecen en Mi perfil.
• Paso 3: Haga clic en Generar llave criptográfica, escriba dos veces un PIN de 4 dígitos, haga clic en Generar y descargue el archivo .p12.
• Paso 4: Para el ambiente de pruebas, elija la opción de usuario de pruebas; las credenciales de prueba aparecen en Mi perfil → Credenciales pruebas. Genere una llave de prueba de la misma forma.
• Paso 5: En Hotelmente, Configuración FACTURA → Credenciales para el envío: suba el .p12, escriba el PIN, el usuario y la contraseña, y haga clic en Guardar credenciales.

Complete también la sucursal (3 dígitos), la terminal (5 dígitos, una que ningún otro sistema de facturación use), los códigos CABYS y los códigos de ubicación en Numeración y ambiente. Los nombres de los menús pueden cambiar; vea las guías oficiales de arriba.

Hotelmente pide:
- Usuario de API del MH (su NIT).
- Contraseña de API del MH.
- Archivo del certificado del MH (.crt o .xml).
- Contraseña de la llave privada.

Cómo obtenerlos: solicite el ingreso como emisor de DTE en factura.gob.sv/ (Solicitud de Ingreso), por el Sistema de Transmisión, que es para software propio o de terceros. En el sitio de emisores admin.factura.gob.sv/login complete el acreditamiento una vez para el ambiente de pruebas y otra para producción: genera el certificado de firma (define una clave pública y una clave privada) y la contraseña de acceso a la API. Luego haga las pruebas mínimas y obtenga la autorización para producción. Manuales: factura.gob.sv/informacion-tecnica-y-funcional/

Complete también el NRC, el código de actividad económica y los códigos de establecimiento y punto de venta en Numeración y ambiente.

En Guatemala las facturas las certifica un certificador autorizado por la SAT. Usted contrata uno, lo acredita en la Agencia Virtual de la SAT y el certificador le entrega su acceso. Hotelmente pide:
- Usuario de API del certificador.
- Llave de API del certificador.
- Usuario de firma (si es distinto) y llave o token de firma.

En Numeración y ambiente ingresa además el código de establecimiento de la SAT, la afiliación al IVA, las frases FEL y el nombre y NIT del certificador como se imprimen. Lista de certificadores de la SAT: portal.sat.gob.gt/portal/certificador-de-dte/ e información para emisores: portal.sat.gob.gt/portal/emisor-de-dte/

Cada certificador nombra sus credenciales a su manera: pida al suyo el usuario y la llave de API para integración con un sistema externo, en pruebas y en producción.

En Honduras las facturas se numeran dentro de rangos que autoriza el SAR, cada uno con un CAI y una fecha límite de emisión. Una autorización dura como máximo un año. Lo que Hotelmente necesita hoy:
- En Numeración y ambiente: establecimiento (3 dígitos), punto de emisión (3 dígitos) y sus Rangos autorizados (CAI): para cada tipo de documento, el CAI, el primer y último número autorizados y la fecha límite.

Los rangos se solicitan al SAR como autoimpresor en la oficina virtual del SAR: oficinavirtual.sar.gob.hn/ y www.sar.gob.hn/facturacion/

Los campos de Credenciales para el envío (usuario del SAR o del proveedor, contraseña o llave de API, certificado) son para el servicio de facturación electrónica del SAR; déjelos vacíos hasta que el SAR lo anuncie para su empresa. Hotelmente le avisa cuando un rango está por agotarse o por vencer.

En Panamá las facturas electrónicas pasan por un PAC (Proveedor de Autorización Calificado) autorizado por la DGI. Pasos:
- Paso 1: Obtenga su certificado de firma electrónica en la Dirección Nacional de Firma Electrónica: dgi.mef.gob.pa/_7FacturaElectronica/RCfirmaE
- Paso 2: Presente la declaración jurada de adopción del SFEP en e-Tax 2.0, eligiendo un PAC. Cómo: dgi.mef.gob.pa/_7FacturaElectronica/R-Emisorfe
- Paso 3: Contrate un PAC de la lista oficial: dgi.mef.gob.pa/_7FacturaElectronica/Proveedorespac y confirme la afiliación en e-Tax 2.0. El PAC ofrece el ambiente de pruebas.

Hotelmente pide: usuario o id de token del PAC, token o contraseña de API del PAC y, si usted firma, su certificado calificado (.p12) y su PIN. En Numeración y ambiente: tipo de RUC, dígito verificador (DV), código de sucursal, punto de facturación y códigos de ubicación.

El Facturador gratuito de la DGI es para contribuyentes pequeños, con límites de ingresos anuales y de documentos por mes que fija la DGI. La mayoría de los hoteles los supera y usa un PAC. Hotelmente FACTURA funciona a través de un PAC, no del facturador gratuito. Límites: dgi.mef.gob.pa/_7FacturaElectronica/f-Gratuito

La DGI de Nicaragua autoriza los sistemas de facturación computarizados y las series y rangos de numeración de facturas; la autorización de la DGI se imprime en cada factura. Lo que Hotelmente necesita hoy:
- En Numeración y ambiente: sucursal o caja, y sus Series y rangos autorizados (DGI): para cada tipo de documento, la letra de serie, el primer y último número autorizados, la autorización de la DGI y su fecha límite (si la hay).

Los campos de Credenciales para el envío (usuario de la DGI o del proveedor, contraseña o llave de API, certificado) son para la facturación electrónica de la DGI; déjelos vacíos hasta que la DGI la exija para su empresa. Sitio de la DGI: www.dgi.gob.ni/

• Paso 1: En Credenciales para el envío, haga clic en el campo del certificado y elija el archivo original (.p12, .pfx, .crt o .xml, según su país).
• Paso 2: Escriba su PIN o contraseña en el campo siguiente.
• Paso 3: Haga clic en Guardar credenciales. Aparece un ✓ junto a cada campo guardado.

Los certificados son archivos pequeños. Si ve Ese archivo es demasiado grande para un certificado., eligió otro archivo. Si ve Vuelva a subir el archivo del certificado., el archivo está dañado o no es un certificado.

Se guardan cifrados y solo para su hotel. No se vuelven a mostrar, ni siquiera a usted: los secretos no muestran nada y los campos de usuario solo sus últimos caracteres. Si deja un campo vacío, se mantiene el valor guardado. Eliminar credenciales los borra. Solo los propietarios ven este panel.

Envío a la autoridad tributaria indica quién transmite para su país. Mientras diga que aún no está conectado, los documentos se preparan y numeran pero quedan en estado Listo para enviar hasta que Hotelmente active el envío para su país. Sus credenciales siguen guardadas mientras tanto.

Sí, a menudo:
- Los certificados y las llaves criptográficas tienen una fecha de vencimiento que fija quien los emite. Genere uno nuevo antes de que venza y súbalo de nuevo.
- Los rangos de Honduras y Nicaragua tienen un último número y una fecha límite. Solicite el siguiente rango con tiempo y agréguelo en Numeración y ambiente.
- Si genera una llave o contraseña nueva en la autoridad, la anterior puede dejar de funcionar: actualice Hotelmente el mismo día.

Sí, si la numeración no choca. Dé a Hotelmente su propio punto de venta, terminal o rango que ningún otro sistema use (en Costa Rica, un número de terminal propio). Consulte a su contador cuál usar y qué pagos debe facturar cada sistema, para que ningún pago se facture dos veces.

• Su identificación tributaria, razón social y código de actividad económica.
• Las tasas de impuestos (las que muestra Hotelmente son un punto de partida).
• Qué pagos debe facturar FACTURA y desde qué fecha.
• Los números de sucursal, punto de venta o terminal, y los rangos autorizados.
• Si a los huéspedes se les emite tiquete o factura por defecto, y cuándo usar facturas de exportación o notas de crédito.

Sí. Complete por adelantado la Configuración FACTURA, incluidas sus credenciales: todo lo que ingrese estará listo el día en que FACTURA se active en su país. Mantenga el ambiente en Pruebas hasta entonces.