Bienvenido a la Documentación de DocuCenter
Esta es la documentación completa del sistema DocuCenter, organizada por categorías para facilitar la navegación y el mantenimiento.
📚 Estructura de la Documentación
🎓 Guías de Usuario
- Workflow de Entrenamiento Document AI ⭐ - Guía completa paso a paso para entrenar modelos custom de Google Document AI
🔌 APIs
Documentación completa de todas las APIs disponibles en el sistema:
- Facturación Electrónica (FE) - APIs para emisión de documentos fiscales electrónicos
- Sage ACICloud - Integración con sistema ERP Sage
- Organizaciones - Gestión de organizaciones y configuraciones
- Ubicaciones - Manejo de ubicaciones geográficas
🔗 Integraciones
Documentación de integraciones con sistemas externos:
- Zoho Self Client ⭐ - Integración completa con Zoho Books API usando código directo
- Lightspeed - Integración con sistema POS
- QuickBooks - Sincronización bidireccional
- Shopify - Importación de órdenes
🧪 Sistema de Testing
Documentación completa del sistema de testing y validaciones:
- Testing de Filtros de Configuración FE ⭐ - Testing de filtros de organización y usuario en configuración de facturación electrónica
- Testing de branch_code en Facturación ⭐ - Implementación y testing del campo branch_code para códigos de sucursal
- Testing de Clientes Extranjeros QuickBooks ⭐ - Guía completa de testing para creación de clientes extranjeros con pasaporte y país
- Comandos de Testing ⭐ - Comandos Artisan PHP y scripts bash centralizados
- Testing de Facturas de Exportación - Testing completo para Facturas de Exportación Electrónica (46)
- Testing de Webhooks - Pruebas de webhooks de pagos y integraciones
- Testing de Cálculos - Validación de cálculos de facturación sin PAC
- Script de Automatización Principal - Herramienta maestra para automatizar testing
- Configuración de Testing - Configuración centralizada del sistema
📈 Optimizaciones
Documentación sobre mejoras de performance y optimizaciones del sistema:
- Mejoras en Manejo de Errores de QuickBooks ⭐ - Sistema mejorado de captura y formateo de errores del API de QuickBooks
- Resumen: Mejoras de Errores QB 🎯 - Resumen visual de las mejoras implementadas
- Optimizaciones de consultas a base de datos
- Mejoras en el manejo de grandes volúmenes de datos
- Implementación de circuit breakers y patrones de resiliencia
- Optimizaciones de memoria y recursos
✅ Validaciones
Documentación de validaciones de datos y reglas de negocio:
- Validación de Conexión Alanube ⭐ - Mejoras en el sistema de validación de PAC Alanube
- Detección Automática Alanube ⭐ - Sistema de detección automática de PAC en facturación panameña
- Validaciones de documentos fiscales
- Reglas de negocio para facturación electrónica
- Validaciones de integraciones
🔧 Troubleshooting
Guías de resolución de problemas comunes:
- Error 401 en Digifact PAC ⭐ - Diagnóstico y solución de errores de autenticación con Digifact
- Resumen: Fix Error 401 Digifact 🎯 - Resumen ejecutivo de correcciones aplicadas
- Problemas de conexión con PACs
- Errores de certificación de documentos
-
Issues con integraciones de terceros Documentación sobre validaciones específicas implementadas:
-
Validaciones de documentos fiscales (RUC, DV)
- Reglas de negocio específicas
- Validaciones de formato y integridad de datos
- Controles de calidad de datos
🔧 Documentación Técnica
Análisis técnicos y soluciones a problemas específicos:
- Sistema de Monitoreo del Servidor ⭐ - Sistema completo de monitoreo en tiempo real de recursos del servidor (disco, RAM, CPU)
- Resumen de Implementación - Monitoreo del Servidor 🎯 - Resumen de implementación del sistema de monitoreo
- ✅ SOLUCIÓN COMPLETA: Cliente Solmary Identificación 🎉 - Solución completa con x-data + auto-llenado campos B406-B416
- ✅ SOLUCIONADO: Cliente Solmary No Mostraba Identificación 🔧 - Fix x-data faltante para cliente extranjero
- ✅ RESUMEN FINAL COMPLETO - Unificación Receptor Extranjero 🎯 - Estado final de toda la unificación backend + frontend
- Unificación Blade Receptor Extranjero B406-B416 ⭐ - Eliminación de duplicación de campos similares en interfaz
- Unificación Backend Receptor Extranjero B406-B416 ⭐ - Implementación completa de campos DGI B406-B416 para receptores extranjeros con compatibilidad legacy
- Análisis de Unificación Receptor Extranjero ⭐ - Análisis técnico de duplicación de campos y plan de unificación DGI
- Resumen Evaluación Receptor Extranjero ⭐ - Resumen completo de evaluación y resultados de unificación
- QuickBooks Foreign Customer Country Storage Fix ⭐ - Fix para almacenamiento correcto de país en clientes extranjeros de QuickBooks
- Control Auto-Emit FE en QuickBooks ⭐ - Sistema de control para emisión automática de FE desde create_sale_quickbooks
- Análisis de Números Fiscales - Análisis técnico de extracción y validación de números fiscales del CUFE
- Facturas de Exportación Alanube DOM - Implementación completa de Facturas de Exportación Electrónica (46)
- Reorganización de Comandos por Operación ⭐ - Análisis completo de 135+ comandos Artisan categorizados por tipo de operación
- Reorganización Física de Comandos ⭐ - Reorganización de 92 comandos en 7 directorios por tipo de operación
- Comandos NO Incluidos en Kernel ⭐ - 72 comandos organizados por tipo de operación que NO están en el scheduler automático
- Verificación de Comandos del Kernel - Lista de verificación y criterios para comandos incluidos en el scheduler del Kernel
- Correcciones de bugs y issues técnicos
- Implementaciones de funcionalidades complejas
- Análisis de casos edge y comportamientos especiales
- Soluciones de sincronización e integración
🚀 Inicio Rápido
Para Desarrolladores
- Revisa la documentación de APIs para entender los endpoints disponibles
- Consulta las optimizaciones si trabajas con performance
- Verifica las validaciones para implementaciones que requieren validación de datos
Para Integradores
- Comienza con la API de Facturación Electrónica
- Revisa los ejemplos específicos para tu plataforma
- Consulta la documentación técnica para casos especiales
Para Administradores de Sistema
- Revisa las optimizaciones de MySQL
- Consulta la documentación de organizaciones para configuraciones
- Verifica las validaciones para mantener integridad de datos
📝 ¿Cómo Contribuir?
- Nuevas APIs: Agrega documentación en el directorio correspondiente dentro de
api/ - Optimizaciones: Documenta mejoras de performance en
optimizations/ - Validaciones: Agrega nuevas validaciones en
validations/ - Issues Técnicos: Documenta soluciones en
technical/
Cada documento debe seguir las plantillas establecidas en cada directorio y incluir ejemplos prácticos.
¿Dudas o sugerencias? Abre un issue en GitHub.