Codice di Transcodifica

Cos’è il Codice di Transcodifica?

Il codice di transcodifica è un “traduttore” che permette a Qapla’ di interpretare correttamente i dati provenienti dal tuo CMS, solo per:

Shopify
Prestashop
Magento
Magento 2.

Spesso il nome di un corriere registrato sul tuo sito (es. “Corriere Espresso”) non coincide esattamente con l’identificativo usato da Qapla’ (es. “GLS-Italy”). Senza transcodifica, il sistema potrebbe assegnare la spedizione al corriere sbagliato, impedendo la corretta importazione dell’ordine o il tracciamento della spedizione.

A cosa serve concretamente?

Pre-assegnazione per Import Ordini: Assicura che un ordine importato dal CMS sia già associato al corriere corretto.
Pre-assegnazione per Import Spedizioni: Fondamentale per importare la spedizione con il corriere corretto e seguire l’avanzamento del tracking.

Per impostarlo, accedere al proprio account Qapla’ nella sezione nella sezione: Canali > [Nome Canale] > Corriere > [Nome Corriere] > Codice di transcodifica

Attenzione!

Il sistema rimuove solo gli spazi iniziali e finali dal valore ricevuto dalla piattaforma (es. ” BRT ” diventa “BRT”).
Se su piattaforma il codice è “ROYAL MAIL” (spazio in mezzo), inserire il valore nel campo codice transcodifica esattamente come presente su piattaforma.
Il confronto tra il codice di transcodifica e il valore ricevuto dalla piattaforma è sensibile alle maiuscole e minuscole, ad esempio, se la piattaforma invia “Bartolini”, il codice “BARTOLINI” non corrisponderà. Inserisci il codice esattamente come presente sulla piattaforma.
Valori multipli: Se devi inserire più codici per lo stesso corriere, separali con una virgola e senza spazi, esempio: BARTOLINI,BRT,BRT-IT

Codici di transcodifica su Shopify

È possibile importare automaticamente il corriere preassegnato su Shopify.
Per configurare correttamente questa funzione vai su: Canali > [Nome Canale] > Importazione > Ordini > Pre-assegnazione corrieri > Pre-assegna il corriere importandolo da Shopify

Imposta i codici transcodifica:

Informazione: Qapla’ legge il valore dal campo shipping_lines > code. Se questo campo è vuoto, utilizza il campo shipping_lines > carrier_identifier come alternativa.

Verifica gli ordini su Shopify per analizzare il campo shipping_lines > carrier_identifier > “code”
Ogni valore presente nel campo “code” o “carrier_identifier” corrisponde al codice corriere necessario da associare ai corrieri disponibili al tuo canale/account.
Il codice corriere sarà necessario inserirlo nel campo Codice transcodifica nella sezione di configurazione corriere.
Si consiglia di verificare l’effettiva importazione e l’assegnazione corretta del corriere su uno o più ordini dopo il salvataggio della configurazione, per assicurarsi che la mappatura dei valori sia corretta

Codici di transcodifica su Prestashop

È possibile importare automaticamente il corriere preassegnato su Prestashop.
Per configurare correttamente questa funzione vai su: Canali > [Nome Canale] > Importazione > Ordini > Pre-assegnazione corrieri > Pre-assegna il corriere importandolo da Prestashop

Imposta i codici transcodifica:

Verifica gli ID Carrier presenti sulla tua piattaforma PrestaShop. Ogni ID carrier ha un codice corriere.
Ogni ID carrier configurato e utilizzato sulla tua piattaforma è necessario associarlo ai corrieri disponibili sul tuo canale/account.
Il codice corriere sarà necessario inserirlo nel campo Codice transcodifica nella sezione di configurazione corriere.
Ad esempio, se in PrestaShop il corriere con ID 3 si chiama “Corriere Espresso”, Qapla’ cercherà una corrispondenza con “Corriere Espresso”. Inserisci quindi il nome del corriere in maiuscolo come codice di transcodifica, non il numero ID.
Si consiglia di verificare l’effettiva importazione e l’assegnazione corretta del corriere su uno o più ordini dopo il salvataggio della configurazione, per assicurarsi che la mappatura dei valori sia corretta.

Codici di transcodifica su Magento e Magento 2

È possibile importare automaticamente il corriere preassegnato su Magento e Magento 2.
Per configurare correttamente questa funzione vai su: Canali > [Nome Canale] > Importazione > Ordini > Pre-assegnazione corrieri > Pre-assegna il corriere importandolo da Magento/Magento 2

È possibile importare automaticamente il corriere scelto su Magento in fase di checkout. Tuttavia, nel caso di Magento, questa configurazione richiede alcune attenzioni specifiche, poiché la piattaforma non restituisce codici corriere strutturati via webservice.
A differenza di altre piattaforme (es. PrestaShop), Magento non fornisce un identificativo univoco del corriere via API, ma trasmette due campi testuali generici:

“shipping_method”, esempio: tablerate_bestway
“shipping_description”, esempio: Corriere espresso

Il campo “shipping_description” rappresenta la descrizione visibile al cliente in fase di checkout, e non è un codice univoco, ma una semplice stringa. Questo valore può variare nel tempo, in base alla configurazione del merchant su Magento.
Più metodi di spedizione (shipping_method) possono corrispondere a corrieri diversi, e non sempre è possibile distinguere con certezza il corriere effettivamente selezionato.
Poiché si tratta di testi liberi, l’interpretazione del corriere corretto richiede una mappatura specifica.
Per configurare correttamente questa funzione:

Analizza alcuni ordini reali presenti sulla tua piattaforma Magento, così da verificare i valori presenti nel campo “shipping_description”.
In base a quanto rilevato, sarà possibile procedere all’inserimento nel campo Codice transcodifica nella sezione di configurazione corriere. Se desideri associare più stringhe è possibile inserirli separati da virgola, senza spazi. Esempio: “Corriere espresso,Spedizione standard,Corriere GLS”
Si consiglia di verificare l’effettiva importazione e l’assegnazione corretta del corriere su uno o più ordini dopo il salvataggio della configurazione, per assicurarsi che la mappatura dei valori sia corretta.

Per importare le spedizioni da Magento/Magento 2
Qapla’ legge il campo “carrier_code” della spedizione e lo converte automaticamente in maiuscolo. Se il “carrier_code” è “custom”, viene utilizzato il campo `title` (anch’esso in maiuscolo).

Hai bisogno di supporto?Se desideri assistenza contatta il Customer Care Qapla‘ scrivendo a support@qapla.it