Usare ID prodotto alternativi negli ordini

Scopri come la mappatura ID alternativa aiuta Channable ad abbinare gli articoli degli ordini del marketplace ai prodotti corretti del webshop.

Usa la mappatura con ID alternativo quando gli articoli dell’ordine non corrispondono ai prodotti. Di solito succede quando i marketplace usano un identificativo diverso da quello del tuo webshop.

Che cos’è una connessione degli ordini?

Una connessione degli ordini sincronizza gli ordini del marketplace nella tua piattaforma e-commerce. Per creare una riga d’ordine, Channable deve abbinare ogni articolo dell’ordine a un prodotto.

Termini chiave (così il resto della pagina ha senso)

• ID univoco (identificativo prodotto del webshop): L’identificativo che la tua piattaforma e-commerce usa per fare riferimento a un prodotto (spesso uno SKU, ma non sempre).

• ID alternativo: Un altro identificativo memorizzato sullo stesso prodotto, come EAN/GTIN o MPN.

• Identificativo articolo del marketplace: L’identificativo che arriva nei dati dell’ordine. Spesso è Seller SKU.

Perché gli ID univoci sono importanti

Gli ID univoci collegano l’articolo dell’ordine al prodotto corretto del webshop. Se l’identificativo nell’ordine non esiste nel tuo webshop, la creazione dell’ordine non va a buon fine.

Configura un ID univoco in Channable

• Quando configuri un’API per un marketplace in Channable, durante il passaggio Impostazioni della configurazione dell’API devi selezionare il campo che corrisponde all’ID univoco. Questo identificativo viene poi inviato al marketplace e usato per abbinare i prodotti.

• Più precisamente, quando un ordine viene effettuato sul marketplace, Channable usa questo ID univoco per abbinare il prodotto nell’ordine al prodotto corrispondente nella tua piattaforma e-commerce.

Problemi con ID univoci errati o mancanti

• I problemi sorgono se i tuoi prodotti non sono stati inizialmente inseriti sul marketplace tramite Channable, oppure se l’ID univoco differisce da quello usato nella tua piattaforma e-commerce. In questi casi, Channable non riuscirà ad abbinare i prodotti negli ordini.

• Questa mancata corrispondenza genererà un errore che indica che il prodotto non è stato trovato, impedendo la creazione dell’ordine.

È qui che la mappatura con ID alternativo aiuta.

Come funziona la mappatura con ID alternativo

Quando importi i tuoi prodotti in Channable, teniamo traccia sia degli identificativi principali dalla tua fonte di importazione principale (la tua piattaforma e-commerce) sia degli identificativi alternativi più usati, come i codici EAN e i codici SKU.

Quando elabora un ordine, Channable può:

1. Leggere l’identificativo ricevuto dai dati dell’ordine del marketplace.

2. Provare ad abbinare quel valore agli ID alternativi tracciati (come EAN/GTIN).

3. Se trova una sola corrispondenza, creare la riga d’ordine del webshop per quel prodotto corrispondente.

Questo ti permette di elaborare gli ordini anche quando gli identificativi del marketplace sono diversi dall’identificativo principale del tuo webshop.

Channable al momento supporta le seguenti piattaforme e-commerce e i relativi campi identificativi standard:

Piattaforma	Campi identificativi
BigCommerce	sku, GTIN
CCVShop	sku_number, ean, ean_number, mpn
Lightspeed Eseries	sku
Lightspeed	sku, article_code, ean
Magento	sku, ean
MijnWebWinkel	sku, uuid
Prestashop	ean13, GTIN, reference
Shopify	sku, GTIN
Shoptrader	sku, ean
Shopware	ean, article_number
Squarespace	sku
WooCommerce	sku

Se vuoi usare campi identificativi che al momento non sono supportati, contatta pure il nostro team di supporto. Valuteremo la tua richiesta e, se possibile, la prenderemo in considerazione per futuri aggiornamenti.

Nota: Se aggiungi una seconda importazione (come un CSV) e sovrascrivi il valore di un identificativo, gli ordini possono fallire. La mappatura con ID alternativo si basa sugli identificativi registrati dalla tua fonte di importazione principale quando abbina gli articoli dell’ordine.

Quando usare la mappatura con ID alternativo

La mappatura con ID alternativo è particolarmente utile in diversi scenari per garantire un’elaborazione accurata degli ordini. Ecco le situazioni più comuni in cui questa funzione è utile:

• Uso di più identificativi

  • Scenario: le inserzioni dei tuoi prodotti sui marketplace usano una combinazione di codici EAN e codici SKU come identificativo principale.

  • Vantaggio: la mappatura con ID alternativo aiuta a garantire che gli ordini vengano abbinati correttamente ai prodotti corrispondenti nella tua piattaforma e-commerce, indipendentemente dall’identificativo usato dal marketplace.

• Sistemi legacy con strutture ID diverse

  • Scenario: la tua piattaforma e-commerce o il tuo sistema di gestione degli ordini usa una struttura ID diversa da quella richiesta dal marketplace.

  • Vantaggio: con la mappatura con ID alternativo, Channable può collegare sistemi ID diversi, garantendo che gli ordini vengano associati ai prodotti corretti senza bisogno di interventi manuali.

• Passaggio tra sistemi

  • Scenario: stai passando a una nuova piattaforma e-commerce o stai aggiornando il tuo sistema ID e, durante questo periodo, i tuoi prodotti potrebbero avere sia identificativi vecchi sia nuovi.

  • Vantaggio: la mappatura con ID alternativo ti permette di continuare senza interruzioni riconoscendo entrambi i set di identificativi, evitando problemi nell’elaborazione degli ordini.

Prima di attivare la funzione, controlla la mappatura ID registrata del tuo progetto. Vedi la sezione successiva per sapere come accedere a questi dati.

Accedere ai record di mappatura ID

Ci sono due modi per visualizzare i record di mappatura ID.

1

Visualizzare la mappatura ID per tutti gli articoli

Questa pagina ti permette di verificare le mappature ID che Channable sta tracciando prima di attivare la funzione. Controllando questi record, puoi assicurarti che tutto sia mappato correttamente. Questo passaggio è fondamentale per evitare possibili problemi che potrebbero verificarsi se la funzione venisse attivata senza una verifica adeguata.

Per ottenere una panoramica completa dei record di mappatura ID passati e attuali per tutti gli articoli (non solo gli ordini):

• Vai in Configura > Ordini nel tuo progetto.

• Fai clic sul pulsante Mappatura ID alternativa. Si aprirà un pop-up con tutti i record passati e attuali degli ID mappati per i tuoi prodotti.

Panoramica della mappatura ID alternativa (tutti gli articoli).

• Usa la casella di ricerca nell’angolo in alto a destra del pop-up per filtrare i record per ID, Titolo o altri criteri e navigare più facilmente.

Filtra i record di mappatura per ID, titolo o altri campi.

2

Visualizzare la mappatura ID per gli articoli usati negli ordini

Per vedere i record passati e attuali degli articoli usati negli ordini:

• Vai alla pagina Ordini nel tuo progetto e fai clic su Mappatura ID alternativa.

• Visualizza i record di mappatura ID passati e attuali per tutti gli articoli usati negli ordini.

Record di mappatura ID alternativa usati negli ordini.

Spiegazione delle colonne nell’interfaccia di mappatura ID

• ID univoco: l’identificativo usato dalla tua piattaforma e-commerce per fare riferimento al prodotto.

• ID alternativo: il tipo di identificativo che Channable sta tracciando, come SKU o EAN/GTIN.

• Valore: il valore effettivo dell’ID alternativo (ad esempio lo specifico codice SKU o EAN).

• Creato: la data e l’ora in cui il record di mappatura è stato creato.

• Status: indica se la mappatura è attualmente attiva o inattiva.

Prima di attivare la mappatura con ID alternativo

Controlla prima questi punti. Ti farà risparmiare tempo dopo.

• Conferma quale identificativo il marketplace restituisce nei dati dell’ordine (di solito Seller SKU).

• Conferma che il valore di quell’identificativo esista da qualche parte nel prodotto webshop corrispondente.

  • Esempio: il marketplace invia EAN, ma nel tuo prodotto webshop il campo EAN è vuoto.

• Controlla che non ci siano duplicati sugli ID alternativi.

  • Esempio: due prodotti condividono lo stesso EAN/GTIN.

• Controlla se una seconda importazione sovrascrive gli identificativi usati per la corrispondenza.

Checklist dettagliata di configurazione (consigliata)

Usa questa checklist prima di attivare l’impostazione. Previene la maggior parte dei problemi di “prodotto non trovato”.

1

1) Scegli la tua strategia di corrispondenza

Scegli un identificativo su cui vuoi far corrispondere gli ordini.

Scelte comuni:

• SKU: meglio se ogni articolo vendibile ha uno SKU stabile.

• EAN/GTIN: meglio se ogni articolo vendibile ha un codice a barre valido.

Evita di mescolare identificativi tra le inserzioni, a meno che non sia necessario.

2

2) Verifica che l’ID scelto esista sull’articolo vendibile (spesso sulle varianti)

Controlla il catalogo prodotti per l’ID scelto:

• Dovrebbe esistere al livello variante se vendi varianti.

• Dovrebbe essere compilato per i prodotti che vendi sul marketplace.

Fai un controllo manuale su almeno 10 articoli:

• 3 prodotti semplici

• 3 prodotti con varianti (più taglie/colori)

• 2 bestseller

• 2 prodotti “problematici” che in passato hanno fallito

3

3) Controlla la coerenza del formato

La corrispondenza è esatta. Piccole differenze la fanno saltare.

Controlla:

• Spazi iniziali/finali

• Maiuscole e minuscole diverse (soprattutto rilevante per gli SKU)

• Zeri iniziali che scompaiono (frequente con esportazioni CSV)

• Separatori diversi (SKU-001 rispetto a SKU001)

Correggi prima il formato nel sistema di origine.

4

4) Elimina i duplicati per l’ID alternativo scelto

I duplicati causano la situazione “trovate più corrispondenze”. In quel caso Channable non riesce a scegliere un prodotto in modo affidabile.

Fai un controllo dei duplicati nel catalogo per l’ID scelto:

• Se due prodotti condividono lo stesso EAN/GTIN, correggi o rimuovi uno dei valori.

• Se esistono SKU segnaposto (NA, 0, DEFAULT), sostituiscili.

Se non puoi eliminare i duplicati, passa a un’altra strategia di corrispondenza.

5

5) Conferma che la tua importazione principale sia la fonte attendibile

La mappatura con ID alternativo si basa sugli identificativi registrati dalla tua fonte di importazione principale.

Prima di attivare:

• Assicurati che la tua importazione principale contenga i valori corretti di SKU/EAN.

• Evita di sovrascrivere quegli identificativi tramite una seconda importazione (come un arricchimento CSV).

Se devi importare gli identificativi via CSV, mantieni la coerenza e considera un periodo di transizione.

6

6) Controlla i record di mappatura con ID alternativo

Apri la panoramica della mappatura e verifica cosa ha registrato Channable. Vedi Accedere ai record di mappatura ID.

Cosa controllare:

• ID alternativi mancanti per i prodotti che vendi

• Valori duplicati su prodotti diversi

• Valori vecchi/non aggiornati dopo una migrazione

7

7) Attiva e verifica su un piccolo campione

Attiva Usa ID alternativi per gli articoli dell’ordine sulla connessione degli ordini.

Poi verifica con almeno uno di questi:

• un ordine che in precedenza era fallito (ideale), oppure

• un nuovo ordine in arrivo

Controlla entrambi:

• L’ordine viene creato correttamente.

• Il la variante corretta viene abbinata.

8

8) Estendi e monitora

Una volta che la corrispondenza è corretta:

• Attivala anche sulle altre connessioni degli ordini (se ne hai).

• Monitora gli errori “prodotto non trovato” e “trovate più corrispondenze”.

Se gli errori aumentano, correggi prima i dati del catalogo. Evita soluzioni temporanee che introducono altra incoerenza negli identificativi.

Attiva la mappatura con ID alternativo

1

Seleziona la casella di controllo Usa ID alternativi per gli articoli dell’ordine nella connessione degli ordini che vuoi attivare.

Attiva gli ID alternativi per gli articoli dell’ordine.

2

Fai clic Salva. Puoi poi aprire la mappatura con ID alternativo (Configura > Ordini) per verificare le mappature tracciate.

Cosa non fa questa impostazione

La mappatura con ID alternativo aiuta ad abbinare gli articoli dell’ordine ai prodotti webshop esistenti. Non:

• modifica l’identificativo che invii a un marketplace quando inserisci i prodotti.

• corregge i valori duplicati di EAN/SKU nel catalogo del tuo webshop.

• garantisce la creazione dell’ordine quando il marketplace invia identificativi prodotto sconosciuti.

Scenari di corrispondenza con identificativi alternativi

Gli identificativi alternativi come EAN e i codici SKU non sono sempre univoci. Nel tuo catalogo prodotti potresti avere più prodotti con lo stesso EAN oppure prodotti senza alcun EAN. Channable abbina il corretto ID del database della piattaforma e-commerce in base all’identificativo alternativo ricevuto dal marketplace.

Verifichiamo se qualche ID del database della piattaforma e-commerce corrisponde all’ID prodotto nei dati dell’ordine per tutti gli identificativi alternativi monitorati. Possono verificarsi tre scenari:

1

Nessuna corrispondenza trovata

Channable non riesce ad abbinare l’identificativo del marketplace a un prodotto del webshop. Channable proverà a creare l’ordine usando l’identificativo del marketplace. Questo può fallire se il tuo webshop non riconosce quell’identificativo.

Correzione: aggiungi l’ID alternativo mancante al prodotto webshop, oppure modifica ciò che invia il marketplace.

2

Trovata esattamente una corrispondenza

Channable trova un solo prodotto webshop che corrisponde all’identificativo del marketplace. Channable crea la riga d’ordine per quel prodotto webshop corrispondente.

3

Trovate più corrispondenze

• Valori identici tra identificativi: Channable potrebbe tracciare più valori di identificativi alternativi per la tua piattaforma e-commerce (per esempio sia SKU sia EAN) e entrambi hanno valori identici per un prodotto. In questo caso esiste un solo ID del database della piattaforma e-commerce e l’ordine verrà creato usando quell’unico ID. Channable verifica che l’ID del database della piattaforma e-commerce collegato al record SKU ed EAN corrispondente sia lo stesso.

• Più prodotti con lo stesso identificativo: più prodotti distinti nella tua piattaforma e-commerce condividono lo stesso valore per un ID alternativo. Channable non può scegliere quello giusto. Channable tornerà all’identificativo del marketplace durante la creazione dell’ordine. Questo può causare un errore nella creazione dell’ordine nel tuo webshop.

Correzione: elimina i duplicati dei valori di identificativo nel tuo webshop, oppure cambia l’identificativo usato dal marketplace.

Controlli rapidi per la risoluzione dei problemi

Se continui a vedere “prodotto non trovato” dopo aver attivato l’impostazione, di solito dipende da uno di questi motivi.

• Il valore dell’ID alternativo è vuoto nel prodotto webshop.

• Il marketplace invia un identificativo diverso da quello che ti aspettavi.

  • Esempio: ti aspettavi EAN, ma viene inviato Seller SKU.

• Il valore dell’ID alternativo esiste, ma è duplicato su più prodotti.

• Una seconda importazione ha sovrascritto i valori degli identificativi dopo che erano stati registrati.