CFDI_PLATFORM
FISCAL SYSTEMS, MADE LEGIBLE. ENGINEERING BUILD 04.0
[ SANDBOX TÉCNICO ]   CFDI 4.0   PYTHON / POSTGRESQL

Ingeniería fiscal sin fricción.

Una plataforma Full-Stack diseñada para convertir reglas fiscales, XML, certificados, validaciones, timbrado y cancelaciones en un flujo entendible para personas —sin sacrificar rigor técnico.

CFDI_PLATFORM_V4.0 // FAIL-CLOSED STRICT
Facturar parece una tarea administrativa. Por debajo, es un sistema distribuido que debe calcular, validar, serializar, firmar, enviar, reconciliar y auditar. La plataforma existe para que esa complejidad viva en el software, no en el usuario.
[ PIPELINE ]

De una captura humana
a un documento fiscal.

El objetivo de producto es simple: el usuario describe una operación comercial; el sistema se encarga de traducirla a las reglas técnicas que exige el flujo CFDI.

01. Captura

Cliente, conceptos, cantidades, impuestos y condiciones de pago entran como información entendible.
HUMAN INPUT -> DOMAIN MODEL

02. Motor Fiscal

Normaliza datos, calcula con precisión decimal, valida catálogos, construye XML, genera cadena original y sello digital.
VALIDATE -> BUILD -> SIGN

03. Certificación

La respuesta timbrada no se acepta a ciegas: se parsea, se compara con la operación esperada y se registra para auditoría.
STAMP -> VERIFY -> PERSIST

[ DISEÑO DEL NÚCLEO ]

Un motor fiscal
con fronteras.

La arquitectura separa dominio, persistencia, XML, criptografía, PAC y reconciliación para que cada capa tenga una responsabilidad verificable.

01 / Precisión

Cálculo determinista con Decimal, sin "centavos fantasma". Impuestos, bases y totales se calculan con precisión controlada para evitar redondeos intermedios.

02 / XML Local XSD

Serialización estricta, no "strings pegados". La estructura CFDI se genera validándose contra los XSD oficiales del SAT localmente.

03 / Fail-Closed

Si falta una regla oficial, el flujo debe detenerse. El resolver local no adivina archivos faltantes.

04 / Firma Digital

Cadena Original → sello → verificación local, antes de confiar en la red. Separamos la frontera criptográfica del PAC (RSA SHA-256).

[ MÁQUINA DE ESTADOS ]

La factura nunca
"simplemente se manda".

El ciclo explícito evita que reintentos de red o fallos parciales produzcan comprobantes duplicados o estados imposibles.

DRAFT

Captura inicial. Los archivos y formularios se convierten en un borrador estructurado (ExtractedInvoiceDraft).

PREPARED

Cálculo estable. Dominio estructurado y catálogos validados. Revisión humana antes de ejecución.

SIGNED

Sello local verificado. Cadena original validada criptográficamente (CSD).

STAMPING

Operación idempotente. Transacción de red / Timbrado PAC en curso.

STAMPED

UUID válido. Parse y reconciliación exitosos.

[ TOPOLOGÍA REAL ]

Red, dominio y
persistencia separados.

La orquestación evita mantener una transacción de base de datos abierta mientras se espera al PAC. Primero se persiste la intención; después ocurre la red; al final se reconcilia.

Frontend

Captura, corrección y aprobación humana antes de cualquier operación fiscal irreversible.

Python Core

Modelos, validación, matemáticas, XML, firma y servicios de aplicación.

PostgreSQL

Estados e intentos se registran de forma explícita para trazabilidad e idempotencia.

PAC Adapters

Timbrado, consulta, relaciones y cancelación se encapsulan como integraciones externas.

[ RECONCILIACIÓN ]

Pagos 2.0 y Cancelaciones.

Cancelar también es un proceso de estados. La plataforma valida precondiciones externas antes de enviar cancelaciones. En Pagos 2.0, reconstruimos el perfil histórico de impuestos desde el XML original timbrado.

Pagos Anti-drift

Pagos fraccionados sin perder centavos. La asignación conserva precisión interna postergando redondeos.

Multimoneda

EquivalenciaDR como regla. Cuando MonedaDR difiere de MonedaP, usamos conversión controlada.

Preflight de Cancelación

Estado y relaciones del CFDI se consultan en el SAT antes de construir la solicitud de cancelación.

[ STATUS ]

Estado del
Proyecto.

Es un sandbox de ingeniería; no se presenta como producto comercial terminado.

IMPLEMENTADO

Dominio + CFDI 4.0 + Criptografía

Validación de XSD/XML, matemáticas deterministas, cadena original y sellos locales funcionales.

IMPLEMENTADO

Orquestación y Cancelaciones

Idempotencia en PostgreSQL, auditoría append-only y consulta de relaciones con PAC externalizado.

EN PROGRESO

Pagos 2.0 XML Builder

Motor matemático de impuestos DR/P finalizado. En progreso la traducción del snapshot a XML.