Identificatori e varianti dei prodotti#
L’elemento di destinazione del negozio deve identificare lo stesso prodotto presente nel catalogo del commerciante. La maggior parte dei problemi di integrazione nasce da una mancata corrispondenza tra questi due valori.
Scegliere un identificatore stabile#
Usa il productCode mostrato per il prodotto preparato. Nel tutorial Shopify è lo SKU della variante. I campi delle richieste Product Import API sono definiti nella documentazione dell’importazione; non sostituire questi nomi con quelli degli attributi del negozio.
Mantieni identici gli identificatori, incluse maiuscole e minuscole. Non generarli da nomi visualizzati che possono cambiare e non presumere che l’ID interno del prodotto di una piattaforma corrisponda a uno SKU.
Associare la variante selezionata#
| Stato del negozio | Comportamento dell’elemento di destinazione |
|---|---|
| È selezionata una variante preparata | Imposta il suo productCode esatto |
| La selezione cambia | Aggiorna l’elemento di destinazione e cancella lo stato obsoleto di SDK seguendo la guida all’integrazione |
| Non esiste uno SKU o un prodotto corrispondente | Mantieni nascosto o disabilitato il pulsante creato manualmente |
| Una scheda prodotto rimanda a una variante predefinita | Usa sempre l’identificatore di quella variante |
Per Shopify, collega la funzione di sincronizzazione del tutorial alla funzione di richiamo effettiva del tema per il cambio di variante. Per gli altri negozi, segui pagine dinamiche.
Convalidare le associazioni#
Scegli due varianti con prodotti visibilmente diversi. Annota i codici nel catalogo, controlla ogni data-product-code visualizzato negli strumenti per sviluppatori del browser, quindi apri Viewer per ciascuno. Ripeti dopo una navigazione senza ricaricamento completo della pagina.
Quando cambia un identificatore nel sistema di origine, coordina l’importazione nel catalogo e il rilascio del negozio. Una risposta HTTP di importazione riuscita indica soltanto l’accettazione; controlla lo stato del processo e gli errori dei singoli prodotti prima di usare il nuovo codice.