Sistema Operativo Integral para distribución de hidrocarburos B2B.
Construir sobre una base open source (ERPNext/Frappe) envuelta en una capa agéntica (FastAPI + LangGraph) gobernada por un AI Gateway neutral de vendors (LiteLLM), sobre infraestructura costo-eficiente (Hetzner), con el compliance fiscal FiscalAI/DeCabeceraTax como diferenciador central frente al huachicol fiscal.
Fuentes: IMARC Group, CNE/PetroIntelligence (abr 2026), Onexpo, Procuraduría Fiscal de la Federación (oct 2025). Cifras de mercado y consumo, no proyecciones internas de Cluster17.
El terremoto regulatorio 2024–2026.
La CRE desapareció. La CNE, la nueva Ley del Sector Hidrocarburos y tres obligaciones fiscales nuevas —Carta Porte 3.1, Controles Volumétricos y el Complemento de Hidrocarburos— son ahora el núcleo del cumplimiento normativo.
Estructura del mercado (permisionarios)
Estaciones por marca (oct 2025)
Fuente: PetroIntelligence vía Onexpo (dic 2025) y "Fotografía del Sector Gasolinero" (oct 2025). Pemex mantiene 58.2% del mercado con 7,480 estaciones propias.
Open source forkeado + capa agéntica.
ERPNext como core (CRM, compras, inventario, contabilidad), FastAPI + LangGraph como orquestación de agentes, y LiteLLM como AI Gateway neutral — ningún modelo se integra con API key directa.
Arquitectura del sistema — flujo de capas
Nodo · lectura en vivo
Terminal · monitoreo de campo
Identidad · instalación física
Documentación · manual v1.0Stack por capa
| Capa | Recomendado | Justificación |
|---|---|---|
| Core ERP | ERPNext (Frappe, GPLv3) | CRM, compras, inventario, contabilidad sin costo por licencia |
| Capa agéntica | FastAPI + LangGraph | Checkpointing, human-in-the-loop, estándar de producción 2026 |
| AI Gateway | LiteLLM proxy (MIT) | 100+ modelos, budgets y fallbacks por tenant |
| Cola de mensajes | Redis + RQ/Celery | Ya integrado a Frappe; suficiente para 10–1000+ ops/mes |
| Infraestructura | Hetzner Cloud (k3s) | 4–7x más barato que AWS; EUR 250–600/mes |
Nueve agentes, un gate de cumplimiento obligatorio.
Cada agente opera vía router LiteLLM (nunca API key directa). El agente Compliance/FiscalAI puede bloquear cualquier operación ante una contraparte de riesgo alto — el diferenciador que ningún competidor tradicional ofrece.
Captación omnicanal, calificación de leads, pipeline WhatsApp-first.
Ingesta OCR+LLM de listas diarias de proveedores, detección de atípicos.
Cálculo de litros, flete, margen e impuestos con folio único.
Programación de carga, ruta óptima, evidencias y seguimiento GPS.
Armado del expediente digital y clasificación automática.
Registro de pagos y autorización electrónica de descarga.
Due diligence 69-B, scoring de riesgo, validación de permisos contra L_CNE.
Campañas WhatsApp, reactivación, NPS.
Atención conversacional con escalamiento a humano si CSAT baja.
Criterios de evaluación — mapa cualitativo
Lectura cualitativa e ilustrativa basada en los criterios del RFP (§14), no un benchmark numérico publicado.
FiscalAI / DeCabeceraTax
- Verificación 69-B automática antes de cada operación
- Scoring de riesgo de contrapartes (RFC, régimen, SCIAN)
- Mapa de red Art. 69-BIS — contagio fiscal
- Monitoreo continuo de CSD, e.firma, buzón tributario
- Validación de complementos de pago y cadena CFDI 4.0
"El único sistema que verifica automáticamente a cada contraparte contra las listas negras del SAT antes de vender un litro."
De MVP a SaaS multi-tenant.
Inversión acumulada por fase, costo mensual de infraestructura y LLM con routing optimizado, y tarifas vigentes de timbrado y WhatsApp.
Inversión acumulada por fase (USD, estimación)
MVPPuntos medios de los rangos reportados en §11. No son cifras cerradas del cliente.
Costo mensual infraestructura por proveedor
Timbrado CFDI y WhatsApp
| Concepto | Tarifa | Nota |
|---|---|---|
| Finkok (PAC) | MX$0.30 + IVA / timbre adicional | Sin sobrecosto por complemento de hidrocarburos |
| SW Sapien (PAC) | ~MX$0.24–0.82 / timbre | Según volumen de paquete |
| WhatsApp marketing | US$0.0436 / mensaje | Tarifa base Meta México, abr 2026 |
| WhatsApp utility | US$0.0080 / mensaje | Notificaciones transaccionales |
| WhatsApp servicio (24h) | Gratis | Hasta 30-sep-2026 |
Cuatro fases, umbrales de decisión claros.
De discovery a SaaS multi-tenant en 24 meses, con puntos de "go/no-go" explícitos en cada transición.
Levantamiento de procesos, setup ERPNext + LiteLLM + Hetzner, definición de DocTypes del core.
Compliance/FiscalAI, Precios, Cotizador, Conversión, WhatsApp-first, CFDI + complemento hidrocarburos.
Logística OR-Tools/OSRM, Tesorería, Controles Volumétricos, Carta Porte 3.1, multi-agente completo.
Aislamiento por tenant, onboarding self-service, venta a otras distribuidoras. Requiere revisión legal AGPL/GPL.
Caveats — a verificar antes de cada release
Marco regulatorio en transición
CRE→CNE, LSH y disposiciones secundarias siguen cambiando. Tratar autoridades y permisos como parámetros configurables, no hardcodeados.
Precios volátiles
LLMs, Hetzner y WhatsApp cambian de precio con frecuencia. Cifras válidas a julio 2026; re-verificar antes de contratar.
Licencias open source (AGPL/GPL)
Imponen obligaciones en el modelo SaaS multi-tenant. Requiere revisión legal antes de la Fase 3.
Neutralidad de vendors LLM
LiteLLM evita lock-in, pero exige disciplina: prohibir integraciones directas de API keys en el código de los agentes.
Latencia y residencia de datos
Hetzner no tiene datacenter en México (~40-70ms). Evaluar componente híbrido si el compliance de datos lo exige.
Cifra de huachicol fiscal en disputa
Los $600,000 MDP fueron matizados públicamente por la presidencia. Tratar como estimación oficial en disputa, no cifra cerrada.
