FAQ PostNL Magento Plugin
Datum: 17-02-2016 Auteur: PostNL Versie: v1.1
1
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 1.1.0 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? .............................................................................................................................. 10 Wat zijn de testgegevens voor de Magento plugin? ....................................................................................................................... 11 Hoe kan ik adresregels in Magento opsplitsen? ............................................................................................................................. 12 Hoe kan ik gebruik maken van de PostNL bezorgopties in Magento? ............................................................................................ 16 Hoe kan ik gratis verzending aanbieden bij de verzendmethode PostNL? ..................................................................................... 16 Hoe bepaal je de startpositie van het label bij labels printen? ....................................................................................................... 18 Hoe print ik verzendlabels vanuit Google Chrome? ........................................................................................................................ 18 Waarom krijg ik een foutmelding tijdens installatie met Magento Connect? ................................................................................ 19 Hoe kan ik de plugin upgraden met Magento Connect? ................................................................................................................ 20 Hoe kan ik de plugin installeren met Magento Connect? ............................................................................................................... 21 Waarom zie ik op buitenlandse adressen geen verzendmethode? ................................................................................................ 23 Hoe verwijder/deïnstalleer ik de extensie? .................................................................................................................................... 23 Welke configuratiemogelijkheden zijn er voor brievenbuspakjes? ................................................................................................ 24 Hoe configureer ik de Parcelware export in de Magento plugin? .................................................................................................. 30 Welke methods kan ik gebruiken om PostNL bezorginformatie uit Magento op te halen? ........................................................... 30 Waarom worden verzendlabels onscherp of onvolledig afgedrukt op een Zebra a6 printer? ....................................................... 31 Hoe krijg ik huisnummer toevoeging bij handmatige bestellingen i.c.m. de postcode check? ...................................................... 32 Waarom zijn PostNL acties niet zichtbaar in het verzendingen overzicht? .................................................................................... 33 Werkt de Postcode.nl extensie i.c.m. de PostNL Magento extensie? ............................................................................................. 35 Hoe maak ik rollen aan in Magento? .............................................................................................................................................. 35 Welke configuratiemogelijkheden in Magento zijn er voor pakbonnen? ....................................................................................... 37 Hoe kan ik andere verzendmethodes afhandelen via de PostNL extensie? ................................................................................... 41 Hoe kan ik multi colli zendingen aanmaken? .................................................................................................................................. 41
2
Is de PostNL plugin responsive? ...................................................................................................................................................... 42 Hoe configureer ik matrix rates in de PostNL Magento Extensie? .................................................................................................. 43 Hoe pas ik in Magento een logo aan in de Track & Trace e-mail? .................................................................................................. 44 Hoe test ik de PostNL Checkout en Account login in de Magento plugin? ..................................................................................... 45 Waarom is extra vroeg ophalen niet zichtbaar als bezorgoptie? .................................................................................................... 45 Waarom is mijn voormeldstatus na enkele dagen verlopen? ......................................................................................................... 46 Kan de PostNL extensie overweg met configurable producten? .................................................................................................... 46 Hoe activeer ik rembours in de Magento plugin? ........................................................................................................................... 46 Waarom zijn mijn PostNL tarieven niet zichtbaar in de PostNL Magento extensie? ...................................................................... 46 Waarom wordt de PostNL Account knop niet ingeladen? .............................................................................................................. 48 Hoe kan ik PostNL layout handles opnemen in transactionele e-mails? ........................................................................................ 48 Hoe activeer ik retouren in de Magento extensie?......................................................................................................................... 49 Hoe verwijder ik de gescheiden adresregels melding in de Magento extensie? ............................................................................ 50 Hoe pas ik de PostNL label startpositie aan in de Magento extensie? ........................................................................................... 50 Waarom kan ik geen orders verwijderen als ik de PostNL Magento extensie gebruik? ................................................................. 52 Waarom zijn mijn PostNL bezorgopties Engels in een Nederlandse webshop? ............................................................................. 54 Hoe werk ik productattributen bij via een script? .......................................................................................................................... 54 Hoe werkt de PostNL verzendoptie Verhoogde Aansprakelijkheid in de Magento PostNL extensie? ............................................ 55 Hoe wijzig ik het onderwerp of inhoud van de Track & Trace e-mail? ........................................................................................... 55 Kan ik de Firecheckout gebruiken i.c.m. de PostNL Magento extensie?......................................................................................... 56 Waarom krijg ik een 403 foutmelding in het debugmenu van mijn browser? ............................................................................... 57 How do I install the PostNL Magento extension? ........................................................................................................................... 57 Kan ik Brievenbuspakje & Brievenbuspakje Extra allebei gebruiken? ............................................................................................ 58 Hoe installeer ik de patch voor SUPEE-6285 in de PostNL extensie 1.5.3 en lager? ....................................................................... 59 Waarom wordt aangemeld meerdere keren getoond? .................................................................................................................. 60 Hoe ga ik om met de leveringsdatum in de Gomage LightCheckout? ............................................................................................ 60 Waarom worden de adresinstellingen genegeerd in de GoMage LightCheckout? ......................................................................... 60 Hoe maak ik een API user aan? ....................................................................................................................................................... 60 Hoe wijzig ik de afzender op labels en in de PostNL App? .............................................................................................................. 62 Hoe wijzig ik de afzender op labels en in de PostNL App? .............................................................................................................. 63 Afterpay en PostNL, waar moet ik op letten? ................................................................................................................................. 63 Van welke database tabellen maakt de Magento plugin gebruik? ................................................................................................. 64 Waarom krijg ik in Magento 1.7.0 een wit scherm bij een voormelding? ...................................................................................... 67 Kan ik de PostNL extensie via Modman installeren? ...................................................................................................................... 68 Waar kan ik de release notes van de Magento plugin vinden? ...................................................................................................... 68 PostNL extensie v1.7.1 ........................................................................................................................................................ 68
3
PostNL extensie v1.7.0 ........................................................................................................................................................ 68 PostNL extensie v1.6.0 ........................................................................................................................................................ 69 PostNL extensie v1.5.3 ........................................................................................................................................................ 71 PostNL extensie v1.5.2 ........................................................................................................................................................ 71 PostNL extensie v1.5.1 ........................................................................................................................................................ 73 PostNL extensie v1.5.0 ........................................................................................................................................................ 73 PostNL extensie v1.4.1 ........................................................................................................................................................ 75 PostNL extensie v1.4.0 ........................................................................................................................................................ 76 PostNL extensie v1.3.1 ........................................................................................................................................................ 77 PostNL extensie v1.3.0 ........................................................................................................................................................ 77 PostNL extensie v1.2.2 ........................................................................................................................................................ 79 PostNL extensie v1.2.1 ........................................................................................................................................................ 79 PostNL extensie v1.2.0 ........................................................................................................................................................ 79 PostNL extensie v1.1.5 ........................................................................................................................................................ 80 PostNL extensie v1.1.4 ........................................................................................................................................................ 80 PostNL extensie v1.1.3 ........................................................................................................................................................ 81 PostNL extensie v1.1.2 ........................................................................................................................................................ 81 PostNL extensie v1.1.1 ........................................................................................................................................................ 81 PostNL extensie v1.1.0 ........................................................................................................................................................ 81 PostNL extensie v1.0.7 ........................................................................................................................................................ 82 PostNL extensie v1.0.6 ........................................................................................................................................................ 82 PostNL extensie v1.0.5 ........................................................................................................................................................ 82 PostNL extensie v1.0.4 ........................................................................................................................................................ 82 PostNL extensie v1.0.3 ........................................................................................................................................................ 82 PostNL extensie v1.0.2 ........................................................................................................................................................ 82 PostNL extensie v1.0.1 ........................................................................................................................................................ 83 PostNL extensie v1.0.0 ........................................................................................................................................................ 83 Hoe installeer ik de Magento extensie?.......................................................................................................................................... 83 Hoe configureer ik de Magento extensie? ...................................................................................................................................... 83 Waarom zijn mijn PostNL bezorgopties niet zichtbaar? ................................................................................................................. 83 Waarom krijg ik errors na installatie van de SUPEE-6788 patch? ................................................................................................... 84 Waarom krijg ik een wit scherm na installatie van versie 1.7.0 van de Magento extensie? ........................................................... 84 Waarom krijg ik na voormelding een wit scherm in versie 1.7.0 van de Magento extensie? ......................................................... 86
4
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
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
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 (http://checkout.postnl.nl) het domein zonder http of https is opgevoerd.
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%’? 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 1.1.0 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
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 e-mail. 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 www.<webshop>.nl/activatePostNL.php 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
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 e-mail heeft ontvangen van PostNL met de Webwinkel extern ID en Publiek Webshop ID. 1. Ga naar https://checkout.postnl.nl/Login 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
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: 11223344 Klantcode: TOTA Test gebruikersnaam: Dem0#Magnt01 Test wachtwoord: z9A4LpFd53Z BLS (locatie) code: 103861 Webwinkel ID: 853f9d2a4c5242f097daeaf61637609c Publiek Webshop ID: a98e0769d6bf40a8b49d85e7aff41d7a
11
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
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
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
PostNL thema OneStepCheckout
Neutraal thema Onepage Checkout
15
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
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 1.8.1.
17
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 1.5.1 en lager. Vanaf versie 1.5.2 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
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
Binnen Magento Connect is het ook mogelijk om een extensie key te gebruiken. Deze kunt u vinden op: http://www.magentocommerce.com/magento-connect/postnlmagento-extension.html Mocht u bij het installeren via de extensie key de melding "Connection Error try again later." krijgen dan dient u de "http://" 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
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
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
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 www..nl/deletePostNL.php 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
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
26
27
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
Dit artikel kan handig zijn om de attributen met de batchmethode in te stellen (let op! U wordt naar de pagina van TIG verwezen): http://servicedesk.tig.nl/hc/nl/articles/206493728 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
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
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: http://www.zebra.com/us/en/products-services/software/zebralink/zebra-setup-utility.html 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
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
-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: http://www.postnl.nl/Images/foutmeldingen_tcm10-75132.pdf . 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
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
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
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 E-mail: Nodig om handmatig een Track&Trace e-mail 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
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): http://servicedesk.tig.nl/hc/nl/articles/206493738
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
39
40
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
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
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: http://wiki.onestepcheckout.com/index.php?title=Customization_guide 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
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 e-mail? Het is mogelijk om het logo van de track&trace e-mail 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 e-mails geüpload worden. Dit logo zal gebruikt worden voor alle transactionele e-mails, waaronder dus ook de PostNL Track&Trace e-mail.
44
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: https://tpppmsandbox.e-id.nl/
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
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
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
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 'www.'. De website 'Https://www.voorbeeld.nl' 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 e-mails? 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 e-mails binnen Magento. Volg hiervoor onderstaande stappen: 1. Ga naar Systeem > Transactionele Emails. 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 e-mail template.
48
3. In het veld Inhoud sjabloon kunt u onderstaande variabelen opnemen:
{{layout handle="postnl_email_order_pakjegemak_address" order=$order}} Deze layout handle voegt het PakjeGemak adres toe indien van toepassing.
{{layout handle="postnl_email_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 e-mail templates. Als de e-mails 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/email/ 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 e-mail". Het retourlabel zal per e-mail 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
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: http://www.postnl.nl/Images/foutmeldingen_tcm10-75132.pdf. 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
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
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
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 http://watismijnip.nl/). 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: “” dit kunt u veranderen in: “” met deze aanpassing zal de melding verdwijnen. dataupgrade2.php (5 kB) dataupgrade5.php (5 kB) productattributes.php (3 kB) dataupgrade1.php (5 kB)
54
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 5.000 euro bij diefstal en vermissing. Op de PostNL website vindt u hier meer informatie over, zie: http://www.postnl.nl/zakelijkeoplossingen/webwinkels/oplossingen-voor-in-uw-webwinkel/verhoogde-aansprakelijkheid/ 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 e-mail? 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 email 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 Emails. 2. Kies rechts boven voor Add New Template. 3. Selecteer in de template dropdown PostNL Track & Trace e-mail 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
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: http://templates-master.com/knowledgebase/faq/tig-postnl/ Omdat deze patch niet in samenwerking met PostNL gemaakt is kunnen wij geen ondersteuning op de Firecheckout bieden.
56
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 https://tppwscheckout-sandbox.e-id.nl/Checkout2/Premium/ValidateLogin 403 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 5.3 - 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): http://store.tig.nl/postnl.html - Choose the correct version of the extension for your store (Enterprise or Community) - Choose 'Download' - Choose 'Ga naar afrekenen'
57
- 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
Hoe installeer ik de patch voor SUPEE-6285 in de PostNL extensie 1.5.3 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. * * @return 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
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
- 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
- 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
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>
postnl_payment/quote_address_total_codFee tax,grand_total subtotal,discount,shipping postnl_payment/checkout_total_codFee postnl_adminhtml/sales_order_create_totals_codFee 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
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
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
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
track_and_trace_email_sent 0/1 flag welke aangeeft of de Track&Trace e-mail 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 email has been sent.' wordt toegevoegd aan een shipment wanneer de Track&Trace e-mail is verzonden.
Waarom krijg ik in Magento 1.7.0 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
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 1.0.1.
68
- Track & Trace url generator code herschreven. - CIF services geüpdatet naar CIF 1.14. - Berekening bezorgdag verbeterd t.b.v. stabiliteit en snelheid. - Track & Trace url aangepast conform PostNL standaarden. - Compatibiliteit met de Magento Patch SUPEE-6788 - 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 3.19. - Fout afhandeling voor bepaalde CIF fouten.
69
- 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_6285 - 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
- 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 v1.5.2
71
Nieuwe features - Compatibiliteit met de Bpost Shipping Manager extensie. Deze extensie en de PostNL extensie kunnen nu probleemloos naast elkaar draaien in de webshop. Verbeteringen - De PostNL extensie schakelt nu automatisch de postcodecheck functionaliteit uit wanneer de Postcode.NL extensie geïnstalleerd is om conflicten te voorkomen. De merchant wordt hierover geïnformeerd in de backend. - Het onjuist verwijderen van orders, quotes en shipments uit de database wordt nu beter ondervangen door de PostNL extensie. - De verwachtte verzend- en bezorgdata worden nu ook opgeslagen voor bestellingen waarbij geen gebruik is gemaakt van de bezorgopties. Dit zorgt voor een duidelijker overzicht voor de merchant in het bestellingenoverzicht. - De PostNL extensie bepaalt nu op betere wijze of een product wel of niet op voorraad is bij het bepalen of PostNL bezorgopties beschikbaar dienen te zijn voor het product in kwestie. - Verbeterde foutafhandeling wanneer een brievenbuspakje zending wordt omgezet in een pakket en andersom. - Performance verbeteringen bij het omrekenen van tijdzones. - Additionele controles toegevoegd bij het voormelden van zendingen met extra dekking. - Dubbele vermelding van pakketautomaten in de bezorgopties verwijderd. - In de orderbevesting e-mail wordt nu duidelijker vermeld waar het pakket naartoe verzonden wordt wanneer de consument heeft gekozen voor ophalen op een postkantoor en de merchant de PostNL Handle gebruikt. - Het is nu duidelijker voor consument in Magento's OnePageCheckout dat er bij de verzendmethode stap gekozen kan worden voor ophalen op een postkantoor. - Het verzendadres wordt nu automatisch verborgen in de voortgangsbalk in Magento's OnePageCheckout wanneer de consument kiest voor ophalen op een postkantoor om onduidelijkheid over de bestemming van het pakket te voorkomen. Bug fixes - Onjuiste validatie op postkantoornamen gecorrigeerd. Dit kon er voor zorgen dat sommige postkantoor locaties met vreemde tekens in de naam onterecht geweigerd werden. - De controle op het gebruik van gesplitste adresregels in de backend werkt nu conform verwachtingen. - Een probleem waarbij in sommige gevallen de gekozen verzendoptie niet werd opgeslagen wanneer zendingen in bulk werden aangemaakt, is opgelost. - De voormelddatum wordt nu ook correct weergegeven voor bestellingen die na 11 uur 's avonds geplaatst zijn. - In het bestellingenoverzicht kan nu ook gefilterd worden op bestellingen waarbij er niet is gekozen voor een bezorgoptie. N.B. dit werkt enkel voor nieuwe bestellingen. - Verzendlabels worden nu in Google Chrome horizontaal weergegeven om problemen met het direct printen vanuit Google Chrome te verhelpen. - Een fout waarbij het 'extra dekking' veld wordt getoond bij het los aanmaken van een brievenbuspakje zending is opgelost. - Een probleem opgelost waarbij in sommige gevallen de besteldatum werd getoond als de bezorgdatum wanneer er niet was gekozen voor een bezorgdag in Idev's OneStepCheckout. - Een probleem opgelost waarbij de verzend- en bezorgdagen werden berekend aan de hand van de webshops tijdzone, in plaats van UTC. - Een 'notice'-fout in een configuratie-veld renderer is verholpen. - Er wordt niet langer een foutmelding getoond wanneer er op de zendingtype kolom gefilterd wordt in het bestellingenoverzicht.
72
- Een probleem opgelost waarbij Magento's Table Rates werden getoond voor PostNL. - Een probleem opgelost waarbij de default brievenbuspakje verzendoptie niet zichtbaar was in de configuratie. - Een mogelijke javascript foutmelding wanneer de PostNL bezorgopties niet konden worden ingeladen, is verholpen. - Punten zijn nu toegestaan in straatnaam velden. - Een klein layout probleem op beeldschermen met een lage resolutie is opgelost. - De configuratie is aangepast volgens de laatste security richtlijnen. - Een probleem waarbij PostNL bezorgopties niet beschikbaar zijn wanneer tweemaal hetzelfde configurabele product, met een ander simpel product besteld worden, is opgelost. - Een probleem opgelost waarbij enkele bepaalde bezorgopties beschikbaar waren wanneer de PostNL upgrade cron nog niet afgerond was.
PostNL extensie v1.5.1 Nieuwe functionaliteiten - Filteren op pakketautomaten in de bezorgopties pop-up.
Bug fixes - Afrekenen met de PostNL Checkout is weer mogelijk. - Ongeldige css link verwijderd voor het base/default theme. - Telefoonnummers zijn niet langer verplicht voor Postkantoorlocaties.
Verbeteringen - Verbeterde filtermogelijkheden voor de verzenddag kolommen in het bestellingen- en zendingenoverzicht. - Verbeterde weergave pakketautomaten in de bezorgopties pop-up. - Het afleveradres van de gekozen Postkantoorlocatie is zichtbaar in de bevestigingspop-up van Idev’s OneStepCheckout extensie. - Het splitsen van adressen is onmogelijk als er maar 1 adresregel is. - Bij gesplitste adresregels is het niet langer mogelijk om 1 adresregel te gebruiken voor meerdere waardes. Bekende problemen v1.5.1 - Onterechte 005 melding in de backend. U kunt deze melding negeren. - Sorteren op zendingtype in orderoverzicht kan fouten opleveren. - Bundle products i.c.m. Globalpack levert een foutmelding op. - In de bezorgopties werken Emté supermarkten en afhaallocaties met interpuncties niet correct. - Bij enkele serverconfiguraties kan het voorkomen dat de bezorgtijden in de backend niet overeenkomen met wat de klant heeft gekozen. Dit is in onderzoek.
PostNL extensie v1.5.0
73
Nieuwe functionaliteiten - Retourfunctionaliteit. - Het is nu mogelijk om het aantal collo van een zending aan te passen zolang deze nog niet voorgemeld is. - Het is nu mogelijk om de gekozen bezorgopties en de gekozen postkantoor-ophaallocatie te tonen in transactionele e-mails. - Het is nu mogelijk om via een massa-actie de verzend- en retourstatus van zendingen te updaten in het zendingenoverzicht.
Bug fixes - Track&Trace Postkantoorlocaties in backend werkt weer correct. - De PostNL massa-acties in het orderoverzicht beïnvloeden niet langer de massa-acties die door sommige andere extensies worden toegevoegd. - Postcode’s zijn niet langer verplicht om een Track & Trace URL op te bouwen. - Het is niet langer mogelijk om de voormelding van een brievenbuspakje zonder Track & Trace te wijzigen. - Een klein probleem in Magento CE 1.6 en Magento EE 1.11 is verholpen door niet langer gebruik te maken van de ‘DEFAULT_DEST_STREET’ constant waarde. - PostNL Account login en bezorgopties zij nu ook compatible met Idev’s OneStepCheckout wanneer het verzendadres formulier uitgeschakeld is. 14 - Brievenbuspakje configuratie opties werken nu correct voor ‘grouped products’. - De gekozen bezorgdag wordt niet langer getoond in de account pagina van de consument indien bezorgdagen uitgeschakeld zijn. - Afwijkende overkomstduur van producten wordt nu meegenomen in de berekening van de bezorgdagen van bestellingen waarbij niet voor een specifieke bezorgdatum is gekozen. - Dinsdag wordt niet langer getoond als valide bezorgdag wanneer maandag geen verzenddag is en het al na zaterdag is. Verbeteringen - Upgrade naar CIF 1.10. - Cut-off tijd is afhankelijk van de tijdzone in de webwinkel. - Verbeterde performance in de back-end. - Verminderd risico op extensie conflicten in de bestellingen- en zendingenoverzichten. - Het is nu mogelijk om labels te printen voor GlobalPack zendingen wanneer één of meerdere producten geen land van herkomst waarde hebben. - Het is nu mogelijk om per product een kortere overkomstduur in te stellen dan de standaard geconfigureerde overkomstduur. - Adresregels op de pakbon hebben nu een maximum lengte van 33 tekens. Regels van meer dan 33 tekens worden opgesplitst. - De gekozen postkantoorlocatie is nu ook zichtbaar op de sales/guest/form pagina. - De voormeld- en bezorgdata worden nu correct in de database opgeslagen in de UTC tijdzone. - De gekozen postkantoorlocatie wordt op de OnePage Checkout pagina nu ook getoond in
74
de voortgangsbalk. - Verscheidene cronjobs zijn beter verdeeld over de dag om de druk op de cron te verminderen. - BTW en kortingen worden nu correct meegenomen in de zending base grandtotal berekening. - De extensie toont nu een nette foutmelding wanneer de PHP versie van de server te laag is. - Decimaalwaardes zijn nu toegestaan voor de alternatieve standaard verzendoptie. - Verzendlabels van zendingen die bezorgd zijn worden nu na 30 dagen verwijderd uit de database om voldoende tijd achter te houden voor eventuele retourzendingen. Bekende problemen v1.5 - De PostNL Checkout werkt niet correct. Schakel deze functionaliteit uit. In recentere versies van de plugin is dit probleem verholpen.
PostNL extensie v1.4.1 Nieuwe functionaliteiten - Vernieuwde indeling van de PostNL configuratiepagina. Bug fixes - 'Alleen aan huisadres leveren' optie is niet meer beschikbaar wanneer de inhoud van het winkelmandje een brievenbuspakje betreft. - Probleem opgelost waarbij waarschuwingen ontstaan bij het opslaan van een PostNL order, wanneer geen bezorgopties zijn geselecteerd. - Probleem opgelost waarbij bezorgoptie toeslagen niet werden verwijderd, wanneer de bezorgopties niet meer beschikbaar waren tijdens de checkout. - Probleem opgelost rondom het gebruik van responsive ontwerp bij oudere versies van Magento. - Probleem opgelost in het bestellingenoverzicht, waardoor het niet mogelijk was te filteren op order ID. - Probleem opgelost voor EPS track&trace codes. Deze oude URL's gebruikten een oude format, welke niet meer ondersteund worden door PostNL. - Probleem opgelost voor PakjeGemak track&trace codes. Verbeteringen - 'Lever alleen aan huisadres' toeslag wordt niet meer getoond waneer de toeslag lager is dan 1 cent. - Wanneer de bezorgdagen uitgeschakeld zijn, wordt in plaats van bezorgdagen de tekst 'zo snel mogelijk' getoond. - Er is een extra orderstatus-update toegevoegd tussen 01:00 en 03:00 uur 's nachts. - Toevoeging van extra template parameters aan de Track&trace transactionele e-mail. Bekende problemen v.1.4.1: - Transactionele e-mail werkt niet altijd direct. Door het aanmaken van een nieuw sjabloon is dit opgelost. - Track&Trace url voor Postkantoorlocaties werkt niet correct vanuit het bestellingen en zendingen scherm. Gebruik hiervoor de Trac&Trace url in het zendingenoverzicht. - Enkele betaalproviderextensie's conflicteren met de PostNL pakbonnen.
75
PostNL extensie v1.4.0 Nieuwe functionaliteiten - Responsive design voor bezorgopties. - Mogelijkheid om verzenddagen als merchant te specificeren. - Mogelijkheid voor consumenten om aan te geven dat een pakket niet bij de buren mag worden afgeleverd. - Mogelijkheid toegevoegd om verzendkosten aan de hand van meerdere variabelen te configureren. - Mogelijkheid toegevoegd om pakbonnen te printen vanaf de zendingdetailpagina. - Het is nu mogelijk om een apart tarief te hanteren voor brievenbuspakje bestellingen. Bug fixes - Probleem opgelost in OneStepCheckout waarbij het toevoegen van coupon codes ertoe leidde dat de bezorgopties niet langer beschikbaar waren. - Probleem opgelost in OneStepCheckout waarbij de bezorgdag berekening niet correct verliep indien de consument geen bezorgdag gespecificeerd had - Probleem opgelost in de filter functionaliteit van het bestellingenoverzicht. - Probleem opgelost waarbij het kiezen van een extra dekking verzendoptie als standaard verzendoptie fouten veroorzaakte in het voormeldproces. - PostNL Checkout ziet producten niet langer als zijnde gewichtsloos indien een gratisverzending coupon actief is. - Probleem opgelost in de PostNL Checkout CMS pagina selectie dat foutmeldingen kon opleveren. - De BTW berekening van de PostNL rembourstoeslag houdt nu correct rekening met de instelling die bepaalt of de BTW rekening voor of na korting wordt gedaan. - Probleem opgelost waarbij sommige massa-acties niet beschikbaar waren indien bepaalde verzendopties niet beschikbaar waren. - PostNL rembours is nu correct beschikbaar voor reguliere bestellingen. - De print-verzendlabels massa-actie meldt zendingen niet meer automatisch voor. - Het gebruik van de postcodecheck functionaliteit zorgt niet langer voor foutmeldingen in multi-address checkout. - Virtuele bestellingen zorgen niet langer voor foutmeldingen. Verbeteringen - Performance verbeteringen door zware functionaliteiten aan te passen en sommige functionaliteiten te cachen. - PostNL Checkout houdt nu ook rekening met het feit dat bestellingen als brievenbuspakjes verzonden kunnen worden. - Het updaten van productattribuut waardes wordt nu via een tijdelijke cronjob gedaan om de server belasting tijdens het installeren van de extensie te verlichten. - Er wordt nu automatisch een comment bij de bestelling en zending geplaatst wanneer de PostNL Track & Trace e-mail verstuurd is. - Avondbezorging is niet langer beschikbaar voor brievenbuspakje bestellingen.
Bekende problemen in 1.4.0: - Track&Trace werkt niet voor alle landen. - Binnen de PostNL Checkout kunnen consumenten geen ander adres of PakjeGemak kiezen.
76
- Responsive werkt niet op oudere Magento versie's. - Labels voor brievenbuspakjes zijn niet compleet
PostNL extensie v1.3.1 Bugfixes - De verzenddatum wordt niet langer standaard in de toekomst getoond. - Additionele controles toegevoegd om fouten te voorkomen wanneer bestellingen of zendingen uit Magento verwijderd zijn. - BTW bedragen worden niet langer dubbel getoond op de afreken pagina. - Het is niet langer onmogelijk om multi-colli zendingen aan te maken wanneer de buspakje berekeningsmodus op automatisch staat. - Rembours toeslagbedragen zorgen niet langer in sommige gevallen voor foutmeldingen op de factuurpagina in de backend.
Bekende problemen in 1.3.1: - Witte configuratiepagina in Magento Community 1.6.0. 1.7.0. - Coupons OneStepCheckout i.c.m. Bezorgopties. - Sorteren bestellingen en zendingen grid op datum werkt niet correct. - Als PakjeGemak locatie alleen Almere zichtbaar. - Straatnaam en huisnummer niet zichtbaar in de OSC pop-up. -----------------------------------------------
PostNL extensie v1.3.0 Nieuwe functionaliteiten - Het is nu mogelijk om bestellingen te versturen als brievenbuspakjes. Brievenbuspakjes worden via de briefpost bezorgd en kunnen verzonden worden tegen een aantrekkelijk tarief. Het is mogelijk om zowel handmatig te bepalen of een bestelling als brievenbuspakje verzonden kan worden of de extensie dit automatisch te laten bepalen. - De 'rembours' betaalmethode is toegevoegd en volledig geïntegreerd in het bestel- en verzendproces. Voor de rembours betaalmethode kan een aparte toeslag in rekening gebracht worden. Ook kunnen rembours bestellingen automatisch gefactureerd worden, nadat de bestelling is bezorgd. - Het is nu mogelijk om voor zendingen een pakbon af te drukken. Op deze pakbon staat ook direct het PostNL verzendlabel afgedrukt, waardoor de pakbon ook als verzendlabel gebruikt kan worden. - Het is nu mogelijk om de beschikbare bezorgopties op productniveau te beheren.
77
- Het is nu mogelijk om een pakketzending om te zetten naar een brievenbuspakje en andersom, mits de zending naar een Nederlands huisadres verstuurd wordt en nog niet verzonden is. - Het is nu mogelijk om de gekozen verzendoptie te wijzigen nadat de zending aangemaakt is. - Het is nu mogelijk om in de extensie aan te geven welke Magento verzendmethodes voor PostNL gebruikt worden. - Het is nu mogelijk om direct vanuit het bestellingenoverzicht een bestelling te verzenden, voor te melden en de verzendlabels af te drukken. Kleine wijziging - Het is nu mogelijk om in de bezorgopties de bezorgdagen en tijdvakken los van elkaar te activeren of deactiveren. - Het is nu mogelijk om de cut-off tijd voor bestellingen per 5 minuten op te geven. Voorheen kon dit enkel per uur. - Het is nu mogelijk om direct vanuit het bestellingenoverzicht inzicht te krijgen in de verzenddatum, voormeldstatus en verzendstatus van bestellingen. - Op de bestelling- en zendingdetailpagina is nu informatie te vinden met betrekking tot de gekozen bezorgopties. - Aan de configuratiepagina van de extensie is een knop toegevoegd om alle PostNL log bestanden direct te downloaden. - De interface voor het aanmaken van zendingen via massa-actie in het bestellingenoverzicht is gewijzigd. Er worden nu enkel de beschikbare verzendopties getoond voor geselecteerde bestellingen. - Foutmeldingen die optreden bij het verwerken van meerdere bestellingen of zendingen, zorgen er niet langer voor dat het hele proces stopt. in plaats daarvan zal het proces verder gaan voor de overige bestellingen of zendingen. Achteraf wordt er een gedetailleerde foutmelding getoond voor de bestellingen of zendingen die niet verwerkt konden worden. - De voor- en achternaam velden zijn niet langer verplicht bij de afzenderadresinstellingen. Het is nu verplicht om de bedrijfsnaam of achternaam velden in te vullen. - Spaties zijn nu toegestaan in postcodes. Bug fix - Het verwijderen van orders zou niet langer moeten resulteren in foutmeldingen in de extensie. - De PostNL verzendmethode wordt niet langer automatisch geselecteerd wanneer een consument aankomt bij de 'verzendmethode' stap van het bestelproces. - Griekenland wordt nu gezien als EPS land.
78
- Upgrade- en installatiescripts zorgen niet langer voor foutmeldingen wanneer meerdere gebruikers tegelijk een upgrade- of installatiescript aanroepen. - De verzendkosten in de 'voortgangsbalk' op de Onepage Checkout pagina worden nu correct aangepast met de eventuele toeslag voor het gebruik van bepaalde bezorgopties. - Het aanmaken van zendingen waarvoor geen standaard verzendoptie geconfigureerd is, zal niet langer zorgen voor foutmeldingen.
PostNL extensie v1.2.2 Nieuwe functionaliteiten: - Added the option to send a copy of the Track & Trace e-mail to a specified e-mail address. Kleine wijzigingen: - Performance of the entire extension has been improved. The extension will now attempt to cache several configuration values. - Label printing will now always follow the 'label size' configuration setting. Bug fixes - Fixed several small html errors in the Track & Trace e-mail template. - Fixed an SQL error that could occur when filtering the 'store' column in the order and shipment grids.
PostNL extensie v1.2.1 Nieuwe functionaliteiten: - The extension now fully supports Magento CE 1.9 and EE 1.14! Kleine wijzigingen: - Added additional checks to prevent errors when Magento's layout has been altered or PostNL's layout has not been uploaded properly. - Added additional compatibility enhancements for MultiSafePay and other PSP extensions. - Improved several minor texts and translations. Bug fixes - Fixed an issue that prevented PostNL Account login data from being cached. - Fixed an issue where using PostNL-only features on non-PostNL shipments would cause an error. - Fixed an issue where PostNL's feed messages would be loaded in the wrong order. - Fixed an issue where several notifications would be added to Magento when installing an unsupported version of Magento with the PostNL extension. - Fixed an issue with EPS comb-labels. EPS combi-labels were rotated by 90 degrees, causing overlapping issues with other labels being printed.
PostNL extensie v1.2.0
79
Nieuwe functionaliteiten - Added delivery options to the checkout flow. Customers can now choose where, when and how they want their order shipped when choosing their preferred shipping method. - Added support for evening delivery, early pickup locations and parcel dispenser locations. - Added Dutch postcode validation support. - Added the option to create a parcelware export csv file directly from the Magento backend. - Added a PostNL Account login feature. Customers who have a PostNL account can use this feature to automatically fill in their preferred billing and shipping address. Kleine wijzigingen - Refactored the label printing functionality. Shipping labels will now be opened in a separate window from where they may be printed or downloaded. - Added the option to select where on an A4 page the shipping labels will start printing. This allows you to re-use partially used sticker-sheets. - Added many new customization options for the shipment grid in the Magento backend. - Added the ability to view and edit a chosen post office delivery address from the Magento backend. - Added the option to only show the PostNL Checkout feature to customers who have a PostNL account. - Refactored many sections of the source code to improve readability and extensibility. - Moved several configuration settings. - Merged the 'test/live mode' settings of PostNL Checkout and Label Printing & Confirming functionality. There is now a single option to set the entire extension to test or live mode. - Added the option to upload separate csv files for the PostNL shipping method in 'table rate' configuration. Bugfixes - Fixed an issue where it was not possible to choose to only manually send Track & Trace information. - Fixed several typos and translation errors.
PostNL extensie v1.1.5 Bugfixes: - Validatieknop fix. Het valideren van live gegevens was in 1.1.3 niet mogelijk. - Beveiligingsverbetering
PostNL extensie v1.1.4 Nieuwe functionaliteiten: - Standaard testmogelijkheid toegevoegd. De extensie bevindt zich nu standaard in de testmodus na installatie. - De mogelijkheid om verzendlabels te verwijderen is toegevoegd. Dit biedt de mogelijkheid om het verzendlabel te wijzigen nadat hij is geprint. Het label dient te worden verwijderd en opnieuw te worden aangemaakt hiervoor. - De mogelijkheid om een zending opnieuw aan te maken, dus opnieuw een vezendlabel te printen en de zending voor te melden, zonder een nieuwe order aan te moeten maken.
80
Kleine wijzigingen: - De mogelijkheid om testgegevens te valideren is toegevoegd. - EPS mogelijkheden zijn aangepast. Indien u vragen heeft over het gebruik van een EPS product kunt u contact opnemen met de servicedesk. - De testmogelijkeid is standaard beschikbaar, voorheen was dit een configuratiewaarde in de geavanceerde instellingen. - Wanneer een voormelding is verlopen zal de Track & Trace barcode link verdwijnen. - Verbeterde teksten en vertalingen. Bugfixes: - Een probleem waarbij de PostNL verzendmethode instellingen niet werden gebruikt als de Magento table rates verzendmethode niet actief was is opgelost. - Een probleem waarmee het filteren in het order en zendingenscherm in een foutmelding resulteerde is opgelost. - Een probleem waarbij de cron stopte zodra deze tegen een fout aanliep is opgelost. Nu maakt hij de taak af en worden de overige zendingen bijgewerkt. - Een probleem waarbij je een zending niet kon voormelden is opgelost. - Een probleem verholpen waarbij het niet mogelijk was om een zending voor te melden zonder een barcode door process blocking wanneer developer mode actief is. - Een probleem verholpen waardoor het niet mogelijk was in Safari labels te printen (output was een html bestand).
PostNL extensie v1.1.3 - Probleem opgelost in de activatie procedure van de extensie.
PostNL extensie v1.1.2 - Handleiding geüpdatet.
PostNL extensie v1.1.1 - Probleem opgelost waarbij foutmeldingen konden ontstaan wanneer het zendingenoverzicht op de eerste kolom gefilterd werd. De Magento Connect manager controleert niet langer of bepaalde PHP extensies geïnstalleerd zijn wanneer de PostNL extensie geïnstalleerd wordt. Deze controle gaat niet altijd goed waardoor Magento Connect in sommige gevallen de installatie tegenhoudt ondanks dat de server aan alle vereisten voldoet.
PostNL extensie v1.1.0 - First public release - Manual changed
81
PostNL extensie v1.0.7 - Improved configuration fields. - Improved translations.
PostNL extensie v1.0.6 - Improved shipment grid interface. It shoulod now be more clear which shipments have been confirmed and when they should be handed over to PostNL. - Improved PostNL Checkout payment method handling. The Checkout summary page should now remember your chosen bank when you attempt to pay using iDEAL. 100% support for all payment methods is not guaranteed.
PostNL extensie v1.0.5 - Several bug fixes. - Improved configuration interface.
PostNL extensie v1.0.4 - Several minor bug fixes. - Improved Dutch translations. - Added additional information to several fields in system/config.
PostNL extensie v1.0.3 - Several bug fixes. Including an issue preventing the extension from functioning properly with the compiler active. - Several improvements to the Dutch translations. - Improved the extension's system > config interface - Added the Klarna payment method to PostNL Checkout
PostNL extensie v1.0.2 - A large number of bug fixes and general improvements - Improved error handling. Almost all errors will now automatically provide you with a link where you can find more information and a possible solution.
82
PostNL extensie v1.0.1 - Added a filter to the possible product options you may select, based on the selected orders when mass-creating shipments from the order grid. - Improved several translations. - Fixed several minor bugs.
PostNL extensie v1.0.0 - This is the initial beta release of the extension. If you have any questions, please contact the servicedesk
Hoe installeer ik de Magento extensie? Onderstaand kunt u de installatiehandleiding downloaden van de PostNL Magento extensie. tig_postnl_installatiehandleiding.pdf (500 kB)
Hoe configureer ik de Magento extensie? Hieronder kunt u de gebruikershandleiding downloaden van de PostNL Magento extensie. tig_postnl_gebruikershandleiding.pdf (900 kB)
Waarom zijn mijn PostNL bezorgopties niet zichtbaar? Probleem: Mijn PostNL bezorgopties zijn niet zichtbaar. Oplossing: Er kunnen meerdere oorzaken zijn waarom uw PostNL bezorgopties niet zichtbaar zijn. Controleer onderstaande punten om de oorzaak hiervan te vinden.
83
1. De communicatie met PostNL mislukt. In de praktijk komt dit vaak door verkeerd ingevoerde gegevens.
Let erop dat u met uw eigen gegevens alleen in live modus kunt werken. 2. Bezorgopties inschakelen Ga naar Systeem -> Configuration -> Sales -> PostNL. Open de vierde stap en activeer de PostNL bezorgopties. 3. PostNL productattributen Ga naar Catalog -> Manage Products -> open een product -> PostNL. Controleer of alle PostNL productattributen op Ja staan. Als de PostNL productattributen niet op Ja staan ziet u boven in uw webshop een PostNL0198 foutmelding. Klik hier voor informatie over deze foutmelding. 4. Product voorraad Ga naar Catalog -> Manage Products -> open een product -> Inventory. Controleer of het veld Stock Availability op "In Stock" staat. U kunt indien wenselijk in de PostNL configuratie aangeven dat de bezorgopties ook zichtbaar zijn als dit veld op "Out of Stock staat". Neem contact op met de servicedesk als hiermee het probleem niet heeft kunnen oplossen.
Waarom krijg ik errors na installatie van de SUPEE-6788 patch? In de recent uitgebrachte SUPEE-6788 patch is een standaard functionaliteit binnen Magento, waar veel extensies gebruik van maken, aangepast en veiliger gemaakt. Dit heeft tot gevolg dat een groot deel van de Magento extensies (deels) onbruikbaar worden, waaronder ook de PostNL extensie. Ondanks dat de PostNL extensie onbruikbaar zal zijn adviseren wij wel om de Magento security patch SUPEE-6788 te installeren. Wij bieden vanaf versie 1.7 ondersteuning op de SUPEE-6788 Magento patch.
Waarom krijg ik een wit scherm na installatie van versie 1.7.0 van de Magento extensie? In enkele situaties kan het voorkomen dat u een wit PostNL configuratie scherm krijgt binnen uw webshop na het installeren van versie 1.7.0. Volg onderstaande stappen om dit probleem te verhelpen: 1. Open deze twee bestanden: /app/code/comuniy/TIG/PostNL/block/Adminhtml/System/Systeem/Form/field/PostcodeNlE xtensionActive.php
84
/app/code/comuniy/TIG/PostNL/block/Adminhtml/System/Systeem/Form/field/GoMageDeli veryDateConflicts.php 2. Zoek op regel 47 protected function _getValue() 3. Vervang protected function _getValue() naar protected function _getValue(Varien_Data_Form_Element_Abstract $element) 4. Sla uw aanpassingen op.
85
Waarom krijg ik na voormelding een wit scherm in versie 1.7.0 van de Magento extensie? In enkele situaties kan het voorkomen dat u een wit orderscherm krijgt binnen uw webshop na het installeren van versie 1.7.0. Volg onderstaande stappen om dit probleem te verhelpen: 1. Open dit bestand: /app/code/community/TIG/PostNL/Model/Core/Shipment.php 2. Zoek op regel 2423 if ($this->getPostnlOrder()->getType() == 'Sunday') 3. Vervang dit door if ($this->getPostnlOrder() && $this->getPostnlOrder()->getType() == 'Sunday') 4. Zoek op regel 1874 $storeId = $postnlOrder->getStoreId(); 5. Vervang dit door $storeId = $this->getStoreId(); 6. Sla uw aanpassing op.
86
