# 🧾 Conector de Facturación Electrónica Fiscal en LATAM (Facturapi & Alegra API)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial prepare y emita facturas electrónicas con validez tributaria oficial ante los organismos de impuestos de tu país (DIAN en Colombia, SAT en México, SII en Chile, SUNAT en Perú), generando el XML fiscal y el archivo PDF con código QR sin digitar datos a mano.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Facturación e Impuestos |
| **Área Empresarial** | 03. Finanzas, Contabilidad y Cumplimiento Tributario |
| **Nivel de Dificultad** | 🟡 Media |
| **Modelo de Costo** | Planes PyME desde $5 a $15 USD mensuales (incluyen timbres fiscales ilimitados o por paquetes) |
| **Enlace Oficial** | [Facturapi.io (México)](https://www.facturapi.io/) / [Alegra API (Colombia, México, Perú, Chile)](https://developer.alegra.com/) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

En América Latina, la **facturación electrónica es obligatoria por ley**. Cada vez que vendes un producto o servicio, debes generar un documento con sello digital, folio fiscal y código QR y enviarlo tanto a la autoridad tributaria como al cliente.

Hacer esto manualmente en el portal del gobierno o en sistemas lentos toma entre 5 y 10 minutos por cada venta.

Con esta API conectada a tu IA:
1. El cliente te pide factura y te pasa sus datos fiscales por WhatsApp o correo.
2. La IA valida que el RUT/RFC/NIT sea correcto y que el código de producto o servicio del catálogo oficial corresponda.
3. La IA prepara la factura, la timbra ante la entidad fiscal y le envía el PDF y el XML al cliente en menos de 10 segundos.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Cero errores en claves de producto**: La IA busca automáticamente la clave fiscal oficial (ej: catálogo del SAT o DIAN) para que no te rechacen la factura.
- **Cumplimiento Tributario al Día**: Evitas multas y sanciones por demoras en la emisión de facturas.
- **Envío Inmediato**: El cliente recibe su comprobante sin tener que llamar a pedirlo varias veces.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta activa en un proveedor tecnológico de facturación como [Facturapi](https://facturapi.io) o [Alegra](https://alegra.com).
2. Tu Certificado de Sello Digital (CSD / Firma Electrónica) emitido por la autoridad tributaria de tu país (SAT en México, DIAN en Colombia, etc.).
3. Tu API Key de integración.

---

## ⚙️ Configuración Paso a Paso (Ejemplo con Facturapi / Alegra)

Variables de entorno para tu backend o servidor de automatización:

```env
# Variables de entorno (.env)
FACTURACION_API_KEY=tu_clave_de_facturacion_aqui
FACTURACION_PROVEEDOR=facturapi # o alegra
EMPRESA_RFC_NIT=XAXX010101000
EMPRESA_REGIMEN_FISCAL=601 # Régimen General de Ley Personas Morales
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Asistente Contable y Especialista en Facturación Electrónica.
Vamos a emitir una factura electrónica fiscal válida para un cliente.

Por favor, pregúntame antes de emitir la factura:
1. ¿Cuál es el país y la autoridad fiscal correspondiente (DIAN Colombia, SAT México, SII Chile, SUNAT Perú)?
2. ¿Cuáles son los datos del cliente (Razón social, NIT/RFC/RUT, Uso de CFDI / Régimen, Correo electrónico)?
3. ¿Cuál es el detalle de los productos/servicios a facturar (descripción, cantidad, precio unitario, tasa de IVA/impuesto aplicable)?
4. ¿Cuál fue el método de pago utilizado (transferencia, tarjeta, efectivo, crédito)?

Una vez me des los datos, muéstrame una vista previa del borrador con subtotales, impuestos calculados y retenciones para mi aprobación humana final antes de enviar la orden de timbrado oficial.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Ferretería & Construcciones El Roble" (Venta de materiales en Barranquilla, Colombia).
- **Problema**: Los viernes por la tarde se formaban filas de clientes esperando su factura electrónica de la DIAN, colapsando el mostrador de ventas.
- **Resultado con la API**: Conectaron la emisión de facturas con Alegra API. Los clientes escanean un código QR en el mostrador o envían su RUT por WhatsApp, y la factura se genera y envía a su correo en 15 segundos. Redujeron el tiempo de espera en caja en un 70%.

---

## 🛡️ Consideraciones de Seguridad y Supervisión Humana

- **Supervisión Humana Obligatoria**: Configura el flujo para que la IA siempre muestre una confirmación del monto total e impuestos antes de realizar el timbrado fiscal definitivo, ya que la cancelación de facturas ante el fisco requiere trámites adicionales.
- **Resguardo de Certificados**: Tus archivos de certificado y llave privada (`.cer` y `.key`) deben almacenarse en servidores cifrados y nunca compartirse en texto plano.