Installatiehandleiding 2.x
Voorwoord Hierbij de installatiehandleiding voor onze plugin met Magento 2.x. Bij vragen kunt u support aanvragen via een e-mail naar ict@parcelpro.nl of bellen naar 085 273 2780. Kijk voor de meest recente informatie met betrekking tot de Magento 2.x plugin in het verzendsysteem onder het menu item Koppelingen. Wij horen graag wat uw bevindingen zijn met betrekking tot deze koppeling. Met uw feedback maken wij de plugin steeds een stap beter. Snelle link naar Installeren 3 Gebruik van de module 7 FAQ 11 Pagina 2 van 11
Installeren De plugin kunt u downloaden via het online verzendsysteem. Belangrijk! Zorg voor een (recente) back-up van uw bestanden en database. Deze module is compatible met Magento versie 2.x. Deze module ondersteund enkel de standaard checkout die in Magento 2.x zit. Stap 1: Ga naar het online verzendsysteem. Vul hier uw e-mailadres en wachtwoord in en klik op [Inloggen]. Stap 2: Ga naar de pagina Koppelingen en klik vervolgens op Magento. Download het zip bestand Magento 2.x module [..]' en pak het bestand uit. Als u dit niet kunt vinden, stuur dan een e-mail naar ict@parcelpro.nl. In het zipbestand staat de map ParcelPro met daarin de volgende bestanden: Shipment/Block/Adminhtml/form/field/Countries.php Shipment/Block/Adminhtml/System/Config/Form/Field/Countriesmap.php Shipment/Controller/Adminhtml/Shipment/Index.php Shipment/etc/adminhtml/di.xml Shipment/etc/adminhtml/routes.xml Shipment/etc/adminhtml/system.xml Shipment/etc/config.xml Shipment/etc/events.xml Shipment/etc/frontend/di.xml Shipment/etc/module Shipment/Model/Carrier/Parcelpro.php Shipment/Model/CustomConfigProvider.php Shipment/Model/Parcelpro.php Shipment/Model /Resource/Parcelpro/CollecDon.php Shipment/Model /Resource/Parcelpro.php Shipment/Model/System/Config/Source/Country.php Shipment/Observer/Shipment.php Shipment/Observer/Trackinfo.php Pagina 3 van 11
Shipment/Plugin/PluginBefore.php Shipment/registraDon.php Shipment/Setup/InstallSchema.php Shipment/View/Adminhtml/ui_compone nt/sales_order_grid.xml Shipment/View/Frontend/layout/checkout_cart_index.xml Shipment/View/Frontend/layout/checkout_index_index.xml Shipment/View/Frontend/layout/default.xml Shipment/View/Frontend/layout/shipping_tracking_popup.xml Shipment/View/Frontend/require-config.js Shipment/View/Frontend/templates/tracking/popup.phtml Shipment/View/Frontend/web/css/parcelpro.css Shipment/View/Frontend/web/js/acDon/set-shipping-informaDon.js Shipment/View/Frontend/web/js/model/shipping-rates-validaDon-rules/ parcelpro_shipment.js Shipment/View/Frontend/web/js /model/shipping-rates-validadon-rules.js Shipment/View/Frontend/web/js /model/shipping-rates-validator.js Shipment/View/Frontend/web/js /model/shipping-save-processor/default.js Shipment/View/Frontend/web/js /model/shipping-save-processor.js Shipment/View/Frontend/web/ js/model/parcelpro-modal.js Shipment/View/Frontend/web/ js/model/parcelpro.js Shipment/View/Frontend/web/ js /view/shipping-rates-validadon.js Shipment/View/Frontend/web/ js/view/shipping.js Shipment/View/Frontend/web/template/shipping.html Stap 3: Bestanden op de FTP plaatsen Kopieer de map ParcelPro naar de map app > code met behulp van een FTP programma, bijvoorbeeld het gratis te verkrijgen FileZilla. Er worden geen files overschreven. Pagina 4 van 11
Stap 4: Voeg onze module toe aan de config Voeg onderstaand stukje code toe aan de config.php. Deze staat in de map app > etc. Zorg er voor dat onderstaande regel voor ), wordt toegevoegd. 'Parcelpro_Shipment' => 1, Stap 5: Voer de setup script uit Voer via de command-line de volgende commando uit: php bin/magento setup:upgrade. Hiervoor dien je in de root van de Magento installatie te zijn om de commando succesvol te kunnen uitvoeren. Meer informatie hierover kun u vinden in de Magento documentatie: http://devdocs.magento.com/guides/v2.0/install-gde/install/cli/install-clisubcommands-enable.html. Stap 6: Vernieuw de cache (optioneel) Voor een goede werking raden wij een vernieuwing van de cache aan. Dit doet u in de back-end van Magento bij System > Tools > Cache Management. Vink alle aankruisvakjes aan en refresh de cache via de opties linksboven. Pagina 5 van 11
Stap 7: De module configureren De module is geïnstalleerd onder Stores > Settings > Configuration. Op deze configuratie pagina is de module te vinden onder het menu Sales > Shipping Methods. Versturen via Parcel Pro is hierbij de nieuwe verzendmethode voor uw Magento webwinkel. Voeg in dit scherm uw gebruiker id en API key toe. Pagina 6 van 11
Gebruik van de module De module kan gevonden worden onder Stores > Settings > Configuration. Op deze configuratie pagina is de module te vinden onder het menu Sales > Shipping Methods en het tabje Versturen via parcelpro.nl'.' De module heeft een Gebruiker id en 'API key nodig om succesvol te werken. Per verzendmethode kan er een tarief worden ingesteld. Voor de optie buitenland kan er per land een tariefregel worden ingesteld. U heeft de optie om elke bestelling die via uw webshop binnenkomt direct door te laten schieten naar ons verzendsysteem. Als u hiervan geen gebruik wilt maken kunt u een bestelling of een reeks bestellingen handmatig via ons verzendsysteem aanmelden. Pagina 7 van 11
Een bestelling handmatig aanmelden kan via de knop Zending aanmelden in het overzicht van de betreffende order. Op het moment dat de zending succesvol aangemeld is kan er via de knop Print label in ditzelfde menu direct een verzendlabel afgedrukt worden. Pagina 8 van 11
Meerdere bestellingen tegelijk aanmelden kan in het bestellingen overzicht. Kies de gewenste bestellingen en selecteer linksboven in het dropdown menu voor Zendingen aanmelden'. Het kan even duren om meerdere orders aan te melden, wees geduldig en vernieuw de pagina niet voordat u een melding krijgt dat het aanmelden wel of niet geslaagd is. Pagina 9 van 11
Als de zending verzonden wordt, kan de zending via de track en trace code gevolgd worden. Deze wordt per order in het overzicht opgeslagen. Als u op de link Track Order klikt wordt het volgende scherm geopend. De track en trace code leid je naar de pagina van de betreffende vervoerder waar de zending tot in detail gevolgd kan worden. Pagina 10 van 11
FAQ Een order doorzetten d.m.v. de knop lukt niet. Controleer of uw ID en LoginID gegevens juist zijn in de configuratie van de plugin. Deze kunt u terugvinden in het verzendsysteem via Koppelingen > Magento. Welke vervoerders worden ondersteund? De vervoerders DHL, DPD, Fietskoeriers.nl, PostNL, UPS en Van Straaten Post worden ondersteund op basis van de geactiveerde contracten onder uw account in het verzendsysteem. De track & trace knop laat een lege pagina zien. Voor de beste werking raden wij aan gebruik te maken van de verzendmethoden uit onze plugin. Op die manier kan een consument een gekoppelde verzendmethode kiezen. Bij het doorzetten van de data kan het verzendsysteem een bijhorend verzendtype bepalen en direct de benodigde track & trace gegevens terugkoppelen. Indien dat niet het geval is, zal het op basis van de standaard ingestelde verzendmethode in het verzendsysteem gaan. Indien er niet gebruik gemaakt wordt van onze verzendmethoden in de plugin, worden alle zendingen op basis van de standaard verzendtype in ons verzendsysteem ingeboekt. Dit kan dus betekenen dat er een foute track & trace code teruggekoppeld wordt naar Magento 2.x. In dit geval is het handig om de checkbox Voeg tracking toe aan order uit te zetten. Een zending bevat verkeerde gegevens of een verkeerd verzendtype. Dit moet handmatig in ons verzendsysteem veranderd worden. Het is vooralsnog niet mogelijk om na een bestelling met gekozen verzendtype van de consument - in Magento 2.x een wijziging aan te brengen aan het verzendtype, of een order opnieuw door te zetten. Pagina 11 van 11