Smart Wholesaler Feed Sync

Cosa fa il modulo

MPR Feed Sync è un modulo back office di sincronizzazione feed per PrestaShop. Recupera feed prodotto dei grossisti, normalizza i record in un modello prodotto comune, li abbina a prodotti e combinazioni esistenti, salva i diff dry-run e applica modifiche al catalogo solo dopo che i safety gate configurati autorizzano l'esecuzione.

Il modulo può aggiornare stock, prezzo, disponibilità, categoria, brand/produttore, nomi, descrizioni, immagini, combinazioni, attributi e caratteristiche. Ogni area è controllata da interruttori per feed, quindi un feed può essere limitato solo a stock e prezzo oppure esteso alla creazione prodotti e alla gestione varianti quando il negozio è pronto.

Posizione nel back office

Dopo l'installazione, usa Sell > Feed Sync. La dashboard del modulo mostra l'ultima esecuzione, il tasso di matching, i feed attivi, i prodotti gestiti, gli avvisi aperti, l'etichetta della prossima pianificazione, le esecuzioni recenti e link rapidi a Feeds, Mapper, Runs e Configuration. L'apertura della configurazione del modulo reindirizza al controller mapper/preview.

Configurazione globale

Apri Sell > Feed Sync > Configuration per copiare l'URL cron protetto da token e regolare i limiti di runtime.

• Global apply enabled: interruttore principale per la modalità Apply. Apply richiede comunque anche un dry run recente e un token di conferma.
• Fetch timeout seconds, Fetch connect timeout seconds e Fetch max bytes: limiti di trasporto usati dal recupero feed.
• Sync lock TTL seconds: durata del lock per le esecuzioni feed, così le esecuzioni sovrapposte vengono saltate invece di scrivere in concorrenza.
• Product create max count, Combination create max count e Create max percent: limiti globali di creazione usati dai safety gate.
• Image max count, Image max bytes, Image timeout seconds e Image connect timeout seconds: limiti per l'import immagini.

Creazione di un feed

Apri Sell > Feed Sync > Feeds e aggiungi un feed. I campi richiesti sono nome feed e URL/percorso feed. Scegli grossista, tipo sorgente, adapter o profilo di mapping, priorità di matching, ordine di priorità, ambito di sync, comportamento categoria, soglie di sicurezza, pianificazione e stato attivo.

• Feed URL / path accetta HTTP(S), FTP, FTPS, SFTP, URL/ID Google Sheets o un percorso locale assoluto dentro la directory di import configurata.
• Source type supporta url, ftp, ftps, sftp, file e google_sheets.
• Compression può rilevare automaticamente gzip, forzare gzip o disabilitare la decompressione.
• Source settings JSON salva opzioni avanzate come Google Sheets gid e range.
• I campi di autenticazione FTP/FTPS/SFTP salvano username/password e percorso/passphrase opzionali della chiave privata SFTP. I campi password/passphrase vuoti mantengono il segreto esistente durante la modifica.

Mapping dei feed

Usa Sell > Feed Sync > Mapper per sondare una sorgente, campionare record, creare o salvare profili di mapping e vedere l'anteprima degli elementi normalizzati. I campi canonici includono ean, sku, supplier_id, name, price, stock, location_quantities, avail, category, brand, variant_group_key, variant_key, variant_attributes, features, combination_ean, combination_reference, combination_price_impact, combination_stock, combination_images, images, e attrs.

Le trasformazioni disponibili includono trim, digits_only, decimal_normalize, lower, upper, prefix, suffix, regex_replace, split, concat, default_if_empty, e map_values. I preset includono Corsan XML, Google Shopping XML generico, Ceneo XML generico, CSV generico e JSON generico.

Dry run, Apply e rollback

Usa Dry-run nella schermata Feeds oppure esegui l'endpoint cron con action=dryrun. Un dry run recupera il feed, lo analizza, crea un indice prodotti, abbina gli elementi del feed, scrive righe mprfeedsync_run e mprfeedsync_run_diff e salva una firma di configurazione sul feed.

Usa Apply solo dopo aver verificato il risultato del dry-run. La modalità Apply richiede abilitazione Apply, token di conferma valido, firma dry-run recente, tassi valuta pronti e safety gate superati. Apply scrive le righe pianificate e registra lo stato applied/skipped/error per ogni riga diff. Le azioni rollback sono disponibili dalle schermate Feeds e Runs per le esecuzioni Apply.

Matching e override

Il matching usa prima le mappe esistenti del modulo quando sono coerenti, poi la match_priority. Le corrispondenze EAN e SKU/riferimento univoche hanno alta affidabilità; le corrispondenze solo per riferimento fornitore hanno bassa affidabilità e sono bloccate dalle scritture salvo che la policy le consenta. Chiavi feed duplicate, candidati catalogo ambigui, mappe ignorate e righe saltate come non sicure non sono trattate come righe scrivibili.

Il controller Mappings permette agli admin di congelare una mappa, scongelarla, ignorarla/riattivarla, rimapparla manualmente a un altro ID prodotto o impostare/cancellare un override categoria prodotto. Il congelamento protegge stock, prezzo, disponibilità, nome, descrizione e immagini per quella mappa.

Categorie e brand

La strategia categoria può essere default, manual o auto_path. Gli override categoria prodotto vincono per primi, poi le mappe categoria attive; la strategia manuale si basa su quelle mappe e auto-path può creare o risolvere percorsi categoria sotto la categoria radice configurata durante Apply.

La sincronizzazione brand usa la tabella brand map. Un brand del feed può essere mappato a un produttore PrestaShop, oppure Create if missing può creare un produttore dal valore brand del feed durante Apply. Gli override prodotto possono anche fornire un override produttore.

Sedi stock

Quando sync_location_stock è abilitato, le location_quantities del feed vengono scritte nei registri sede del modulo e la quantità stock del negozio viene aggiornata dalla strategia di aggregazione selezionata. Le strategie supportate sono sum, max, primary_location, e specific_location. Le sedi stock possono essere sedi virtuali gestite dal modulo o collegate ai magazzini Advanced Stock Management.

Valuta e prezzi

Se source_currency è impostato e differisce dalla valuta del negozio, il modulo richiede un provider tassi configurato prima di Apply. La sorgente tasso può essere manual or nbp, con margine tasso opzionale e settings JSON. I tassi sono memorizzati in cache in mprfeedsync_currency_rate; tassi richiesti mancanti o obsoleti bloccano Apply.

Inoltro ordini dropship

Apri Sell > Feed Sync > Dropship Orders per configurare l'inoltro ordini per feed. È disabilitato per impostazione predefinita. L'adapter predefinito generic_export scrive un documento ordine su disco e non contatta un fornitore. Per inviare all'esterno, scegli email_csv, email_xml o http_post, imposta l'ID dello stato ordine trigger e fornisci email fornitore, URL endpoint, options JSON o auth JSON secondo necessità.

Il modulo ascolta actionValidateOrder e actionOrderStatusPostUpdate. Quando un ordine raggiunge lo stato configurato, risolve solo le righe appartenenti al feed, crea un elemento coda idempotente per coppia ordine/feed, lo invia e conserva dati risposta/errore. L'azione cron di retry processa i record di inoltro in scadenza in coda o falliti fino al limite tentativi configurato.

Endpoint cron

Il front controller è /module/mprfeedsync/cron e richiede il token. Le azioni supportate sono parse, sync, dryrun, apply, status e alias di retry inoltro come forwarding_retry. I parametri opzionali includono id_feed, url, adapter_key, profile, id_mapping_profile, confirm or apply_token, limit e products.

Note operative

• Il modulo supporta PrestaShop da 1.7.0.0 fino alla versione installata _PS_VERSION_ secondo il costruttore del modulo.
• L'installazione crea tabelle del modulo per feed, profili, mappe prodotto, override, cronologia esecuzioni, diff, categorie, brand, tassi valuta, sedi, inoltro ordini, immagini, regole prezzo, avvisi e lock.
• La riconciliazione schema runtime e i controlli hook vengono eseguiti prima delle operazioni admin e cron quando disponibili.
• I lock di esecuzione sono salvati in mprfeedsync_sync_lock e impediscono esecuzioni sovrapposte per lo stesso feed o URL ad-hoc.
• I controlli di integrità sistema e la manutenzione delle tabelle del modulo sono disponibili dal controller integrity.