feat(sat): reporte diario de errores SAT por proxy

- Agrega tabla sat_proxy_errors con proxy_usado, error_code, stage, message. - sat-client.service.ts expone proxyInfo usado en cada conexión SAT. - sat.service.ts registra errores de bloqueo/devolución del SAT en sat_proxy_errors y guarda proxyUsed en sat_sync_jobs. - Nuevo job sat-proxy-report.job.ts: cron 8 AM CDMX, envía email a ADMIN_EMAIL con errores de las últimas 24h agrupados por proxy/error_code. - Template de email sat-proxy-report.ts y método sendSatProxyReport. - Registra el cron en src/index.ts. - Actualiza docs/SAT-SYNC-IMPLEMENTATION.md.
2026-08-03 14:27:19 +00:00
parent 3de0014e80
commit 099f34c903
57 changed files with 4554 additions and 7 deletions
--- a/apps/api/scripts/backfill-conceptos.ts
+++ b/apps/api/scripts/backfill-conceptos.ts
@@ -0,0 +1,105 @@
+/**
+ * Backfill: Extrae conceptos de XMLs existentes en cfdis y los inserta en cfdi_conceptos.
+ * Uso: npx tsx scripts/backfill-conceptos.ts <database_name> [batchSize]
+ */
+import { Pool } from 'pg';
+import { parseXml } from '../src/services/sat/sat-parser.service.js';
+
+async function main() {
+  const databaseName = process.argv[2];
+  const batchSize = parseInt(process.argv[3] || '100', 10);
+
+  if (!databaseName) {
+    console.error('Uso: npx tsx scripts/backfill-conceptos.ts <database_name> [batchSize]');
+    process.exit(1);
+  }
+
+  const pool = new Pool({
+    host: 'localhost',
+    port: 5432,
+    user: 'postgres',
+    password: 'ZxHMrmnwanvLfLDdNJdRthFjWF2Lj1Rb',
+    database: databaseName,
+  });
+
+  let totalProcessed = 0;
+  let totalConceptos = 0;
+  let errors = 0;
+
+  while (true) {
+    const { rows: cfdis } = await pool.query(`
+      SELECT c.id, c.uuid, c.xml_original
+      FROM cfdis c
+      LEFT JOIN cfdi_conceptos cc ON cc.cfdi_id = c.id
+      WHERE c.xml_original IS NOT NULL AND cc.id IS NULL
+      LIMIT $1
+    `, [batchSize]);
+
+    if (cfdis.length === 0) break;
+
+    for (const row of cfdis) {
+      try {
+        const cfdi = parseXml(row.xml_original, 'emitidos');
+        if (!cfdi || !cfdi.conceptos || cfdi.conceptos.length === 0) {
+          // Algunos XMLs pueden no tener conceptos (ej. tipo P, N, T)
+          // Pero aún así los marcamos como "procesados" insertando un concepto dummy?
+          // No, mejor solo saltamos.
+          totalProcessed++;
+          continue;
+        }
+
+        const tc = cfdi.tipoCambio || 1;
+        const m = (v: number) => v * tc;
+
+        for (const c of cfdi.conceptos) {
+          await pool.query(`
+            INSERT INTO cfdi_conceptos (
+              cfdi_id, clave_prod_serv, no_identificacion, descripcion, cantidad,
+              clave_unidad, unidad, valor_unitario, valor_unitario_mxn, importe, importe_mxn,
+              descuento, descuento_mxn,
+              isr_retencion, isr_retencion_mxn,
+              iva_traslado, iva_traslado_mxn,
+              iva_retencion, iva_retencion_mxn,
+              ieps_traslado, ieps_traslado_mxn,
+              ieps_retencion, ieps_retencion_mxn
+            ) VALUES (
+              $1,$2,$3,$4,$5,$6,$7,$8,$9,$10,
+              $11,$12,$13,$14,$15,$16,$17,$18,$19,$20,
+              $21,$22,$23
+            )
+          `, [
+            row.id,
+            c.claveProdServ, c.noIdentificacion, c.descripcion, c.cantidad,
+            c.claveUnidad, c.unidad,
+            c.valorUnitario, m(c.valorUnitario), c.importe, m(c.importe),
+            c.descuento, m(c.descuento),
+            c.isrRetencion, m(c.isrRetencion),
+            c.ivaTraslado, m(c.ivaTraslado),
+            c.ivaRetencion, m(c.ivaRetencion),
+            c.iepsTraslado, m(c.iepsTraslado),
+            c.iepsRetencion, m(c.iepsRetencion),
+          ]);
+        }
+
+        totalConceptos += cfdi.conceptos.length;
+        totalProcessed++;
+      } catch (err: any) {
+        errors++;
+        console.error(`[ERROR] UUID ${row.uuid}:`, err.message);
+      }
+    }
+
+    console.log(`[PROGRESS] Procesados: ${totalProcessed}, Conceptos: ${totalConceptos}, Errores: ${errors}`);
+  }
+
+  console.log(`\n[COMPLETE] Total CFDIs procesados: ${totalProcessed}`);
+  console.log(`[COMPLETE] Total conceptos insertados: ${totalConceptos}`);
+  console.log(`[COMPLETE] Errores: ${errors}`);
+
+  await pool.end();
+}
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});