name: contador-pyme-mx description: | Usar cuando el usuario sea CONTADOR de PyMEs MEXICANAS y necesite validar CFDI 4.0, detectar errores caros antes de timbrar/cancelar, cruzar proveedores contra listas 69-B, validar retenciones a personas físicas (honorarios, arrendamiento, RESICO 1.25%), aplicar reglas de cancelación (motivos 01-04), checar Carta Porte 3.1, alertar PUE timbrados a fin de mes que pueden quedar como ingreso fantasma. Anclado en corpus oficial (Anexos RMF 2026, XSDs SAT, listas 69-B, leyes federales).

Triggers: "valida este CFDI", "este XML está bien", "el SAT lo va a rechazar", "PUE PPD", "cancelar CFDI motivo", "retención RESICO", "honorarios 10%", "arrendamiento 10.67% IVA", "Carta Porte", "complemento pagos", "régimen fiscal receptor", "uso CFDI", "metodo de pago", "factura electrónica", "Anexo 20", "validar nómina", "contador México", "contabilidad fiscal".

contador-pyme-mx — Skill para contadores PyME (CFDI + validación)

Familia de validadores y calculadoras para el contador mexicano de PyMEs. v1.0 = cfdi-validator-mx (núcleo). Siguientes módulos en backlog: nomina-mx, declaraciones-mx, descarga-masiva-cfdi-mx, valores-vigentes-mx, opinion-32d-mx.

Cuándo activarte

• El usuario te pasa un XML de CFDI y pregunta si está bien armado
• El usuario está por cancelar/sustituir un CFDI y pregunta qué motivo poner
• El usuario tiene proveedores y quiere checar si alguno está en lista 69-B
• El usuario timbró PUE a fin de mes y se da cuenta que aún no le pagaron
• El usuario emitió CFDI a una PF en RESICO y olvidó la retención 1.25%
• El usuario mueve mercancía y pregunta sobre Carta Porte
• El usuario menciona régimen fiscal, uso CFDI, forma de pago, método de pago

NO actives si: el usuario quiere asesoría legal específica de un litigio fiscal — para eso refiere a abogado fiscalista.

Módulos disponibles (v1.0)

Bloque CFDI

Bloque Nómina

Bloque Declaraciones (nuevo)

Composables (delega a otros skills)

Workflow

Paso 1: Identifica intent

Paso 2: Si es validación de CFDI, corre el flujo completo

~/sistemia-skills-mx/skills/contador-pyme-mx/scripts/validate_cfdi.py archivo.xml

El script valida en orden:

1. Estructura XML contra XSD cfdv40.xsd
2. Catálogos (RegimenFiscal, UsoCFDI, FormaPago, MetodoPago, ClaveProdServ, ClaveUnidad)
3. Reglas de negocio (régimen receptor compatible con uso CFDI, total = subtotal - descuentos + impuestos, etc.)
4. Detección de complementos (Pagos 2.0, Nómina 1.2, Carta Porte 3.1, Retenciones)
5. Si tiene Retenciones: valida monto contra tasas oficiales por concepto
6. Si emisor es RESICO PF y receptor PM: alerta si NO viene retención 1.25% ISR
7. Cruce 69-B del RFC emisor y receptor (delega a legal-pyme-mx/check_69b.py)

Paso 3: Output al usuario

## Validación CFDI {{folio/UUID}}

**Veredicto:** ✅ Válido / ⚠️ Válido con advertencias / 🚨 Inválido (no timbrar)

### Estructura XML
- [✓/✗] Pasa esquema XSD cfdv40
- [✓/✗] Versión 4.0

### Datos fiscales receptor
- RFC: {{rfc}} — {{vigente / cancelado / no encontrado}}
- Régimen fiscal: {{cod}} {{nombre}} — {{compatible con uso CFDI / INCOMPATIBLE}}
- CP fiscal: {{cp}} — {{coincide con datos SAT / por verificar manual}}
- Uso CFDI: {{cod}} {{nombre}}

### Catálogos
- Forma de pago: {{cod}} ({{descr}})
- Método de pago: {{cod}} (PUE/PPD)
- {{Si PUE y fecha emisión >25 del mes: alerta cruce mes}}

### Complementos detectados
- {{Pagos 2.0 / Nómina 1.2 / Carta Porte 3.1 / Retenciones v2.0}}

### Riesgos detectados
- {{Lista de hallazgos con su impacto en MXN si aplica}}

### Cruce 69-B
- RFC emisor en lista SAT: {{NO / 69-B Definitivos / 69 CFF / etc.}}
- RFC receptor en lista SAT: {{NO / ...}}

### Recomendación accionable
{{1-2 líneas}}

Paso 4: Cierre

Siempre cierra con:

1. Decisión binaria (timbrar / cancelar / corregir y re-timbrar)
2. Si hay riesgo, cuál es la multa potencial en MXN
3. Cuál es la fuente (artículo LISR/LIVA/CFF o Anexo RMF)

Los 5 errores más caros que este skill previene

Lo que NO hace este skill v1.0

• No emite/timbra CFDI. Solo valida XMLs ya generados o por generar.
• No genera nómina. Eso es módulo nomina-mx (v1.1).
• No presenta declaraciones. Eso es módulo declaraciones-mx (v1.1).
• No descarga masivo del SAT. Eso es módulo descarga-masiva-cfdi-mx (v1.1) — requiere FIEL.
• No asesoría legal personalizada. Información operacional basada en corpus oficial.

Fuentes del corpus

Ver research/fiscal-INDEX.md para mapa temático completo. Resumen:

• SAT esquemas: 11 XSDs CFDI 4.0 (research/contador-pyme-mx-corpus/esquemas-cfdi/)
• SAT contabilidad electrónica: 6 XSDs (/esquemas-contabilidad/)
• SAT RMF 2026: Anexo 8 (tarifas ISR) + Anexo 24 (contabilidad) + Anexo 20 (guía CFDI) + Guía Nómina
• SAT listas negras: 11 CSVs en research/sat/listas-negras/ (del skill legal-pyme-mx)
• Diputados leyes: CFF, LISR, LIVA, LIEPS, LFT, LSS (todas vigentes 2026)
• INEGI: INPC histórico CSV
• Banxico SIE: FIX SF43718 via API con token