Zonos Checkout for WooCommerce

Per iniziare, contatta il nostro team commerciale per creare un account e firmare un accordo. Una volta firmato l’accordo, riceverai due micro depositi sul tuo account che devono essere verificati.

Invia via email questi importi dei micro depositi a accounting@zonos.com con il tuo Dashboard store ID (CC il tuo sales rep).

Una volta verificati, i dettagli bancari verranno visualizzati in Dashboard -> Settings -> Billing.

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

Imposta i payout 

Collega un conto bancario per ricevere payout tempestivi da Checkout. I payout vengono elaborati giornalmente con un ritardo di 2 giorni dal pagamento acquisito. Per farlo, segui questi passaggi:

1. Vai a Dashboard -> Settings -> Checkout settings .
2. Fai clic su Add bank account.
3. Verrai portato a un portale Stripe per completare la configurazione e fornire le seguenti informazioni:
   • Informazioni del conto bancario.
   • EIN dell’azienda.
   • Social Security Number di un proprietario dell’azienda al 25%. Per maggiori dettagli sul perché è richiesto, consulta la documentazione di Stripe.

Nota: Se ti serve aggiornare la pianificazione dei payout, contatta support@zonos.com

Imposta 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 venga eseguito solo sui tuoi domini approvati. Senza questa configurazione, Checkout restituirà errori di autorizzazione.

Per configurarlo:

1. Vai a Dashboard -> Settings -> Checkout settings.
2. In URLs, aggiungi il tuo dominio completo e eventuali sottodomini in cui verrà usato Checkout. Ad esempio, se il tuo dominio è example.com, dovresti aggiungere example.com e test.example.com.

Personalizza le impostazioni di branding 

Configura le impostazioni di branding in Dashboard per corrispondere all’aspetto del tuo negozio.

Per farlo, segui questi passaggi:

1. Vai a Dashboard -> Settings -> Checkout settings -> Branding
2. Configura le seguenti impostazioni:
   • Logo.
   • Colore del brand e di accento.
   • Theme, Style e Font.

Per maggiori informazioni sulle impostazioni di branding, consulta la nostra documentazione.

Collega un corriere di spedizione 

Per quotare la spedizione al checkout, dovrai collegare un corriere di spedizione al tuo account Zonos. Questo ti consentirà di abilitare specifici service level di spedizione al checkout.

Per collegare un corriere di spedizione, segui questi passaggi:

1. Vai a Dashboard -> Settings -> Shipping -> Rates.
2. Fai clic su Add carrier.
3. Segui le istruzioni di setup del corriere.

Per maggiori dettagli sul collegamento degli account corriere, consulta la nostra documentazione.

Imposta le zone di spedizione 

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

Per impostare le zone di spedizione, segui questi passaggi:

1. Vai a Dashboard -> Settings -> Shipping -> Locations.
2. Fai clic su New zone.
3. Inserisci un nome della zona e seleziona i Paesi verso cui vuoi spedire.
4. Seleziona il corriere e il service level che vuoi offrire.

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

Imposta un Paese di origine e un codice HS di fallback 

Il Paese di origine e il codice HS vengono usati per calcolare dazi e imposte accurati.

Se non fornisci un Paese di origine o un codice HS specifico, useremo i fallback impostati in Dashboard.

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

1. Vai a Dashboard -> Settings -> Shipping -> Catalog.
2. Per il Paese di origine, seleziona il Paese in cui viene prodotta 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, vai a Classify in Dashboard e inserisci il nome e la descrizione del tuo prodotto per generare un codice HS accurato.

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

Installa l’estensione 

1. Accedi al tuo WordPress admin.
2. Nei plugin, cerca Zonos Checkout for WooCommerce extension.
3. Fai clic su Install and activate.

Collega l’estensione al tuo account Zonos 

1. Nel tuo WordPress Admin fai clic sull’estensione Zonos Checkout nella navigazione a sinistra.

2. Fai clic su General Settings.

3. Inserisci la tua Private API key e il Store ID per collegare le impostazioni di Zonos Dashboard al tuo sito WooCommerce.

   1. Individua la private API key del tuo negozio in Dashboard. Sono disponibili diverse API key. Seleziona l’API key che ha il nome del tuo negozio, il Type è Secret e il Token inizia con credential_live. Inserisci questa API key nel campo Private API Key in General settings dell’estensione.

   2. Copia il tuo Store ID da Dashboard e inseriscilo nel campo Store ID in General settings dell’estensione.

4. Abilita l’app in modalità test.

   1. Di default, Test mode è attivato. Quando la modalità test è abilitata, gli acquirenti non verranno indirizzati a Zonos Checkout.

Configura il pulsante di checkout internazionale 

Hai due opzioni per configurare come gli acquirenti internazionali accedono a Zonos Checkout.

Usa il tuo pulsante di checkout attuale per acquirenti nazionali e internazionali: 

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

1. In General settings dell’estensione, inserisci il selettore CSS del tuo pulsante di checkout (ad es. #checkout-button o .woocommerce-checkout-button).
2. Fai clic su Save general settings.

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

Aggiungi un pulsante di checkout internazionale dedicato 

Crea un pulsante di checkout internazionale dedicato, ideale se hai molti utenti VPN o acquirenti basati negli USA che devono spedire a un indirizzo internazionale.

Per creare un pulsante separato per gli acquirenti internazionali:

1. In General settings dell’estensione, inserisci il selettore CSS del tuo pulsante di checkout (ad es. #checkout-button o .woocommerce-checkout-button).

2. Attiva International checkout button verso destra.

3. Configura l’aspetto del pulsante:

   • Inserisci il testo del pulsante (ad es. "International Checkout" o "Global Checkout").
   • (Facoltativo) Aggiungi CSS personalizzato per corrispondere al design del tuo negozio come mostrato nell’esempio seguente. Se non viene fornito CSS personalizzato, il pulsante userà di default lo schema di colori primario del tuo negozio. Consigliamo di testare l’aspetto del pulsante sia su desktop sia su dispositivi mobili.

4. Fai clic su Save general settings.

Abilita gli USA nelle Shipping zones: Quando abilitato, il pulsante di checkout internazionale dedicato apparirà per tutti gli acquirenti. Per consentire agli acquirenti basati negli USA di usare il checkout internazionale (ad esempio, quando usano una VPN o spediscono a un indirizzo internazionale), devi abilitare gli USA in Shipping zones in Dashboard. Senza questa impostazione, gli acquirenti USA non verranno reindirizzati a Zonos Checkout.

Personalizza Zonos per integrarsi senza problemi con il tuo negozio WooCommerce, garantendo calcoli accurati di dazi, imposte e spedizione. Usa la scheda Mapping settings per allineare i dettagli e gli attributi del prodotto con la tua configurazione ecommerce. Sebbene vengano forniti valori predefiniti, puoi configurare queste impostazioni per soddisfare i requisiti unici del tuo negozio.

Dettagli prodotto, dettagli personalizzati, peso e dimensioni 

Questi campi sono mappati a valori comuni predefiniti. I valori contrassegnati con un asterisco (*) sono obbligatori. Se usi un’app di terze parti che sovrascrive qualsiasi campo (*), assicurati che questi campi (*) siano mappati correttamente ai valori usati dall’app di terze parti.

Attributi prodotto 

Se i tuoi prodotti hanno attributi unici come colore o taglia applicati alle variazioni, dovrai mappare questi attributi nell’estensione Zonos. Questo garantisce che quando un ordine viene evaso, il tuo negozio WooCommerce e l’inventario vengano aggiornati con il prodotto corretto che è stato spedito. Per mappare gli attributi, segui i passaggi delineati nella nostra documentazione sulla mappatura degli attributi prodotto WooCommerce.

Nota: Se hai domande o ti serve assistenza per mappare le variazioni prodotto, contatta support@zonos.com.

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

Per effettuare un ordine di test al checkout:

1. Aggiungi ?zonosTestMode=1 all’URL del tuo negozio per essere indirizzato a Zonos Checkout.
2. Cambia Zonos Hello nel Paese che vuoi testare facendo clic sulla bandiera Hello e selezionando il Paese. Questo è necessario altrimenti non verrai reindirizzato a Zonos Checkout se usi un singolo pulsante di checkout. Puoi aggiornare Hello cambiando zCountry= nell’URL nel Paese che vuoi testare. Ad esempio, se volevi testare il Canada inseriresti CA in zCountry=CA.
3. Esegui il processo di checkout ed effettua un ordine. Consulta la nostra documentazione generale sui test per maggiori dettagli.
4. Dopo aver completato i test, abilita Zonos impostando Test mode su off. Questo renderà live la tua integrazione e consentirà agli acquirenti internazionali di usare Zonos Checkout.

Alcune cose da ricordare:

• De minimis—Se il subtotale del carrello del tuo ordine è sotto il de minimis del Paese di destinazione, potrebbe non esserci alcun dazio o imposta dovuto. Questo si riflette nei nostri calcoli.
• Rimborsi e cancellazioni—Stiamo riscuotendo il pagamento, quindi se ti serve effettuare rimborsi o cancellazioni, elaborali in Dashboard.
• Etichette—Stampa le etichette per tutti gli ordini internazionali in Dashboard, a meno che tu non sia stato certificato per stampare etichette al di fuori di Dashboard. Questo è richiesto affinché Zonos possa pagare dazi e imposte per tuo conto.

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

1. Accedi a Dashboard.
2. Vai a Orders.
3. Apri l’ordine che deve essere importato e copia il Zonos order number.
4. In WordPress Admin, vai alla scheda Order import nell’estensione Zonos e inserisci il Zonos order number nel campo Zonos order number.
5. Fai clic su Import order. Se l’ordine è stato importato correttamente, l’ordine comparirà in WooCommerce e vedrai il banner "Order imported successfully" in alto nella pagina. Se l’importazione dell’ordine non è riuscita, vedrai un banner con i dettagli del messaggio di errore.

Se lo stato di un ordine in WooCommerce non corrisponde allo stato in Zonos, puoi sincronizzare manualmente l’ordine.

1. Accedi a Dashboard.
2. Vai a Orders.
3. Apri l’ordine che deve essere importato e copia il Zonos order number.
4. In WordPress Admin, vai alla scheda Order sync nell’estensione Zonos e inserisci il Zonos order number nel campo Zonos order number.
5. Fai clic su Sync order. Lo stato dell’ordine in WooCommerce dovrebbe ora corrispondere allo stato dell’ordine in Dashboard.

Debug mode 

Attiva Debug mode per inviare a Zonos log dettagliati che ti aiutano a diagnosticare eventuali problemi e migliorare le prestazioni della tua integrazione.

Rate limit 

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

Se usi un’app di caching come WP Rockett, dovrai svuotare la cache quando apporti modifiche alla tua estensione Zonos.

Quali informazioni prodotto dovrei fornire per la quotazione più accurata su dazi, imposte e costi di spedizione? 

Le informazioni prodotto possono influire sull’importo di dazi e imposte dovuti e sul costo totale di spedizione. Maggiori sono le informazioni prodotto che fornisci a Zonos, più precisa sarà la quotazione restituita. Zonos può generare una quotazione anche quando queste informazioni non sono disponibili, ma consiglia di fornire i seguenti dettagli chiave del prodotto per migliorare l’accuratezza:

• Peso: Il peso influisce sul costo di spedizione, che può influire su dazi o imposte. I pesi nei listing prodotto WooCommerce vengono usati automaticamente da Zonos quando mappati. Puoi anche aggiungere il peso a Catalog in Dashboard per garantire calcoli di spedizione accurati.
• Dimensioni: Le dimensioni vengono usate per calcolare il peso dimensionale. I corrieri addebiteranno il peso maggiore tra peso fisico e peso dimensionale. Zonos può utilizzare le dimensioni del prodotto (lunghezza, larghezza e altezza) impostate su ciascun prodotto in WooCommerce per calcolare il peso dimensionale e assicurarti di riscuotere l’importo corretto di spedizione dai tuoi clienti. Puoi anche aggiungere le dimensioni a Catalog in Dashboard per garantire calcoli di spedizione accurati.
• Codici HS: I codici HS influiscono sulle aliquote dei dazi e a volte possono influire sulle imposte. Puoi mappare i valori dei codici HS in WooCommerce o usare Catalog in Dashboard.
• Paese di origine: Il Paese di origine di un prodotto influisce sulle aliquote dei dazi e può influire sulle imposte. Puoi mappare i valori del Paese di origine in WooCommerce o usare Catalog in Dashboard.