Tax authority credentials for FACTURA

In Hotelmente FACTURA → FACTURA settings, in these panels:
- What FACTURA invoices: which payments get an invoice.
- Numbering and environment: Test or Production, branch, point of sale, authorized ranges and other codes for your country.
- Sending to the tax authority: who transmits for your country (set by Hotelmente).
- Credentials for sending: your user, password or API key, and your certificate file with its PIN.

Only an owner can change them. Save each panel with its own button: Save what to invoice, Save tax settings, Save credentials.

In FACTURA settings → What FACTURA invoices, tick the sources:
- Hotelmente PAY payments.
- Direct bookings: website or booking engine, phone, walk-in, email and WhatsApp.
- Booking.com, Expedia and Airbnb: payments recorded in Cloudbeds for those reservations.
- Other channels: travel agents, other OTAs and corporate clients.

Then set Invoice payments from: only payments on or after that date are invoiced automatically; earlier ones can be invoiced from the Invoices page. Each source shows how many payments it had in the last 30 days. Click Save what to invoice.

Numbering and environment has an Environment field: Test (sandbox) or Production. Stay on Test until your first documents are accepted in the authority’s test environment. Test documents print a TEST ENVIRONMENT banner and have no tax value.

Most authorities give different credentials for test and production. When you switch, replace the credentials too.

Hotelmente asks for:
- ATV API user (it looks like [email protected]).
- ATV API password.
- Cryptographic key (.p12) file.
- Key PIN (4 digits).

Prerequisite: be registered in the RUT with at least one economic activity. Since 2025 Hacienda’s virtual office is TRIBU-CR; the user, password and key are generated in its Tico Factura module (the Hotelmente labels keep the name ATV). Official guides: production www.hacienda.go.cr/docs/GuiaCredencialesProduccionparaTicoFacturayotrossistemas.pdf and test www.hacienda.go.cr/docs/GuiaparaCredencialesEntornodepruebas.pdf

• Step 1: Sign in to Hacienda’s virtual office (TRIBU-CR).
• Step 2: In the Tico Factura block, click Crear usuario and choose No, voy a utilizar otro programa. The API user and password arrive at your RUT email and appear under Mi perfil.
• Step 3: Click Generar llave criptográfica, enter a 4-digit PIN twice, click Generar and download the .p12 file.
• Step 4: For the test environment, choose the option for a test user; the test credentials appear under Mi perfil → Credenciales pruebas. Generate a test key the same way.
• Step 5: In Hotelmente, FACTURA settings → Credentials for sending: upload the .p12, type the PIN, user and password, click Save credentials.

Also fill in branch (3 digits), terminal (5 digits, one no other invoicing system uses), CABYS codes and location codes in Numbering and environment. Menu names can change; see the official guides above.

Hotelmente asks for:
- MH API user (your NIT).
- MH API password.
- MH certificate file (.crt or .xml).
- Private key password.

How to get them: request entry as a DTE issuer at factura.gob.sv/ (Solicitud de Ingreso), using the Sistema de Transmisión, which is for your own or third-party software. On the issuers site admin.factura.gob.sv/login you complete accreditation once for the test environment and once for production: you generate the signature certificate (you set a public and a private key password) and the API access password. Then run the minimum tests and get authorization for production. Manual: factura.gob.sv/informacion-tecnica-y-funcional/

Also fill in NRC, economic activity code, establishment and point of sale codes in Numbering and environment.

In Guatemala, invoices are certified by a certificador authorized by SAT. You contract one, accredit it in SAT’s Agencia Virtual, and the certificador gives you your access. Hotelmente asks for:
- Certificador API user.
- Certificador API key.
- Signing user (if separate) and signing key or token.

In Numbering and environment you also enter the SAT establishment code, IVA affiliation, FEL phrases, and the certificador’s name and NIT as printed. SAT’s list of certificadores: portal.sat.gob.gt/portal/certificador-de-dte/ and issuer information: portal.sat.gob.gt/portal/emisor-de-dte/

Each certificador names its credentials differently: ask yours for the API user and key for integration with an external system, in test and production.

In Honduras invoices are numbered inside ranges that SAR authorizes, each with a CAI and a deadline to issue (fecha límite de emisión). An authorization lasts at most one year. What Hotelmente needs today:
- In Numbering and environment: establishment (3 digits), emission point (3 digits) and your Authorized ranges (CAI): for each document type, the CAI, first and last authorized numbers and the deadline.

You request the ranges from SAR as a self-printer (autoimpresor) through SAR’s virtual office: oficinavirtual.sar.gob.hn/ and www.sar.gob.hn/facturacion/

The fields in Credentials for sending (SAR or provider user, password or API key, certificate) are for SAR’s electronic invoicing service; leave them empty until SAR announces it for your business. Hotelmente warns you when a range is almost used up or about to expire.

In Panamá electronic invoices go through a PAC (Proveedor de Autorización Calificado) authorized by DGI. Steps:
- Step 1: Get your electronic signature certificate from the Dirección Nacional de Firma Electrónica: dgi.mef.gob.pa/_7FacturaElectronica/RCfirmaE
- Step 2: File the sworn declaration of adoption of SFEP in e-Tax 2.0, choosing a PAC. How: dgi.mef.gob.pa/_7FacturaElectronica/R-Emisorfe
- Step 3: Contract a PAC from the official list: dgi.mef.gob.pa/_7FacturaElectronica/Proveedorespac and confirm the affiliation in e-Tax 2.0. The PAC provides the test environment.

Hotelmente asks for: PAC user or token id, PAC API token or password, and, if you sign yourself, your qualified certificate (.p12) and its PIN. In Numbering and environment: RUC type, check digits (DV), branch code, invoicing point and location codes.

DGI’s free invoicer (Facturador gratuito) is for small taxpayers, with limits on yearly income and on documents per month set by DGI. Most hotels exceed them and use a PAC. Hotelmente FACTURA works through a PAC, not through the free invoicer. Limits: dgi.mef.gob.pa/_7FacturaElectronica/f-Gratuito

Nicaragua’s DGI authorizes computerized invoicing systems and the series and ranges of invoice numbers; the DGI authorization is printed on each invoice. What Hotelmente needs today:
- In Numbering and environment: branch or till, and your Authorized series and ranges (DGI): for each document type, the series letter, first and last authorized numbers, the DGI authorization and its deadline (if any).

The fields in Credentials for sending (DGI or provider user, password or API key, certificate) are for DGI electronic invoicing; leave them empty until DGI requires it for your business. DGI’s site: www.dgi.gob.ni/

• Step 1: In Credentials for sending, click the certificate field and choose the original file (.p12, .pfx, .crt or .xml, depending on your country).
• Step 2: Type its PIN or password in the next field.
• Step 3: Click Save credentials. A ✓ appears next to each saved field.

Certificates are small files. If you see That file is too large for a certificate., you chose another file. If you see Upload the certificate file again., the file is damaged or not a certificate.

They are encrypted and stored for your hotel only. They are never shown again, not even to you: secrets show nothing, and user fields show only their last characters. Leaving a field empty keeps the saved value. Remove credentials deletes them. Only owners can see this panel.

Sending to the tax authority says who transmits for your country. While it says Not connected yet, documents are prepared and numbered but stay Ready to send until Hotelmente switches on sending for your country. Your credentials stay saved in the meantime.

Yes, often:
- Certificates and cryptographic keys have an expiry date set by the issuer. Generate a new one before it expires and upload it again.
- Honduras and Nicaragua ranges have a last number and a deadline. Request the next range early and add it in Numbering and environment.
- If you generate a new key or password at the authority, the old one may stop working: update Hotelmente the same day.

Yes, if the numbering does not collide. Give Hotelmente its own point of sale, terminal or range that no other system uses (in Costa Rica, a terminal number of its own). Ask your accountant which one to use, and which payments each system should invoice, so no payment is invoiced twice.

• Your tax ID, legal name and economic activity code.
• The tax rates (the rates Hotelmente shows are starting points).
• Which payments FACTURA should invoice and from which date.
• Branch, point of sale or terminal numbers, and authorized ranges.
• Whether guests get a ticket or an invoice by default, and when to use export invoices or credit notes.

Yes. Fill in FACTURA settings, including your credentials, in advance: everything you enter is ready the day FACTURA is switched on for your country. Keep the environment on Test until then.