Integración Shopify

🎯 VERSIÓN 2.0.29 - CORRECCIONES CRÍTICAS MULTI-ENTIDAD

Bugs críticos multi-entidad corregidos + Diagnósticos precisos + Flujo de trabajo GitHub mejorado

🚨 BUGS CRÍTICOS CORREGIDOS
• BUG #83 MULTI-ENTIDAD: Error "Failed to fetch company" bloqueando sincronización de pedidos resuelto
• Solución entity-aware: Consultas SQL ahora filtradas por entidad para evitar conflictos cross-entidad
• BUG #84 DIAGNÓSTICOS: Versión hardcodeada "2.0.27" en exportación JSON de diagnóstico corregida
• Versión dinámica: Recuperación automática de versión desde módulo para soporte técnico preciso
• Cero bloqueos: Entornos Dolibarr multi-entidad ahora 100% compatibles

✨ DIAGNÓSTICOS PROFESIONALES MEJORADOS
• Exportación JSON completa: 47 verificaciones + versión dinámica para soporte técnico óptimo
• Interfaz colores: Clases CSS visuales para estados conexión Shopify (verde/naranja/rojo)
• Configuración segura: Exportación con enmascaramiento automático claves sensibles (API keys, tokens)
• Flujo GitHub: Anti-duplicados ZIP con validación coherencia tag vs versión

🔄 COMPATIBILIDAD MULTI-ENTIDAD COMPLETA
• Dolibarr multi-entidad: Soporte completo instalaciones complejas con separación datos garantizada
• Filtrado inteligente: Consultas cliente entity-aware para aislamiento perfecto entornos
• Compatibilidad hacia atrás: Sin impacto en instalaciones single-entity existentes
• Robustez: Manejo errores mejorado + logging detallado para todos tipos entornos

📊 CARACTERÍSTICAS HEREDADAS v2.0.28

Correcciones sincronización + Compatibilidad universal Dolibarr + Diagnósticos avanzados

CORRECCIONES CRÍTICAS SINCRONIZACIÓN (v2.0.28)
• HOTFIX BUG #80: Pedidos que se vuelven "pagados" después creación ahora sincronizados automáticamente
• Solución updated_at: Uso updated_at_min en lugar de created_at_min + ventana seguridad 24h
• BUG #81 COMPATIBILIDAD: Error getDolGlobalBool() en Dolibarr v19-20 resuelto con polyfill automático
• Universalidad: Dolibarr v19/v20/v21+ soportados universalmente con rendimiento óptimo

COLECCIONES BIDIRECCIONALES COMPLETAS (v2.0.26)
• Issue #70 resuelta: Funcionalidad colecciones perdida completamente restaurada
• Mapping inteligente: Tabla dedicada robusta llx_shopify_collections_mapping
• 3 modos sincronización: Dolibarr → Shopify, Shopify → Dolibarr, Bidireccional
• Resolución conflictos: 3 estrategias automáticas con interfaz administrativa

PRIMERA SINCRONIZACIÓN GARANTIZADA
• HOTFIX crítico v2.0.25: Primera sync no recuperando pedidos recientes corregida
• Fallback inteligente: Fecha instalación automática con lógica jerárquica robusta
• Impacto inmediato: Todas nuevas instalaciones funcionan correctamente desde inicio
• Compatibilidad total: Sin impacto en sincronizaciones existentes

🚀 CARACTERÍSTICAS PRINCIPALES

SINCRONIZACIÓN BIDIRECCIONAL AUTOMÁTICA
Productos, variantes, pedidos, clientes, stocks, imágenes, colecciones - Sincronización tiempo real GraphQL API

GESTIÓN MULTI-ENTIDAD NATIVA
Soporte completo instalaciones Dolibarr complejas con separación datos garantizada

INTERFAZ ADMINISTRATIVA PROFESIONAL
Dashboard completo, configuración intuitiva, diagnósticos expertos 47 puntos, logs detallados

ARQUITECTURA TÉCNICA ROBUSTA
Shopify GraphQL API, retry automático, seguridad reforzada, transacciones atómicas

🔧 CARACTERÍSTICAS PRINCIPALES PRESERVADAS

Sincronización avanzada de productos + Gestión automatizada de pedidos + Clientes unificados

Productos simples y variantes: Gestión completa de productos padre y variaciones
• Sincronización configurable: Precios, descripciones, imágenes, stocks, atributos a elección
• Precios multinivel: Soporte completo de tarificación Dolibarr con selección de nivel de precio
• Imágenes alta calidad: Sincronización automática con conversión WebP a JPEG
• Colecciones jerárquicas: Mapping bidireccional inteligente hacia colecciones Shopify

Gestión automatizada de pedidos
• Importación tiempo real: Recuperación inteligente por lotes configurable con paginación
• Gestión completa descuentos: Soporte códigos promo y descuentos globales
• Cálculos IVA precisos: IVA ponderado y gestión fiscalidad internacional
• Estados sincronizados: Actualización bidireccional estados pedidos
• Importación histórica: Fecha instalación como referencia automática

Sincronización clientes unificada
• Base CRM centralizada: Importación y actualizaciones automáticas desde Shopify
• Direcciones completas: Sincronización direcciones facturación y entrega
• Gestión multi-entidad: Soporte completo entornos multi-empresas

🚀 RENDIMIENTO Y FIABILIDAD v2.0.29

Correcciones críticas: Resolución completa bugs multi-entidad y diagnósticos
• Compatibilidad universal: Polyfill automático todas versiones Dolibarr (v19-21+)
• Diagnósticos mejorados: Exportación JSON 47 verificaciones + versión dinámica
• Diagnósticos profesionales: Interfaz completa identificación/resolución problemas automatizada heredada v2.0.27
• Arquitectura modernizada: Migración estándares Dolibarr con rendimiento optimizado (+40%)

💼 VENTAJAS BUSINESS MEJORADAS

Sincronización sin pérdidas: Correcciones bugs críticos garantizando ningún pedido perdido
• Compatibilidad multi-entidad: Adaptación automática entornos Dolibarr complejos
• Diagnósticos completos: Soporte técnico con exportación JSON diagnóstico mejorado
• Rendimiento garantizado: Arquitectura modernizada con caché nativo (+40% velocidad)
• Escalabilidad ilimitada: Gestión miles productos/pedidos sin interrupción

🔧 ESPECIFICACIONES TÉCNICAS

Compatibilidad: Dolibarr 19-21+, PHP 7.4-8.3+
• API: Shopify Admin GraphQL 2024-07 con 4 nuevos métodos colecciones
• Base de datos: MySQL/MariaDB con consultas condicionales universales
• Idiomas: Francés, Inglés, Alemán, Español, Italiano (traducciones completas)
• Rendimiento: Procesamiento por lotes configurable para optimización servidor

📞 SOPORTE PROFESIONAL

Desarrollado por Asociación P'tite Tête, especialista soluciones e-commerce Dolibarr desde 2021.

• Documentación completa: Guía configuración integrada paso a paso
• Soporte técnico: Asistencia dedicada vía DoliStore con exportación JSON diagnóstico automatizada
• Actualizaciones regulares: Evolución continua según comentarios usuarios
• Sitio dedicado: shopifyintegration.ptitetete.com

¡Diagnostique y sincronice sus sistemas Shopify-Dolibarr con la solución más avanzada!

AUTOR: P'tite Tête
SITIO WEB: https://shopifyintegration.ptitetete.com
SOPORTE: shopifyintegration@ptitetete.com
VERSIÓN: 2.0.29 (2025-09-05)