Integrazione
Se non ti sei ancora registrato a Zonos, compila il nostro modulo di contatto commerciale per iniziare. Un referente dedicato all'onboarding ti contatterà entro 24 ore per guidarti nel processo di integrazione una volta attivo l'accordo contrattuale.
Integra Checkout con il tuo negozio Magento seguendo i passaggi di questa sezione:
Installa l'app Checkout
Per usare Checkout con Magento, devi acquistare l'estensione dal Magento Marketplace e installarla nel terminale con Composer. Questo approccio è più tecnico rispetto agli altri plugin a causa del modo in cui Magento gestisce le estensioni. Per installare l'app:
- Scarica l'estensione Checkout dal Magento Marketplace.
- Scarica l'estensione Hello dal Magento Marketplace.
- Apri un nuovo terminale, vai alla directory root della tua installazione Magento e segui le istruzioni riportate di seguito.
Esegui il seguente comando per aggiungere Checkout alle dipendenze del tuo sito. Hello verrà incluso automaticamente.
composer require zonos/checkoutQuindi esegui il seguente comando per abilitare il modulo Checkout.
php bin/magento module:enable Zonos_CheckoutOra esegui il seguente comando per installare l'estensione ed eseguire eventuali migrazioni del database necessarie.
php bin/magento setup:upgradeInfine, esegui il seguente comando per compilare una nuova versione del sito che include il plugin Checkout.
php bin/magento setup:di:compileNota: Checkout ha una dipendenza da Hello, quindi i comandi sopra installeranno entrambi.
Configura Magento
- Vai al tuo admin Magento -> Stores -> Configuration -> Zonos -> Zonos Checkout.
- Copia la tua chiave API Zonos da Dashboard e inseriscila come Service token.
- Copia il tuo numero account Zonos da Dashboard e inseriscilo come Store ID number.
- In Domestic shipping countries, seleziona tutti i tuoi Paesi domestici.
- In Cart item attribute mapping, scegli le informazioni che desideri mappare. Per impostazione predefinita, Zonos recupererà peso articolo, prezzo, descrizione e Paese di produzione (se disponibile). Questa sezione contiene campi aperti a cui possono essere passate le informazioni degli articoli per importare codici HS, lunghezza, larghezza, altezza o qualsiasi attributo personalizzato a livello di articolo che Zonos possa utilizzare per regole speciali necessarie nel calcolo dei preventivi.
Configura le impostazioni generali
Quando configuri l'app Checkout in Magento, dovrai apportare anche alcune modifiche alle impostazioni General di Magento.
- Vai al tuo admin Magento -> Stores -> Configuration -> General.
- Nella sezione Allow countries, seleziona tutti i Paesi verso cui desideri spedire, internazionalmente e domesticamente. Se un Paese non è selezionato qui ma è abilitato in Zonos, l'ordine potrà essere completato e apparirà in Dashboard, ma non verrà importato in Magento.
- Zonos consiglia inoltre di selezionare tutti i Paesi tranne gli Stati Uniti nella sezione Zip/postal code is optional for. Questo riduce gli errori nel completamento degli ordini, poiché alcuni Paesi non usano o non richiedono codici postali. Inoltre, poiché Checkout include la protezione antifrode di Zonos, non incorrerai in rischi aggiuntivi rimuovendo questo requisito.
Configura Hello
Hello viene aggiunto con l'installazione dell'app Checkout. Segui le istruzioni di configurazione riportate di seguito per Hello.
- Vai al tuo admin Magento -> Stores -> Configuration -> Zonos -> Zonos Hello.
- Copia la tua Hello site key da Dashboard e inseriscila come Site Key.
- Se desideri che Hello converta la valuta, incolla i selettori CSS nel campo Currency conversion selectors. Più selettori sono separati da una virgola, ad es.
.price,.__current-price,.__subtotal,.__original-price.- Se la valuta base del tuo negozio non è USD, indica a Hello la valuta base del negozio in Dashboard -> Hello.
- Se devi Hide domestic elements per i tuoi clienti internazionali, inserisci i selettori CSS per gli elementi che desideri nascondere, ad es.
.nav-6,.action-add.
Regola le impostazioni avanzate
Facoltativo — Le impostazioni seguenti sono avanzate. Sono già presenti valori predefiniti, quindi non è necessaria alcuna azione. Se desideri apportare modifiche, segui queste linee guida:
- Vai al tuo admin Magento -> Stores -> Configuration -> Zonos -> Zonos Checkout.
- Regola in base alle tue preferenze:
- Create invoice on import — Impostato su Yes per impostazione predefinita. Zonos creerà una fattura al momento dell'importazione dell'ordine. Se scegli di disabilitare questa funzionalità, dovrai creare la fattura autonomamente e Zonos imposterà un blocco per revisione antifrode allo stato
zonos_hold. Una volta rimossa la frode, torneremo allo stato precedente. - Customer login — Impostato su No per impostazione predefinita. Se desideri richiedere un account per il checkout, passa a Yes. Dovrai anche andare in Customer configuration -> Login options e aggiornare Redirect Customer to Account Dashboard after Logging In su No.
- Create invoice on import — Impostato su Yes per impostazione predefinita. Zonos creerà una fattura al momento dell'importazione dell'ordine. Se scegli di disabilitare questa funzionalità, dovrai creare la fattura autonomamente e Zonos imposterà un blocco per revisione antifrode allo stato
Testa l'integrazione
Ora che hai configurato l'account e l'app, puoi testare l'integrazione. Durante i test dovrai abilitare Checkout e Hello in Magento. Per farlo:
- Vai al tuo admin Magento -> Stores -> Configuration -> Zonos -> Zonos Checkout.
- Imposta Enabled su Yes.
- Passa a Zonos Hello nel menu a sinistra.
- Imposta Enabled su Yes.
Se non sei ancora pronto per andare live, ricorda di riportare entrambi su No al termine dei test. Dopo aver completato i test, abilita Zonos seguendo gli stessi passaggi sopra.
Disinstalla Checkout
La disinstallazione delle app deve essere eseguita da uno sviluppatore Magento esperto tramite Composer. Esegui questo comando per disinstallare Checkout e Hello:
php bin/magento module:uninstall Zonos_Checkout Zonos_HelloQuali informazioni sui prodotti devo fornire per il preventivo più accurato su dazi, imposte e costi di spedizione?
Le informazioni sui prodotti possono influire sull'importo di dazi e imposte dovuti e sul costo di spedizione. Più informazioni sui prodotti fornisci a Zonos, più preciso sarà il preventivo restituito. Zonos può generare un preventivo anche quando queste informazioni non sono disponibili, ma consiglia di fornire i seguenti dettagli chiave sui prodotti per migliorare l'accuratezza:
- Peso: Il peso influisce sul costo di spedizione, che può influire su dazi o imposte. I pesi nelle schede prodotto Magento vengono utilizzati automaticamente da Zonos quando presenti.
- Dimensioni: Le dimensioni possono influire sul costo di spedizione, che può influire su dazi o imposte. Zonos può utilizzare le dimensioni del prodotto (lunghezza, larghezza e altezza) impostate su ciascun prodotto in Magento, ma devi mapparle nell'app Zonos per un'integrazione corretta.
- Codici HS: I codici HS influiscono sulle aliquote dei dazi e a volte possono influire sulle imposte. Zonos può utilizzare i codici HS impostati nelle schede prodotto Magento, ma devi mappare il campo codice HS nell'app Zonos.
- Paese di origine: Il Paese di origine di un prodotto influisce sulle aliquote dei dazi e può influire sulle imposte. Il Paese di origine impostato nelle schede prodotto Magento viene utilizzato automaticamente da Zonos quando presente.
Dettagli prodotto trasmessi a Zonos da Magento
| Dettagli prodotto↕ | Pesi↕ | Dimensioni↕ | Codice HS↕ | Paese di origine↕ |
|---|---|---|---|---|
| Trasmessi automaticamente | ||||
| Devono essere mappati |
Nota: In alternativa, puoi inserire le informazioni in Catalog, sostituendo quelle memorizzate e trasmesse da Magento.
Scopri di più sulle informazioni prodotto per piattaforma.
Checkout per Magento
Integra il plugin Checkout per Magento.Prima di integrare Zonos Checkout, assicurati che funzioni come ti aspetti. Ecco com'è l'esperienza quando usi Checkout: