Saltar al contenido principal

¿Qué es Lummy?

Lummy es una API moderna de facturación electrónica que simplifica la generación de Comprobantes Fiscales Digitales por Internet (CFDI 4.0) para México. Diseñada por desarrolladores, para desarrolladores.

Características Principales​

🚀 API RESTful Moderna​

  • Endpoints intuitivos siguiendo estándares REST
  • Respuestas en JSON fáciles de procesar
  • Ejemplos de código en múltiples lenguajes (cURL, TypeScript, Python, PHP)

⚡ Timbrado Automático​

  • Sellado digital con tu CSD
  • Integración automática con PAC autorizado
  • Generación de XML y PDF en segundos

🔒 Seguridad y Confiabilidad​

  • Autenticación mediante API Keys
  • Transacciones atómicas (no se consume timbre si falla el proceso)
  • Idempotencia garantizada para prevenir duplicados
  • Logs seguros sin exposición de datos sensibles

📦 Completo Soporte CFDI 4.0​

  • Facturas de Ingreso (I) - Ventas de productos y servicios
  • Notas de Crédito (E) - Devoluciones y descuentos
  • Complemento de Pago 2.0 - Registro de pagos diferidos
  • Carta Porte 3.1 - Transporte de mercancías
  • Facturación Global - Público en general

🛠️ Developer Experience (DX)​

  • Documentación interactiva con ejemplos funcionales
  • Ambientes Sandbox y Producción
  • Validación automática de catálogos SAT
  • Errores descriptivos y accionables

¿Cómo Funciona?​

graph LR
    A[Tu Sistema] -->|POST /invoices| B[Lummy API]
    B -->|Valida Datos| C{¿Válido?}
    C -->|No| D[Error 400]
    C -->|Sí| E[Sella con CSD]
    E --> F[Envía a PAC]
    F --> G[Genera XML + PDF]
    G --> H[Retorna UUID Fiscal]
    H --> A
  1. Envías los datos de la factura (receptor, conceptos, impuestos) vía API
  2. Lummy valida contra las reglas del SAT y catálogos oficiales
  3. Sellado digital automático con tu Certificado de Sello Digital (CSD)
  4. Timbrado inmediato con el Proveedor Autorizado de Certificación (PAC)
  5. Recibes el UUID fiscal, XML timbrado y PDF listo para entregar

Casos de Uso Comunes​

E-Commerce​

Genera facturas automáticamente después de cada venta online. Integra con Shopify, WooCommerce, Magento, o tu plataforma personalizada.

Sistemas ERP​

Conecta tu ERP existente (SAP, Oracle, Odoo) con Lummy para centralizar la facturación electrónica.

SaaS y Subscripciones​

Automatiza la emisión de facturas mensuales para suscripciones, con soporte para Complemento de Pago 2.0.

Marketplaces​

Permite que tus vendedores emitan facturas directamente desde tu plataforma.

Logística y Transporte​

Genera facturas de traslado con Complemento Carta Porte 3.1 para cumplir con regulaciones de transporte de mercancías.

Ambientes Disponibles​

AmbienteURL BaseUso
Sandboxhttps://sandbox-api.lummy.comPruebas y desarrollo. Usa CSD de prueba del SAT.
Producciónhttps://api.lummy.comFacturación real con CFDIs válidos ante el SAT.
Recomendación

Desarrolla y prueba siempre en Sandbox antes de migrar a Producción. Los timbres en Sandbox son gratuitos.

Próximos Pasos​

⚡ Guía de Inicio Rápido

Configura tu cuenta y emite tu primera factura en 5 minutos.

Empezar

📡 Referencia de API

Explora todos los endpoints con ejemplos de código.

Ver Endpoints

Soporte​

¿Tienes preguntas? Estamos aquí para ayudarte: