FAQ PostNL Magento Plugin

Transcriptie

1 FAQ PostNL Magento Plugin Datum: Auteur: PostNL Versie: v1.1 1

2 Inhoud Waarom krijg ik de melding [LIRS_0] Geen combilabel beschikbaar?... 5 Waarom krijg ik de melding CONNECT ERROR: The 'community' channel is not installed. Please use the MAGE shell script to install the 'community' channel?... 5 Waarom krijg ik de melding Sorry, no quotes are available for this order at this time?... 6 Waarom is mijn 3S Track&Trace code niet klikbaar?... 7 Waarom is de PostNL Account button grijs?... 7 Waarom krijg ik de melding Exception occured: Could not update the Order: There are %amount% Orders in MijnPakket for OrderRef %order_number% of Webshop %webshop_id%?... 8 Waarom krijg ik de melding Magento Connect error: Package (community-enterprise)tig_postnl depends on PHP extensions: Array?... 8 Ondersteunt de extensie multishop omgevingen?... 9 Kan ik 1 PostNL account in meerdere aparte Magento omgevingen gebruiken?... 9 Waarom krijg ik de melding Access denied: Decryption of data failed?... 9 Waar vind ik mijn PostNL Checkout gegevens? Wat zijn de testgegevens voor de Magento plugin? Hoe kan ik adresregels in Magento opsplitsen? Hoe kan ik gebruik maken van de PostNL bezorgopties in Magento? Hoe kan ik gratis verzending aanbieden bij de verzendmethode PostNL? Hoe bepaal je de startpositie van het label bij labels printen? Hoe print ik verzendlabels vanuit Google Chrome? Waarom krijg ik een foutmelding tijdens installatie met Magento Connect? Hoe kan ik de plugin upgraden met Magento Connect? Hoe kan ik de plugin installeren met Magento Connect? Waarom zie ik op buitenlandse adressen geen verzendmethode? Hoe verwijder/deïnstalleer ik de extensie? Welke configuratiemogelijkheden zijn er voor brievenbuspakjes? Hoe configureer ik de Parcelware export in de Magento plugin? Welke methods kan ik gebruiken om PostNL bezorginformatie uit Magento op te halen? Waarom worden verzendlabels onscherp of onvolledig afgedrukt op een Zebra a6 printer? Hoe krijg ik huisnummer toevoeging bij handmatige bestellingen i.c.m. de postcode check? Waarom zijn PostNL acties niet zichtbaar in het verzendingen overzicht? Werkt de Postcode.nl extensie i.c.m. de PostNL Magento extensie? Hoe maak ik rollen aan in Magento? Welke configuratiemogelijkheden in Magento zijn er voor pakbonnen? Hoe kan ik andere verzendmethodes afhandelen via de PostNL extensie? Hoe kan ik multi colli zendingen aanmaken?

3 Is de PostNL plugin responsive? Hoe configureer ik matrix rates in de PostNL Magento Extensie? Hoe pas ik in Magento een logo aan in de Track & Trace ? Hoe test ik de PostNL Checkout en Account login in de Magento plugin? Waarom is extra vroeg ophalen niet zichtbaar als bezorgoptie? Waarom is mijn voormeldstatus na enkele dagen verlopen? Kan de PostNL extensie overweg met configurable producten? Hoe activeer ik rembours in de Magento plugin? Waarom zijn mijn PostNL tarieven niet zichtbaar in de PostNL Magento extensie? Waarom wordt de PostNL Account knop niet ingeladen? Hoe kan ik PostNL layout handles opnemen in transactionele s? Hoe activeer ik retouren in de Magento extensie? Hoe verwijder ik de gescheiden adresregels melding in de Magento extensie? Hoe pas ik de PostNL label startpositie aan in de Magento extensie? Waarom kan ik geen orders verwijderen als ik de PostNL Magento extensie gebruik? Waarom zijn mijn PostNL bezorgopties Engels in een Nederlandse webshop? Hoe werk ik productattributen bij via een script? Hoe werkt de PostNL verzendoptie Verhoogde Aansprakelijkheid in de Magento PostNL extensie? Hoe wijzig ik het onderwerp of inhoud van de Track & Trace ? Kan ik de Firecheckout gebruiken i.c.m. de PostNL Magento extensie? Waarom krijg ik een 403 foutmelding in het debugmenu van mijn browser? How do I install the PostNL Magento extension? Kan ik Brievenbuspakje & Brievenbuspakje Extra allebei gebruiken? Hoe installeer ik de patch voor SUPEE-6285 in de PostNL extensie en lager? Waarom wordt aangemeld meerdere keren getoond? Hoe ga ik om met de leveringsdatum in de Gomage LightCheckout? Waarom worden de adresinstellingen genegeerd in de GoMage LightCheckout? Hoe maak ik een API user aan? Hoe wijzig ik de afzender op labels en in de PostNL App? Hoe wijzig ik de afzender op labels en in de PostNL App? Afterpay en PostNL, waar moet ik op letten? Van welke database tabellen maakt de Magento plugin gebruik? Waarom krijg ik in Magento een wit scherm bij een voormelding? Kan ik de PostNL extensie via Modman installeren? Waar kan ik de release notes van de Magento plugin vinden? PostNL extensie v

4 PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v PostNL extensie v Hoe installeer ik de Magento extensie? Hoe configureer ik de Magento extensie? Waarom zijn mijn PostNL bezorgopties niet zichtbaar? Waarom krijg ik errors na installatie van de SUPEE-6788 patch? Waarom krijg ik een wit scherm na installatie van versie van de Magento extensie? Waarom krijg ik na voormelding een wit scherm in versie van de Magento extensie?

5 Waarom krijg ik de melding [LIRS_0] Geen combilabel beschikbaar? Probleem: Sommige EPS (EU) zendingen krijgen geen combilabel, maar een standaard label. Het label dat u normaal print is direct geschikt voor het gehele verzendtraject. Door externe omstandigheden kan dat bij deze order momenteel niet. Het label dat u nu print zal nog "overplakt" worden door PostNL om de aflevering mogelijk te maken. De melding is puur informatief en de zending zal goed verwerkt worden. U heeft als merchant geen invloed op de oorzaak van deze melding. Waarom krijg ik de melding CONNECT ERROR: The 'community' channel is not installed. Please use the MAGE shell script to install the 'community' channel? Probleem: U installeert de extensie met de Magento Connect Manager en krijgt daarbij de volgende foutmelding: CONNECT ERROR: The 'community' channel is not installed. Please use the MAGE shell script to install the 'community' channel." 5

6 Oplossing: U dient de mage map in uw Magento installatie schrijfrechten te geven (chmod 777). Tevens dient u met ssh het volgende commande te runnen:./mage mage-setup. Waarom krijg ik de melding Sorry, no quotes are available for this order at this time? Deze melding krijgt u als u een order in de backend aanmaakt. Dit kan diverse oorzaken hebben zoals: U selecteert een land waar geen verzendmethode aan is gekoppeld. U heeft nog geen product in de quote. U heeft probeert een bestelling te plaatsen waarvoor geen PostNL verzendproduct beschikbaar is. Het gebruikte Tablerate/Matrixrate.csv bestand is incorrect. 6

7 Waarom is mijn 3S Track&Trace code niet klikbaar? Een barcode wordt gereserveerd wanneer u een zending aanmaakt binnen Magento en is dan ook zichtbaar in het zendingenscherm maar is dan nog niet actief. Na het voormelden van een zending wordt de bijbehorende barcode geactiveerd. Het kan nog even duren (ongeveer 20 minuten) alvorens deze barcode ook bekend is bij PostNL en volgbaar wordt. Waarom is de PostNL Account button grijs? Als de PostNL Account button grijs blijft, ondanks dat er in de configuratie van de PostNL extensie geen meldingen staan over missende configuratie dient u het volgende te doen: 1. Zet de logging aan. Dit kan onder Systeem > Configuratie > Ontwikkelaar > Log instellingen. 2. Zet de PostNL debug modus op Volledig in Systeem > Configuratie > PostNL > Geavanceerde instellingen > Technische instellingen 3. Ga naar de winkelwagen en wacht totdat de grijze PostNL button zichtbaar is. 4. Er is nu een log beschikbaar met de naam "TIG_PostNL_Checkout_Debug.log". Die kunt u hier vinden op uw server: var/log/tig_postnl/ folder. 5. In deze log kunt u meer informatie vinden. Veel voorkomende oorzaken zijn: 1. Gewicht van de bestelling is onder de 2KG. In de PostNL extensie configuratie kunt u deze controle uitschakelen. 2. Een artikel uit de bestelling is niet op vooraad. In de PostNL extensie configuratie kunt u deze controle uitschakelen. 3. Uw PostNL Checkout sleutels zijn niet correct. Deze kunt u controleren in uw PostNL Checkout account. 4. Er vindt een Http/Https conflict plaats. Zorg dat in uw PostNL Checkoutaccount ( het domein zonder http of https is opgevoerd. 7

8 Waarom krijg ik de melding Exception occured: Could not update the Order: There are %amount% Orders in MijnPakket for OrderRef %order_number% of Webshop %webshop_id%? Probleem: In de backend krijgt de winkelier de volgende melding: Exception occured: Could not update the Order: There are %amount% Orders in MijnPakket for OrderRef %order_number% of Webshop %webshop_id%. Oplossing: Er zijn voor de genoemde webshop ID's meerdere orders geplaatst met hetzelfde ordernummer. Dit kan voorkomen als je hetzelfde webshop ID in meerdere webshops gebruikt. Gebruik voor elke shop een ander webshop ID of zorg er voor dat ordernummers voor elke shop uniek zijn. In Magento kunt u hiervoor het order increment ID voor elke website aanpassen. Waarom krijg ik de melding Magento Connect error: Package (communityenterprise)tig_postnl depends on PHP extensions: Array? Probleem: Bij de installatie van de extensie via Magento Connect krijgt u de volgende foutmelding: Magento Connect error: Package (community-enterprise)tig_postnl verise depends on PHP extensions: Array Oplossing: OpenSSL en SOAP dienen geactiveerd te zijn op uw server. Mochten deze actief zijn maar deze melding is toch zichtbaar, dan dient u de installatie via FTP te doen. De controle van Magento Connect op OpenSSL en SOAP kan niet worden voltooid. 8

9 Ondersteunt de extensie multishop omgevingen? De PostNL extensie ondersteunt volledige multi-store omgevingen. De configuratie van de extensie is op verschillende niveaus te configureren. Zo kunt u op website niveau aparte PostNL account gegevens invullen en kunt u PostNL Checkout per storeview activeren of deactiveren. Dit kan erg handig zijn, aangezien PostNL Checkout enkel gelokaliseerd is voor Nederlandse webshops. Het is niet wenselijk dat u uw PostNL account gegevens voor meerdere Magento webshops in aparte installaties gebruikt. Kan ik 1 PostNL account in meerdere aparte Magento omgevingen gebruiken? Het is mogelijk om dezelfde PostNL account gegevens te gebruiken voor meerdere Magento installaties. Let er hierbij wel op dat de gebruikte order en zendingnummers uniek moeten zijn. U kunt hier lezen hoe u unieke IDs kunt gebruiken voor verschillende Magento installaties. Waarom krijg ik de melding Access denied: Decryption of data failed? Probleem: Na het invoeren van uw unieke en privé sleutel tijdens de activatie van de extensie krijgt u de melding: "Access denied: Decryption of data failed" Oplossing: De privé sleutel is niet correct ingevoerd. Het kan zijn dat u spaties heeft mee gekopiëerd vanuit de . In sommige gevallen is het zo dat deze melding getoond wordt, terwijl de keys wel correct zijn overgenomen. In dat geval is het mogelijk om met bijgevoegd script de postnl_is_activated configwaarde direct in de database aan te passen. Dit script dient geüpload te worden op de root van de Magento installatie van de klant, waarna dit uitgevoerd wordt door in de adresbalk in te voeren. Wanneer dit script uitgevoerd wordt, worden de statistieken van deze gebruiker niet verstuurd naar PostNL. Houd hier rekening mee en gebruik dit dus enkel wanneer het niet is gelukt om dit op reguliere wijze op te lossen. 9

10 activatepostnl.php (160 bytes) Waar vind ik mijn PostNL Checkout gegevens? Om de PostNL checkout te activeren heeft u de volgende gegevens nodig: PostNL account gegevens Webwinkel extern ID Publiek Webshop ID Deze gegevens dient in het menu Account Instellingen in te voeren. Volg onderstaande stappen indien u geen heeft ontvangen van PostNL met de Webwinkel extern ID en Publiek Webshop ID. 1. Ga naar en log in. 2. U komt binnen op het dashboard en ziet "PostNL Checkout voor webwinkels". Selecteer uw webwinkel. 3. Ga naar het tabblad "Beveiliging". 10

11 4. Kopieer hier de Webwinkel extern ID en Publiek Webshop ID. Indien de ID's niet beschikbaar zijn in dit menu dient u contact op te nemen met PostNL. Wat zijn de testgegevens voor de Magento plugin? Vanaf versie 1.5 is de PostNL extensie zich na installatie standaard uitgeschakeld. Wanneer de extensie-modus op "test" wordt gezet, worden automatisch de PostNL testaccount gegevens ingevuld. Indien u wilt testen maar de gegevens van het PostNL test account reeds zijn overschreven met live gegevens dan kunt u onderstaande PostNL testaccount gegevens aanhouden. Klantnummer: Klantcode: TOTA Test gebruikersnaam: Dem0#Magnt01 Test wachtwoord: z9a4lpfd53z BLS (locatie) code: Webwinkel ID: 853f9d2a4c5242f097daeaf c Publiek Webshop ID: a98e0769d6bf40a8b49d85e7aff41d7a 11

12 Voor Wereldwijd verzenden testen heeft u deze gegevens nodig: Type Barcode GlobalPack: CD Klantcode Global Pack: 1660 Hoe kan ik adresregels in Magento opsplitsen? Indien u geen gebruikt wenst te maken van de postcode validatie is het is ten zeerste aan te raden om, voordat u de PostNL extensie gaat gebruiken, de adresregels te splitsen wanneer deze nog niet gesplitst geconfigureerd zijn in uw Magento webshop. Hiermee voorkomt u dat het verkeerde afleveradres aan PostNL wordt doorgegeven. Met het splitsen van de adresvelden wordt bedoeld dat de gebruikers van uw webshop aparte invulvelden hebben voor de straatnaam, het huisnummer en eventueel de extensie van het huisnummer. Volg de stappen hieronder om de adresregels op te splitsen wanneer dit nog niet het geval is in uw webshop. Magento Community Volg deze a,b,c stappen alleen wanneer u een Magento Community webshop heeft. a.) Ga in uw Magento beheeromgeving naar Systeem > Configuratie en klik links onder het kopje Klanten op Klant Configuratie. b.) Klik vervolgens op het kopje Naam en Adresinstellingen. c.) Voer bij het veld Aantal regels in adres het getal 3 in en klik op de Sla Configuratie op button. Ga verder bij stap d. Magento Enterprise Volg deze a,b,c stappen alleen wanneer u een Magento Enterprise webshop heeft. a.) Ga in uw Magento beheeromgeving naar Klanten > Attributen > Beheer klant adresgegevens. b.) Klik op de attribuutcode street. c.) Voer bij het veld lijn telling het getal 3 in en klik op de sla eigenschap op button. 12

13 Vervolgstappen voor Magento Community en Magento Enterprise d.) Ga weer naar Systeem > Configuratie en klik op PostNL. Klik op het kopje Winkel Instellingen. e.) Zet een vinkje achter 'Deel straatnaam velden op'. f.) Kies bij Straatnaam veld de gewenste adresregel. g.) Kies bij Huisnummer veld de gewenste adresregel. h.) Zet een vinkje achter 'Deel huisnummer op'. i.) Kies bij Huisnummer extensie veld de gewenste adresregel en klik op de Sla configuratie op button. Let op: Zorg dat voor straatnaam, huisnummer en huisnummer extensie verschillende velden worden gebruikt. j.) Eventueel kunt u voor Gebied, Gebouw naam, Afdeling naam, Deurcode en Verdieping nog aparte adresvelden aanmaken. Hiervoor moet u het getal dat u bij stap c heeft ingevoerd aanpassen. Let op: Voor Magento Community kunnen er maximaal 4 adresregels worden ingesteld. 13

14 De adresgegevens zijn nu juist ingesteld. Vergeet niet de velden in de frontend goed te labelen. Voorbeelden PostNL bezorgopties thema Als u gebruik maakt van PostNL bezorgopties in uw reguliere bestelproces kunt u kiezen uit twee thema's. - PostNL thema - Neutraal thema De extensie biedt ondersteuning voor: - Onepage Checkout (native Magento) - OneStepCheckout (betaalde extensie, zie onestepcheckout.com) - GoMage LightCheckout Onderstaand kunt u de twee thema's zien. PostNL thema Onepage Checkout 14

15 PostNL thema OneStepCheckout Neutraal thema Onepage Checkout 15

16 Neutraal thema OneStepCheckout Hoe kan ik gebruik maken van de PostNL bezorgopties in Magento? Wilt u ook gebruik maken van de PostNL bezorgopties in uw Magento webshop? Download gratis de extensie in onze webshop. Hoe kan ik gratis verzending aanbieden bij de verzendmethode PostNL? Als u de verzendkosten binnen uw Magento webshop berekent op basis van gewicht en bestemming d.m.v. Table Rates kunt u daar geen gratis verzending instellen voor een order boven een bepaalde waarde bij de verzendmethode zelf. Dit geldt tevens voor vaste verzendkosten. Het is echter wel mogelijk gratis verzending aan te bieden. Volg hiervoor onderstaande stappen: 1. Ga naar het menu Promotions ->Shopping Cart Price Rules. 2. Kies voor Add New Rule. 3. Configureer de velden in het tabje Rule Information. 4. Configuur het tabje Conditions naar wens. Wij hebben in onderstaand voorbeeld gekozen voor gratis verzending boven de 50 euro. 16

17 5. Configureer het tabje Actions als onderstaande afbeelding. 6. De tabjes Labels en Manage Coupon Codes hoeven niet te worden aangepast. 7. Test de aanpassing goed voor u het op de live omgeving doorvoert. Bovenstaande stappen zijn getest in Magento

18 Hoe bepaal je de startpositie van het label bij labels printen? Als u gebruik maakt van stickervellen met daarop 4 stickers per a4 zult u in de praktijk stickervellen overhouden waarop nog 3 of minder labels op zitten. Om deze vellen te kunnen gebruiken kunt u de positie waar de extensie begint met printen aanpassen. In het zendingengrid kunt u hiervoor kiezen als u de labels gaat printen. Deze functionaliteit is uitsluitend zichtbaar als de labels op a4 staan in de configuratie. Tevens kunt u de functionaliteit uitsluitend gebruiken als u van de batch mogelijkheid gebruik maakt. Hoe print ik verzendlabels vanuit Google Chrome? Let op. Onderstaand artikel is uitsluitend voor versie en lager. Vanaf versie gaat dit direct goed. Het printen van verzendlabels direct vanuit Chrome gaat niet juist. In de pop-up is al direct zichtbaar dat het niet goed gaat: 18

19 Er zijn drie mogelijkheden om verzendlabels via Chrome succesvol te printen: 1. Kies voor de optie "Print using sysem dialog" 2. Sla de verzendlabels vanuit Chrome op naar uw lokale computer. Dit kan door er met uw rechtermuisknop op de klikken en vervolgens te kiezen voor "Save as". Vervolgens opent u de verzendlabels lokaal met uw PDF reader. 3. Schakel de Chrome PDF viewer uit waardoor u ze altijd direct download en lokaal kunt openen met uw PDF reader (bijv. Adcrobat Reader). U kunt dit doen door in de browserbalk about:plugins te typen. Schakel vervolgens de Chrome PDF Viewer uit. Met andere browsers zijn er geen problemen bekend bij het direct vanuit de browser printen van labels. Bij Internet Explorer kan het wel nodig zijn de pagina te vernieuwen. Waarom krijg ik een foutmelding tijdens installatie met Magento Connect? In de installatiehandleiding van de PostNL extensie worden twee manieren beschreven om de PostNL Magento extensie te installeren: 1. Bestanden met FTP op server plaatsen 2. Het.tgz bestand via Magento Connect uploaden 19

20 Binnen Magento Connect is het ook mogelijk om een extensie key te gebruiken. Deze kunt u vinden op: Mocht u bij het installeren via de extensie key de melding "Connection Error try again later." krijgen dan dient u de " voor de link te verwijderen. Als installatie via een extensie key of.tgz bestand met Magento Connect niet werkt dan adviseren wij de bestanden via FTP te uploaden. Hoe kan ik de plugin upgraden met Magento Connect? Het is alleen mogelijk om te upgraden via Magento Connect als u de extensie ook via Magento Connect heeft geïnstalleerd. Mocht dat niet zo zijn dan dient u de upgrade via FTP uit te voeren, zie voor uitleg hierover de installatie handleiding. Stap 1. Controleer of de compiler uit staat via Systeem > Gereedschap > Compilatie. Zet de compiler uit wanneer deze ingeschakeld staat. Stap 2. Ga naar Systeem > Magento Connect > Magento Connect Manager. Log hier in met dezelfde gegevens als van uw Magento beheeromgeving. Let op: Om gebruik te kunnen maken van Magento Connect heeft u admin rechten nodig. Stap 3. Klik in de tabje Manage Existing Extensions achter TIG_PostNL op de dropdown onder Actions en kies voor de optie Uninstall. Klik vervolgens op de Commit Changes button. Stap 4. Kies bij het tweede blok in het tabje Direct package file upload het Magento Connect extensie.tgz bestand van de recentste versie en klik op de Upload button. Onderin zal er een blok met zwarte achtergrond en groene letters verschijnen. Zodra het pakket geïnstalleerd is, zal dit hier worden aangegeven. Stap 5. Ga in de beheeromgeving van uw Magento webshop naar Systeem > Beheer cache. Klik vervolgens op Selecteer alles, controleer of de Acties dropdown op Ververs staat en klik op de Bevestig button. 20

21 Stap 6. Log uit de beheeromgeving van uw Magento webshop en log opnieuw in. De upgrade is nu succesvol uitgevoerd. Hoe kan ik de plugin installeren met Magento Connect? Indien u de PostNL extensie via Magento Connect wilt installeren dan zijn hiervoor twee mogelijkheden: 1. Op Magentocommerce.com kunt u bij de PostNL een Extension Key kopiëren. 2. Extensie downloaden vanuit de Total Internet Group webshop en het.tgz bestand uploaden. Wij bespreken in dit artikel mogelijkheid 2, het uploaden van het.tgz bestand. In beide gevallen dient de compiler uit te staan. Indien wenselijk kunt u hiervoor stap 1 tot en met 3 van de installatie handleiding volgen (te vinden in de.zip bij de extensie). Stap 1. Ga naar Systeem > Magento Connect > Magento Connect Manager. Stap 2. Log hier in met dezelfde gegevens als van uw Magento beheeromgeving. Let op: Om gebruik te kunnen maken van Magento Connect heeft u admin rechten nodig. Stap 3. Kies bij blokje 2 onder het tabje Direct package file upload het Magento Connect extensie bestand dat u heeft gedownload (.tgz bestand, te vinden in de.zip) en klik op de Upload button. Onderin zal er een blok met zwarte achtergrond en groene letters verschijnen. Zodra het pakket geïnstalleerd is, zal dit hier worden aangegeven. 21

22 Let op: Krijgt u onderstaande fout? Log dan via ssh in op uw webserver en voer de volgende 2 regels code uit vanuit de root van uw Magento installatie: sudo chmod 777 mage./mage mage-setup De extensie is nu actief in uw webshop. Om de installatie af te ronden dient u de installatiehandleiding verder te volgen vanaf stap 6. 22

23 Waarom zie ik op buitenlandse adressen geen verzendmethode? Probleem: Uw klanten met een afleveradres in het buitenland zien de PostNL verzendmethode in het bestelproces niet. Zij zien de melding: "Sorry, er zijn momenteel geen offertes beschikbaar voor deze bestelling". Oorzaak: Er zijn diverse oorzaken voor dit probleem. Onderstaand kunt u de veel voorkomende oorzaken vinden, mocht dit het probleem bij u niet verhelpen neem dan contact met ons op. 1. Bij de PostNL verzendmethode is het land niet geselecteerd als beschikbaar land. 2. U gebruikt Table Rates/Matrix Rates maar het.csv bestand is niet correct. 3. Er staan geen PostNL producten aan die verzenden naar het buitenland mogelijk maken. Als u in de PostNL geavanceerde instelllingen zit kan dit in het tabje "Gebruikersinstellingen". Vervolgens zullen ook uw buitenlandse klanten kunnen afrekenen met de PostNL verzendmethode. Hoe verwijder/deïnstalleer ik de extensie? Om de PostNL extensie te deïnstalleren, dient het onderstaande stappenplan gevolgd te worden. LET OP: Wanneer u verzendingen onder rembours heeft verzonden, zijn deze vanaf het deïnstalleren niet meer te openen. Het is dus zeer belangrijk om deze verzendingen compleet af te handelen voordat u de PostNL extensie verwijdert. Verwijder de extensie niet door TIG_PostNL.xml aan te passen. Dit kan leiden tot problemen in uw backend. 1) Download het verwijderscript 2) Navigeer via FTP naar uw installatie van Magento 3) Zoek uw IP adres op (watismijnip.nl) 4) Open het bestand met een tekstbewerker als notepad en vervang op regel 2 UW_IP_ADDRESS_HIER door uw ip adres 5) Voeg het bestand deletepostnl.php toe aan de root van de Magento installatie 6) Navigeer in uw browser naar 7) Er zal nu een bericht verschijnen dat de PostNL extensie is verwijderd 8) Verwijder het script uit de root van uw installatie Dit script zet de extensie op non-actief. Daarnaast worden de toegevoegde PostNL attributen verwijderd en de PostNL regel uit de core_resource tabel verwijderd. Dit zorgt ervoor dat, wanneer de PostNL extensie geheractiveerd wordt via het TIG_PostNL.xml bestand, de 23

24 installatiescript opnieuw worden uitgevoerd en op deze manier de productattributen opnieuw worden toegevoegd. deletepostnl.php (3 kb) Welke configuratiemogelijkheden zijn er voor brievenbuspakjes? Als u gebruik wilt maken van brievenbuspakjes zijn er twee mogelijkheden: 1. De extensie bepaalt automatisch of een bestelling als brievenbuspakje wordt verzonden. 2. U bepaalt in de backend handmatig of een bestelling als brievenbuspakje wordt vezonden. Onderstaand per situatie een beschrijving van de aandachtspunten. 1. De extensie bepaalt automatisch of een bestelling als brievenbuspakje wordt verzonden. In deze situatie zijn onderstaande punten belangrijk: o o Al uw artikelen dienen met correcte gewichten te zijn ingevoerd. U dient bij elk artikel aan te geven hoeveel van deze artikelen in een brievenbuspakje passen. Op basis hiervan bepaalt de extensie of de bestelling in een brievenbuspakje past. Ter voorbeeld: Als u bij de max hoeveelheid 4 invult voor product A en 2 voor product B dan kan een consument product A 2x en product B 1x kopen en zal dat als brievenbuspakje worden verzonden. De berekening hiervoor is als volgt: Product A vult het brievenbuspakje voor 50% (want er passen er 4 totaal in). Product B vult het brievenbuspakje voor 50% (want er passen er totaal 2 in). Samen vullen zij het brievenbuspakje voor 100%. 24

25 25

26 26

27 27

28 Indien in deze situatie een pakket past als brievenbuspakje in de brievenbus, zullen PakjeGemak locaties niet getoond worden, aangezien een brievenbuspakje niet bij een PakjeGemak locatie afgeleverd kan worden. In deze situatie dient u de configuratie waarde "Toon PostNL bezorgopties voor buspakje bestellingen" in het tabje "Bezorgopties" naar wens in te stellen. U kunt artikelen hiervan uitzonderen door het attribuut "Max hoeveel" met 0 te vullen. U dient een aantal attributen naar wens te configureren. Zie onderstaand screenhot. 28

29 Dit artikel kan handig zijn om de attributen met de batchmethode in te stellen (let op! U wordt naar de pagina van TIG verwezen): 2. U bepaalt in de backend handmatig of een bestelling als brievenbuspakje wordt vezonden. In deze situatie zijn onderstaande punten belangrijk: U kunt in de backend alvorens u een zending aanmaakt bepalen of het in een brievenbuspakje past. U kunt dit overigens altijd achteraf nog omwisselen mocht het niet passen. In deze situatie dient u tijdvensterkeuze in de configuratie tabje "Bezorgopties" uit te schakelen. Omdat brievenbuspakjes met de normale postbode afgeleverd worden kan er geen tijdvak worden gegarandeerd. U dient goed op te letten of het geen PakjeGemak zending is. Eventueel kunt u ook PakjeGemak uitschakelen indien wenselijk. 29

30 Hoe configureer ik de Parcelware export in de Magento plugin? In de PostNL Magento extensie kunt u een.csv export van uw zendingen maken die u vervolgens in Parcelware kunt importeren. Deze fallback functionaliteit is bij normaal gebruik van de extensie niet nodig. Om van deze functionaliteit gebruik te maken heeft u de volgende gegevens nodig: Contract referentie nummer Contract naam Afzender adres referentie nummer Hieronder kunt u vinden waar u deze informatie kunt vinden binnen Parcelware Desktop en Parcelware Web. Parcelware Desktop o o o Contract referentie nummer Klik op Contracten > Mijn contractgegevens. Het Ref.nr. dient u te gebruiken. Contract naam Klik op Contracten > Mijn contractgegevens (Bewerken)> Contracten. Gebruik PostNL Pakketten+contractnummer dat u daar ziet. Afzender adres referentie nummer Klik op Contactgegevens > Afzenders > Afzender bewerken. Het Ref.Nr dient u te gebruiken. Parcelware Web o o o Contract referentie nummer Klik op Stamgegevens > Mijn Contractgegevens. Het Ref. Nr. dient u te gebruiken. Contract naam Klik op Stamgegevens > Mijn contractgegevens (Bewerken)> Contracten. Gebruik PostNL Pakketten+contractnummer dat u daar ziet. Afzender adres referentie nummer Klik op Stamgegevens > Afzenders. Het Ref. Nr. dient u te gebruiken. Welke methods kan ik gebruiken om PostNL bezorginformatie uit Magento op te halen? Onderstaande methods kunt u gebruiken binnen uw Magento webshop. De implementatie hiervan valt niet onder de kosteloze support die wij op de PostNL Magento extensie bieden. Uw technisch beheerder kan deze methods voor u toepassen in uw Magento webshop. getdeliveryoptionsinfo($entity) Als u deze method een order, quote, invoice, creditmemo of shipment object meegeeft 30

31 krijgt u een lijst m.b.t. de bezorgopties die de gebruiker gekozen heeft terug. Wij adviseren een shipment mee te geven omdat dit de meeste informatie oplevert. getdeliverydate($orderdate) Als u deze method een datum meegeeft waarop een order zal worden geplaatst of is geplaatst krijgt u een bezorgdatum terug. Deze method communiceert niet met PostNL, met feestdagen zal bijvoorbeeld geen rekening worden gehouden. getpostcodedeliverydate($postcode) Als u deze method een Nederlandse postcode meegeeft krijgt u de eerst mogelijke bezorgdatum terug. Deze method communiceert met PostNL en levert dus actuele informatie. Omdat er communicatie met PostNL nodig is voor deze method kan het extra tijd kosten. Voor deze method is het noodzakelijk dat u een active quote heeft. Als u dat niet heeft, kunt u een oude quote uit de database inladen en als tweede parameter meegeven. getshippingduration() Deze method bepaalt de overkomst duur voor de huidige quote. Hierbij wordt gekeken naar de configuratie setting en de producten in de winkelwagen die mogelijk een afwijkende overkomstduur hebben. Er wordt geen rekening gehouden met de cut-off tijd. Al deze methods staan in de TIG_PostNL_Helper_DeliveryOptions class. Waarom worden verzendlabels onscherp of onvolledig afgedrukt op een Zebra a6 printer? Als u ervaart dat bij het printen van verzendlabels via een Zebra printer de verzendlabels niet volledig of scherp zijn dient u allereerst te controleren of het verzendlabel er wel goed uit ziet voor u hem print (.pdf bestand). Mocht het label daar niet volledig zijn neem dan contact op met de Servicedesk. Als het label er op uw computer goed uitziet maar als u hem print niet volledig is dan adviseren wij u indien u Windows gebruikt onderstaande link te volgen: U kunt hiermee een programma van Zebra installeren dat al uw lokale printer instellingen reset waardoor de labels weer goed uit de printer komen. Als het label er op uw computer goed uitziet maar als u hem print de barcode niet scherp is dan adviseren wij de snelheid van de printer te verlagen. Dit kan in de configuratie van de printer. 31

32 Hoe krijg ik huisnummer toevoeging bij handmatige bestellingen i.c.m. de postcode check? Als u gebruik maakt van de PostNL extensie zijn er twee manieren om de adresgegevens van uw klant vast te leggen: 1. Normale Magento wijze waarbij u adresvelden aanmaakt. 2. Postcode check, de PostNL extensie overschrijft de standaard Magento velden. Indien u de postcode check gebruikt zullen er 3 velden gebruik worden: -Straatnaamveld 32

33 -Huisnummerveld -Huisnummertoevoegingveld Op onderstaand screenshot is te zien hoe dit eruit ziet bij een bestelling. Indien u een adres wilt wijzigen of handmatig een order aanmaakt heeft u wellicht geen derde veld voor de huisnummertoevoeving zoals te zien is op onderstaand screenshot. Mocht dit bij u voorkomen download dan de pdf door deze link te volgen: De oplossing kunt u vinden onder het kopje [POSTNL-0005] Gescheiden adresregels. Waarom zijn PostNL acties niet zichtbaar in het verzendingen overzicht? Het kan zo zijn, dat na de installatie van de PostNL extensie het niet mogelijk is voor nietadmin gebruikers om de PostNL acties op verzendingen toe te passen. 33

34 Wanneer dit het geval is, ziet het verzendingenoverzicht er als volgt uit: Dit probleem ontstaat wanneer de PostNL extensie is geïnstalleerd, maar niet de juiste rechten aan de gebruikers zijn toegekend. Voor de acties van de PostNL extensie toe te passen, heeft de gebruiker namelijk een extra set rechten nodig. Om dit op te lossen moeten de juiste rechten toegekend worden aan de rol van de gebruiker. In dit voorbeeld gaat het om TestGebruiker, die als rol TestRol heeft. TestGebruiker kan op het moment niet de PostNL acties uitvoeren op de zendingen. Om dit te verhelpen volgt u het volgende stappenplan: 1) Log in op het admin account, of een andere account die toegang heeft tot de rechteninstellingen 2) Navigeer naar de Systeem->Toestemmingen->Gebruikers 3) Selecteer de gebruiker in kwestie, en controleer welke rol deze gebruiker heeft 4) TestGebruiker is TestRol, daarom dienen voor TestRol de permissies aangepast te worden. 5) Navigeer naar Systeem->Toestemmingen->Rollen en selecteer de rol in kwestie 6) Selecteer 'Rol Bronnen' 34

35 7) Scroll naar het kopje PostNL en activeer deze Nu is het mogelijk om met de zojuist geactiveerde rol de PostNL verzendingsopties uit te voeren! Werkt de Postcode.nl extensie i.c.m. de PostNL Magento extensie? Postcode.nl heeft een Magento extensie waarmee consumenten in uw webshop adressen kunnen aanvullen en valideren. Wij adviseren deze extensie uit te schakelen als u gebruik maakt van de PostNL Magento extensie. In een standaard configuratie conflicteert dit met de PostNL extensie vanwege een verschil in velden waarin de straatnaam, het huisnummer en de huisnummer toevoeging worden geplaatst. Dit leidt tot foutmeldingen bij het voormelden van zendingen. Tevens zijn er problemen met het tonen van de juiste veld in de frontend bekend. Wij adviseren de Postcode.nl Magento extensie uit te schakelen en de postcode check van de PostNL extensie te gebruiken om problemen te voorkomen. Hoe maak ik rollen aan in Magento? Er kunnen binnen Magento nieuwe rollen aangemaakt worden, zodat bepaalde gebruikers minder (of meer) rechten hebben dan de bestaande rollen. Dit kan gedaan worden volgens het volgende stappenplan: - Navigeer naar Systeem->Toestemmingen->Rollen - Selecteer rechtsboven 'Nieuwe Rol Toevoegen' - Vul de Rolnaam in en selecteer vervolgens Rol Bronnen - Ken de gewenste rechten toe aan de gebruiker en sla deze instellingen op Gebruikers hebben voor de PostNL extensie een aantal permissies nodig om gebruik te maken van de volledige extensie. Deze zijn op te delen in twee delen: 35

36 Het kopje PostNL: hierin worden de rechten toegekend voor de functionaliteit van de PostNL extensie Het kopje configuratie: hierin staat een tweetal PostNL permissies voor Systeem- >Configuratie Hieronder staan deze permissies verder uitgelegd: Onder het kopje PostNL: PostNL: Basis permissie, wanneer deze niet is aangevinkt kan de rol geen gebruik maken van de PostNL extensie in de backend. Verzending: Nodig om van de order een PostNL zending te maken Volledige statusgeschiedenis: Nodig om de geschiedenis te zien van de verschillende statusupdates van de order Acties: Nodig om de verschillende acties uit te voeren in het verzendingenoverzicht Voormelden: Nodig om een PostNL verzending te kunnen voormelden Verzendingslabel Printen: Nodig om een PostNL verzendlabel te printen voor een PostNL zending Print Pakbonnen: Nodig om een PostNL pakbon te printen met verzendlabel, voor een PostNL zending Parcelware Export Aanmaken: Nodig om een export te maken naar Parcelware, wanneer hiervan gebruik gemaakt wordt Send Track & Trace Nodig om handmatig een Track&Trace te versturen naar de ontvanger van een PostNL zending Voormeldig Wijzigen: Nodig om, na het voormelden van een zending, de voormeldstatus te wijzigen Verwijder Verzendlabels: Nodig om de verzendlabels te verwijderen, zodat nieuwe verzendlabels aangemaakt kunnen worden Omzetten: Nodig om de eigenschappen van de PostNL zendingen aan te passen, na het aanmaken van de PostNL zending Naar Pakket: Nodig om een Brievenbuspakje om te zetten naar een Pakket Naar Brievenbuspakje: Nodig om een Pakket om te zetten naar een Brievenbuspakje 36

37 Wijzig Productopties: Nodig om de verschillende productopties van een PostNL zending te wijzigen, na het aanmaken van de PostNL zending. Onder Configuratie: PostNL: Nodig om de configuratiepagina van de PostNL extensie te zien en aan te passen. Download PostNL log bestanden: Nodig om via de configuratiepagina van de PostNL extensie de PostNL logbestanden te downloaden, zonder dat hiervoor FTP toegang nodig is voor verdere instructies hoe een gebruiker toegevoegd kan worden aan een rol, volg deze link (Let op! Deze link gaat naar de pagina van TIG, de ontwikkelaar van de plugin): Welke configuratiemogelijkheden in Magento zijn er voor pakbonnen? De PDF pakbon van de PostNL extensie is vanuit de backend in zijn geheel te configureren. Het configureren van de PDF pakbon kun je doen door te gaan naar: Systeem->Configuratie->Verkoop->Facturatie en verpakking ontwerp (stap 1) Systeem->Configuratie->PostNL->Geavanceerde Instellingen->Label, Pakbon en Gewichtsinstellingen (stap 2 t/m 17). Hieronder staat een overzicht waaruit duidelijk gemaakt wordt welke configuratiewaardes in de backend invloed hebben op de gedeeltes van de pakbon: 37

38 38

39 39

40 40

41 Hoe kan ik andere verzendmethodes afhandelen via de PostNL extensie? In dit artikel beschrijven wij hoe u meerdere verzendmethodes aan de PostNL extensie kunt koppelen. Ter voorbeeld enkele situaties waarin dat nuttig kan zijn: U heeft normaal een levertijd van een week (overeenkomstduur is configureerbaar i.v.m. bezorgopties) maar indien een klant extra verzendkosten betaalt kunt u direct afzenden. Dan heeft u de normale verzendmethode en een express verzendmethode. U wilt uw klant de keuze geven tussen normale of aangetekende verzending, waarbij het echter niet mogelijk is op beide verzendmethodes bezorgopties aan te bieden. U stapt over van een andere logistieke partij naar PostNL en u heeft nog orders open staan die via een andere verzendmethode zijn aangemaakt. U gebruikt een andere verzendmethode i.v.m. matrix verzendkosten. Let op: Hoewel er gebruik gemaakt kan worden van vrijwel elke verzendmethode, kan niet de werking van alle verzendmethoden gegarandeerd worden. Test elke verzendmethode daarom uit op een testomgeving alvorens dit te activeren op de productieomgeving. Aangezien dit 3e partij extensies betreft, kan er helaas geen gratis support worden geleverd op externe verzendmethoden. 1. Ga naar de PostNL configuratie en open het tabje Geavanceerde instellingen > Technische instellingen. 2. Bij de configuratie optie PostNL verzendmethodes selecteert u de verzendmethodes waar u PostNL handelingen op wilt uitvoeren. Bij de eerste verzendmethode zullen bezorgopties zichtbaar zijn. U kunt de volgorde van de verzendmethodes aanpassen door een sorteervolgorde in te stellen bij verzendmethode. Hoe kan ik multi colli zendingen aanmaken? Naast standaard verzendingen van 1 pakket, is het ook mogelijk om binnen de PostNL extensie een zending aan te maken van meerdere pakketten, een multicolli zending. Wanneer een multicolli zending aangemaakt moet worden, is de flow afwijkend van de standaard flow van de PostNL extensie. Volg daarom, bij het maken van een multicolli zending, het onderstaande stappenplan: In het bestellingen overzicht, selecteer de bestelling waar een multicolli zending van gemaakt moet worden Binnen de detailpagina van de bestelling, selecteer de optie 'verstuur' 41

42 Binnen de verzendingen-aanmaak pagina dient er naar de bodem van de pagina gescrold te worden, waar de optie 'aantal pakketten' standaard op '1' staat. Vul hier het gewenste aantal colli in en selecteer 'stuur verzending'. Indien een zending al is aangemaakt, is het mogelijk om deze achteraf aan te passen tot een multicolli zending. Hiervoor dient, indien de zending is voorgemeld, eerst de voormelding geannuleerd te worden. Open hiervoor de zending en gebruik de knop "Postnl - Voormelding annuleren". Hierna is het mogelijk om het aantal pakketten te wijzigen. Is de PostNL plugin responsive? Vanaf versie 1.4 is er een mogelijkheid om gebruik te maken van responsive PostNL bezorgopties. De extensie biedt hierbij ondersteuning voor: Magento OnePageCheckout i.c.m. RWD theme Idev OneStepCheckout 4.1 GoMage LightCheckout(vanaf versie 1.6) Magento OnePageCheckout i.c.m. RWD theme 42

43 Vanaf versie Magento Community 1.9 & Enterprise 1.14 biedt Magento een responsive theme (RWD). Idev OneStepCheckout 4.1 De OneStepCheckout van Idev heeft de mogelijkheid om responsive te worden ingesteld. Dit is nodig om de PostNL bezorgopties responsive te kunnen tonen in uw OneStepCheckout. Uitleg hoe u de OneStepCheckout responsive kunt maken leest u op deze pagina: GoMage LightCheckout Vanaf versie 1.6 van de PostNL extensie bieden wij ook ondersteuning voor de GoMage LightCheckout hierbij is het mogelijk om de volgende opties te gebruiken: Postcode validatie, bezorgopties & PostNL Account login. Om gebruik te maken van het responsive ontwerp van de PostNL bezorgopties, dient dit geactiveerd te worden. Dit kan gedaan worden onder Systeem->configuratie->PostNL- >Bezorgopties->"gebruik responsive ontwerp". Wanneer deze optie wordt aangevinkt en opgeslagen, zal de extensie gebruik maken van de responsive variant van de PostNL bezorgopties. Let op: Het PostNL responsive thema voor de PostNL bezorgopties kan mogelijk conflicteren met bestaande custom Magento themes. Daarom is het aan te raden om dit eerst op een testomgeving te activeren en door te testen, alvorens dit op de productieomgeving te activeren. Hoe configureer ik matrix rates in de PostNL Magento Extensie? De PostNL Magento extensie biedt u drie manieren om verzendkosten te bepalen: Platte verzendkosten Table Rates, hierbij kunt u de Magento Table Rates overnemen of specifieke PostNL Table Rates gebruiken. Matrix Rates Om uw verzendkosten gelijk te maken aan uw PostNL tarieven dient u gebruik te maken van de Matrix Rates. Als u gebruik wilt maken van de matrix functionaliteit om uw verzendkosten te bepalen dan adviseren wij u onderstaande punten aandachtig door te nemen. Wij adviseren het.csv bestand te openen met Google Docs, Libre Office, of een simpele textbewerker (zoals notepad). Het bewerken van het bestand met Microsoft Excel raden wij af in verband met het niet correct tonen van de data. Wanneer het.csv bestand is geopend in Excel, kan het ook voorkomen dat dit niet meer geüpload kan worden. We raden u aan om bij verzendkosten de tarieven in te vullen die corresponderen met uw contract. 43

44 Om voor internationale verzendingen gebruik te maken van Magento's tablerates raden we u aan om de gewichten van uw producten (catalogus->beheer producten->gewenste product) correct te configureren. De gewichten dienen gebaseerd te zijn op de gewichten van het product inclusief verpakking- en verzendmateriaal. In uw contract kunnen verschillende tariefmethoden gehanteerd worden, het zogenaamde COLLO/KILO tarief of één gemiddeld tarief per land. Het kan zijn dat voor nationale en internationale verzendingen twee verschillende methoden gehanteerd worden. De tarieven gelden tot en met het laatst aangegeven gewicht in de betreffende gewichtstrap. Tot en met 5 kilogram betekent dus dat elk pakket niet zwaarder mag zijn dan 5 kilogram. Als uw contract is gebaseerd op één tarief kunt u dit tarief per land invullen door één gewichtstrap te vervangen met een sterretje (*) en de overige gewichtstrappen voor dat land te verwijderen. De verzendkosten voor brievenbuspakje worden alleen aan uw klanten getoond als brievenbuspakjes automatisch berekend worden. Wanneer er gebruik wordt gemaakt van een handmatige berekening van brievenbuspakjes, zullen de verzendkosten voor een pakket getoond worden. Het is mogelijk om a.d.h.v. postcodes andere verzendtarieven te gebruiken. Dit kan handig zijn als u bijvoorbeeld in uw eigen stad geen verzendkosten heeft omdat u het zelf brengt. Standaard kunt u hier geen wildcard op toepassen, dus elke postcode dient er in te staan. Neem contact op met de servicedesk indien u een grote range postcodes wilt toevoegen. PostNL_default_matrix_rates.csv (30 kb) Hoe pas ik in Magento een logo aan in de Track & Trace ? Het is mogelijk om het logo van de track&trace aan te passen. Dit kan gedaan worden door te navigeren naar Systeem->configuatie->ontwerp. Vervolgens kan het in het onderste tabblad een nieuw logo voor de transactionele s geüpload worden. Dit logo zal gebruikt worden voor alle transactionele s, waaronder dus ook de PostNL Track&Trace . 44

45 Hoe test ik de PostNL Checkout en Account login in de Magento plugin? De PostNL extensie kan in een testmodus gezet worden. Dit kan handig zijn als er nog geen accountgegevens aangemaakt zijn bij PostNL. De PostNL testmodus maakt gebruik van de PostNL testgegevens die gevonden kunnen worden op pagina 11 van dit document. De PostNL testmodus kan gebruikt worden om de volledige functionaliteit van de extensie te testen. Indien de PostNL Checkout en/of PostNL Account login getest worden, dient u wel een aparte account aan te maken. Wanneer deze diensten in testmodus geconfigureerd staan, zullen deze diensten verbinding maken met de testomgeving van PostNL, waarbinnen uw standaard consumenten account niet bekend is. Daarom dient u een test consumenten account aan te maken, wat u op de volgende pagina kunt realiseren: Uiteraard kunt u deze functionaliteiten ook met uw live account testen. Waarom is extra vroeg ophalen niet zichtbaar als bezorgoptie? Wanneer uw bezorgoptiesopties zichtbaar zijn, maar consumenten geen 'extra vroeg ophalen op een Postkantoorlocatie' keuze kunnen maken doorloop dan onderstaande stappen: 1. Ga naar Systeem ->Configuratie ->Verkoop ->PostNL->Bezorgopties. 2. Bevestig dat de Bezorgopties geactiveerd zijn. 3. Zorg ervoor dat de optie Activeer extra vroeg postkantoor locaties op Ja staat. Let op dat nog niet op elke locatie extra vroeg ophalen beschikbaar is. 45

46 Waarom is mijn voormeldstatus na enkele dagen verlopen? Probleem: In uw bestellingen- en zendingenoverzicht staat in de kolom Voormeld Status na enkele dagen "Voormelding verlopen" bij al uw PostNL zendingen. Tevens is de achtergrond niet meer groen maar rood. Oplossing: Dit wijst op een cron die niet correct alle taken afrond. Neem contact op met uw ontwikkelaar. Kan de PostNL extensie overweg met configurable producten? Kan de PostNL extensie overweg met configureerbare producten? Jazeker. De PostNL extensie gebruikt de configuratie van het simple product voor de configuratie van het configurable product. Dit houdt in dat de voorraad, bezorgoptie voorkeuren en brievenbuspakje instellingen worden behouden. Hoe activeer ik rembours in de Magento plugin? Als u PostNL rembours betalingen wilt accepteren dient u twee stappen te nemen: 1. Schakel PostNL Rembours in. Dit kan in de configuratie van de PostNL Magento extensie. 2. Schakel de betaalmethode PostNL rembours in. Dit kan in het betalingsmethoden menu van Magento. Als u een Rembours zending heeft neemt u de volgende stappen: 1. U plakt het label op de doos. 2. U vult het remboursformulier in. 3. Schuift het remboursformulier in een doorzichtige envelop, of een envelop met vensters waaruit duidelijk blijkt dat het een remboursformulier betreft. Deze envelop plakt u op de zending. Waarom zijn mijn PostNL tarieven niet zichtbaar in de PostNL Magento extensie? Hier zijn twee redenen voor: Verschillende tarieven Elke merchant maakt eigen tariefafspraken met PostNL. 46

47 Verschil PostNL tarief en verzendkosten Merchants kunnen er voor kiezen om andere verzendkosten aan de consument door te berekenen dan zij zelf voor de zending betalen aan PostNL. Denk aan verpakkingsmateriaal dat erbij zit of gratis verzending. 47

48 Waarom wordt de PostNL Account knop niet ingeladen? Probleem: De PostNL Account inlogknop wordt niet getoond op de checkout. Dit gaat gepaard met de volgende meldingen: NB: afbeelding ook te downloaden als bijlage onderaan dit artikel Oplossing: Bovenstaand probleem kan 3 redenen hebben, daarom kan dit het beste stap voor stap aangepakt worden. Controleer allereerst of het juiste Webshop ID en Publieke Webshop ID ingevuld is. Het makkelijkste is om de originele accountgegevens van PostNL nogmaals direct over te nemen in deze velden. Deze zijn via de mail door een PostNL medewerker toegestuurd. Daarnaast kunnen deze gegeven ook gevonden worden op checkout.postnl.nl, wanneer is ingelogd, onder het tabje 'beveiliging'. Let op: De Webshop ID's worden niet gevalideerd door de knop 'valideer accountgegevens'. Een succesvolle valdiatie is dan ook geen garantie dat de Webshop ID's correct zijn. Daarnaast kan het zijn dat op checkout.postnl.nl niet is aangegeven dat de webshop gebruik kan maken van de PostNL Account login. Onder het tabje 'beveiliging' staat onderaan het formulier het veld 'Referer URL'. Hier dient de URL van de webshop ingevuld te worden, zodat deze herkend wordt als toegestane URL. Let op: De URL dient ingevuld te worden zonder 'Http(s)://' en zonder ' De website ' dient ingevuld als 'voorbeeld.nl'. Ten slotte is het ook mogelijk dat de account geen toegang heeft tot de PostNL Account login. Als bovenstaande stappen niet werken, is het raadzaam contact op te nemen met de betreffende PostNL accountmanager, zodat dit geactiveerd kan worden. Hoe kan ik PostNL layout handles opnemen in transactionele s? Let op. Voor onderstaande uitleg is basis kennis HTML nodig. Vanaf versie 1.5 is het mogelijk om informatie over PostNL zendingen op te nemen in alle transactionele s binnen Magento. Volg hiervoor onderstaande stappen: 1. Ga naar Systeem > Transactionele s. 2. Open een sjabloon dat u reeds heeft aangemaakt of voeg een nieuw sjabloon toe. U kunt onderstaande handles gebruiken op alle templates waar het order object in beschikbaar is, zoals in de orderbevestiging, factuur en verzending template. 48

49 3. In het veld Inhoud sjabloon kunt u onderstaande variabelen opnemen: {{layout handle="postnl_ _order_pakjegemak_address" order=$order}} Deze layout handle voegt het PakjeGemak adres toe indien van toepassing. {{layout handle="postnl_ _order_delivery_options" order=$order}} Deze layout handle voegt informatie over de gekozen bezorgopties toe indien van toepassing. Beide layout handles zijn vormgegeven op basis van de standaard Magento templates. Als de s in uw webshop hier van afwijken kan het nodig zijn om de layout handles vorm te geven. Hiervoor kunt u de template in /app/design/frontend/base/default/template/tig/postnl/core/sales/order/ / kopiëren naar het package/theme dat door uw Magento webshop gebruikt wordt. De templates kunnen daar gewijzigd worden naar wens. Dit werkt op dezelfde wijze als waarop je Magento pagina's vormgeeft. Hoe activeer ik retouren in de Magento extensie? Let op: Voor de retourfunctionaliteit is een antwoordnummer verplicht. Neem contact op met uw PostNL accountmanager voor meer informatie. Standaard staat de retourfunctionaliteit uitgeschakeld in de PostNL configuratie. Indien u een antwoordnummer heeft ontvangen van uw PostNL accountmanager en u gebruik wilt maken van de PostNL extensie retouren functionaliteit, kan deze geactiveerd worden onder Systeem->configuratie->PostNL->"Geavanceerde instellingen"->retouren- >"Activeer Retouren" De retourfunctionaliteit kan uitsluitend met een live PostNL account worden getest. Er kan op vier manieren een retourlabel worden aangemaakt: In de backend door de webwinkelier. Ga hiervoor naar het zendingen detail scherm en klik op de button "PostNL - Verstuur Retourlabel ". Het retourlabel zal per aan de consument worden verzonden. In de backend door de webwinkelier bij het aanmaken van een verzendlabel (configureerbaar) Via de frontend door klanten op de accountpagina (configureerbaar) Via de frontend door gasten op de gasten order pagina (configureerbaar) U kunt de aangemaakt retourlabels bekijken in uw backend, ga hiervoor naar het menu Sales > PostNL Retouren. 49

50 Hoe verwijder ik de gescheiden adresregels melding in de Magento extensie? Let op: Voer dit enkel uit op instructie van de servicedesk Download onze lijst met foutmeldingen door deze link te volgen: Volg eerst de instructies onder het artikel met de naam[postnl-0005]. Als het probleem hierna niet opgelost is kan de melding op instructie van de servicedesk worden uitgeschakeld. Dit kan gedaan worden door onderstaand bestand te downloaden, waarna deze geplaatst kan worden in app/code/community/tig/postnl/block/adminhtml/system/config/form/field. Wanneer hierna de caches geflusht worden, zal de melding verdwijnen. SplitAddressCheck.php (4 kb) Hoe pas ik de PostNL label startpositie aan in de Magento extensie? In de PostNL extensie is het mogelijk om de startpositie voor het labels printen aan te passen. Dit is geïntroduceerd zodat het niet noodzakelijk is om delen van een stickervel weg te moeten gooien. Om de startpositie voor het labels printen aan te passen, dient eerst het verzendingenoverzicht geopend te worden; Op het moment is het enkel mogelijk om dit via het verzendingenoverzicht te doen. Selecteer vervolgens de orders waarvan het label geprint moet worden. Nu kan de printer startpositie worden aangepast, zodat dit op een afwijkende startpositie wordt geprint. Selecteer vervolgens vanaf welke positie geprint moet worden, en print de labels. Het resultaat ziet er (bijvoorbeeld) als volgt uit: 50

51 51

52 Waarom kan ik geen orders verwijderen als ik de PostNL Magento extensie gebruik? Het verwijderen van orders is geen standaard onderdeel van Magento. Wanneer Magento orders verwijderd zijn terwijl de Foreign Key Contstraints uitstaan zal de PostNL extensie niet meer naar wens werken. Wij adviseren dan ook om geen orders te verwijderen. Toelichting PostNL Magento extensie en Magento orders De PostNL orders zijn gekoppeld aan Magento orders. Wanneer de Magento order verwijderd wordt, kan het voorkomen dat een oude PostNL order wordt gekoppeld aan een (verkeerde) nieuwe Magento order. Dit heeft tot gevolg dat de gekozen PostNL bezorgopties niet correct worden getoond in de backend en dat verzendlabels onjuiste informatie bevatten. Voorkomen problemen toekomstige orders Indien er Magento orders zijn verwijderd en er problemen hierdoor zijn is er geen manier om de verkeerd gekoppelde orders te herstellen. Het is wel mogelijk om de verkeerd gekoppelde orders te verwijderen, zodat vanaf de eerstvolgende order dit probleem niet meer voorkomt. Om dit te uit te voeren, dient eerst de database worden geopend. In de database, open de tabel tig_postnl_order. Allereerst moet elke postnl order verwijderd worden welke een NULL waarde heeft in de kolom order_id of quote_id. Daarnaast dient de tabel sales_flat_order geopend te worden in een nieuw tabblad/venster. Neem van elke rij uit de tig_postnl_order tabel de order_id, en zoek de bijbehorende entity_id op binnen sales_flat_order. Voorbeeld: Een postnl order heeft enitity_id '1' en heeft als order_id '5'. In de tabel sales_flat_order zoek je dan de order met entity_id '5' op. Indien de betreffende entity_id niet bestaat in de tabel sales_flat_order, dient de postnl order verwijderd te worden. 52

53 Ten slotte dient de quote_id van tig_postnl_order vergeleken te worden met de quote_id van sales_flat_order. Indien deze van elkaar verschillen, dient de postnl order verwijderd te worden. Voorbeeld: Een postnl order heeft entity_id '1', heeft als order_id '5' en als quote_id '7'. In de tabel sales_flat_order pak je eerst de order met entity_id '5'. Deze order heeft als quote_id '4'. Aangezien de quote id van de PostNL order verschilt van de quote_id van de Magento order, dient de PostNL order verwijderd te worden. Bovenstaande stappen dienen herhaald te worden voor de tabellen tig_postnl_shipment en sales_flat_shipment. Wanneer een shipment_id uit de tig_postnl_shipment tabel niet teruggevonden kan worden als entity_id binnen de tabel sales_flat_shipment, dient de PostNL shipment verwijderd te worden. Indien de order_id uit tig_postnl_shipment niet overeenkomt met de order_id uit sales_flat_shipment, dient ook de PostNL order verwijderd te worden. Indien u ondersteuning hierbij nodig heeft kunt u contact opnemen met de servicedesk 53

54 Waarom zijn mijn PostNL bezorgopties Engels in een Nederlandse webshop? Een bekend probleem is dat uw PostNL bezorgopties Engels zijn maar uw webshop Nederlands. Vanaf Magento versie CE1.7/EE1.12 is een mogelijke oorzaak het missen van een Javacript in uw Magento thema. Neem contact op met uw ontwikkelaar hiervoor. Uiteraard kunt u ook contact op nemen met de servicedesk, wij helpen u graag verder. Hoe werk ik productattributen bij via een script? Wanneer het niet mogelijk is om via de cron de PostNL producattributen bij te werken, biedt dit artikel een fallback methode aan. In oudere versies van de PostNL extensie werden de producattributen bijgewerkt door middel van een script. Hier is vanaf geweken omdat dit script niet altijd binnen de server time-out uitgevoerd kon worden, als een webshop een groot aantal artikelen had. Dit script is echter nog achter de hand gehouden, voor het geval de cron niet toereikend is. Om de producattributen handmatig bij te werken, dient het script producattributes.php op de root van de Magento installatie geplaatst te worden. Vervolgens dient het script geopend te worden en op regel 39 het IP adres van de gebruikte computer toegevoegd te worden (kan gevonden worden op Nu kan het script aangeroepen worden door in de adresbalk de URL van de webshop in te vullen, gevolgd door /producattributes.php.. Het script zal nu uitgevoerd worden en een melding geven wanneer de attributen zijn bijgewerkt. Indien het script niet uitgevoerd kan worden binnen de server time-out (hier zal een melding van gegeven worden als dit het geval is), dienen scripts datauprade1-6.php gedownload te worden, en bovenstaande uitvoering voor elk bestand opgevolgd te worden. Deze script zijn opgedeelde versies van producattributes.php, om de server belasting per uitvoering te minimaliseren. Na het uitvoeren van het (of alle) scripts, dient enkel nog de cache geflushed te worden. De melding dat de extensie nog geüpgrade wordt, zal hierdoor niet automatisch verdwijnen. Hiervoor dient u de if statement in het bestand app/design/adminhtml/default/default/template/tig/postnl/upgrade_notification.phtml op false te zetten. Deze If statement staat op regel 44, normaliter staat er: <?php if ($_upgradeactive):?> dit kunt u veranderen in: <?php if (!$_upgradeactive):?> met deze aanpassing zal de melding verdwijnen. dataupgrade2.php (5 kb) dataupgrade5.php (5 kb) productattributes.php (3 kb) dataupgrade1.php (5 kb) 54

55 dataupgrade3.php (5 kb) dataupgrade4.php (5 kb) dataupgrade6.php (5 kb) Hoe werkt de PostNL verzendoptie Verhoogde Aansprakelijkheid in de Magento PostNL extensie? Met de PostNL verzendoptie Verhoogde Aansprakelijkheid is de inhoud van uw pakket verzekerd tot maximaal euro bij diefstal en vermissing. Op de PostNL website vindt u hier meer informatie over, zie: Standaard staat deze verzendoptie aan voor Postkantoor zendingen als u de PostNL Magento extensie gebruikt. U kunt dit naar wens wijzigen, volg hiervoor onderstaand pad: Systeem > Configuratie > PostNL > Geavanceerde Instellingen > Gebruikersinstellingen De verhoogde aansprakelijkheid gaat in een staffel van 500 euro. Als u via de batch methode voormeld wordt gekeken naar het orderbedrag om de waarde te bepalen. Via de orderdetailpagina kunt u hier zelf uitzonderingen op maken. Hoe wijzig ik het onderwerp of inhoud van de Track & Trace ? De PostNL Magento extensie stuurt uw klanten Track & Trace informatie. Dit kan handmatig worden gedaan in de zendingdetail pagina of met de Magento cron functionaliteit. Standaard zal de extensie hiervoor gebruik maken van de content in het Track & Trace e- mail sjabloon. Dit sjabloon is onderdeel van de extensie. U kunt de inhoud en/of het onderwerp naar wens aanpassen, volg hiervoor onderstaande stappen. 1. Log in op uw Magento backend en ga naar het menu System > Transactional s. 2. Kies rechts boven voor Add New Template. 3. Selecteer in de template dropdown PostNL Track & Trace en klik vervolgens op Load Template. 4. Vul in het veld Template Name een naam in. 5. Wijzig de content of het onderwerp naar wens en sla de pagina op. Als u het Magento Ordernummer wilt gebruiken in het onderwerp in plaats van het Magento zendingnummer vervang in het onderwerp dan {{var shipment.increment_id}} voor {{var order.increment_id}}. 55

56 Kan ik de Firecheckout gebruiken i.c.m. de PostNL Magento extensie? De PostNL Magento extensie biedt ondersteuning voor twee Magento checkouts: OneStepCheckout van Idev, onestepcheckout.com. OnePageCheckout, standaard onderdeel van Magento. De backend functionaliteiten en de PostNL Checkout zullen in de praktijk ook werken met andere checkouts. Voor de postcodecheck, PostNL Account login en bezorgopties bieden wij uitsluitend ondersteuning voor bovenstaande twee checkouts. Onlangs hebben de ontwikkelaars van de FireCheckout een artikel geschreven hoe u de postcodecheck en bezorgopties kunt aanbieden aan uw klanten in de FireCheckout. U kunt dit artikel hier vinden: Omdat deze patch niet in samenwerking met PostNL gemaakt is kunnen wij geen ondersteuning op de Firecheckout bieden. 56

57 Waarom krijg ik een 403 foutmelding in het debugmenu van mijn browser? Probleem: In het debugmenu van uw browser krijg u de onderstaande melding: POST Forbidden Oplossing/Toelichting: Dit probleem kan drie oorzaken hebben. 1. Een onderdeel van de PostNL Magento extensie is de PostNL Account login. Om deze te kunnen gebruiken dient u uw domein te whitelisten in uw PostNL Checkout account. In testmodus is dit onmogelijk omdat u op een algemeen PostNL Checkout account test. Als u in testmodus werkt zult u dus altijd deze melding zien. 2. Uw Webshop ID en/of Public Webshop ID is onjuist ingevoerd in uw PostNL Magento configuratie 3. In uw PostNL account zit een fout. Neem contact op met uw PostNL accountmanager als dit uw geval is. How do I install the PostNL Magento extension? Important information you should know: - You should always install the PostNL extension on a test environment first - Always back-up your webshop before starting the installation process - After installing the PostNL extension, the extension will provide test account credentials. These test credentials can be used to test the extension, without the need of a PostNL account. Technical requirements The PostNL Magento extension requires: - A minimum of PHP version Mcryp and SOAP PHP libraries - 256mb of memory - A working Magento cron Installing the extension: Step 1: Download - Navigate to (you will be directed to our developer s website): - Choose the correct version of the extension for your store (Enterprise or Community) - Choose 'Download' - Choose 'Ga naar afrekenen' 57

58 - Enter your information and choose 'Plaats uw bestelling' - You will now recieve a download link in the mail, use this link to download the extension Step 2: Preparation Log on to your Magento backend and deactivate the compiler if this is activated (System- >Tools->Compliation) Step 3: Extract & Upload Extract the downloaded files, log in to the FTP server and upload the folders app, lib and skin. When promted to merge or overwrite, always choose 'merge'. Step 4: Finishing In the Magento backend, refresh the caches. In order to see the configuration page, log out of the Magento backend and log back in. The PostNL extension is now installed, you can now proceed to configure the extension. Kan ik Brievenbuspakje & Brievenbuspakje Extra allebei gebruiken? De PostNL extensie biedt u twee PostNL brievenbus producten: 1. Brievenbuspakje (los label, u dient zelf nog te frankeren) 2. Brievenbuspakje extra (tracebare brievenbuszending. Komt op PostNL factuur) Als u ze beide wilt gebruiken dient u te zorgen dat ze beide aan staan. Om dit te doen gaat u naar Configuratie > Sales > Postnl > Bezorgopties daar zet u het vinkje aan bij Gebruik brievenbuspakjes. Dan dient u naar Geavanceerde instellingen > Gebruikersinstellingen > Verzend voorkeuren in deze lijst dient u zowel Brievenbuspakje als Brievenbuspakje extra te selecteren. Wij raden aan de variant die u het meest gaat gebruiken te als standaard in te stellen. Dit kunt u ook doen onder Geavanceerde instellingen > Gebruikersinstellingen > Standaard brievenbuspakje optie. Vervolgens kunt u het product dat u standaard niet gebruikt aanroepen door een zending aan te maken via het orderdetailscherm. In het gele vlak kiest u welk Brievenbuspakje gebruikt u gebruikt voor de zending. 58

59 Hoe installeer ik de patch voor SUPEE-6285 in de PostNL extensie en lager? Om de PostNL extensie correct te laten functioneren na de laatste Magento security patch (SUPEE-6285) raden we u aan te upgraden naar de meest recente versie van de plugin. Mocht u en dit raden wij niet aan- geen upgrade willen doen dan kunt u ervoor kiezen om aanpassingen te doen in de volgende bestanden: app/code/community/tig/postnl/controllers/adminhtml/configcontroller.php app/code/community/tig/postnl/controllers/adminhtml/extensioncontrolcontroller.php app/code/community/tig/postnl/controllers/adminhtml/shipmentcontroller.php Voeg in deze bestanden onderaan het bestand, voor de laatste '}' de volgende code toe: /** * Actions are always allowed as access validation is handled separately in each individual action. * bool */ protected function _isallowed() { return true; } Deze aanpassing is nodig, omdat Magento in deze laatste patch alle backend functionaliteiten heeft afgeschermd voor beheerders met beperkte rechten. Dit heeft Magento gedaan om de beveiliging te vergroten. De PostNL extensie heeft deze veiligheidsmaatregelen echter afgevangen op andere plekken in de code, waardoor de patch conflicteert. De genoemde aanpassing zorgt ervoor dat de PostNL extensie en de patch correct samenwerken en de hoogste veiligheidsstandaarden hanteren. Heeft u aan de hand van dit artikel nog vragen, neem dan s.v.p. contact op met de Servicedesk. 59

60 Waarom wordt aangemeld meerdere keren getoond? Het kan zijn dat u in uw orderoverzicht meerdere keren per order ziet dat deze is aangemeld, dat kan verschillende oorzaken hebben. Hieronder de twee meest voorkomende. U heeft de order een aantal keer aangemeld, dit is dan een handmatige actie geweest. Het kan zijn dat er een conflict is met een andere extensie die gebruik maakt van de order grid. Als dit het geval is komt het hoogstwaarschijnlijk doordat de extensie een left join gebruikt, maar niet een group by variable mee geeft. Daardoor toont hij het woord "voorgemeld" meerdere keren. U kan uw developer hiernaar laten kijken of anders contact opnemen met de Servicedesk. Mocht het voorkomen dat de bovenstaande punten niet het probleem veroorzaken dan kunt u altijd contact opnemen met de servicedesk. Hoe ga ik om met de leveringsdatum in de Gomage LightCheckout? De GoMage LightCheckout biedt u de mogelijkheid om een leveringsdatum te selecteren. Omdat de PostNL extensie ook deze mogelijkheid biedt adviseren wij de webshop zo te configureren dat voor een verzendmethode nooit op twee plekken een levermoment kan worden gekozen. Het is mogelijk om bijvoorbeeld de verzendmethode Afhalen gebruik te maken van de GoMage LightCheckout functionaltieit en voor de PostNL verzendmethode gebruik te maken van de Bezorgopties van PostNL. Waarom worden de adresinstellingen genegeerd in de GoMage LightCheckout? In de configuratie van de GoMage LightCheckout is het mogelijk de volgorde van de adresvelden aan te passen. Omdat een aangepaste volgorde een conflict zal opleveren met de PostNL extensie is er voor gekozen om deze instellingen te negeren als de PostNL extensie actief is. Hoe maak ik een API user aan? Om gebruik te maken van de PostNL extensie API, is het noodzakelijk om een Magento API user aan te maken. Deze user is niet gelijk aan een backend user, en dient ook op een aparte manier aangemaakt te worden. Het aanmaken van een API user werkt als volgt: 60

61 - Navigeer naar Systeem->'Web Services'->'SOAP/XML-RPC Roles'. Net zoals een backend gebruiker, dient een API user een rol toegekend te krijgen. Deze rol geeft aan tot welke acties de API user toegang heeft. Indien er geen rol beschikbaar is, is het zaak om deze rol eerst aan te maken. - Selecteer 'Add New Role'. Binnen dit menu dient een naam toegekend te worden aan de rol. Daarnaast dient het Admin wachtwoord ter verificatie ingevuld te worden. In het tabje 'Role Resources' kan aangegeven worden tot welke acties de users met deze rol toegang hebben. Sla, na het instellen van de rol, de rol op. 61

62 - Navigeer naar Systeem->'Web Services'->'SOAP/XML-RPC Users'. Na het aanmaken van een rol, dient er een user aangemaakt te worden, zodat er ingelogd kan worden in de Magento API. - Selecteer 'Add New User'. Binnen dit menu dient informatie ingevuld te worden over de user en het admin wachtwoord wederom ter verificatie ingevuld te worden. De API Key is in dit geval het wachtwoord wat gebruikt zal worden om in te loggen in de Magento API. Selecteer vervolgens onder 'User Role' de juiste rol voor deze user, en sla de user op. Hoe wijzig ik de afzender op labels en in de PostNL App? De afzender van een pakket is zichtbaar op een verzendlabel en in de PostNL App. U kunt de afzender wijzigen in uw Magento PostNL configuratie. 62

63 Ga hiervoor naar Systeem -> Configuratie -> Verkopen -> PostNL -> 2. Adresgegevens. Een achternaam is hier niet verplicht als u een bedrijfsnaam heeft ingevoerd. Hoe wijzig ik de afzender op labels en in de PostNL App? De afzender van een pakket is zichtbaar op een verzendlabel en in de PostNL App. U kunt de afzender wijzigen in uw Magento PostNL configuratie. Ga hiervoor naar Systeem -> Configuratie -> Verkopen -> PostNL -> 2. Adresgegevens. Een achternaam is hier niet verplicht als u een bedrijfsnaam heeft ingevoerd. Afterpay en PostNL, waar moet ik op letten? De Afterpay Magento extensie en de PostNL Magento extensie bieden beide de mogelijkheid om een betaaltoeslag aan uw klant door te rekenen. Binnen de PostNL extensie is dit mogelijk voor de betaalmethode Rembours. Als er twee extensie's binnen Magento betaaltoeslagen hanteren zal dat conflicteren en zal de betaaltoeslag niet correct gaan. Als u geen gebruik maakt van Rembours (of daar geen toeslag voor wilt hanteren) kunt u deze uitschakelen via de code zodat de Afterpay toeslag weer correct werkt. Neemt hiervoor onderstaande stappen. 1. Open /app/code/community/tig/postnl/etc/config.xml 2. In dit bestand staat meerdere keren het element postnl_cod_fee Dit kan er bijvoorbeeld als volgt uit zien: <postnl_cod_fee> <class>postnl_payment/quote_address_total_codfee</class> <before>tax,grand_total</before> <after>subtotal,discount,shipping</after> <renderer>postnl_payment/checkout_total_codfee</renderer> <admin_renderer>postnl_adminhtml/sales_order_create_totals_codfee</admin_renderer> </postnl_cod_fee> Deze regels komen meerdere keren voor in het bestand, dit moet u allemaal verwijderen. Wanneer u dit aangepast en opgeslagen heeft dan kunt u de betaaltoeslag van Afterpay weer naar wens gebruiken. 63

64 Momenteel is het nog niet mogelijk om een betaaltoeslag voor Afterpay en een betaaltoeslag voor Rembours te hanteren. Van welke database tabellen maakt de Magento plugin gebruik? De PostNL extensie maakt gebruik van een aantal database tabellen, om alle benodigde gegevens op te slaan. Hieronder is een overzicht, van welke tabellen er gebruikt worden en welke data hier in opgeslagen wordt. Deze uitleg is bedoeld voor merchants met een externe verzendpartij en richt zich daarom voornamelijk op de gegevens welke benodigd zijn, voor het versturen van pakketten. Vanaf versie 1.6 is PostNL functionaliteit toegevoegd aan de Magento API. tig_postnl_order Deze tabel bevat de additionele PostNL gegevens voor de bestelling: type Pakket type: - PA - Pakketautomaat. - PG - Pakjegemak. - PGE - Pakjegemak extra vroeg. - Avond - Avondbezorging. - Overdag - Standaard bezorging (kan ook buspakje zijn) product_code Wordt in uitzonderlijke gevallen gevuld voor interne logica, voor de echte productcode, dient gebruik gemaakt te worden van de kolom binnen "tig_postnl_shipment". is_pakje_gemak 0/1 flag of de order een pakjgemak bestelling is. is_pakketautomaat 0/1 flag of de order een pakketautomaat bestelling is. mobile_phone_number Wordt enkel gevuld indien "pakketautomaat bestelling" gekozen is. 64

65 confirm_date De dag waarop de bestelling voorgemeld en verstuurd dient te worden. Dit is 1 dag voor, de door de klant gekozen bezorgdag. delivery_date De dag waarop de bestelling wordt afgeleverd. Is gelijk aan, de door de klant gekozen bezorgdag. expected_delivery_time_start Begin tijd van de door de klant gekozen tijdvak, niet relevant voor verzending, wordt enkel opgeslagen voor het tonen van de tijdvak in de Magento backend. expected_delivery_time_end Eind tijd van de door de klant gekozen tijdvak, niet relevant voor verzending, wordt enkel opgeslagen voor het tonen van de tijdvak in de Magento backend. options Indien de klant gebruik heeft gemaakt van checkbox 'niet bij buren bezorgen', wordt deze kolom gevuld. tig_postnl_shipment Deze tabel bevat de additionele PostNL gegevens voor de verzending: confirmed_at Tijdstip waarop de zending is voorgemeld. main_barcode Hoofdbarcode voor de verzending. confirm_date Gelijk aan order tabel. delivery_date Gelijk aan order tabel. expected_delivery_time_start Gelijk aan order tabel. expected_delivery_time_end Gelijk aan order tabel. confirm_status "confirmed" wanneer de shipment voorgemeld is, "unconfirmed" wanneer dit nog niet het geval is. shipping_phase Huidige status van de verzending. 65

66 return_phase Wordt enkel gevuld wanneer de zending geretourneerd wordt. product_code Productcode, welke gebruikt is bij het voormelden van de zending. shipment_type Type van de verzending: - domestic (Binnenlandse zending) - domestic_cod (Binnenlandse rembours zending) - avond (Binnenlandse avondbezorging) - avond_cod (Binnenlandse avond rembours zending) - pg (Pakjegemak zending) - pg_cod (Pakjgemak rembours zending) - pge (Pakjegemak extra vroeg zending.) - pge_cod (Pakjegemak extra vroeg rembours zending) - pa (Pakketautomaat zending.) - pa_cod (Pakketautomaat rembours zending.) - eps (Zending naar een EPS land.) - globalpack (Wereldwijde zending.) - buspakje (Binnenlands brievenbuspakje zending.) is_pakje_gemak 0/1 flag welke aangeeft of de shipment een pakjegemak shipment is. is_pakketautomaat 0/1 flag welke aangeeft of de shipment een pakketautomaat zending is. globalpack_shipment_type Geeft aan welk type Globalpack shipment, de zending is. Wordt enkel gevuld in geval van een Globalpack zending. parcel_count Aantal pakketten binnen de zending. Standaard '1', tenzij de zending een multicolli zending betreft. extra_cover_amount Indien er is gekozen voor 'verhoogd aansprakelijk' verzenden, wordt hier het verzekerde bedrag ingevuld. labels_printed 0/1 flag welke aangeeft of de labels van de zending geprint zijn. return_labels_printed 0/1 flag welke aangeeft of de retour labels van de zending geprint zijn. is_parcelware_exported 0/1 flag welke aangeeft of de zending is geëxporteerd naar Parcelware. 66

67 track_and_trace_ _sent 0/1 flag welke aangeeft of de Track&Trace verstuurd is naar de klant. sales_flat_order Deze tabel bevat PostNL rembours gegevens: base_postnl_cod_fee Rembours toeslag, in de basis valuta van de winkel. base_postnl_cod_fee_invoiced Hoeveelheid rembours toeslag, welke invoiced is. base_postnl_cod_fee_refunded Hoeveelheid rembours toeslag, welke refunded is. base_postnl_cod_fee_tax Belasting berekend over de rembours toeslag. base_postnl_cod_fee_tax_invoiced Hoeveelheid invoiced belasting, welke berekend is over de rembours toeslag. base_postnl_cod_fee_tax_refunded Hoeveelheid refunded belasting, welke berkend is over de rembours toeslag. sales_flat_order_address De PostNL PakjeGemak adressen worden in deze tabel opgeslagen. Dit gebeurt op dezelfde wijze als het "order adres" en de velden worden op dezelfde wijze gevuld. De PostNL PakjeGemak adressen kunnen herkend worden aan de kolom "type", welke gevuld is met de waarde 'pakje_gemak', indien het een PakjeGemak adres betreft. sales_flat_shipment_comment De comment 'PostNL Track&Trace has been sent.' wordt toegevoegd aan een shipment wanneer de Track&Trace is verzonden. Waarom krijg ik in Magento een wit scherm bij een voormelding? In enkele situaties kan het voorkomen dat u een wit orderscherm krijgt als u een voormelding doet nadat u versie 1.7 van de PostNL Magento extensie heeft geïnstalleerd. Volg onderstaande stappen om dit probleem te verhelpen: 1. Open dit bestand: app/code/community/tig/postnl/model/core/shipment.php 2. Ga naar regel 2423 en zoek if ($this->getpostnlorder()->gettype() == 'Sunday') 3. Vervang dit door if ($this->getpostnlorder() && $this->getpostnlorder()->gettype() == 'Sunday') 67

68 4. Sla uw aanpassing op. Kan ik de PostNL extensie via Modman installeren? Jazeker, u kunt het modman bestand dat hiervoor nodig is in deze map vinden: /app/code/community/tig/postnl/docs/modman Waar kan ik de release notes van de Magento plugin vinden? Onderstaand kunt u de Release notes vinden van de PostNL Magento extensie. PostNL extensie v1.7.1 Verbeteringen - Wijze waarop EPS labels worden getoond. Bug fixes - Een probleem waarbij twee configuratie velden errors gaven bij een specifieke serverconfiguratie is opgelost - Een probleem waarbij Magento orders zonder PostNL orders niet konden worden verzonden is verholpen. PostNL extensie v1.7.0 Nieuwe features - Zondagbezorging ondersteuning Verbeteringen - Compatibel met de Picqer Magento extensie versie

69 - Track & Trace url generator code herschreven. - CIF services geüpdatet naar CIF Berekening bezorgdag verbeterd t.b.v. stabiliteit en snelheid. - Track & Trace url aangepast conform PostNL standaarden. - Compatibiliteit met de Magento Patch SUPEE Opslaan van de Bezorgopties in de Idev OneStepCheckout verbeterd Bug fixes - Probleem waardoor er geen Bezorgopties zichtbaar zijn bij configurabele producten. - LightCheckout die blijft laden na gekozen Bezorgoptie. - Correctie op tijdzone veroorzaakt onjuiste bezorgdagen en bezorgtijden. - Melding met cronjobs en melding dat een map niet leesbaar is opgelost. - Onnodige controle op Bezorgopties op actuele quote verwijderd. PostNL extensie v1.6.0 Nieuwe features - Verwijder mogelijkheid in de extensie opgenomen. - Ondersteuning voor de GoMage LightCheckout (Postcode validatie, bezorgopties & PostNL Account Login). - Ondersteuning voor de Magento SOAP v2 API. - Pakbonnen printen zonder label is mogelijk. Verbeteringen - Google Maps JS library bijgewerkt naar Fout afhandeling voor bepaalde CIF fouten. 69

70 - SOAP communicatie verloopt via native PHP SoapClient voor verbeterde ondersteuning van HHVM. - Een extra data installatiescript toegevoegd om overbodige updates te voorkomen. - Wijze waarop voorradigheid van artikelen werd gecontroleerd verbeterd. - Snelheid van pakbonnen printen in batch. - Malta is nu een EPS bestemming. - Ondersteuning voor SUPEE_ Verbeterde adres splitsing. - Verbeterde ondersteuning met betaalproviders (bijv. Sisow) waardoor pakbonnen printen altijd mogelijk is. Bug fixes - Wanneer bezorgdag keuze is uitgeschakeld wordt er geen verzenddatum meegezonden naar CIF. - Overbodig geworden CSS code verwijderd uit het base default theme. - Na het invoeren van een coupon is het invoeren van een mobielnummer in het geval dat er is gekozen voor een Pakketautomaat weer mogelijk in de OneStepCheckout. - Ongeldige variabele in upgradenotification block aangepast. - Een probleem veroorzaakt door het kiezen van een bezorgoptie maar deze niet opslaan met als gevolg geen bezorgoptie keuze zonder dag in de Magento zending in de OneStepCheckout is opgelost. - Probleem opgelost waarbij op de PostNL pakbon bij de producten 0% btw zichtbaar was. - Probleem opgelost waarbij de verzenddatum zichtbaar was op de PostNL pakbon terwijl de zichtbaar van de verzendmethode uit stond. - Javascript rembours probleem dat voorkwam als bezorgopties uitstonden is opgelost. - Diverse problemen gerelateerd aan de servertijd configuratie is opgelost. - Probleem opgelost waarbij de upgrade melding niet verdween. - Probleem opgelost met de tijdelijke cron update wanneer de config cache actief is. - Probleem opgelost met het heractiveren van een quote nadat een order is afgerond wat kon leiden tot missende PostNL informatie. 70

71 - Probleem opgelost waardoor orders een afleverdag hadden terwijl daar niet voor was gekozen. - Probleem opgelost met orders die niet via de PostNL verzendmethode waren geplaatst maar waarvan de verzendmethode pas achteraf aan de PostNL extensie is gekoppeld. Bekende problemen: - Bij configurable products kan het voorkomen dat de bezorgopties niet worden ingeladen. In dit geval kunt u deze stappen volgen: 1. Open app/code/community/tig/postnl/helper/deliveryoptions.php. 2. Zoek de functie _canshowdeliveryoptionsforstock.(r2546) 3. Voeg de code onderstaande code in de foreach toe: /** * Only check the stock for simple products */ if ($item->getproducttype()!= 'simple') { continue; } Ter verduidelijking: PostNL extensie v1.5.3 Bug fixes - Een probleem waarbij de bezorgdag soms onterecht wordt aangegeven als gelijk aan de verzenddag, is opgelost. - Een probleem waarbij de cut-off tijd niet altijd correct werd gebruikt is opgelost. PostNL extensie v