Objetivo #

El objetivo de este manual es proporcionar una guía clara, estructurada y detallada para la configuración paso a paso de una API de CFDI (Comprobante Fiscal Digital por Internet) dentro de LOVIS EOS, con el propósito de garantizar una integración correcta, una operación eficiente y una validación adecuada del proceso de facturación electrónica.

Procedimiento #

Paso 1. Acceso a la función de configuración de API #

En el menú principal de LOVIS EOS, ve a Archivo y selecciona Compañías de la Suscripción.

Busca y selecciona la empresa de tu suscripción que deseas configurar. A continuación, haz clic en Partidas o presiona Alt + P.

Al hacer clic en Partidas, el sistema te mostrará el formulario donde seleccionarás el proveedor de Facturación Electrónica, ingresarás tus credenciales y definirás si lo activarás en modo de prueba o modo productivo.

Paso 2. Configuración de API del CFDI #

En el campo Application ID, selecciona tu proveedor de timbrado de CFDI.

Una vez seleccionado el PAC de CFDI, ingresa en uno o más campos, según corresponda, las credenciales que te haya proporcionado tu PAC de timbrado de CFDI:

• Application Token
• Application Token Test
• Application API Key
• Application Secret
• Application UserID
• Application Password

Asegúrate de capturar la información exactamente como fue entregada para evitar errores de conexión o validación.

Activa la casilla Application Testing para indicar que estás utilizando el ambiente de prueba o desactívalo si entras en modo de producción.

• En ambiente de prueba, los CFDIs generados no se timbran ante el SAT (solo pruebas).

• En ambiente de producción, Los CFDIs emitidos sí se timbran y tienen validez fiscal.

Guía obtención credenciales para los PAC disponibles en LOVIS EOS #

A continuación, te mostramos los campos que debes utilizar y la forma en que se obtienen las credenciales para cada uno de los PAC disponibles en LOVIS EOS.

Facturapi #

Abre tu navegador y ve al sitio oficial de Facturapi: → https://www.facturapi.io

Accede al dashboard (panel) con tus credenciales.

Una vez dentro del dashboard de Facturapi, busca en el menú lateral o superior la sección llamada Integración o Integration. Suele llamarse Integration / API Keys. En esa sección verás un área dedicada a API Keys.

Las Credenciales de prueba (Test Secret Key)

Estas llaves permiten desarrollar e integrar sin timbrar CFDIs reales:

1. Dentro de API Keys, ubica el bloque o fila que dice Test Secret Key.
2. Si aún no la has generado:
   • Haz clic en + Crear nueva llave (o botón similar).
   • La plataforma te generará automáticamente la llave.
3. Copia esa llave y guárdala en un lugar seguro (p. ej., un gestor de secretos o variables de entorno).

Importante: Las llaves de prueba solo funcionan contra el ambiente de desarrollo y no generan CFDIs fiscales reales ante el SAT.

Credenciales de producción (Live Secret Key)

Estas llaves sirven para emitir CFDIs con validez fiscal:

1. Asegúrate de tener una organización activa en tu cuenta y haber subido tus datos fiscales (incluyendo los archivos del Certificado de Sello Digital – CSD). Esto por lo general se hace en secciones como Org & Settings o Configuración fiscal dentro del dashboard.
2. En la misma pantalla de API Keys, ubica el área que dice Live Secret Key. Si no ves ninguna llave disponible, usa el botón + Crear nueva llave justo debajo de esa sección.
3. Al generar la Live Secret Key, cópiala de inmediato y guárdala de manera segura, ya que suele mostrarse solo una vez.

Resúmen

Facturapi distingue dos ambientes independientes:

Ambiente	Llave a usar	Efecto
Test (pruebas)	Test Secret Key	CFDIs generados no se timbran ante el SAT (solo pruebas).
Live (producción)	Live Secret Key	Los CFDIs emitidos sí se timbran y tienen validez fiscal.

Para autenticar cada solicitud a la API, solo debes usar la llave correspondiente dependiendo del ambiente en el que estés operando.

En LOVIS EOS las llaves Test Secret Key para pruebas y Live Secret Key se capturan en los siguientes apartados:

• Application Token: para la llave del ambiente de producción.
• Application Token Test: para la llave del ambiente de pruebas

Facturama #

Facturama autentica su API mediante autorización BASIC (Basic Authentication). Este método de autenticación HTTP es simple: te permite identificarte ante el servidor enviando tu usuario y contraseña en cada solicitud.

Cómo funciona la autenticación BASIC

1. Toma tu usuario y tu contraseña.
2. Concaténalos usando dos puntos, con este formato: usuario:contraseña.
3. Codifica ese texto en Base64.
4. Envía el resultado en el encabezado HTTP Authorization.

Ejemplo: Authorization: Basic dXNlY…

Credenciales API

Usa las mismas credenciales (usuario y contraseña) con las que accedes al portal de Facturama para generar la autorización BASIC. Aplica igual para el ambiente de pruebas y para el ambiente productivo.

Puedes generar tu autorización BASIC a través del siguiente enlace a partir de tus credenciales con las que accedes a Facturama

https://www.blitter.se/utils/basic-authentication-header-generator/

Una vez que obtengas la llave de autorización BASIC para pruebas y producción pégalas en los siguientes campos de LOVIS EOS

Configuración de Series y Folios #

Facturapi #

Paso 1. Acceso

Accede a Facturapi https://www.facturapi.io con tus credenciales e ir al Panel de Control.

Paso 2. Acceso al apartado de Conteo de Folios

Para acceder al apartado de Conteo de Folios:

1. Selecciona Configuración en el menú del Panel Izquierdo
2. Selecciona Conteo de Folios

Paso 3. Creación de Serie

Haz clic en el botón Crear Serie que se encuentra en la parte superior a la derecha de Conteo de folios

Al hacer clic en Crear Serie, el sistema te mostrará el siguiente cuadro de dialogo.

En el campo Series, escribe la serie del documento tal cual se muestra en LOVIS EOS.

En el campo Folio live escribe el folio siguiente que emitirá LOVIS EOS. En el ejemplo de la imagen, el siguiente folio que emitirá LOVIS EOS sería el 890.

Una vez capturado presiona el botón verde que dice Crear Serie de este mismo cuadro de dialogo.

Hacer lo mismo para las Series CA01 y BI01

Paso 4. Establecer las series por defecto

Ir al panel Conteo de Folios y seleccionar la Serie por defecto que se utilizará en cada uno de los comprobantes fiscales, como se muestra en la siguiente imagen:

Y luego presionar el botón de guardar.