Collega Qapla’ con Magento 2
La connessione avviene tramite i Web Service ufficiali di Magento 2.
Per permettere a Qapla’ di comunicare con il tuo Magento 2 in cui è stato abilitato la Two-Factor Authentication, è necessario eseguire i passaggi descritti in seguito.
1. Creazione di un Ruolo (Nuova integrazione)
Dal pannello di amministrazione di Magento seleziona: System / Integrations
Seleziona «Add New Integration».
All’interno della sezione «Integration Info» compilare il campo «Name» con “Qapla Integration” e il campo “Your Password” con la tua password personale.
In seguito seleziona: API.
Clicca su «Role Resources» e seleziona «All» oppure seleziona i permessi minimi qui sotto:
Clicca su «Save & Activate».
Conferma l’integrazione clicando su «Allow».
Copia l’Access Token dalla sezione mostrata in seguito:
2. Inserisci i dati su Qapla’
Su Magento 2 la configurazione è terminata.
Accedi in Impostazioni > Canali > [Nome Canale] > Configura > E-Commerce, seleziona la piattaforma e riporta URL e Access Token di Magento 2.
Dopo l’inserimento, clicca su «Salva».
N.B. L’Access Token sarà sempre recuperabile, selezionando “Qapla Integration” all’interno della sezione System / Integrations.
3. Attivazione dell’importazione ordini
Per attivare l’importazione degli ordini accedi alla sezione: Impostazioni > Canali > [Nome Canale] > Configura > Importazioni > Ordini
Seleziona la modalità di importazione desiderata:
- Automatica: Qapla’ interrogherà la tua piattaforma ogni ora (alle .00, es. 9:00, 10:00, 11:00, ecc.) per importare nuovi ordini e aggiornare quelli già presenti.
- Manuale: puoi avviare l’importazione in qualsiasi momento dalla sezione Etichette, selezionando Magento 2 e cliccando su Importazione manuale.
Stati esclusi dall’importazione
Puoi escludere dall’importazione specifici stati ordine (oltre a quelli esclusi di default), personalizzando così il flusso in base alle tue esigenze operative.
Stati pagamento personalizzati per ordini in contrassegno (COD)
Alcune piattaforme CMS permettono di personalizzare gli stati di pagamento, oltre a quelli standard previsti dal sistema.
Se hai configurato degli stati pagamento personalizzati per identificare ordini in contrassegno (COD) è fondamentale comunicarlo al Customer Care Qapla’ per garantire una corretta gestione dell’importazione ordini.
Se utilizzi solo gli stati standard, non è richiesta alcuna azione.
Scrivere alla mail support@qapla.it elencando la dicitura esatta degli stati pagamento ordine personalizzati utilizzati per il contrassegno. Una volta confermato l’inserimento da parte del Customer Care Qapla’, gli ordini che presentano questi stati pagamento verranno riconosciuti automaticamente come ordini in contrassegno.
Impostazioni Avanzate
All’interno della sezione “Importazioni > Ordini” puoi attivare le seguenti opzioni:
- Importa immagini dei prodotti
- Importa il peso
- Codice doganale e Paese di origine: consente di importare questi dati dai prodotti dell’ordine, se disponibili nel CMS. Inserisci nel campo apposito il nome dell’attributo custom da leggere.
Pre-assegnazione corrieri
È possibile importare automaticamente il corriere scelto su Magento 2 in fase di checkout. Tuttavia, nel caso di Magento 2, questa configurazione richiede alcune attenzioni specifiche, poiché la piattaforma non restituisce codici corriere strutturati via webservice.
A differenza di altre piattaforme (es. PrestaShop), Magento 2 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 2.
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 richiedere una mappatura specifica.
Per configurare correttamente questa funzione:
- Analizza alcuni ordini reali presenti sulla tua piattaforma Magento 2 (puoi usare Qapla’ Checker), 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”
- Scrivere a support@qapla.it per completare la configurazione, inviando il nome del canale, tutti i codici e il corriere a cui associarli.
Alla successiva importazione, gli ordini saranno associati al corriere corretto.
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.
Imposta il peso di default
Imposta un peso predefinito da applicare agli ordini importati.
Imposta il numero di colli di default
Definisci un numero predefinito di colli per ciascun ordine importato
4. Aggiornamento dell’ordine su Magento 2
Per attivare l’aggiornamento automatico su Magento 2 accedi alla sezione: Impostazioni > Canali > [Nome Canale] > Configura > Aggiornamenti > E-commerce
Abilita le opzioni di aggiornamento disponibili:
- Complete
- Aggiorna l’ordine in “Complete” quando la spedizione è partita.
- Aggiorna l’ordine in “Complete” quando la spedizione è stata ritirata dal corriere.
- Aggiorna l’ordine in “Complete” quando la spedizione è consegnata.
- Tracking number: Aggiorna le spedizioni su Magento 2 inserendo il Tracking Number.
- Aggiungi l’elenco dei prodotti alle informazioni sulla spedizione (shipping document)
- Genera fattura al completamento dell’ordine su Magento 2
5. Attivazione dell’importazione spedizioni
Per attivare l’importazione delle spedizioni accedi alla sezione: Impostazioni > Canali > [Nome Canale] > Configura > Importazioni > Spedizioni > Connectors > Magento 2 Connector > Imposta Connector.
All’interno di questa sezione, imposta l’orario in cui Qapla’ eseguirà l’importazione delle spedizioni da Magento 2.
- È possibile configurare fino a due orari per canale
- Se desideri impostare più di due orari, contatta il nostro customer care scrivendo a support@qapla.it
L’importazione verrà eseguita automaticamente agli orari configurati.
Non funziona?
Qapla’ utilizza le API (Web Services) ufficiali di Magento 2.
Se non dovesse funzionare si consiglia di richiedere la verifica al gestore che amministra il sito su Magento 2.
Troubleshooting
| Errore | Descrizione | Soluzione |
|---|---|---|
| 401 Unauthorized | Qapla’ non è autorizzato ad accedere | La key fornita non è corretta o non è stata autorizzata seguendo la procedura spiegata sopra. |
| 403 Forbidden | Il server vieta l’accesso a Qapla’ | Verificare che il sito non abbia attive delle strategie di sicurezza (Firewall) e accertarsi che gli IP di Qapla’ siano autorizzati. Per richiedere l’elenco completo ed aggiornato degli IP, contatta la nostra assistenza scrivendo alla mail support@qapla.it. |
| 404 Not Found | La url o l’endpoint al quale si prova ad accedere non esiste | Verificare la correttezza della url del sito e confermare che il sito sia davvero un Magento 2. |
| 500 Internal Server Error | Errore interno del server del sito | Verificare la causa sul proprio server. |
| Bad HTTP response | Il sito non è raggiungibile | La url del sito è errata, non è online o non è più esistente. |
| 301 Moved Permanently | L’url del sito redireziona ad un’altra | Inserire la corretta url del sito. |
| 302 Found | L’url del sito redireziona ad un’altra | Inserire la corretta url del sito. |
| Could not resolve host: www.xxx.xx | La url non è esistente | Inserire la corretta url del sito. |
| OpenSSL SSL_connect: Connection reset by peer in connection to www.xxx.xx:443 | Problemi con il certificato del sito | Verificare il certificato https del sito. |
In generale le connessioni ai server rispondono con codici di errore HTTP.
