DOCS

WooCommerce

Zonos Checkout per WooCommerce

Integra l'estensione Checkout per WooCommerce.

Lista di controllo per l'integrazione 

Segui questa lista di controllo completa per configurare il tuo account Zonos Dashboard e integrare l'estensione Zonos Checkout per WooCommerce.

1

Crea un account Zonos

Per iniziare, ti preghiamo di contattare il nostro team vendite per creare un account e firmare un accordo. Una volta firmato l'accordo, riceverai due micro depositi nel tuo account che devono essere verificati.

Ti preghiamo di inviare questi importi dei micro depositi a accounting@zonos.com con il tuo ID negozio Dashboard (CC il tuo rappresentante di vendita).

Una volta verificati, i tuoi dettagli bancari verranno visualizzati in Dashboard -> Impostazioni -> Fatturazione.

2

Configura le impostazioni di Dashboard e Checkout

Dopo aver creato il tuo account Zonos, dovrai configurare le impostazioni nel Dashboard per garantire che Checkout funzioni correttamente con il tuo negozio. Questa sezione copre tutte le configurazioni essenziali del Dashboard.

Configura i pagamenti

Collega un conto bancario per ricevere pagamenti tempestivi da Checkout. I pagamenti vengono elaborati quotidianamente con un ritardo di 2 giorni dal pagamento catturato. Per fare ciò, segui questi passaggi:

  1. Naviga su Dashboard -> Impostazioni -> impostazioni Checkout.
  2. Clicca su Aggiungi conto bancario.
  3. Verrai reindirizzato a un portale Stripe per completare la configurazione e fornire le seguenti informazioni:
    • Informazioni sul conto bancario.
    • EIN dell'azienda.
    • Numero di previdenza sociale di un proprietario dell'azienda al 25%. Per ulteriori dettagli su perché è richiesto, consulta la documentazione di Stripe.

Nota: Se hai bisogno di aggiornare il tuo programma di pagamento, ti preghiamo di contattare support@zonos.com

Configura i domini consentiti

Zonos Checkout richiede un elenco di domini consentiti per motivi di sicurezza. Questo impedisce a siti non autorizzati di caricare Checkout e garantisce che funzioni solo sui tuoi domini approvati. Senza questa configurazione, Checkout restituirà errori di autorizzazione.

Per configurarlo:

  1. Naviga su Dashboard -> Impostazioni -> impostazioni Checkout.
  2. Sotto URL, aggiungi il tuo dominio completo e eventuali sottodomini in cui verrà utilizzato Checkout. Ad esempio, se il tuo dominio è example.com, dovresti aggiungere example.com e test.example.com.

Personalizza le impostazioni del marchio

Configura le impostazioni del tuo marchio nel Dashboard per adattarle all'aspetto e alla sensazione del tuo negozio.

Per fare ciò, segui questi passaggi:

  1. Naviga su Dashboard -> Impostazioni -> impostazioni Checkout -> Branding
  2. Configura le seguenti impostazioni:
    • Logo.
    • Colore del marchio e accento.
    • Tema, Stile e Font.

Per ulteriori informazioni sulle impostazioni del marchio, consulta la nostra documentazione.

Collega un corriere

Per quotare la spedizione su checkout, dovrai collegare un corriere al tuo account Zonos. Questo ti permetterà di abilitare specifici livelli di servizio di spedizione su checkout.

Per collegare un corriere, segui questi passaggi:

  1. Naviga su Dashboard -> Impostazioni -> Spedizione -> Tariffe.
  2. Clicca su Aggiungi corriere.
  3. Segui le istruzioni per la configurazione del corriere.

Per ulteriori dettagli su come collegare gli account dei corrieri, consulta la nostra documentazione.

Configura le zone di spedizione

Le zone di spedizione ti consentono di configurare quali corrieri e livelli di servizio di spedizione sono disponibili per diverse regioni del mondo.

Per configurare le zone di spedizione, segui questi passaggi:

  1. Naviga su Dashboard -> Impostazioni -> Spedizione -> Località.
  2. Clicca su Nuova zona.
  3. Inserisci un nome per la zona e seleziona i paesi a cui desideri spedire.
  4. Seleziona il corriere e il livello di servizio che desideri offrire.

Per ulteriori dettagli sulle zone di spedizione, consulta la nostra documentazione.

Configura un paese di origine di fallback e codice HS

Il paese di origine e il codice HS vengono utilizzati per calcolare dazi e tasse accurati.

Se non fornisci un paese di origine specifico o un codice HS, utilizzeremo i fallback impostati nel Dashboard.

Per impostare il tuo paese di origine di fallback e il codice HS:

  1. Naviga su Dashboard -> Impostazioni -> Spedizione -> Catalogo.
  2. Per il paese di origine, seleziona il paese in cui viene fabbricata la maggior parte dei tuoi prodotti.
  3. Per il codice HS, inserisci il codice HS del tuo prodotto più comune. Se non hai un codice HS, naviga su Classify nel Dashboard e inserisci il nome e la descrizione del tuo prodotto per generare un codice HS accurato.
3

Installa e configura l'estensione Checkout per WooCommerce

Segui questi passaggi per installare e configurare l'estensione Checkout per WooCommerce.

Installa l'estensione

  1. Accedi all'amministrazione di WordPress.
  2. Nella sezione plugin, cerca l'estensione Zonos Checkout for WooCommerce.
  3. Clicca su Installa e attiva.

Collega l'estensione al tuo account Zonos

  1. Nel tuo amministratore WordPress, clicca su Estensione Zonos Checkout nella navigazione a sinistra.

  2. Clicca su Impostazioni generali.

  3. Inserisci la tua Chiave API privata e ID Negozio per collegare le impostazioni del tuo Dashboard Zonos al tuo sito WooCommerce.

    1. Trova la chiave API privata del tuo negozio in Dashboard. Ci sono diverse chiavi API disponibili. Seleziona la chiave API che ha il nome del tuo negozio, il Tipo è Segreto, e il Token inizia con credential_live. Inserisci questa chiave API nel campo Chiave API privata nelle Impostazioni generali dell'estensione.

    2. Copia il tuo ID Negozio da Dashboard e inseriscilo nel campo ID Negozio nelle Impostazioni generali dell'estensione.

  4. Abilita l'app in modalità di test.

    1. Per impostazione predefinita, la Modalità di test è attivata. Quando la modalità di test è abilitata, i clienti non verranno reindirizzati a Zonos Checkout.

Configura il tuo pulsante internazionale checkout

Hai due opzioni per configurare come i clienti internazionali accedono a Zonos Checkout.

Utilizza il tuo attuale pulsante checkout per entrambi i clienti nazionali e internazionali:

Configura il tuo attuale pulsante checkout per reindirizzare automaticamente i clienti internazionali a Zonos Checkout mantenendo i clienti nazionali nel flusso standard di checkout. Per farlo, segui questi passaggi:

  1. Nelle Impostazioni generali dell'estensione, inserisci il selettore CSS del tuo pulsante checkout (ad esempio, #checkout-button o .woocommerce-checkout-button).
  2. Clicca su Salva impostazioni generali.

Per trovare il tuo selettore CSS, fai clic destro sul tuo pulsante checkout, seleziona "Ispeziona" e cerca l'attributo id o class nell'HTML. Se hai più pulsanti checkout, includi il selettore CSS di ciascun pulsante o configura tutti i pulsanti per reindirizzare alla pagina del carrello e utilizza il selettore del pulsante checkout della pagina del carrello.

Aggiungi un pulsante dedicato internazionale checkout

Crea un pulsante dedicato internazionale checkout, ideale se hai molti utenti VPN o clienti con sede negli Stati Uniti che devono spedire a un indirizzo internazionale.

Per creare un pulsante separato per i clienti internazionali:

  1. Nelle Impostazioni generali dell'estensione, inserisci il selettore CSS del tuo pulsante checkout (ad esempio, #checkout-button o .woocommerce-checkout-button).

  2. Attiva il Pulsante internazionale checkout a destra.

  3. Configura l'aspetto del pulsante:

    • Inserisci il testo del pulsante (ad esempio, "Internazionale Checkout" o "Globale Checkout").
    • (Opzionale) Aggiungi CSS personalizzato per abbinare il design del tuo negozio come mostrato nell'esempio qui sotto. Se non viene fornito alcun CSS personalizzato, il pulsante verrà impostato per impostazione predefinita sullo schema di colori principale del tuo negozio. Ti consigliamo di testare l'aspetto del pulsante su dispositivi desktop e mobili.
  4. Clicca su Salva impostazioni generali.

Abilita gli Stati Uniti nelle zone di spedizione: Quando abilitato, il pulsante internazionale dedicato checkout apparirà per tutti i clienti. Per consentire ai clienti con sede negli Stati Uniti di utilizzare il checkout internazionale (ad esempio, quando si utilizza una VPN o si spedisce a un indirizzo internazionale), è necessario abilitare gli Stati Uniti nelle Zone di spedizione in Dashboard. Senza questa impostazione, i clienti con sede negli Stati Uniti non verranno reindirizzati a Zonos Checkout.

5

Mappa le impostazioni di WooCommerce

Personalizza Zonos per integrarsi perfettamente con il tuo negozio WooCommerce, garantendo calcoli precisi di dazi, tasse e spedizioni. Utilizza la scheda Impostazioni di mappatura per allineare i dettagli e gli attributi del prodotto con la configurazione del tuo ecommerce. Sebbene siano forniti valori predefiniti, puoi configurare queste impostazioni per soddisfare i requisiti unici del tuo negozio.

Dettagli del prodotto, dettagli personalizzati, peso e dimensioni

Questi campi sono mappati ai valori comuni predefiniti. I valori contrassegnati con un asterisco (*) sono obbligatori. Se utilizzi un'app di terze parti che sovrascrive alcuni campi (*), assicurati che questi campi (*) siano mappati correttamente ai valori utilizzati dall'app di terze parti.

Gestisci le informazioni sul prodotto con il Catalogo

Puoi anche gestire le informazioni sul prodotto con Catalogo in Dashboard.

Se aggiungi peso, dimensioni, codici HS o paese di origine al Catalogo, Checkout utilizzerà sempre quei campi. Se sono presenti informazioni sia nella piattaforma di ecommerce che nel Catalogo, le informazioni presenti nel Catalogo avranno la precedenza sulle informazioni inviate dalla piattaforma di ecommerce durante i nostri calcoli. Ad esempio, se il peso di un prodotto è presente in WooCommerce e nel Catalogo, Zonos utilizzerà il peso presente nel Catalogo per calcolare la spedizione.

Attributi del prodotto

Se i tuoi prodotti hanno attributi unici come colore o dimensione applicati alle varianti, dovrai mappare questi attributi nell'estensione Zonos. Ciò garantisce che quando un ordine viene evaso, il tuo negozio WooCommerce e l'inventario vengano aggiornati con il prodotto corretto spedito. Per mappare gli attributi, segui i passaggi descritti nella nostra documentazione sulla mappatura degli attributi del prodotto WooCommerce.

Nota: Se hai domande o hai bisogno di assistenza nella mappatura delle varianti del prodotto, contatta support@zonos.com.

6

Testa la tua integrazione

Ora che hai configurato il tuo account e la tua app, sei pronto per testare la tua integrazione.

Per effettuare un ordine di prova su checkout:

  1. Aggiungi ?zonosTestMode=1 all'URL del tuo negozio per essere reindirizzato a Zonos Checkout.
  2. Cambia Zonos Hello nel paese che desideri testare cliccando sulla bandiera di Hello e selezionando il paese che desideri testare. Questo è necessario altrimenti non sarai reindirizzato a Zonos Checkout se utilizzi un singolo pulsante checkout. Puoi aggiornare Hello cambiando zCountry= nell'URL con il paese che desideri testare. Ad esempio, se desideri testare il Canada, dovresti inserire CA in zCountry=CA.
  3. Completa il processo di checkout e effettua un ordine. Consulta la nostra documentazione generale sui test per ulteriori dettagli.
  4. Dopo aver completato i test, abilita Zonos disattivando Test mode. Questo renderà la tua integrazione attiva e permetterà agli acquirenti internazionali di utilizzare Zonos Checkout.

Alcune cose da ricordare:

  • De minimis—Se il subtotale del carrello del tuo ordine è inferiore al de minimis del paese di destinazione, potrebbero non esserci dazi o tasse dovuti. Questo è riflesso nei nostri calcoli.
  • Rimborsi e cancellazioni—Stiamo raccogliendo il pagamento, quindi se hai bisogno di effettuare rimborsi o cancellazioni, ti preghiamo di elaborare questi nel Dashboard.
  • Etichette—Stampa le etichette per tutti gli ordini internazionali nel Dashboard, a meno che tu non sia stato certificato per stampare etichette al di fuori del Dashboard. Questo è necessario affinché Zonos possa pagare i dazi e le tasse per tuo conto.

Post-integrazione 

La tua estensione Zonos importerà automaticamente gli ordini da Zonos a WooCommerce. Tuttavia, ci possono essere rare istanze in cui un ordine potrebbe non essere importato o uno stato dell'ordine in WooCommerce non è sincronizzato con il Dashboard. Puoi utilizzare le seguenti funzionalità nell'estensione per importare ordini, sincronizzare manualmente gli stati degli ordini e abilitare impostazioni avanzate per risolvere problemi.

Importa ordini manualmente

Se un ordine Zonos non è stato importato in WooCommerce, puoi utilizzare la scheda Order import per importare manualmente gli ordini in WooCommerce:

  1. Accedi a Dashboard.
  2. Naviga su Orders.
  3. Clicca sull'ordine che deve essere importato e copia il Zonos order number.
  4. In WordPress Admin, naviga alla scheda Order import nell'estensione Zonos, e inserisci il numero d'ordine Zonos nel campo Zonos order number.
  5. Clicca su Import order. Se l'ordine è stato importato con successo, l'ordine verrà visualizzato in WooCommerce e vedrai un banner "Ordine importato con successo" nella parte superiore della pagina. Se l'ordine non è riuscito a essere importato, vedrai un banner con i dettagli del messaggio di errore.

Sincronizza ordini manualmente

Se uno stato dell'ordine in WooCommerce non corrisponde allo stato in Zonos, puoi sincronizzare manualmente l'ordine.

  1. Accedi a Dashboard.
  2. Naviga su Orders.
  3. Clicca sull'ordine che deve essere importato e copia il Zonos order number.
  4. In WordPress Admin, naviga alla scheda Order sync nell'estensione Zonos, e inserisci il numero d'ordine Zonos nel campo Zonos order number.
  5. Clicca su Sync order. Lo stato dell'ordine in WooCommerce dovrebbe ora corrispondere allo stato dell'ordine nel Dashboard.

Impostazioni avanzate

Modalità di debug

Attiva la Debug mode per inviare a Zonos registri dettagliati per aiutarti a diagnosticare eventuali problemi e migliorare le prestazioni della tua integrazione.

Limite di Rate

Numero massimo di richieste webhook consentite per indirizzo IP al minuto. Il valore predefinito è 30 per proteggere da potenziali abusi.

Risoluzione dei problemi comuni

Se utilizzi un'app di caching come WP Rockett, dovrai clear la tua cache quando apporti modifiche alla tua estensione Zonos.

Domande frequenti

Quali informazioni sul prodotto dovrei fornire per ottenere la stima più accurata su dazi, tasse e costi di spedizione?

Le informazioni sul prodotto possono influenzare l'importo dei dazi e delle tasse dovuti e il costo totale della spedizione. Maggiore è la quantità di informazioni sul prodotto che fornisci a Zonos, più precisa sarà la stima restituita. Zonos può generare una stima anche quando queste informazioni non sono disponibili, ma raccomanda di fornire i seguenti dettagli chiave sul prodotto per migliorare l'accuratezza:

  • Peso: Il peso influisce sul costo di spedizione, che può influenzare i dazi o le tasse. I pesi nelle tue inserzioni di prodotto WooCommerce vengono utilizzati automaticamente da Zonos quando mappati. Puoi anche aggiungere peso a Catalog nel Dashboard per garantire calcoli di spedizione accurati.
  • Dimensioni: Le dimensioni vengono utilizzate per calcolare il peso dimensionale. I corrieri addebiteranno il peso maggiore tra il peso fisico e il peso dimensionale. Zonos può utilizzare le dimensioni del prodotto (lunghezza, larghezza e altezza) impostate su ciascun prodotto in WooCommerce per calcolare il peso dimensionale per garantire che tu collect l'importo corretto per la spedizione dai tuoi clienti. Puoi anche aggiungere dimensioni a Catalog nel Dashboard per garantire calcoli di spedizione accurati.
  • Codici HS: I codici HS influenzano le tariffe doganali e possono talvolta influenzare le tasse. Puoi mappare i valori dei codici HS in WooCommerce o utilizzare Catalog nel Dashboard.
  • Paese di origine: Il paese di origine di un prodotto influisce sulle tariffe doganali e può influenzare le tasse. Puoi mappare i valori del paese di origine in WooCommerce o utilizzare Catalog nel Dashboard.

Questa pagina è stata utile?