Obiettivo: Scopri come connettere il tuo negozio online Craft con il tuo account Sendcloud con pochi e semplici step.
Requisiti
- Questo plugin richiede la versione Craft CMS 3.3 o successive
- Questo plugin richiede la versione Craft Commerce 3.1 o successive (è necessaria la versione 3.2 o superiore per visualizzare il pannello laterale nella pagina dell'ordine)
- Il sito web di Craft dovrebbe essere accessibile al pubblico
- Per configurare il plugin, la modifica delle impostazioni dovrebbe essere consentita in Craft (consentire modifiche admin), e un utente che è un Admin in Craft. Clicca
qui
per accedere alle impostazioni. - Il plugin dovrebbe essere in grado di creare una tabella personalizzata nel tuo database
- Questo plugin è compatibile con Composer 2.0
Step 1: Installa il plugin Sendcloud
Per installare il plugin di Sendcloud per Craft CMS, segui i seguenti step:
- Apri il tuo terminale e vai al tuo progetto Craft:
cd /path/to/project
- Poi chiedi a Composer di caricare il plugin:
composer require white-nl/craft-commercesendcloud
- Installa il plugin tramite il CLI:
./craft install/plugin commercesendcloud
Installa
per Commerce Sendcloud.
Step 2: Attiva la tua licenza
Questo plugin richiede una licenza commerciale. Dopo aver installato il plugin, vedrai una barra di allerta in Craft. Clicca questa barra per attivare la tua licenza nel plugin store di Craft utilizzando il tuo ID Craft.
Step 3: Configurazione di base
A seguito dell'installazione, apri la pagina delle impostazioni del plugin nel tuo progetto Craft per completare la configurazione di Sendcloud in Craft.
- Connetti Craft a Sendcloud
Assicurati che il tuo sito Craft sia accessibile dai server Sendcloud. Poi cliccaRegistra
per connetterti a Sendcloud. Verrai reindirizzato al sito di Sendcloud e ti verrà chiesto di confermare l'integrazione. Dopo aver impostato la connessione, il suo stato dovrebbe essere Attivo in Craft (potresti dover ricaricare la pagina per visualizzare le modifiche). - Crea i metodi di spedizione
Lo step successivo è creare i metodi di spedizione per Sendcloud in Craft. La lista sotto lo stato della connessione mostra tutti i metodi di spedizione Sendcloud disponibili per i paesi abilitati nelle impostazioni dello store di Craft Commerce. Se non vedi alcuni dei metodi di spedizione, assicurati di aver abilitato i Paesi corrispondenti in Craft Commerce.
Per creare un metodo di spedizione Commerce clicca sul tasto+
o crea manualmente un metodo di spedizione con esattamente lo stesso nome rispetto al metodo di spedizione in Sendcloud. Devi configurare anche le regole di spedizione per il nuovo metodo di spedizione creato perché appaia nel front-end. - Seleziona lo stato dell'ordine per inviarlo a Sendcloud
Nella scheda Order Sync nelle impostazioni dei plugin di Sendcloud, seleziona lo stato dell'ordine di Craft per gli ordini che vuoi vengano inviati automaticamente a Sendcloud (puoi selezionarne più di uno). - Associa gli stati dei pacchi di Sendcloud agli stati degli ordini di Craft
Se vuoi che gli stati degli ordini in Craft si aggiornino automaticamente in base allo stato della spedizione in Sendcloud, associa stati di spedizione specifici in Sendcloud a stati dell'ordine in Craft. Gli stati degli ordini saranno aggiornati automaticamente quando cambia lo stato della spedizione. Quando Craft riceve uno stato di spedizione non associato, questo sarà ignorato. Se non assegni nessuno stato, nessun ordine verrà aggiornato. - Non dimenticare di salvare le impostazioni del plugin in Craft.
Clicca il tasto rossoSalva
quando hai terminato.
Scaricare le etichette di spedizione
Dopo aver completato la configurazione, i nuovi ordini con gli stati che hai selezionato saranno inviati a e le etichette di spedizione verranno create automaticamente per te. Ci sono due modi per scaricare le etichette di spedizione in Craft - più etichette per volta, oppure un'etichetta per volta.
- Pagina di riepilogo dell'ordine in Commerce
Utilizza le caselle di selezione per selezionare uno o più ordini. Clicca suPrint Sendcloud Labels
nel menu delle opzioni. Il file PDF che viene creato conterrà le etichette per tutti gli ordini selezionati. - Pagina dei dettagli dell'ordine di Commerce
Apri un ordine specifico in Craft. Troverai il pannello delle informazioni di Sendcloud nella barra laterale a destra (disponibile solo nella versione di Craft Commerce 3.2 o superiore). Clicca il tastoPrint Label
. Il file PDF che viene creato conterrà le etichette per tutti gli ordini selezionati.
Inviare gli ordini manualmente
É inoltre possibile inviare un ordine manualmente. Può essere utile quando hai un ordine con uno stato diverso o quando, per qualche ragione, un ordine non viene inviato automaticamente. Ci sono due modi per inviare un ordine a Sendcloud - più ordini per volta o un ordine per volta.
- Pagina di riepilogo dell'ordine in Commerce
Utilizza le caselle di selezione per selezionare uno o più ordini, poi selezionaPush to Sendcloud
nel menu delle opzioni. - Pagina dei dettagli dell'ordine di Commerce
Se l'ordine non è stato inviato a Sendcloud, vedrai il tastoPush to Sendcloud
(disponibile solo nella versione di Craft Commerce 3.2 o superiore).
Dopo averlo inviato, troverai ulteriori informazioni su Sendcloud e un tasto per scaricare l'etichetta.
Spedire presso Service Point (opzionale)
Questo plugin supporta la spedizione presso Service Point di Sendcloud. Questa configurazione è più complessa ed è necessario uno sviluppo personalizzato per integrare il selettore dei Service Point nella pagina di checkout del tuo negozio web. Poiché ogni progetto Craft può avere un diverso stack front-end, codice template e approccio, questo plugin contiene solo un esempio per il selettore dei Service Point di Sendcloud per i template front-end di default del negozio demo Craft Commerce.
Dopo l'installazione troverai una sostituzione drop-in per il modello di spedizione di Craft Commerce nella cartella `example-templates`. Semplicemente copia e incolla questo nella tua cartella `templates`. Dopo di che, segui questa procedura di configurazione:
- Abilita i Service Points in Sendcloud
Per configurare i service point (o spedizione presso un punto di raccolta) in Craft, assicurati prima di aver abilitato i Service Points in Sendcloud e seleziona i corrieri che vuoi mostrare nel selettore di service point.
- Per abilitare i service points in Sendcloud, effettua l'accesso al tuo account e naviga su Impostazioni> Integrazioni.
- Cerca la tua integrazione Craft Commerce nella lista dei negozi online connessi e clicca su
Modifica
. - Dopo di che, seleziona l'opzione Service Points per abilitare la funzionalità dei service point, e scegli i corrieri che vuoi offrire per la consegna presso i service point.
- Clicca su
Salva
quando hai finito.
- Crea il metodo di spedizione presso Service Point in Craft
Per abilitare i Service Points in Sendcloud, la pagina delle impostazioni del plugin ti mostrerà lo stato abilitato per i Punti di Spedizione (verde) e la lista con i metodi di spedizione disponibili mostrerà i metodi di spedizione presso i Service Point.
Per creare un metodo di spedizione Craft, clicca sul(+)
. Puoi creare un metodo di spedizione anche manualmente che abbia esattamente lo stesso nome del metodo di spedizione in Sendcloud. Puoi inoltre configurare regole di spedizione per il nuovo metodo di spedizione perché sia visibile nel front-end. - Integra il selettore di Service Point nel tuo front-end
Se stai utilizzando i modelli demo predefiniti dei negozi in Craft Commerce, puoi semplicemente copiare i template dalla cartella del plugin `example-templates` nella tua cartella `templates` del sito.
Il nostro modello di esempio fa quanto segue:
- Mostra il tasto Select Service Point per i metodi di spedizione che hanno i service points abilitati.
- Quando clicchi sul tasto, apparirà un iframe di selezione del punto di servizio Sendcloud. I Service point saranno filtrati in base al corriere del metodo di spedizione selezionato e all'indirizzo di spedizione selezionato.
- Dopo aver selezionato un service point, sarà visualizzato sul front-end e una richiesta AJAX in background sarà inviata al plugin Sendcloud per memorizzare le informazioni selezionate.
Quando invii l'ordine (o quando viene inviato automaticamente), verrà utilizzato il punto di servizio selezionato. Alcuni metodi di spedizione possono richiedere un numero di telefono valido. L'API di Sendcloud rifiuterà un ordine che contiene informazioni di spedizione non valide, quindi assicurati di compilare una buona richiesta!
Tieni presente che l'esempio della cartella `example-templates` è solo a scopo dimostrativo. È tua responsabilità costruire un front-end con una validazione adeguata per il tuo negozio.
Spedire fuori dall'Europa (opzionale)
Questo plugin supporta la generazione di documenti doganali di Sendcloud per le spedizioni al di fuori dell'UE. Usa la mappatura dei campi nelle impostazioni del plugin per associare i campi del tuo prodotto esistente ai campi necessari per generare i documenti doganali.
Assicurati di avere campi personalizzati contenenti Codici HS e Paese d'Origine configurati per prodotti o varianti in Craft. Successivamente, puoi selezionare i campi corrispondenti nelle impostazioni del plugin Sendcloud:
Assicurati che il campo Country Of Origin contenga solo il codice ISO2 Country (per esempio, "IT") e che il plugin HS Code contenga un codice HS valido del prodotto (per esempio, "6403919600").
Quando l'ordine viene inviato a Sendcloud, il plugin cercherà prima i campi a livello di variante, poi a livello di prodotto. Se uno dei campi è vuoto o mancante, il plugin Sendcloud semplicemente li ignorerà e trasmetterà l'ordine senza le informazioni di spedizione internazionale.
Visualizzare le informazioni dell'ordine di Sendcloud sul front-end (opzionale)
Il plugin Sendcloud fornisce ulteriori API Twig che possono essere utilizzate nel tuo front-end per:
- Visualizzare lo stato degli ordini di Sendcloud e le informazioni del service point
- Visualizzare il numero di Tracking e l'URL di Tracking
- Visualizzare l'URL del Portale dei Resi
Consulta il file variables/SendcloudVariable.php per maggiori informazioni.
Impostazioni avanzate (opzionale)
- Modifica il nome di visualizzazione del plugin in Craft
Se desideri modificare il nome di visualizzazione del plugin in Craft, puoi farlo nella scheda Advanced delle impostazioni del plugin.
Risoluzione dei problemi
Registrazione degli errori
Questo plugin produce i suoi log nel sistema di log di Craft, contrassegnati da una categoria separata, 'sendcloud'. Ispeziona il log dell'applicazione per trovare i messaggi di errore di Sendcloud. Inoltre, puoi sempre estrarre i messaggi di log di Sendcloud in un registro separato. Per farlo funzionare, puoi configurare il tuo file `config/app.php` come segue:
▼Craft 3.x
return [
'*' => [
'components' => [
'log' => function() {
$config = craft\helpers\App::logConfig();
if ($config) {
$config['targets']['sendcloud'] = [
'class' => \craft\log\FileTarget::class,
'logFile' => '@storage/logs/sendcloud.log',
'categories' => ['sendcloud'],
//'levels' => Logger::LEVEL_ERROR | Logger::LEVEL_WARNING,
'logVars' => [],
];
}
return $config ? Craft::createObject($config) : null;
},
]
]
];
▼Craft 3.6+
return [ '*' => [ 'components' => [ 'log' => [ 'targets' => [ '__fileTarget' => function() { if (!class_exists(FileTarget::class)) { return null; } return Craft::createObject([ 'class' => FileTarget::class, 'logFile' => '@storage/logs/sendcloud.log', 'categories' => ['sendcloud'], //'levels' => Logger::LEVEL_ERROR | Logger::LEVEL_WARNING, 'logVars' => [], ]); } ], ], ] ], ];
Problemi di connessione
Quando usi le impostazioni del plugin Craft per disconnetterti da Sendcloud, l'integrazione sarà ancora attiva in Sendcloud. Devi disconnettere l'integrazione manualmente anche in Sendcloud. Per farlo ti basta andare su Impostazioni > Integrazioni nel tuo account Sendcloud, cliccando il tasto PDisconnect
sotto la connessione del tuo negozio Craft.
Quando disconnetti l'integrazione in Sendcloud, la connessione sarà ancora attiva in Craft. Devi disconnettere l'integrazione manualmente anche in Craft.
Cancellazione di un ordine in Sendcloud
Quando un ordine viene cancellato in Sendcloud, il webhook Craft verrà attivato e i dati di Sendcloud saranno cancellati anche nella tabella personalizzata del plugin. Ciò mostrerà di nuovo il tasto Push to Sendcloud
nella pagina dei dettagli dell'ordine. La cancellazione di ordini in Sendcloud può subire un leggero ritardo, per cui finché lo stato di spedizione in Sendcloud sarò “Cancellation requested”, l'ordine non verrà rimosso dalla tabella personalizzata.
Per ulteriore supporto, puoi consultare il manuale di documentazione Craft CMS, o sottomettere una richiesta di assistenza dalla sezione assistenza del tuo account Sendcloud.