Canada Post Universal Shipping voor Magento® 2.x

Canada Post Universal Shipping is een Magento 2 extensie waarmee u de volledige cyclus van Canada Post verzending beheert via de Canada Post API.

Canada Post is de nationale postdienst van Canada en bezorgt op elk adres in het land en in meer dan 190 bestemmingen wereldwijd. De extensie verbindt uw winkel van begin tot eind met dat netwerk — live tarieven bij de checkout, labels en douanepapieren vanuit de admin, tracking, annuleringen, retouren, pickups en manifesten aan het einde van de dag.

De belangrijkste voordelen van de Canada Post Universal Shipping extensie zijn:

PDF- en thermische verzendlabels

Het aanmaken van verzendlabels kan handmatig, in bulk vanuit het besteloverzicht, automatisch en zelfs volgens een planning. De extensie koppelt elk label aan een bestelling, een zending of een creditnota. Alle labels staan op uw eigen server en blijven altijd bereikbaar vanuit de beheerinterface.
Voordat u een label handmatig aanmaakt, kiest u de gewenste Canada Post dienst en ziet u meteen de verzendkosten. In automatische modus ontstaan labels volgens de methode die de koper koos, of volgens een binnenlandse en internationale dienst die u instelt. Labels komen terug als PDF in 8.5x11, 4x6 en 3x5, of als ZPL voor thermische printers.

Verzendtarieven en verzendmethoden

Haal verzendtarieven op bij de checkout, net als op canadapost.ca. Verzendprijzen hangen af van de postcodes van herkomst en bestemming, het gewicht, de afmetingen, het adrestype en de actieve bezorgopties — de extensie houdt daar allemaal rekening mee. Offertes worden gedurende een door u ingesteld interval gecachet, zodat een drukke checkout niet telkens opnieuw dezelfde winkelwagen bij de vervoerder opvraagt. De kosten van een methode kunnen statisch of dynamisch zijn, prijzen en weergave stelt u af met limieten en u maakt zoveel methoden aan als u wilt. Lees meer hier.

Accounts met en zonder contract

Een handelscontractnummer ontsluit onderhandelde tarieven, facturatie op rekening, manifesten en Open Returns. Zonder contract kunt u nog steeds tarieven ophalen en verzenden: de extensie schakelt over op het endpoint zonder contract en elk label wordt per zending afgerekend. De bezorging zelf rekent u uitsluitend met Canada Post af — de extensie brengt niets in rekening voor verzending, labels of tariefaanvragen.

Retouren

Twee retourstromen, beide van Canada Post zelf. Een Authorized Return geeft één label per collo, met uw adres als ontvanger. Een Open Return is een vaste sjabloon waaruit de winkel labels put tot het budget op is — u maakt hem met één knop aan in de retourinstellingen en de extensie bewaart het sjabloon-ID voor u. Klanten kunnen vanuit hun account een retourlabel aanvragen; het komt per e-mail in een sjabloon dat u bepaalt.

Pickup en tracking

Bestel een pakketophaling rechtstreeks vanuit de beheeromgeving van uw webwinkel — op afroep voor een bepaald tijdvak, of volgens een vast weekschema. De beschikbaarheid voor een postcode kunt u vóór het boeken controleren en een geboekte ophaling kunt u weer annuleren.

Zodra uw pakketten onderweg zijn, volgt u ze met onze extensie. U ziet alle punten die het pakket is gepasseerd en waar het zich nu bevindt, in een venster binnen Magento of op de website van Canada Post, en het trackingnummer reist mee in de bestel-e-mail.

Manifesten

Handelaren met een contract kunnen zendingen in een groep verzamelen en aan het einde van de dag in één keer doorgeven in plaats van stuk voor stuk. Sluit handmatig af vanuit de admin of laat het aan de cron over; de manifest-PDF van Canada Post wordt gedownload en naast de labels bewaard, en het PO-nummer waarvoor de chauffeur tekent staat op elk label van de groep.

Douane en internationaal

Douaneaangiften voor internationale labels worden opgebouwd uit de gefactureerde producten van de bestelling. Reden van uitvoer, douanevaluta, vooruitbetaalde rechten, licentie- en certificaatnummers, IOSS-registratie voor de EU en de AES-aangifte voor de Verenigde Staten zijn allemaal instelbaar, en een afwijkende «sold to» partij kan worden meegestuurd wanneer die van de geadresseerde verschilt.

Postkantoorzoeker

Laat de koper zelf het kantoor kiezen waar hij het pakket ophaalt. De zoeker werkt rond de bezorgpostcode binnen een straal die u instelt en toont de resultaten als lijst of op een Google- of Bing-kaart. Het gekozen kantoor gaat als hold-for-pickup bezorging mee naar het label.

Afdrukken

Afdrukken is een van de belangrijkste stappen bij het werken met verzendlabels. Gebruik onze app om PDF- en thermische labels op lokale printers en netwerkprinters af te drukken. U vindt hem hier. Elk documenttype — verzendlabel, pakbon, factuur — kunt u naar een eigen printer sturen.

Configuratie

De mogelijkheden van onze module zijn dankzij flexibele instellingen vrijwel onbeperkt. Tegelijk zijn de instellingen intuïtief en veel ervan staan al goed. U configureert de extensie voor een specifieke winkel of een specifiek land. Bepaalde instellingen past u toe op binnenlandse zendingen en andere op buitenlandse, en ook voor retourlabels zijn aparte instellingen mogelijk.

Wat u nodig hebt

Een account bij het Canada Post Developer Program, dat een API-sleutel afgeeft en aan uw klantnummer koppelt, en een Canadees afzenderadres — Canada Post verzendt vanuit Canada.

Demo

U kunt deze extensie 30 dagen uitproberen. Vraag de demo aan op deze pagina met Demo aanvragen; hoe het werkt staat op Probeer een extensie 30 dagen.

Hyva Theme en Hyva Checkout

Compatibel met Hyva Theme en Hyva Checkout

De extensie installeert u met Composer. Welke repository u toevoegt hangt af van waar u hem hebt gekocht — de installatie zelf is in beide gevallen hetzelfde.

1. Repository koppelen

Gekocht op extmag.com. Uw accountpagina toont het adres van de repository en uw persoonlijke inloggegevens, samen met de twee composer config commando's om te plakken. Voer ze één keer per project uit; daarna is elke extensie die u bezit beschikbaar vanuit dezelfde repository.

Gekocht op de Adobe Commerce Marketplace. Het pakket komt van repo.magento.com, dat de meeste winkels al hebben ingesteld. Zo niet, voeg dan de Access Keys uit uw Adobe-account toe onder My Profile -> Access Keys.

2. Extensie installeren

Voer uit in de hoofdmap van het project:

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

Composer lost de gedeelde Extmag-pakketten op waarvan de extensie afhangt, dus verder hoeft u niets met de hand op te geven.

Log uit de admin en weer in, en de extensie is klaar voor gebruik.

3. Uw Canada Post gegevens aanvragen

Meld u aan bij het Canada Post Developer Program. De registratie geeft een API-sleutel af — een gebruikersnaam en een wachtwoord — en koppelt die aan uw klantnummer. Canada Post geeft twee aparte sleutels uit, één voor de ontwikkelomgeving en één voor productie; ze zijn niet uitwisselbaar. Houd per sleutel een verzenderaccount aan en wissel ertussen met de schakelaar Live Account op het accountformulier.

Een handelscontractnummer is optioneel: zonder contract haalt de extensie nog steeds tarieven op en verzendt zij, tegen gepubliceerde tarieven en met afrekening per label. Facturatie op rekening, manifesten en Open Returns vereisen wel een contract.

Vereisten

• Magento 2.4.x (Open Source of Adobe Commerce)
• PHP 8.1 of nieuwer, Composer 2.x
• Een API-sleutel van het Canada Post Developer Program en een klantnummer
• Een Canadees afzenderadres — Canada Post verzendt vanuit Canada
• Uitgaande HTTPS-toegang tot soa-gw.canadapost.ca en ct.soa-gw.canadapost.ca

Cron

De extensie registreert één uurlijkse taak die manifestgroepen afsluit wanneer de manifeststrategie op de dagelijkse cron staat. Bij de standaardstrategie wordt elke zending doorgegeven zodra zij wordt aangemaakt en stopt de taak meteen. De Magento-cron moet draaien wil de geplande variant iets afsluiten.

Labels afdrukken

Om labels op een lokale printer of netwerkprinter af te drukken, installeert u onze printsoftware via hier en volgt u daarna Installatie en configuratie van el-Print.

Hyva Theme en Hyva Checkout

Winkels op Hyva hebben één pakket extra nodig:

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

De integratie vervangt één Hyva-template, view/frontend/templates/checkout/shipping/method-list.phtml. Overschrijft uw thema dat bestand al, voeg de wijzigingen dan samen in plaats van het te vervangen.

Uitproberen voor u koopt

U kunt een demo van 30 dagen van deze extensie aanvragen en hem precies zo installeren als hierboven — hetzelfde pakket, dezelfde repository, dezelfde commando's. Hoe demo's werken.

Installeren zonder Composer

Het archief kunt u ook uitpakken in app/code/Extmag/, maar dan valt de extensie buiten het afhankelijkhedenbeheer: haar gedeelde pakketten moet u met de hand installeren en updates bereiken haar nooit. Gebruik Composer voor elke winkel die u beheert, ook voor de demo.

Hebt u vragen over de installatie, neem dan contact op met onze technische support.

Canada Post richt u in vanuit het Extmag-menu in de Adobe Commerce (Magento) admin. Voeg het vervoerdersaccount toe, het Canadese adres waarvandaan u verzendt, de dozen waarin u verpakt en de verzendmethoden die klanten zien, en stem daarna de configuratie van de vervoerder af.

Canada Post account

1. Hebt u nog geen Canada Post API-gegevens, meld u dan aan bij het Canada Post Developer Program. De registratie geeft een API-sleutel af — een gebruikersnaam en een secret — en koppelt die aan uw klantnummer.
2. Ga naar Admin Main Menu -> Extmag -> Shipper Accounts.
   
3. Klik op de knop «Add New Shipper Account».
4. Kies Canada Post als vervoerder, vul de gebruikersnaam van de API-sleutel, het secret en uw klantnummer als Shipper Number in en klik op «Save». Laat Live Account op No staan zolang u test — Canada Post geeft aparte sleutels uit voor de ontwikkel- en de productieomgeving, en die zijn niet uitwisselbaar. Houd per sleutel één account aan en wissel ertussen vanuit de configuratie.
   

Adressen

1. Ga naar Admin Main Menu -> Extmag -> Settings -> Addresses.
2. Klik op de knop «Add New Address».
3. Vul bedrijfsnaam, contactpersoon, telefoon en het volledige adres in en klik op «Save». De herkomst moet Canadees zijn — Canada Post verzendt vanuit Canada — met een echte tweeletterige provinciecode en een postcode in de vorm A1A1A1. Per vervoerder worden twee adressen gebruikt: de Shipper Address die op het label wordt gedrukt en de Ship From Address waar het pakket wordt opgehaald, die tevens het verzendpunt van het manifest is wanneer beide verschillen.

Package Boxes

1. Ga naar Admin Main Menu -> Extmag -> Settings -> Package Boxes.
2. Klik op de knop «Add New Box».
3. Vul de binnen- en buitenmaten, het leeggewicht en de maximale belading in en klik op «Save». De inpakmodule verdeelt een bestelling op basis van deze dozen over pakketten: hoe meer van uw echte dozen zijn vastgelegd, hoe dichter het opgegeven tarief bij het gefactureerde ligt. Canada Post accepteert tot 30 kg per pakket.

Verzendmethoden

1. Ga naar Admin Main Menu -> Extmag -> Shipping Methods.
2. Klik op de knop «Add New Shipping Method».
3. Kies Canada Post als vervoerder, bepaal welke diensten worden getoond — alle, een bepaalde lijst, of alleen de goedkoopste of de duurste — en beperk de methode zo nodig per website en klantengroep. Klik op «Save». De dienstenlijst wordt gefilterd op het land van herkomst: een Canadese herkomst biedt de groepen binnenland, Verenigde Staten en internationaal.
   

Configuratie

1. Ga naar Admin Main Menu -> Extmag -> Settings -> Canada Post Configuration.
2. Open eerst het tabblad General en kies het verzenderaccount, de Shipper Address en de Ship From Address die u hierboven hebt aangemaakt. Vul uw handelscontractnummer in als u dat hebt — zonder contract vallen tarifering en verzending terug op de gepubliceerde tarieven.
   
3. Werk de overige tabbladen door en vul in wat op uw account van toepassing is.

De tabbladen behandelen:

• General — account, adressen, contractnummer, de klantnummers voor Mailed By en Mailed On Behalf Of, bestemmingstype en de omschrijving van de zending.
• Packaging — de gewichts- en maateenheden. Canada Post codeert de verpakking in de dienstcode en berekent het volumegewicht zelf.
• Returns — Authorized Returns of Open Returns, de retourdienst, de knop om een Open Return sjabloon aan te maken, het labelbudget en wat de klant in zijn eigen omgeving mag doen.
• References — de kostenplaats en de twee klantreferenties die op een contractzending worden gezet.
• Payments — valuta, wie het transport en wie de rechten betaalt, de betaalmethode, de verzekerde waarde, rembours en de Zonos accountsleutel die bestemmingen in de Verenigde Staten vereisen.
• Notification — de gebeurtenissen waarover Canada Post e-mailt, de taal ervan en de ontvangers.
• Printing — papierformaat (8.5x11, 4x6, 3x5), PDF- of ZPL-codering en wat er op het label wordt gedrukt.
• Pickups — hoe een ophaling wordt afgerekend, waar de chauffeur moet zijn, de vrachtwagen- en laadperronvlaggen en het weekschema waarop de cron boekt.
• Tracking — of tracking opent in een venster binnen Magento of als link naar de website van Canada Post.
• Post Office Locator — ophalen bij een kantoor tijdens de checkout, de zoekstraal, weergave als lijst of kaart en de Google- of Bing-sleutel.
• International Invoice — het douaneblok: valuta, reden van uitvoer, vooruitbetaalde rechten, licentie- en certificaatnummers, IOSS-registratie, het aangifte-ID voor de Verenigde Staten en de «sold to» partij.
• Manifest / Closeout — elke zending meteen doorgeven, met de hand afsluiten of aan de dagelijkse cron overlaten, plus het adres dat op het manifest staat.
• Automatic, Mass Actions en Manual Actions — wanneer labels zonder tussenkomst ontstaan, in bulk vanuit het besteloverzicht of één voor één.
• Other Options — zendingen zonder contract, het type offerte, hoe lang een tarief wordt gecachet, het trackingnummer in de bestel-e-mail, de afhandeling van onbestelbare zendingen en de standaard bezorgopties.

Elke instelling kunt u per website, per richting en per land van bestemming toepassen, zodat een regel die alleen voor één markt zinvol is de rest niet raakt.

Retouren

Het tabblad Returns bepaalt welke van de twee retourstromen van Canada Post de winkel gebruikt. Een Authorized Return geeft één label per collo. Een Open Return is een vaste sjabloon: klik op «Create Template» en de extensie registreert hem bij Canada Post, bewaart het sjabloon-ID en put er labels uit tot het budget op is. Hetzelfde tabblad regelt of een klant vanuit zijn omgeving een retourlabel mag aanvragen of opnieuw afdrukken, en welk e-mailsjabloon het meestuurt.

Verzendlabels

Zodra de vervoerder is ingericht, verschijnt elk label dat de winkel aanmaakt onder Admin Main Menu -> Extmag -> Shipping Labels -> Canada Post, met trackingnummer, kosten, manifeststatus en de bijbehorende documenten. Labels maakt u aan vanuit de bestelweergave, in bulk vanuit het besteloverzicht of automatisch — dat regelen de tabbladen Automatic, Mass Actions en Manual Actions.