Canada Post Universal Shipping per Magento® 2.x

Canada Post Universal Shipping è un'estensione per Magento 2 che consente di gestire l'intero ciclo della spedizione Canada Post tramite l'API di Canada Post.

Canada Post è il servizio postale nazionale canadese: consegna a ogni indirizzo del Paese e in oltre 190 destinazioni nel mondo. L'estensione collega il vostro negozio a quella rete dall'inizio alla fine — tariffe in tempo reale al checkout, etichette e documenti doganali dall'amministrazione, tracciamento, annullamenti, resi, ritiri e manifesti di fine giornata.

I principali vantaggi dell'estensione Canada Post Universal Shipping sono:

Etichette di spedizione PDF e termiche

La creazione di etichette di spedizione è possibile manualmente, in blocco dalla griglia degli ordini, automaticamente e persino su pianificazione. L'estensione associa ogni etichetta a un ordine, a una spedizione o a una nota di credito. Tutte le etichette restano sul vostro server e sono raggiungibili in qualsiasi momento dall'interfaccia di amministrazione.
Prima di creare manualmente un'etichetta potete scegliere il servizio Canada Post desiderato e vedere subito il costo di spedizione. In modalità automatica le etichette nascono secondo il metodo scelto dall'acquirente oppure secondo un servizio nazionale e internazionale che configurate voi. Le etichette tornano in PDF nei formati 8.5x11, 4x6 e 3x5, oppure in ZPL per le stampanti termiche.

Tariffe e metodi di spedizione

Ottenete le tariffe di spedizione al checkout esattamente come su canadapost.ca. I prezzi di spedizione dipendono dai codici postali di origine e destinazione, dal peso, dalle dimensioni, dal tipo di indirizzo e dalle opzioni attive: l'estensione tiene conto di tutto questo. I preventivi restano in cache per un intervallo che decidete voi, così un checkout molto frequentato non richiede di nuovo al corriere lo stesso carrello. Il costo di un metodo può essere statico o dinamico, prezzi e visualizzazione si regolano con dei limiti e potete creare tutti i metodi che volete. Maggiori dettagli qui.

Account con e senza contratto

Un numero di contratto commerciale sblocca tariffe negoziate, addebito sul conto, manifesti e Open Returns. Anche senza contratto potete calcolare tariffe e spedire: l'estensione passa all'endpoint senza contratto e ogni etichetta viene saldata singolarmente. La consegna si paga solo a Canada Post — l'estensione non addebita né la spedizione, né le etichette, né le chiamate di tariffazione.

Resi

Due flussi di reso, entrambi nativi di Canada Post. Un Authorized Return emette un'etichetta per collo, con il vostro indirizzo come destinatario. Un Open Return è un modello permanente da cui il negozio attinge etichette fino a esaurire il budget: lo create con un pulsante nelle impostazioni dei resi e l'estensione conserva per voi l'ID del modello. I clienti possono richiedere un'etichetta di reso dalla propria area e la ricevono via e-mail con il modello che decidete voi.

Ritiro e tracciamento

Prenotate il ritiro dei colli direttamente dal pannello di amministrazione del vostro negozio: su richiesta per una fascia oraria precisa oppure con una pianificazione settimanale fissa. La disponibilità per un codice postale si può verificare prima di prenotare e un ritiro prenotato si può annullare.

Una volta partiti, i colli si seguono con la nostra estensione. Vedete tutte le tappe percorse e la posizione attuale, in una finestra dentro Magento oppure sul sito di Canada Post, e il numero di tracciamento viaggia nell'e-mail dell'ordine.

Manifesti

I commercianti con contratto possono raccogliere le spedizioni in un gruppo e trasmetterle una sola volta a fine giornata invece che una per una. Chiudete manualmente dall'amministrazione o lasciate fare al cron; il PDF del manifesto prodotto da Canada Post viene scaricato e archiviato accanto alle etichette, e il numero di PO firmato dall'autista è riportato su ogni etichetta del gruppo.

Dogana e spedizioni internazionali

Le dichiarazioni doganali delle etichette internazionali nascono dai prodotti fatturati dell'ordine. Motivo dell'esportazione, valuta doganale, dazi prepagati, numeri di licenza e certificato di esportazione, registrazione IOSS per l'UE e dichiarazione AES per gli Stati Uniti sono tutti configurabili, e si può inviare un destinatario «sold to» diverso quando non coincide con il consegnatario.

Ricerca degli uffici postali

Lasciate che sia l'acquirente a scegliere l'ufficio in cui ritirare il collo. La ricerca lavora attorno al codice postale di consegna entro un raggio che stabilite voi e mostra i risultati come elenco o su una mappa Google o Bing. L'ufficio scelto arriva sull'etichetta come consegna con ritiro in giacenza.

Stampa

La stampa è uno dei passaggi più importanti quando si lavora con le etichette di spedizione. Usate la nostra app per stampare etichette PDF e termiche su stampanti locali e di rete. Potete ottenerla qui. Ogni tipo di documento — etichetta, documento di trasporto, fattura — può essere indirizzato alla propria stampante.

Configurazione

Le possibilità del nostro modulo sono praticamente illimitate grazie a impostazioni flessibili. Allo stesso tempo le impostazioni sono intuitive e molte sono già predisposte. Potete configurare l'estensione per un negozio specifico o per un Paese specifico. Potete applicare certe impostazioni alle spedizioni nazionali e altre a quelle internazionali, e sono possibili impostazioni distinte anche per le etichette di reso.

Che cosa serve

Un account nel Canada Post Developer Program, che rilascia una chiave API e la collega al vostro numero cliente, e un indirizzo di origine canadese: Canada Post spedisce dal Canada.

Demo

Potete provare questa estensione per 30 giorni. Richiedete la demo su questa pagina con Richiedi demo; il funzionamento è spiegato in Prova un'estensione per 30 giorni.

Hyva Theme e Hyva Checkout

Compatibile con Hyva Theme e Hyva Checkout

L'estensione si installa con Composer. Quale repository aggiungere dipende da dove l'avete acquistata: l'installazione in sé è identica in entrambi i casi.

1. Collegare il repository

Acquistata su extmag.com. La pagina del vostro account mostra l'indirizzo del repository e le credenziali personali, insieme ai due comandi composer config da incollare. Eseguiteli una volta per progetto; da quel momento ogni estensione che possedete è disponibile dallo stesso repository.

Acquistata sull'Adobe Commerce Marketplace. Il pacchetto viene servito da repo.magento.com, che la maggior parte dei negozi ha già configurato. In caso contrario, aggiungete le Access Keys del vostro account Adobe in My Profile -> Access Keys.

2. Installare l'estensione

Nella radice del progetto:

composer require extmag/canadapostshipping
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Composer risolve i pacchetti Extmag condivisi da cui l'estensione dipende, quindi non c'è altro da richiedere a mano.

Uscite dall'amministrazione e rientrate: l'estensione è pronta.

3. Ottenere le credenziali Canada Post

Registratevi al Canada Post Developer Program. La registrazione rilascia una chiave API — un nome utente e una password — e la collega al vostro numero cliente. Canada Post rilascia due chiavi distinte, una per il gateway di sviluppo e una per la produzione; non sono intercambiabili. Tenete un account mittente per ciascuna e passate dall'una all'altra con l'interruttore Live Account del modulo account.

Il numero di contratto commerciale è facoltativo: senza, l'estensione continua a calcolare tariffe e a spedire, con tariffe pubblicate e saldo per singola etichetta. Addebito sul conto, manifesti e Open Returns richiedono un contratto.

Requisiti

• Magento 2.4.x (Open Source o Adobe Commerce)
• PHP 8.1 o superiore, Composer 2.x
• Una chiave API del Canada Post Developer Program e il numero cliente
• Un indirizzo di origine canadese: Canada Post spedisce dal Canada
• Accesso HTTPS in uscita verso soa-gw.canadapost.ca e ct.soa-gw.canadapost.ca

Cron

L'estensione registra un job orario che chiude i gruppi di manifesto quando la strategia di manifesto è impostata sul cron giornaliero. Con la strategia predefinita ogni spedizione viene trasmessa appena creata e il job termina subito. Perché la variante pianificata chiuda qualcosa, il cron di Magento deve essere in funzione.

Stampa delle etichette

Per stampare le etichette su una stampante locale o di rete, installate il nostro software di stampa da qui e seguite poi Installazione e configurazione di el-Print.

Hyva Theme e Hyva Checkout

I negozi su Hyva hanno bisogno di un pacchetto in più:

composer require extmag/shiplab-hyva
composer require magewirephp/magewire

L'integrazione sostituisce un template Hyva, view/frontend/templates/checkout/shipping/method-list.phtml. Se il vostro tema sovrascrive già quel file, unite le modifiche invece di sostituirlo.

Provarla prima di acquistarla

Potete richiedere una demo di 30 giorni di questa estensione e installarla esattamente come sopra: stesso pacchetto, stesso repository, stessi comandi. Come funzionano le demo.

Installazione senza Composer

L'archivio si può scompattare in app/code/Extmag/, ma così l'estensione resta fuori dalla gestione delle dipendenze: i pacchetti condivisi vanno installati a mano e gli aggiornamenti non la raggiungono mai. Usate Composer per ogni negozio che gestite, demo compresa.

Per qualsiasi domanda sull'installazione contattate il nostro supporto tecnico.

Canada Post si configura dal menu Extmag nell'amministrazione Adobe Commerce (Magento). Aggiungete l'account del corriere, l'indirizzo canadese da cui spedite, le scatole in cui imballate e i metodi di spedizione che vedono i clienti, quindi mettete a punto la configurazione del corriere.

Account Canada Post

1. Se non avete ancora credenziali API di Canada Post, registratevi al Canada Post Developer Program. La registrazione rilascia una chiave API — un nome utente e un segreto — e la collega al vostro numero cliente.
2. Andate su Admin Main Menu -> Extmag -> Shipper Accounts.
   
3. Fate clic sul pulsante «Add New Shipper Account».
4. Scegliete Canada Post come corriere, inserite il nome utente della chiave API, il segreto e il vostro numero cliente come Shipper Number, poi fate clic su «Save». Lasciate Live Account su No finché state provando: Canada Post rilascia chiavi distinte per il gateway di sviluppo e per quello di produzione e non sono intercambiabili. Tenete un account per ogni chiave e passate dall'una all'altra dalla configurazione.
   

Indirizzi

1. Andate su Admin Main Menu -> Extmag -> Settings -> Addresses.
2. Fate clic sul pulsante «Add New Address».
3. Compilate ragione sociale, referente, telefono e indirizzo completo, poi fate clic su «Save». L'origine deve essere canadese — Canada Post spedisce dal Canada — con un codice provincia di due lettere valido e un CAP nella forma A1A1A1. Per ogni corriere si usano due indirizzi: la Shipper Address stampata sull'etichetta e la Ship From Address dove il collo viene ritirato, che è anche il punto di spedizione del manifesto quando le due differiscono.

Package Boxes

1. Andate su Admin Main Menu -> Extmag -> Settings -> Package Boxes.
2. Fate clic sul pulsante «Add New Box».
3. Inserite dimensioni interne ed esterne, peso a vuoto e carico massimo, poi fate clic su «Save». L'algoritmo di imballaggio distribuisce un ordine tra i colli partendo da queste scatole: più scatole reali sono elencate, più la tariffa proposta si avvicina a quella che vi verrà addebitata. Canada Post accetta fino a 30 kg per collo.

Metodi di spedizione

1. Andate su Admin Main Menu -> Extmag -> Shipping Methods.
2. Fate clic sul pulsante «Add New Shipping Method».
3. Scegliete Canada Post come corriere, decidete quali servizi mostrare — tutti, un elenco preciso, o solo il più economico o il più caro — e limitate il metodo per sito web e gruppo di clienti se serve. Fate clic su «Save». L'elenco dei servizi è filtrato dal Paese di origine: un'origine canadese propone i gruppi nazionale, Stati Uniti e internazionale.
   

Configurazione

1. Andate su Admin Main Menu -> Extmag -> Settings -> Canada Post Configuration.
2. Aprite prima la scheda General e selezionate l'account mittente, la Shipper Address e la Ship From Address create sopra. Aggiungete il numero di contratto commerciale se ne avete uno: senza, tariffazione e spedizione tornano alle tariffe pubblicate.
   
3. Percorrete le schede restanti e compilate ciò che riguarda il vostro account.

Le schede coprono:

• General: account, indirizzi, numero di contratto, numeri cliente Mailed By e Mailed On Behalf Of, tipo di destinazione e descrizione della spedizione.
• Packaging: le unità di peso e dimensione. Canada Post codifica l'imballaggio nel codice servizio e calcola da sé il peso volumetrico.
• Returns: Authorized Returns oppure Open Returns, il servizio di reso, il pulsante di creazione del modello Open Return, il budget di etichette e ciò che il cliente può fare dalla propria area.
• References: il centro di costo e i due riferimenti cliente scritti su una spedizione con contratto.
• Payments: valuta, chi paga il trasporto e chi i dazi, il metodo di pagamento, il valore assicurato, il contrassegno e la chiave account Zonos richiesta per le destinazioni negli Stati Uniti.
• Notification: gli eventi che Canada Post notifica via e-mail, la loro lingua e i destinatari.
• Printing: formato carta (8.5x11, 4x6, 3x5), codifica PDF o ZPL e cosa viene stampato sull'etichetta.
• Pickups: come viene addebitato il ritiro, dove deve presentarsi l'autista, gli indicatori di camion e banchina e la pianificazione settimanale seguita dal cron.
• Tracking: se il tracciamento si apre in una finestra dentro Magento o come collegamento al sito di Canada Post.
• Post Office Locator: il ritiro in ufficio al checkout, il raggio di ricerca, la vista a elenco o su mappa e la chiave Google o Bing.
• International Invoice: il blocco doganale: valuta, motivo dell'esportazione, dazi prepagati, numeri di licenza e certificato, registrazione IOSS, identificativo della dichiarazione per gli Stati Uniti e il destinatario «sold to».
• Manifest / Closeout: trasmettere ogni spedizione appena creata, chiudere a mano o lasciar fare al cron giornaliero, oltre all'indirizzo stampato sul manifesto.
• Automatic, Mass Actions e Manual Actions: quando le etichette nascono senza operatore, in blocco dalla griglia degli ordini o una alla volta.
• Other Options: spedizioni senza contratto, tipo di preventivo, durata della cache di una tariffa, il numero di tracciamento nell'e-mail dell'ordine, la gestione dei colli non recapitabili e le opzioni di consegna predefinite.

Ogni impostazione si applica per sito web, per direzione e per Paese di destinazione, così una regola che ha senso solo per un mercato non tocca gli altri.

Resi

La scheda Returns decide quale dei due flussi di reso di Canada Post usa il negozio. Un Authorized Return emette un'etichetta per collo. Un Open Return è un modello permanente: premete «Create Template» e l'estensione lo registra presso Canada Post, ne conserva l'ID e da lì attinge etichette fino a esaurire il budget. La stessa scheda controlla se il cliente può richiedere o ristampare un'etichetta di reso dalla propria area e quale modello di e-mail la trasporta.

Etichette di spedizione

Una volta configurato il corriere, ogni etichetta creata dal negozio compare sotto Admin Main Menu -> Extmag -> Shipping Labels -> Canada Post, con numero di tracciamento, costo, stato del manifesto e i documenti allegati. Le etichette si creano dalla vista dell'ordine, in blocco dalla griglia degli ordini oppure automaticamente: lo decidono le schede Automatic, Mass Actions e Manual Actions.