Configuratiehandleiding:Transsmart-connector in Magento

TRANSSMART.COM

Om transportboekingen te kunnen doen, bij één of meerdere transporteurs, vanuit één omgeving heeft Transsmart een

zogenaamde ‘API’ gebouwd.

Magento heeft een koppeling (plugin) met deze API waardoor het mogelijk is om vanuit uw Magento webshop bestellingen te

verzenden, labels te printen en statussen te volgen.

In dit document leest u hoe deze plugin configureert in Magento.

ConfiguratieTranssmart-connector in Magento

Een korte introductieOm transportboekingen te kunnen doen, bij één of meerdere transporteurs, vanuit één omgeving heeft Transsmart een zogenaamde ‘API’ gebouwd.

Magento heeft een koppeling (plugin) met deze API waardoor het mogelijk is om vanuit uw Magento webshop bestellingen te verzenden, labels te printen en statussen te volgen.

In dit document leest u hoe deze plugin configureert in Magento.

Inhoud1. Voorbereiding 3

52. Transsmart verzending

A. Verbinding instellenB. Afdrukken instellenC. Instellen van de standaard eigenschappen van een zending

103. Transsmart vervoerdersprofielen

A. Toon op afrekenpaginaB. Titel vervoerdersprofielC. Prijs vervoerdersprofielD. Zending naar landen die van toepassing zijn

144. Table rates

A. Inrichten van table rates

5. Extensieversie en hyperlinks 16

TRANSSMART.COM

2

TRANSSMART.COM

1. VoorbereidingLog in op uw Magento omgeving (zoals u dat gewend bent met uw Magento inloggegevens).

De Transsmart-connector voor Magento is te installeren door de beheerder van uw webshop. Deze plugin is te vinden onder Systeem > Magento connect > Magento ConnectManager.

De code van de plugin is voor uw Magentobeheerder duidelijk leesbaar. Daarnaast is deze zo geschreven dat het ook toepasbaar is als u geen standaard Magento omgeving heeft. Uw beheerder kan op basis van deze code zo nodig maatwerkaanpassingen verrichten. Mocht uw beheerder hehoefte hebben aan technisch advies op dit gebied, kan onze partner Techtwo B.V. hierin voorzien.

De Transsmart-connector voor Magento is compatible met zowel One-page checkout als OneStepCheckout.

3

Om gebruik te kunnen maken van de Transsmart-connector heeft u het volgende nodig:

HardwareEen recente Windows (géén Windows XP) of Apple PC.Een grafische A4 printer of een Zebra sticker printer (bij voorkeur GK420d).

SoftwareMagento 1.8 of 1.9.De Transsmart-connector (te downloaden via de Magento ConnectManager). De QZ-tray print utility 1.9 (te downloaden via https://qz.io/download/).

SysteembeheerderHet uitgaande IP-adres (te vinden via www.watismijnip.nl).Een internet browser (Internet Explorer, Google Chrome, Firefox, Safari).Een recente versie van Java (geïnstalleerd op de PC van waaraf geprint zal worden, of op het netwerk in geval van een netwerkprinter).Communicatiepoorten 8181 en 8282 moeten openstaan voor printing.

TranssmartHeeft het achterliggende API account voor u ingericht.Heeft de koppeling(en) met uw vervoerder(s) geactiveerd.Heeft u voorzien van inloggegevens.

Hierna kunt u starten met het inrichten van de Transsmart-connector. Deze zorgt voor de verbinding tussen Magento, Transsmart en de gekoppelde vervoerders. De configuratie is toegankelijk voor een Magento-user met administrator rechten. In deze configuratie kunt u naast het maken van een verbinding, onder andere het volgende bepalen:

De standaarden m.b.t. vervoerdersprofiel, verzendlocatie, e-mailnotificatie, incoterms, kostenplaats en verpakkingstype.Welke printer gebruikt wordt.Welke vervoerdersprofielen zichtbaar zijn in de checkout voor uw klant, en hoe deze zichtbaar zijn in de checkout: bezorgoptie of afhaaloptie.Of er een locatieselector (kaart) zichtbaar is in de checkout.Welke transportprijs berekend wordt.Naar welke landen een vervoerdersprofiel te selecteren is.

TRANSSMART.COM

4

TRANSSMART.COM

2. Transsmart verzendingGa in Magento via Systeem > Configuratie naar Verkoop (links in het menu). Hier ziet u dat er na installatie van de plugin twee items zijn toegevoegd: Transsmart verzending en Transsmart vervoerdersprofielen. Kies voor voor Transsmart verzending.

A. Verbinding instellenVul bij ‘verbinding details’ de gebruikersnaam en het wachtwoord in welke u vanTranssmart hebt ontvangen. Om te kunnen boeken, dient deze omgeving op‘productie’ te staan.

We adviseren u om altijd eerst te beginnen in een testomgeving. Uw Magentopartner kan dit voor u instellen. Ook bij Transsmart begint u in een test-

omgeving. Dit doet u door te kiezen voor ‘staging’. Heeft u nog geen test- omgeving bij Transsmart? Neem dan contact met ons op via support.transsmart.com.

Vervolgens kunt u de configuratie van de verbinding(en) die Transsmart gemaakt heeft met uw vervoerder(s) ophalen via de knop ‘nu ophalen’.

5

TRANSSMART.COM

U hebt nu de vervoerdersprofielen opgehaald. Deze kunt u bij het menu ‘Transsmart vervoerdersprofielen’ verder configureren. Hier komen we in hoofdstuk twee op terug.

Wanneer er wijzgingen zijn met betrekking tot de vervoerders en/of diensten die u wilt gebruiken, kunt u contact met ons opnemen via support.transsmart.com. Zodra de wijzigingen door Transsmart zijn ingericht, kunt u deze weer ophalen d oor middel van de knop ‘nu ophalen’.

B. Afdrukken instellenOm te kunnen printen moet u het printprogramma QZ-tray op uw PC installeren. U kunt dit programma hier downloaden: http://qz.io/download/. Wanneer dit is gebeurd, zal rechtsonder in uw menubalk het groene logo van QZ-tray zichtbaar zijn.

U kunt uw printer in Magento instellen via systeem > configuratie en dan verkoop> Transsmart verzending. Bij het menu ‘afdrukken’ kunt u de printergegevens invullen.

QZ-host: hier kunt u het uitgaande IP-adres van uw domein invullen. Deze kunt u opzoeken via www.watismijnip.nl.

6

TRANSSMART.COM

Geselecteerde printer: hier vult u uw exacte printernaam in. Deze kunt u opzoeken in uw PC: start > apparaten en printers > ga met de muis op de printer staan en klik op de rechtermuisknop > kies voor ‘eigenschappen’. Selecteer de pinternaam, kopiëer deze en plak deze in Magento in het veld ‘geselecteerde

printer’.

Geef het uitgaande IP-adres en de exacte printernaam ook door aan Transsmart. Deze kunt u per mail sturen als antwoord (reply) op de mail met inloggegevens die u van ons hebt ontvangen.

Het zal later ook mogelijk zijn im vanuit meedere PC’s (IP-adressen) te printen.

Het is van belang dat poort 8182 open staat voor communicatie. Daarnaast moet het uitgaande IP-adres bereikbaar zijn voor communicatie tot aan uw PC. Het kan voorkomen dat het IP-adres maar tot de router benaderbaar is voor communicatie. In dat geval zullen zendingen wel een status LABL (geprint) kunnen krijgen, maar komt er niet daadwerkelijk een label uit de printer.

Laat uw systeembeheerder dit controleren. Wanneer uw PC niet benaderbaar is, kan uw systeembeheerder namelijk een ‘port forwarding’ instellen.

Als de QZ-tray print utility server geïnstalleerd wordt (bijvoorbeeld op een server), werkt het in principe hetzelfde. Let wel goed op dat het domein uitgaand IP-adres goed wordt ingevuld en dat poort 8182 open is gezet.

7

TRANSSMART.COM

C. Instellen van de standaard eigenschappen van een zendingU kunt de standaard eigenschappen van een zending instellen via ‘systeem >configuratie’ en dan ‘verkoop > Transsmart verzending’.

Hier bepaalt u met welke eigenschappen een zending aangemaakt wordt. Perzending zijn deze instellingen nog te wijzigen door de bestelling aan te passen.Zie hiervoor de gebruikershandleiding.

U bepaalt hier de volgende standaard gegevens voor een zending:

Verzendlocatie: de locatie van waaruit u de zending verstuurt. Deze locatie wordt afgedrukt op het label. Het kan zijn dat u meerdere verzendlocaties heeft.

E-mailtype: dit betreft de e-mailnotificatie die via Transsmart naar uw klanten wordt verstuurd (wanneer dit geconfigureerd is).

Incoterm: dit betreft de incotermvoorwaarden waaronder uw zendingen standaard verstuurd worden.

Kostenplaats: wanneer u vanuit verschillende tenaamstellingen of onder verschillende contractnummers wilt kunnen verzenden, kunnen hiervoor kostenplaatsen geconfigureerd worden door Transsmart. Hier bepaalt u welke kostenplaatst standaard gebruikt wordt.

Verpakkingstype: hier bepaalt u het standaard verpakkingstype dat gebruikt wordt voor een zending.

8

TRANSSMART.COM

Voor alle keuzemogelijkheden geldt dat het geconfigureerd moet worden door Transsmart en daarna opgehaald moet worden in de Magento omgeving door middel van de knop ‘nu ophalen’. Wilt u wijzigingen in de opties aanbrengen? Neem dan contact met ons op via support.transsmart.com.

D. ToewijzingAls uw webshop gebruik maakt van meerdere straatvelden, kunt u hier instellen welk veld waarvoor gebruikt dient te worden. Omschrijving, country of origin, HS code en Reason of export gebruikt u alleen in geval van douaneplichtige documenten waarvoor u een (paperless) invoice mee moet sturen.

Wilt u hier gebruik van maken, dan moeten deze diensten voor u bij Transsmart gekoppeld zijn. Neem ook hiervoor weer contact op via support.transsmart.com.

9

TRANSSMART.COM

3. Transsmart vervoerdersprofielenGa in Magento via Systeem > Configuratie naar ‘verkoop’ (links in het menu). Waar u eerst koos voor ‘Transsmart verzending’, kiest u nu voor ‘Transsmart vervoerders-profielen’.

Er verschijnt een lijst van de vervoerdersprofielen die door Transsmart geconfigureerd zijn, nadat u bij Transsmart verzending heeft gekozen voor ‘nu ophalen’.

een vervoerdersprofiel is een combinatie van vervoerder, dienst (service level), en zo mogelijk ook aanvullende dienst (service level other).

Per vervoerdersprofiel kunt u een aantal zaken bepalen die invloed hebben op het gebruik van deze profielen.

10

TRANSSMART.COM

A. Toon op afrekenpaginaPer vervoerdersprofiel kunt u bepalen of u wilt dat de klant in de checkout demogelijkheid krijgt om zelf te kiezen voor het betreffende profiel. Er zijn hier driemogelijkheden:

Nee: Uw klant ziet in de checkout niet het betreffende vervoerdersprofiel en kan hier dus ook niet zelf voor kiezen. Er moet altijd minimaal één vervoerdersprofiel ingesteld staan op ‘toon op de afrekenpagina’, tenzij u gebruik maakt van table rates (zie pagina 14).U zou ervoor kunnen kiezen om dit profiel een andere naam te geven dan de vervoerder, zodat de klant niet weet met welke vervoerder het verzonden wordt en u achteraf in Magento nog de vervoerder kunt wijzigen.

Bezorgoptie: Uw klant ziet het vervoerdersprofiel in de checkout en kan deze selecteren. Het profiel is een bezorgoptie. De zending wordt dus op het afleveradres afgeleverd.

Afhaaloptie: Uw klant ziet het vervoerdersprofiel in de checkout en kan deze selecteren. Het profiel is een afhaaloptie. De zending wordt dus ergens geleverd waar de klant het zelf gaat afhalen.

Locatieselector: Wanneer Transsmart de locatieselector heeft toegewezen aan een vervoerdersprofiel, staat hier ‘enabled’. Wanneer u voor een vervoerdersprofiel géén locatieselector kunt gebruiken, staat hier ‘disabled’.

11

TRANSSMART.COM

Wanneer u bijvoorbeeld onderstaand in uw configuratie hebt ingesteld (dit is slechts een voorbeeld):

Dan ziet dit er in de checkout als volgt uit:

In de zending in Magento zijn alle vervoerdersprofielen te selecteren ongeacht of deze op de afrekenpagina zichtbaar zijn.

12

TRANSSMART.COM

B. TitelvervoerdersprofielWanneer u gekozen hebt voor bezorgoptie of afhaaloptie, kunt u bij de titel invullen hoe u dit vervoerdersprofiel wilt benoemen. Dit wordt getoond in de checkout en in Magento zelf als u een bestelling wijzigt of aanmaakt.

C. PrijsvervoerdersprofielHebt u gekozen voor bezorgoptie of afhaaloptie, dan wordt de prijs in de Magento checkout getoond aan de klant. Deze prijs telt mee in het totaal af te rekenen bedrag voor de klant. Wanneer u hier niks invult, staat er € 0,00.

Wilt u ‘geen transportkosten’ instellen vanaf een x-bedrag, maak dan gebruik van de Magentofunctionaliteit ‘winkelwagen prijsregels’. Vraag hiervoor advies aan uw Magentopartner. Dit is te combineren met de Transsmart-plugin en de prijzen die u instelt via systeem > configuratie > Transsmart vervoerders-profielen. Resultaat is dat u in de checkout vanaf een x-bedrag aan productwaarde, een transport prijs van € 0,- ziet staat.

D. Zending naar landen die van toepassing zijnHier kunt u bepalen voor welke landen het vervoerdersprofiel zichtbaar is. Dit wordt bepaald op basis van de landcode die de lant als afleveradres heeft gekozen. U kunt kiezen voor alle landen of voor specifieke landen. Wilt u meerdere landen (de-)selecteren, dan houdt u de CTRL-toets in.

Wanneer u iets hebt gewijzigd in één of meerdere profielen, kies dan rechtsboven voor ‘configuratie opslaan’.

13

4. Table ratesMagento kent zogeheten ‘table rates’. Dit is een functionaliteit waarmee u transport-prijzen verder kunt specificeren in de checkout. Deze table rates werken ook in combi-natie met de Transsmart vervoerdersprofielen. Zo heeft u de mogelijkheid om op basis van onderstaand te specificeren welke vervoerdersprofielen getoond mogen worden in de checkout en kunt u de prijzen per profiel hiervoor laten afwijken.

Bestemming vs. gewichtBestemming vs. subtotaal bestellingBestemming vs. aantal artikelen

Table rates is een Magento-functionaliteit. Voor meer informatie hierover adviseren we u om contact op te nemen met uw Magento partner. De uitleg in dit document betreft enkel een uitleg voor het Transsmart gedeelte in table rates.

A. Inrichten van table ratesOm per regel van table rates te kunnen bepalen welk vervoerdersprofiel aangeboden mag worden, moet u de ID codes van de vervoerdersprofielen opzoeken.Ga hoevoor naar systeem > configuratie > Transsmart vervoerdersprofielen.Deze staan in de linker kolom. In dit voorbeeld is het dus 2102, 2100, 2101, etc.

Een table rate op basis van gewicht ziet er dan bijvoorbeeld zo uit:

TRANSSMART.COM

14

In de laatste kolom is er een ruimte bijgekomen voor ID codes van de vervoerdersprofielen. De table rate is als volgt uit te lezen.

Heb je een zending naar NL tussen de 0 en 10 kg, dan krijg je 3 vervoerdersprofielen te zien in de checkout. Namelijk:

2352: PostNL Webservices Pakjegemak, € 5,50, is #12100: UPS Standard, € 6,- , is #22355: DPD Classic, € 6,10, is #3

Zou de bestelling meer dan 10 kg wegen, dan krijgt de klant enkel nummer 4 gepresenteerd in de checkout:

2098: DHL Europlus volgende werkdag met een transspartprijs van € 8,-

In de checkout ziet dit er met bestellingen tot 10 kg alsvolgt uit:

Mocht één van de vervoerdersprofielen een afhaallocatie met locatieselector zijn, dan kan de klant kiezen voor de knop ‘afhaallocatie kiezen’ en komt er een kaart tevoorschijn.

Deze logica werkt exact hetzefde voor table rates op basis van bestemming vs. subtotaal bestelling en bestemming vs. aantal artikelen.

TRANSSMART.COM

15

5. Extensieversie en hyperlinksVia het hoofdmenu, systeem > Transsmart verzending, kunt u zien welke extentie ver-sie u in gebruikt hebt. Tevens vindt u hier hyperlinks naar de andere handleidingen, naar de Transsmart API waar al uw zendingen in terecht komen en naar onze support portal waar u eventuele vragen en wensen in bekend kunt maken.

Via de support portal kunt u, door bij announcements te kiezen voor ‘follow’, op de hoogte gehouden worden van updates, onderhoudswerkzaamheden en storingen van alle betrokken partijen.

U dient in de support portal de eerste keer te kiezen voor ‘sign up’. Met uw e-mailadres kunt u zelf een wachtwoord aanmaken. Is uw e-mailadres al in gebruik? Kies van voor ‘forgot my password’. Hierna kunt u een nieuw wachtwoord aanmaken.

TRANSSMART.COM

16