PostNL extensie voor Magento Installatie- en configuratiehandleiding
Documentinformatie en copyright Document: tig_postnl_installatiehandleiding.pdf Auteur: Berend Lantink Laatst gewijzigd op: 21-07-15 Copyright © 2015 PostNL / TIG B.V. Niets uit deze uitgave mag vermenigvuldigd of openbaar gemaakt worden zonder toestemming van PostNL.
Inleiding PostNL Magento extensie Installeer de PostNL Magento extensie en beschik direct over een volledige logistieke oplossing voor uw webshop. Verzendlabels afdrukken gebeurt in een simpele handeling vanuit uw backend waardoor er naast de extensie geen speciale software meer nodig is. Uw klanten ontvangen binnen 30 minuten compleet geautomatiseerd de Track & Trace informatie. Bovendien kunt u makkelijk via de PostNL Magento extensie onderstaande bezorgopties aanbieden in uw eigen checkout.
Dag -en tijdvakkeuze
Avondbezorging
Afhalen op een postkantoorlocatie
Extra vroeg afhalen
U kiest zelf hoe de bestelling verzonden wordt. Een rijk scala aan PostNL verzendproducten wordt aangeboden waaronder ook het brievenbuspakje. De recentste toevoeging is een retourfunctionaliteit waarmee uw klanten eenvoudig een bestelling retour kunnen sturen. Dit kan door het retourlabel direct mee te sturen met de bestelling , door het retourlabel in het account van de consument aan te bieden of door het retourlabel te versturen op aanvraag van de consument. Ook nieuw is maandagbezorging, neem contact op met PostNL om maandagbezorging in de PostNL Magento extensie te activeren. De extensie bevat zeer uiteenlopende functionaliteiten en wordt continu doorontwikkeld. Hieronder samengevat een overzicht:
Nieuw, een complete oplossing voor retouren.
Nieuw, maandagbezorging.
Verzendlabels afdrukken vanuit uw eigen webshop.
Track & Trace e-mails aanpassen en automatisch versturen.
Verzendstatus van zendingen en retouren volgen vanuit uw webshop.
Gratis postcodecheck en aanvulling in uw eigen checkout.
Verzend bestellingen als pakket naar de hele wereld of als brievenbuspakje binnen Nederland.
Avondbezorging, dag –en tijdvakkeuze en (extra vroeg) ophalen bij Postkantoorlocaties in je eigen checkout.
Een compleet overzicht van alle toevoegingen en verbeteringen kunt u vinden in de Release notes: http://kb.tig.nl/topic/38584893
2
Inhoudsopgave PostNL Magento extensie installeren PostNL Magento extensie configureren PostNL Magento extensie upgraden Veelgestelde vragen Technische gegevens Release notes
4 7 10 11 13 16
3
PostNL Magento extensie installeren Deze handleiding helpt PostNL klanten op weg om zo snel mogelijk PostNL zendingen te kunnen verwerken vanuit een Magento webshop. Voordat u aan de slag kunt gaan met de PostNL extensie, dient u eerst onderstaande stappen te doorlopen. Voor sommige stappen kan hulp van uw technische beheerder nodig zijn. Om gebruik te kunnen maken van de extensie heeft u een pakketten contract nodig. Een contract sluit u al af vanaf 100 pakketten per jaar. Naast een contract heeft u een PostNL account nodig. Alle benodigde gegevens kunt u aanvragen via deze link: http://www.postnl.nl/zakelijke-oplossingen/webwinkels/bezorgopties-voormijn-klanten Het duurt enkele dagen voordat u een e-mail ontvangt van PostNL met de benodigde gegevens voor het gebruik van deze extensie. Indien er aanvullende vragen zijn over uw aanmelding neemt PostNL telefonisch contact met u op. Aandachtspunten U dient de extensie eerst op een testomgeving te installeren. Maak altijd een back-up van uw webshop voor u de extensie installeert. De extensie bevindt zich na implementatie in testmodus met een standaard testaccount. U kunt direct beginnen met het testen van de extensie na de installatie en configuratie. Technische eisen De extensie heeft het volgende nodig voor een goede werking:
Minimaal PHP versie 5.3
Mcrypt en SOAP PHP libraries
256mb geheugen
Actieve Magento cron
U kunt over deze vereisten contact opnemen met uw hostingprovider of de technische beheerder van uw webshop. Wij beschrijven in deze handleiding de installatie via FTP. Mocht u de extensie via Magento Connect willen installeren dan kunt u deze link volgen: http://kb.tig.nl/topic/83644113 Stap 1 Download gratis de PostNL extensie via de TIG extensie store. 1.
Ga naar http://store.tig.nl/postnl.html.
2.
Kies de extensie die voor uw webshop van toepassing is.
3.
Klik op Download.
4.
Klik op Ga naar afrekenen.
5.
Vul uw gegevens in en klik op Plaats uw bestelling.
6.
U ontvangt een e-mail met een downloadlink voor de extensie.
7.
Download de extensie via de downloadlink.
4
Stap 2 Log in op uw Magento beheeromgeving. Stap 3 Controleer of de compiler uit staat via Systeem > Gereedschap > Compilatie. Zet de compiler uit wanneer deze ingeschakeld staat.
Let op: Wanneer de compiler toch aan staat, dan kan de installatie mislukken. Stap 4 Pak het tig_postnl-x.y.z_enterprise/community_edition.zip bestand uit die u bij stap 1 heeft gedownload. Pak vervolgens het tig_postnl-x.y.z_enterprise/community_edition.tgz bestand uit. Stap 5 Login op uw FTP server met uw favoriete FTP-browser. Upload de mappen app, lib en skin. Let op: Er worden geen bestanden overschreven. De mappen dienen samengevoegd te worden. Ga pas verder als alle bestanden zijn geüpload. Stap 6 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. Stap 7 Klik in de Magento beheeromgeving rechtsboven op Uitloggen en log vervolgens opnieuw in. Let op: Dit is belangrijk om verder te kunnen gaan met het installatieproces. Stap 8 Ga in de Magento backend naar Systeem > Configuratie en klik links in de navigatie onder het tabje Verkoop op PostNL.
5
De installatie is afgerond, de volgende stap is het configureren van de extensie.
6
PostNL Magento extensie configureren Om de PostNL extensie zo optimaal mogelijk in te richten voor uw webshop is het verstandig om de volledige configuratie te doorlopen alvorens u de PostNL extensie gaat gebruiken. In de handleiding beschrijven wij de aandachtspunten van de configuratie. De configuratie bestaat uit drie onderdelen: •
Wizard, hierin zijn de belangrijkste instellingen opgenomen;
•
Geavanceerde instellingen;
•
PostNL verzendmethode.
Wizard In de wizard configureert u de belangrijkste instellingen van de extensie. U treft hier de volgende onderdelen in aan:
Registratie extensie
Adresgegevens
Winkel instellingen
Bezorgopties
PostNL Account instellingen
Geavanceerde instellingen In de geavanceerde instellingen kunt u de extensie verder naar wens configureren.
Label, Pakbon & Gewichtinstellingen
De pakbonnen van de PostNL extensie zijn completer dan de standaard pakbonnen van Magento. U kunt onderdelen toevoegen, verwijderen en de locaties bepalen. Tevens kunt u ervoor kiezen het verzendlabel op de pakbon te printen.
Track &Trace
Om Track & Trace e-mails automatisch te versturen dient de Magento cron actief te zijn. Mocht u in uw Magento backend de melding krijgen dat uw cron niet lijkt te functioneren dan worden de Track & Trace emails niet automatisch verzonden. Om uw cron te activeren kunt u deze link volgen: http://kb.tig.nl/topic/31060037.
Retouren
Voor de retourfunctionaliteit is een antwoordnummer verplicht. Neem contact op met uw PostNL accountmanager voor meer informatie. Meer informatie over de retourfunctionaliteit kunt u op deze pagina vinden: http://kb.tig.nl/topic/85971587.
PostNL Rembours
Indien u de PostNL rembours betaalmethode wilt gebruiken dient u de velden in dit tabje in te vullen. Tevens dient u de Magento PostNL Rembours betaalmethode te activeren.
7
Deze kunt u vinden in het menu Systeem > Configuratie > Betalingsmethoden > PostNL Rembours.
Wereldwijd Verzenden
Het is erg belangrijk om deze instellingen te specificeren wanneer u zendingen buiten de EU stuurt. Wanneer u geen zendingen buiten de EU stuurt, kunt u dit tabje overslaan. Volg deze link als u geen land van herkomst heeft ingevoerd bij uw artikelen: http://kb.tig.nl/topic/93693013.
PostNL Checkout Instellingen & PostNL Checkout Betalinginstellingen
De PostNL Checkout is een methode naast uw eigen bestelproces waarmee uw klanten snel en gemakkelijk kunnen kiezen waar, wanneer en hoe ze een bestelling willen ontvangen. Mocht de MijnPakket knop waarmee uw klant naar de PostNL Checkout gaan grijs blijven dan kunt u deze link volgen: http://kb.tig.nl/topic/39102986.
Parcelware Instellingen
Indien u Parcelware (web of desktop) gebruikt kunt u een csv export maken die u kunt importeren in Parcelware. Informatie over de benodigde accountinformatie van Parcelware kunt u op deze link vinden: http://kb.tig.nl/topic/94906903. De PostNL Magento extensie vervangt Parcelware. In de meeste gevallen is deze functionaliteit niet van toepassing.
Gebruikersinstellingen
De PostNL extensie kan in uw Magento backend informatie over PostNL zendingen tonen. Tevens kunt u aangeven welke PostNL producten u wilt gebruiken met de extensie.
Technische instellingen
Pas deze instellingen niet zonder instructies van TIG of PostNL aan.
PostNL verzendmethode Om PostNL handelingen op een bestelling te kunnen uitvoeren dient een bestelling via de PostNL verzendmethode te worden geplaatst. Ga hiervoor naar Systeem > Configuratie > Verkoop > Versturing methode en activeer de PostNL verzendmethode. U kunt kiezen uit drie tariefbepalingen:
Plat
Tabel (Magento tabel tarieven of specifieke PostNL tabel tarieven)
Matrix tarieven, volg voor uitleg hierover deze link: http://kb.tig.nl/topic/102462196
De tarieven die u als merchant met PostNL heeft gesproken zijn niet opgenomen in de PostNL extensie. Per merchant kunnen de tarieven verschillen en u kunt aan de consument andere prijzen rekenen dan uw
8
PostNL tarieven.
9
PostNL Magento extensie upgraden Er worden regelmatig nieuwe versies van de PostNL Magento extensie gelanceerd met daarin meer functionaliteiten. Wij adviseren om de extensie te upgraden als er een nieuwe versie beschikbaar is. Schrijf u in op de TIG nieuwsbrief om op te hoogte te blijven van nieuwe releases, dat kan op http://www.tig.nl. Een upgrade dient altijd eerst op een testomgeving te worden uitgevoerd. Maak altijd een back-up van uw webshop voor u met de upgrade aan de slag gaat. U kunt voor het upgraden van de extensie de stappen uit het installatie hoofdstuk volgen. De configuratie instellingen blijven behouden.
10
Veelgestelde vragen Voor welke versies van Magento is de extensie geschikt? De extensie is geschikt voor:
Magento Community Edition versie 1.6, 1.7, 1.8 en 1.9.
Magento Enterprise Edition 1.11, 1.12, 1.13 en 1.14
Werkt de extensie in samenwerking met andere checkouts? Ja, de extensie werkt op OneStepCheckout (van Idev, www.onestepcheckout.com) versie 4.0.x en versie 4.1.x. en met de GoMage LightCheckout versie 5.8.
Waarom is er een cronjob op de server nodig? De extensie haakt in op de cron functionaliteit van Magento. Deze wordt geactiveerd door een ingestelde cronjob op de server. De extensie voert verschillende periodieke taken hiermee uit, zoals het bijwerken van de zendingsgeschiedenis, het versturen van de Track & Trace e-mails en het opschonen van de PostNL tabellen in de database. Mocht u na installatie een melding krijgen dat uw cron niet werkt, dan kunt u deze link volgen: http://kb.tig.nl/topic/31060037
Kan ik alles testen? Ja, met een uitzondering. De MijnPakket login kunt u niet in testmodus zien werken. Wij adviseren de MijnPakket login te testen met uw live account.
Bieden jullie een API? Ja, wij bieden een API. De documentatie kunt u hier vinden: https://kb.tig.nl/topic/95391157
Bieden jullie ondersteuning voor HHVM? Ja, sinds versie 1.6 bieden wij beperkte ondersteuning voor HHVM.
11
Hoe verwijder ik de PostNL extensie? Op onderstaande link leggen wij uit hoe u de PostNL extensie kunt verwijderen uit uw webshop. https://kb.tig.nl/topic/94842766
Verdere vragen of hulp nodig? Deze extensie is in opdracht van PostNL ontwikkeld door TIG. Voor technische vragen kunt u contact opnemen met TIG via http://kb.tig.nl/ticket/form/new
Kabelweg 37 1014BA Amsterdam http://www.tig.nl/contact
12
Technische gegevens 1. CSS bestanden
skin/adminhtml/default/default/css/TIG/PostNL/
skin/frontend/base/default/css/TIG/PostNL/
skin/frontend/rwd/default/css/TIG/PostNL/
skin/frontend/enterprise/default/css/TIG/PostNL/ (enkel enterprise editie)
2. Javascript
skin/adminhtml/default/default/js/TIG/PostNL/
skin/frontend/base/default/js/TIG/PostNL/
skin/frontend/enterprise/default/js/TIG/PostNL/ (enkel enterprise editie)
3. Afbeeldingen
skin/adminhtml/default/default/images/TIG/PostNL/
skin/frontend/base/default/images/TIG/PostNL/
skin/frontend/enterprise/default/images/TIG/PostNL/ (enkel enterprise editie)
4. Taalbestanden
app/locale/nl_NL/TIG_PostNL.csv
app/locale/en_US/TIG_PostNL.csv
5. E-mail templates
app/locale/nl_NL/template/email/TIG/PostNL/
app/locale/en_US/template/email/TIG/PostNL/
6. Gebruikte observers
Global sales_order_shipment_save_before sales_order_shipment_save_after order_cancel_after sales_order_place_after postnl_shipment_setshippingphase_delivered
Adminhtml adminhtml_block_html_before postnl_shipment_confirm_after controller_action_predispatch_adminhtml_sales_order_shipment_save controller_action_postdispatch_postnl_admin admin_system_config_changed_section_postnl admin_system_config_changed_section_carrier controller_action_layout_render_before_adminhtml_system_config_edit
13
Frontend core_block_abstract_to_html_before core_block_abstract_to_html_after controller_action_postdispatch_checkout_onepage_saveShippingMethod controller_action_predispatch_onestepcheckout_ajax_set_methods_separate controller_action_predispatch_gomage_checkout_onepage_ajax
7. Rewrites
Niet aanwezig.
8. Cronjobs (
: )
postnl_clean_temp_labels: */5 * * * *
postnl_clean_old_locks: 0 * * * *
postnl_get_missing_barcodes: */30 * * * *
postnl_update_shipping_status: 30 3,11,15 * * * (wordt aangepast tijdens extensie installatie)
postnl_update_return_status: 30 2,10,18 * * * (wordt aangepast tijdens extensie installatie)
postnl_expire_confirmation: 0 1,13 * * *
postnl_send_track_and_trace_email: */15 * * * *
postnl_update_statistics: 30 6,18 * * * (wordt aangepast tijdens extensie installatie)
postnl_update_notification_feed: 15 * * * *
postnl_remove_old_labels: 0 1,13 * * *
postnl_update_product_attribute: wordt bepaald tijdens extensie installatie – deze cron is slechts tijdelijk aanwezig tijdens het installeren en updaten van de extensie
postnl_update_date_time_zone: wordt bepaald tijdens extensie installatie – deze cron is slechts tijdelijk aanwezig tijdens het updaten van de extensie
postnl_update_config_settings: 0 0 * * 0
postnl_data_integrity_check: 0 5 * * *
9. Nieuwe tabellen
tig_postnl_order
tig_postnl_shipment
tig_postnl_shipment_label
tig_postnl_shipment_barcode
tig_postnl_shipment_status_history
tig_postnl_tablerate
tig_postnl_matrixrate
tig_postnl_integrity
10. Gewijzigde tabellen
sales_flat_order
sales_flat_invoice
sales_flat_quote
sales_flat_quote_address
sales_flat_creditmemo
14
15
Release notes Onderstaand vindt u onze Release notes van deze release. Op onze Knowledgebase kunt u de Release notes van alle releases vinden: http://kb.tig.nl/topic/38584893 1.6
Nieuwe features - Verwijder mogelijkheid in de extensie opgenomen. - Ondersteuning voor de GoMage LightCheckout (Postcode validatie, bezorgopties & MijnPakketLogin). - 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. - 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.
16
- Probleem opgelost met het heractiveren van een quote nadat een order is afgerond wat kon leiden tot missende PostNL informatie. - 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. 1.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.
1.5.2
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
17
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. - 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.
18
