Integrazione Shopify

🎯 VERSIONE 2.0.29 - CORREZIONI CRITICHE MULTI-ENTITÀ

Bug critici multi-entità corretti + Diagnostica precisa + Workflow GitHub migliorato

🚨 BUG CRITICI CORRETTI
• BUG #83 MULTI-ENTITÀ: Errore "Failed to fetch company" che blocca sincronizzazione ordini risolto
• Soluzione entity-aware: Query SQL ora filtrate per entità per evitare conflitti cross-entità
• BUG #84 DIAGNOSTICA: Versione hardcodata "2.0.27" nell'esportazione JSON diagnostica corretta
• Versione dinamica: Recupero automatico versione da modulo per supporto tecnico preciso
• Zero blocchi: Ambienti Dolibarr multi-entità ora 100% compatibili

✨ DIAGNOSTICA PROFESSIONALE MIGLIORATA
• Esportazione JSON completa: 47 verifiche + versione dinamica per supporto tecnico ottimale
• Interfaccia colori: Classi CSS visuali per stati connessione Shopify (verde/arancione/rosso)
• Configurazione sicura: Esportazione con mascheramento automatico chiavi sensibili (API keys, tokens)
• Workflow GitHub: Anti-duplicati ZIP con validazione coerenza tag vs versione

🔄 COMPATIBILITÀ MULTI-ENTITÀ COMPLETA
• Dolibarr multi-entità: Supporto completo installazioni complesse con separazione dati garantita
• Filtraggio intelligente: Query clienti entity-aware per isolamento perfetto ambienti
• Compatibilità all'indietro: Nessun impatto su installazioni single-entity esistenti
• Robustezza: Gestione errori migliorata + logging dettagliato per tutti tipi ambienti

📊 CARATTERISTICHE EREDITATE v2.0.28

Correzioni sincronizzazione + Compatibilità universale Dolibarr + Diagnostica avanzata

CORREZIONI CRITICHE SINCRONIZZAZIONE (v2.0.28)
• HOTFIX BUG #80: Ordini che diventano "pagati" dopo creazione ora sincronizzati automaticamente
• Soluzione updated_at: Uso updated_at_min invece di created_at_min + finestra sicurezza 24h
• BUG #81 COMPATIBILITÀ: Errore getDolGlobalBool() su Dolibarr v19-20 risolto con polyfill automatico
• Universalità: Dolibarr v19/v20/v21+ supportati universalmente con prestazioni ottimali

COLLEZIONI BIDIREZIONALI COMPLETE (v2.0.26)
• Issue #70 risolta: Funzionalità collezioni persa completamente ripristinata
• Mapping intelligente: Tabella dedicata robusta llx_shopify_collections_mapping
• 3 modalità sincronizzazione: Dolibarr → Shopify, Shopify → Dolibarr, Bidirezionale
• Risoluzione conflitti: 3 strategie automatiche con interfaccia amministrativa

PRIMA SINCRONIZZAZIONE GARANTITA
• HOTFIX critico v2.0.25: Prima sync non recuperando ordini recenti corretta
• Fallback intelligente: Data installazione automatica con logica gerarchica robusta
• Impatto immediato: Tutte nuove installazioni funzionano correttamente dall'inizio
• Compatibilità totale: Nessun impatto su sincronizzazioni esistenti

🚀 CARATTERISTICHE PRINCIPALI

SINCRONIZZAZIONE BIDIREZIONALE AUTOMATICA
Prodotti, varianti, ordini, clienti, scorte, immagini, collezioni - Sincronizzazione tempo reale GraphQL API

GESTIONE MULTI-ENTITÀ NATIVA
Supporto completo installazioni Dolibarr complesse con separazione dati garantita

INTERFACCIA AMMINISTRATIVA PROFESSIONALE
Dashboard completa, configurazione intuitiva, diagnostica esperta 47 punti, log dettagliati

ARCHITETTURA TECNICA ROBUSTA
Shopify GraphQL API, retry automatico, sicurezza rafforzata, transazioni atomiche

🔧 CARATTERISTICHE PRINCIPALI PRESERVATE

Sincronizzazione prodotti avanzata + Gestione ordini automatizzata + Clienti unificati

Prodotti semplici e varianti: Gestione completa prodotti padre e variazioni
• Sincronizzazione configurabile: Prezzi, descrizioni, immagini, scorte, attributi a scelta
• Prezzi multinivello: Supporto completo tariffazione Dolibarr con selezione livello prezzo
• Immagini alta qualità: Sincronizzazione automatica con conversione WebP a JPEG
• Collezioni gerarchiche: Mapping bidirezionale intelligente verso collezioni Shopify

Gestione ordini automatizzata
• Importazione tempo reale: Recupero intelligente a lotti configurabile con paginazione
• Gestione sconti completa: Supporto codici promo e sconti globali
• Calcoli IVA precisi: IVA ponderata e gestione fiscalità internazionale
• Stati sincronizzati: Aggiornamento bidirezionale stati ordini
• Importazione storica: Data installazione come riferimento automatico

Sincronizzazione clienti unificata
• Base CRM centralizzata: Importazione e aggiornamenti automatici da Shopify
• Indirizzi completi: Sincronizzazione indirizzi fatturazione e spedizione
• Gestione multi-entità: Supporto completo ambienti multi-azienda

🚀 PRESTAZIONI E AFFIDABILITÀ v2.0.29

Correzioni critiche: Risoluzione completa bug multi-entità e diagnostica
• Compatibilità universale: Polyfill automatico tutte versioni Dolibarr (v19-21+)
• Diagnostica migliorata: Esportazione JSON 47 verifiche + versione dinamica
• Diagnostica professionale: Interfaccia completa identificazione/risoluzione problemi automatizzata ereditata v2.0.27
• Architettura modernizzata: Migrazione standard Dolibarr con prestazioni ottimizzate (+40%)

💼 VANTAGGI BUSINESS MIGLIORATI

Sincronizzazione senza perdite: Correzioni bug critici garantendo nessun ordine mancato
• Compatibilità multi-entità: Adattamento automatico ambienti Dolibarr complessi
• Diagnostica completa: Supporto tecnico con esportazione JSON diagnostico migliorato
• Prestazioni garantite: Architettura modernizzata con cache nativa (+40% velocità)
• Scalabilità illimitata: Gestione migliaia prodotti/ordini senza interruzione

🔧 SPECIFICHE TECNICHE

Compatibilità: Dolibarr 19-21+, PHP 7.4-8.3+
• API: Shopify Admin GraphQL 2024-07 con 4 nuovi metodi collezioni
• Database: MySQL/MariaDB con query condizionali universali
• Lingue: Francese, Inglese, Tedesco, Spagnolo, Italiano (traduzioni complete)
• Prestazioni: Elaborazione a lotti configurabile per ottimizzazione server

📞 SUPPORTO PROFESSIONALE

Sviluppato da Associazione P'tite Tête, specialista soluzioni e-commerce Dolibarr dal 2021.

• Documentazione completa: Guida configurazione integrata passo dopo passo
• Supporto tecnico: Assistenza dedicata via DoliStore con esportazione JSON diagnostico automatizzata
• Aggiornamenti regolari: Evoluzione continua basata su feedback utenti
• Sito dedicato: shopifyintegration.ptitetete.com

Diagnostica e sincronizza i tuoi sistemi Shopify-Dolibarr con la soluzione più avanzata!

AUTORE: P'tite Tête
SITO WEB: https://shopifyintegration.ptitetete.com
SUPPORTO: shopifyintegration@ptitetete.com
VERSIONE: 2.0.29 (2025-09-05)