Conectar con Hacienda

Cuando estés listo para operar, debes conectar tu cuenta con el Ministerio de Hacienda (MH). Hay tres caminos distintos según tu situación, y todos comparten un requisito: una suscripción activa (ver tutorial 07). Después de pagar, Facturo te presenta un selector de camino.

Elige tu camino

Tras activar la suscripción, verás tres tarjetas:

1. Configurar emisión electrónica — para negocios nuevos o que usaban el facturador gratuito del MH. Es la ruta completa demo → sandbox → producción (Camino A).
2. Migrar desde otro sistema — para negocios ya certificados con el MH en otro software. Van directo demo → producción (Camino B).
3. Solo facturación interna — control interno sin transmitir a Hacienda; los documentos llevan código LOCAL-xxxx (Camino C).

⚠️ Antes de empezar, ten claro esto: cada transición de etapa borra los datos operativos de la etapa anterior (clientes, productos, facturas, pagos, DTE, asientos) para que el nuevo ambiente nazca limpio. Se conservan la identidad del negocio, la configuración del emisor, las credenciales y el plan contable. La única excepción es el Camino B, que continúa tu numeración.

Camino A · Certificación nueva (demo → sandbox → producción)

Ruta: Configuración → Activar cuenta.

Paso 1 — Datos fiscales del emisor

Completa el formulario del emisor:

• Nombre comercial, Nombre comercial (MH), Razón social, NIT (formato 0614-XXXXXX-XXX-X), NRC.
• Actividad económica (catálogo CAT-019; al elegirla se rellena la descripción oficial).
• Tipo de establecimiento (Sucursal, Casa Matriz, Bodega, Patio, Predio), Código de establecimiento (ej. M001), Código de punto de venta (ej. P001) y, si Hacienda te los asignó, sus códigos MH.
• Departamento, Municipio y Dirección completa.
• Teléfono y Correo.

Paso 2 — Certificado y credenciales de sandbox

• Certificado digital (sandbox): sube el archivo .crt y escribe su contraseña.
• Credenciales API MH (sandbox): Usuario (NIT) y Contraseña del sistema de transmisión del MH. El botón “Probar conexión” se habilita al estar en sandbox.

Paso 3 — Pasar a Sandbox

Cuando el panel de estado indique “Todo listo para pasar a Sandbox”, pulsa el botón de transición.

⚠️ Al pasar a Sandbox: se borran los datos de demo, tu cuenta pierde el límite de 30 días y el modo de emisión cambia a Hacienda (los DTE ya llegan al ambiente de pruebas del MH). Se re-crean automáticamente “Casa Matriz” y “Caja Principal”.

Paso 4 — Pruebas DTE

Ruta: Configuración → Pruebas DTE. Solo está disponible en sandbox o producción.

1. Pulsa “Iniciar pruebas” para ejecutar el lote de certificación que exige Hacienda (FC, CCF, NC, ND, FEX, FSE y más).
2. Verás el progreso en vivo: porcentaje, Aprobadas / Fallidas / Pendientes, tiempo transcurrido y velocidad.
3. Puedes Pausar/Reanudar, ejecutar solo un tipo de DTE y revisar el log de transmisión (con el sello de Hacienda o el mensaje de error de cada documento).
4. Si algunas fallan, usa “Reintentar los fallidos”.

Cuando todas las pruebas pasen, aparece el banner “Pruebas mínimas aprobadas” con el botón “Pasar a Producción”.

Paso 5 — Credenciales de producción

Ruta: Configuración → Credenciales de producción. Sube el certificado .crt y las credenciales API del ambiente productivo de Hacienda.

No reutilices el certificado ni las credenciales de sandbox: deben provenir del ambiente productivo del MH.

Paso 6 — Pasar a Producción

Confirma la transición.

⚠️ Al pasar a producción se borran los datos de sandbox (facturas, pagos, DTE, asientos, clientes, productos, etc.), los correlativos se reinician en 0 y tu cuenta queda certificada. Se conserva la configuración del emisor y las credenciales. Esta acción no se puede deshacer.

Camino B · Migrar desde otro sistema

Para negocios ya certificados con el MH en otro software. Va directo demo → producción, saltándose sandbox y las pruebas DTE.

Ruta: Configuración → Cambiar a producción (migrado). Pasos:

1. Suscripción y datos fiscales: confirma la suscripción activa y los datos del emisor.
2. Credenciales de producción: sube el certificado y las credenciales del ambiente productivo, y pulsa “Probar conexión (producción)” para verificar la autenticación contra el MH.
3. Correlativo actual por tipo de DTE: indica el último número emitido en tu sistema anterior para FCF, CCF, NC y FEX. Cada tipo continúa su numeración de forma independiente (Hacienda rechaza números repetidos, así que se sigue desde el siguiente).
4. Activar Producción: solo se habilita si los datos están completos, la conexión fue verificada y los correlativos son válidos. El diálogo te muestra desde qué número continúa cada tipo.

Camino C · Solo facturación interna (local)

Para llevar control interno sin transmitir a Hacienda. Los documentos usan códigos LOCAL-xxxx con un sello de integridad.

Ruta: Configuración → Cambiar a producción (local). Requisitos mínimos:

1. Suscripción activa.
2. Solo son obligatorios el Nombre Comercial y un NIT válido.
3. Pulsa “Activar”.

Al activar se borran los datos de demo y los correlativos se reinician en 0. Los documentos no se transmiten a Hacienda. Podrás certificarte más adelante cuando quieras dar el salto a emisión oficial.

Integraciones: mantener tus credenciales

Ruta: Configuración → Integraciones (oculta en modo demo). Desde aquí puedes revisar y actualizar en cualquier momento la conexión con Hacienda:

• Credenciales MH: Usuario (NIT) y Contraseña del sistema de transmisión.
• Certificado de firma digital: archivo .crt y su contraseña (llave privada).
• Datos fiscales del emisor: actividad económica (CAT-019), nombre comercial, tipo y código de establecimiento, código de punto de venta, departamento, municipio, distrito (CAT-008, por la reforma territorial de 2024) y dirección; más el interruptor “Agente de retención de IVA” (actívalo solo si el MH te designó; habilita emitir Comprobantes de Retención DTE 07).
• Verificar conexión con el API del MH.
• Terminales POS: registra las terminales de tarjeta y sus comisiones para los cobros y las liquidaciones.