Zs9.ӑl(*qdžUld)븱ϙ{sDfVS⣕# }."w?^G,x|R7q?KnkCe~X}}(xl v8lg"h"±nS}>l#ORI/6@-7ޠ"iӔ'+N2xװ \>?Cd%oBޒ=46~&2%HH)6q8|SY)ԩnx {mt6XXe_V_.3^h*mp+G]*ǪO=|pUHðVǐipOeNz`2tCMX= fP/[Tww}9\ K&S j(C1F-W~(%x~L(W.#D}z&M~kܾP1/ed`?MtduaNqQq%g)Vn hU+'|Y*%gNs 'ZWazI;;m$Ʉ}HX@[^Aت3Za,o'F۪M#;.6=Œl TT9SmQ߃!N9!e ..r+:tm{&DSHf2ѝ\ǔ.sqh=_G3Ґ-Oʲ'HݾZDCZc?uu`8{g ISc M-A5|2/a>]cF~1D!0#O6/V:90v^.3W+;~TG!J-& O٣VDg{k"Ir%3 -YPAll&M _Bߴs ~u\|1JQA4ṊYN)24ގhnwL.;7CKi'9P i/Zo*i7/kQ|ush22w@}sN/rs)\ fMc(b@%F|V÷<byW1VIV AgٿF@h X<. +hl\d',ťW5FʍTǝr W7"Q[/"Ut/\'$=s(,+`>rǤubP 2JQjNq4 5}MHU=X>;v9km$F9Ta#RXw Vl-}>;_0#q]r.%d[!`!1(2UqGJ~P- ÝOݵQk1BG 8⺄ޜ"虥h |բC"F\ ۥҨ[t򄢃p2\պxW6R:B2U1MI#ea돞*`@u,#3~gFIEg [kôYAoASS%0N{F\?vY8 Rt=JIx3u oZKuvɖeJ#a܎Z߈ʔ\?l\n7,DŪ=U+UAxy*Uݺo ڝ3 7tpSh_Dhp_wh0,S?sA3Jk턼(ǽ{Xnc _kzG9LRDY{]H5/==Sj?HWCHNLW3r`~`99q nӯXo`ZNeY-Y-$*/tTj rڨvNgϐkFk#_(ԻOTݺÙy@@,Hs]Xd˪im( <QrZlٙhp.?A2/.błs8#Jy֬ -6ح4'990uCI!#&ъ*Qx2X%dִ+E}+q٠% K:LٸReE+O SlӿZr J" ^~(kP s}9J2z nNT1n73c=}8ڒ5+_i=&H!Q[ )PR~x"_mfV]5 ZL|!_pv`fG:QW_3yE,CZ ¦HQW쐑1DPU^k\?יZ$:AU80QH#@ 7_Nb:jĀi۶S@蔑7ïjF[;֙_Tǰk y.qݲXY_ow}\$2nZq)aHaBh V 3AU /͆(vݶE^7ģ uU['F[gՂky3tv SLv}dDT,@$*FVx8vLmqSgf{7&u0N)ޯ ! syvK( 4yhTXnk@뱐oS),np0֙*b.%VPY.e֜kpUK;$Z3Xߵ)n`r蠍2xE|CUI:Sݿ5kSKS1; =Dco%pq\ YE虓A{[&:af.-;I=BSZ+:JKֿM!J D|"QJ X X9Zb`Re wV"0sNɤͷ4|vnX,jH+&Pw=ZbIx}) 4 / k Blnlace: `../pos/cfe_validacion.php` - Condición: Solo Master **Resultado:** - ✓ Acceso desde menú principal - ✓ Organizado bajo "Cumplimiento DGII" - ✓ Visible solo para nivel Master #### 4. `/compras/comprar.php` (Modificado previamente - Fase 7d) **Estado actual:** Ya contiene - include_once("../php/ncf_helper.php") - Selector tipo_ncf con data-secuencia - Campo readonly ncf con auto-generación - JavaScript cargar_prefijo_ncf() con módulo 11 **Nota:** Ver CHANGELOG Fase 7 para detalles --- ## 🔄 FLUJO DE INTEGRACIÓN - CÓMO FUNCIONA ### 1. REGISTRO DE COMPRA (comprar.php) ``` Usuario selecciona "Tipo NCF" ↓ JavaScript cargar_prefijo_ncf() ejecuta ↓ Calcula validación digit (módulo 11) ↓ Genera NCF formato TIPO+SECUENCIA+DIGITO (13 chars) ↓ Guarda en tabla compras (campo ncf) ↓ Estado compra = "Cerrada" → inicia tracking CFE ``` ### 2. VALIDACIÓN CFE (cfe_validacion.php) ``` Master abre módulo Validación CFE ↓ Muestra resumen KPIs y tabla de compras ↓ Valida cada compra: - RNC proveedor: 9 dígitos - NCF: formato 13 caracteres - Módulo 11: dígito correcto - Estado CFE: ACEPTADO/RECHAZADO/PENDIENTE ↓ Botón "Enviar a DGII" actualiza estado_dgii='ENVIADO' ``` ### 3. EXPORTACIÓN A DGII (dgii_606.php) ``` Master filtra por período ↓ Query ejecuta: SELECT c.* FROM compras c LEFT JOIN ncf n ON prefijo match WHERE n.estado_dgii='ACEPTADO' ↓ Tabla muestra solo compras aceptadas ↓ Resumen suma: CFE Aceptados vs Rechazados ↓ Exporta a Excel/TXT/CSV solo ACEPTADOS ``` ### 4. DASHBOARDS ``` cfe_resumen.php: Estadísticas globales + tabla CFE ↓ cfe_admin.php: Administración de CFE (suspender/reactivar) ↓ dgii_formularios.php: Acceso a validación ↓ Menú principal: Enlace en "Cumplimiento DGII" ``` --- ## ✅ VALIDACIONES IMPLEMENTADAS ### En comprar.php - [x] NCF auto-genera con módulo 11 - [x] Formato NCF: 13 caracteres (TIPO 2 + SEQ 8 + DIGITO 3) - [x] RNC requerido para compras de proveedor ### En cfe_validacion.php - [x] RNC formato XXX-XXXXXXX (9 dígitos) - [x] NCF validación módulo 11 - [x] Clave seguridad: 8 dígitos - [x] Estado DGII transitions: NO_ENVIADO → ENVIADO → ACEPTADO/RECHAZADO - [x] Suspension tracking: fecha + usuario + motivo ### En dgii_606.php - [x] Solo compras con ncf != '' - [x] Solo compras con rnc_proveedor != '' - [x] Filtro LEFT JOIN con ncf table - [x] WHERE n.estado_dgii = 'ACEPTADO' (exportación) - [x] Muestra estado CFE en cada fila - [x] Estadísticas separadas por estado ### En cfe_export_helper.php - [x] `obtener_compras_cfe_aceptados()` - Filtra query - [x] `validar_compra_para_export()` - Valida antes de exportar - [x] `obtener_estadisticas_cfe_export()` - Calcula stats - [x] Manejo de errores con mysql_error() --- ## 📊 ESTRUCTURA DE DATOS ### Tabla compras (campos nuevos) - `rnc_proveedor` VARCHAR(9) - Requerido para formulario 606 - `ncf` VARCHAR(13) - Link a tabla ncf - `base_sin_itbis` DECIMAL - Para cálculos 606 - `itbis` DECIMAL - ITBIS soportado - `ret_itbis` DECIMAL - Retención de ITBIS - `ret_renta` DECIMAL - Retención de renta - `estado_compra` VARCHAR(20) - Cerrada/Abierta/Anulada ### Tabla ncf (20+ campos) - `id_ncf` - Clave primaria - `tipo_comprobante` - 01-04, 11-14 - `prefijo` - A1-H1 - `secuencia` - Contador - `estado` - Activo/Suspendido - `estado_dgii` - NO_ENVIADO/ENVIADO/ACEPTADO/RECHAZADO - `rnc_empresa` - Del empresa - `clave_seguridad` - 8 dígitos aleatorios - `hash_validacion` - SHA-256 - `fecha_suspension`, `usuario_suspension`, `motivo_suspension` - Auditoría - UNIQUE(prefijo, rnc_empresa) --- ## 🔑 CONSTANTES Y VALORES ### Tipos DGII ``` 01 = Factura Consumidor (prefijo A1) 02 = Factura Crédito (prefijo B2) 03 = Nota Débito (prefijo C3) 04 = Nota Crédito (prefijo D4) 11 = Combustible (prefijo E5) 12 = Telecom (prefijo F6) 13 = Zona Franca (prefijo G7) 14 = Seguros (prefijo H1) ``` ### Pesos Módulo 11 ``` Array: [7, 3, 1, 7, 3, 1, 7, 3, 1, 7] Resto >= 10 → Digito = 0 Resto = 0 → Digito = 0 ``` ### Estados DGII ``` NO_ENVIADO - CFE registrado pero no enviado ENVIADO - Enviado a DGII, esperando respuesta ACEPTADO - Aceptado por DGII ✓ RECHAZADO - Rechazado por DGII ✗ ``` --- ## 📋 CHECKLIST DE IMPLEMENTACIÓN - [x] Crear tabla ncf con estructura CFE - [x] Implementar funciones ncf_helper.php (11 functions) - [x] Integrar CFE en comprar.php (selector + auto-gen) - [x] Crear dashboard cfe_admin.php - [x] Crear validador cfe_validacion.php - [x] Actualizar dgii_606.php con filtro CFE - [x] Crear cfe_export_helper.php - [x] Crear cfe_resumen.php dashboard - [x] Integrar en header.php menú - [x] Integrar en dgii_formularios.php card - [x] Crear documentación GUIA_CFE.md - [x] Validar 0 errores en todos los archivos - [x] Testear flujo completo --- ## 🚀 PRÓXIMOS PASOS (Opcional) 1. **Integración API DGII:** - Conectar con servicio REST de DGII - Auto-envío de CFE aceptados - Recepción automática de respuestas 2. **Firma Digital:** - Generar certificado digital - Firmar hash_validacion con SHA-256 - Almacenar en certificado_digital (BLOB) 3. **Auditoría Avanzada:** - Crear tabla audit_log - Registrar todos los cambios de estado - Reportes de trazabilidad 4. **Reimpresión CFE:** - Workflow de reimpresión duplicada - Validación de autorización DGII - Control de cantidad máxima 5. **Notificaciones:** - Email a usuario cuando CFE rechazado - Alerts de secuencias cerca del límite - Dashboard alertas en tiempo real --- ## 📞 SOPORTE TÉCNICO **Módulos relacionados:** - `php/dgii_helper.php` - Validación DGII - `php/ncf_helper.php` - Funciones CFE ⭐ - `php/contable_helper.php` - Registro contable - `compras/comprar.php` - Formulario compras ⭐ - `pos/dgii_606.php` - Formulario 606 ⭐ **Tablas relacionadas:** - `ncf` - Estados y validación ⭐ - `compras` - Detalle de compras - `empresa` - RNC empresa **Contacto:** Sistema de Cumplimiento DGII **Versión:** 1.0 **Estado:** ✅ Producción --- **Documento generado:** 2024 **Autor:** Sistema CFE Integration **Aprobado por:** Master Access