Configuración Inicial

Configurar tu cuenta de Lummy es sencillo y toma solo unos minutos. Sigue estos pasos para empezar a emitir facturas electrónicas.

---

Paso 1: Crear una Cuenta

1. Visita https://lummy.io/signup
2. Completa el formulario de registro con tus datos fiscales
3. Verifica tu correo electrónico

Sandbox vs Producción

Al registrarte, tendrás acceso automático al ambiente Sandbox para pruebas. El ambiente de Producción requiere activación manual y CSD vigente.

---

Paso 2: Obtener tu API Key

1. Inicia sesión en dashboard.lummy.io
2. Navega a Configuración → API Keys
3. Haz clic en "Generar Nueva API Key"
4. Copia y guarda la API Key en un lugar seguro

Seguridad

• Nunca expongas tu API Key en repositorios públicos ni en código cliente (frontend)
• Usa variables de entorno en producción
• Rota tus keys periódicamente

Ejemplo: Guardar API Key en Variables de Entorno

Linux / macOS

# Agregar a ~/.bashrc o ~/.zshrc
export LUMMY_API_KEY="lummy_live_abc123..."
export LUMMY_ORG_ID="550e8400-e29b-41d4-a716-446655440000"

# Recargar configuración
source ~/.bashrc

Windows

# PowerShell
[Environment]::SetEnvironmentVariable("LUMMY_API_KEY", "lummy_live_abc123...", "User")
[Environment]::SetEnvironmentVariable("LUMMY_ORG_ID", "550e8400-e29b-41d4-a716-446655440000", "User")

Docker

# docker-compose.yml
services:
  app:
    environment:
      - LUMMY_API_KEY=lummy_live_abc123...
      - LUMMY_ORG_ID=550e8400-e29b-41d4-a716-446655440000

---

Paso 3: Cargar tu Certificado de Sello Digital (CSD)

Para emitir CFDIs válidos, necesitas cargar tu CSD emitido por el SAT.

¿Qué es el CSD?

El Certificado de Sello Digital es un archivo digital emitido por el SAT que contiene:

• Certificado (.cer): Llave pública
• Llave privada (.key): Llave privada protegida por contraseña

Cómo Obtener tu CSD

1. Entra al portal del SAT con tu e.firma
2. Navega a Trámites → Generación de certificado de sello digital
3. Descarga los archivos .cer y .key

Cargar CSD en Lummy

1. En el dashboard, ve a Configuración → Certificados
2. Selecciona tu sucursal (o crea una nueva)
3. Sube los archivos:
   • Certificado (.cer)
   • Llave privada (.key)
   • Ingresa la contraseña de la llave privada
4. Haz clic en "Guardar y Validar"

CSD de Prueba

Para Sandbox, puedes usar el CSD de prueba del SAT:

• Descargar CSD de prueba

---

Paso 4: Verificar Conectividad con la API

Prueba tu configuración haciendo una petición simple:

cURL

curl -X GET https://sandbox-api.lummy.com/health \
  -H "x-organization-id: ${LUMMY_ORG_ID}" \
  -H "x-api-key: ${LUMMY_API_KEY}"

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://sandbox-api.lummy.com/health',
  headers: {
    'x-organization-id': process.env.LUMMY_ORG_ID,
    'x-api-key': process.env.LUMMY_API_KEY,
  },
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Python

import os
import requests

headers = {
    'x-organization-id': os.environ.get('LUMMY_ORG_ID'),
    'x-api-key': os.environ.get('LUMMY_API_KEY'),
}

response = requests.get('https://sandbox-api.lummy.com/health', headers=headers)

print(response.json())

Respuesta esperada:

{
  "status": "healthy",
  "version": "1.0.0",
  "environment": "sandbox"
}

---

Paso 5: Configurar Sucursales (Opcional)

Si tienes múltiples sucursales, puedes gestionarlas desde el dashboard:

1. Configuración → Sucursales → Nueva Sucursal
2. Completa:
   • Nombre
   • Dirección fiscal
   • Código postal
   • Régimen fiscal
3. Carga el CSD específico de esa sucursal

Usar Sucursales en tu API

// Por defecto, se usa la sucursal matriz
await lummyClient.createInvoice(invoiceData);

// Especificar sucursal personalizada
await lummyClient.createInvoice(invoiceData, {
  headers: {
    'x-branch-id': '123e4567-e89b-12d3-a456-426614174000',
  },
});

---

URLs de los Ambientes

Ambiente	Base URL	Uso
Sandbox	https://sandbox-api.lummy.com	Desarrollo y pruebas. Timbres gratuitos.
Producción	https://api.lummy.com	Facturación real con costo por timbre.

---

Checklist de Configuración

• Cuenta creada y email verificado
• API Key generada y guardada
• LUMMY_API_KEY y LUMMY_ORG_ID en variables de entorno
• CSD cargado y validado en dashboard
• Prueba de conectividad exitosa (/health)
• (Opcional) Sucursales configuradas

---

Próximos Pasos

Ahora que tienes todo configurado, estás listo para emitir tu primera factura.

Emitir mi Primera Factura →