--- title: Magento handleiding description: Dit is de installatiehandleiding voor onze plugin met Magento 2.x. Bij vragen kan je contact opnemen met onze klantenservice. Lees voor meer informatie. --- [Overslaan naar inhoud](https://support.shops-united.nl/koppelingen/magento-handleiding#main-content) Nederlands Submenu tonen voor vertalingen ![ShopsUnited\_logo\_WIT.svg\]](https://support.shops-united.nl/hubfs/ShopsUnited_logo_WIT.svg) Hoofdnavigatie openen Hoofdnavigatie sluiten - Nederlands Submenu tonen voor vertalingen - [Bekijk GRATIS verzendsysteem](https://shops-united.nl/hoe-werkt-het/) [Bekijk GRATIS verzendsysteem](https://shops-united.nl/hoe-werkt-het/) Waar kunnen we je mee helpen? - Er zijn geen suggesties want het zoekveld is leeg. 1. [Kennisbank](https://support.shops-united.nl/?hsLang=nl) 2. [Koppelingen](https://support.shops-united.nl/koppelingen?hsLang=nl) # Magento handleiding ![magento](https://support.shops-united.nl/hs-fs/hubfs/Imported%20images/magento.png?width=150&name=magento.png)Dit is de installatiehandleiding voor onze plugin met Magento 2.x. Bij vragen kan je altijd bellen of support aanvragen via een e-mail naar [ict@shops-united.nl](mailto:ict@shops-united.nl). Kijk voor de meest recente informatie met betrekking tot de Magento 2.x plugin in het verzendsysteem via het menu **Instellingen \> Koppelingen \> Magento**. Wij horen graag wat je bevindingen zijn met betrekking tot deze koppeling. Met je feedback maken wij de plugin steeds een stap beter. ### Snel naar: ⚙️ [Installeren plugin](https://support.shops-united.nl/koppelingen/magento-handleiding#installatie) ⚙️ [Gebruik van de module](https://support.shops-united.nl/koppelingen/magento-handleiding#gebruik) ⚙️ [Veelgestelde vragen](https://support.shops-united.nl/koppelingen/magento-handleiding#faq) ⚙️ [Technische updates](https://support.shops-united.nl/koppelingen/magento-handleiding#updates) ### Installeren De plugin kan je downloaden via het online verzendsysteem. **⚠️ Belangrijk! Zorg voor een (recente) back-up van je bestanden en database. Deze module is compatible met Magento versie 2.x.** Deze module ondersteunt de volgende checkout varianten: - **Standaard checkout** - **Onepage checkout** - **Firecheckout** **Stap 1** Ga naar het online verzendsysteem. Vul hier je e-mailadres en wachtwoord in en klik op **Inloggen**. **Stap 2** Ga naar de pagina **Instellingen** \> **Koppelingen** en klik vervolgens op **Magento**. Download het zip bestand **Magento 2.x module \[..\]** en pak het bestand uit. Als je dit niet kan vinden, stuur dan een e-mail naar [ict@shops-united.nl](mailto:ict@shops-united.nl). In het zipbestand staan de volgende bestanden: ``` Block/Adminhtml/form/field/Countries.php Block/Adminhtml/Order/View/Tab/Custom.php Block/Adminhtml/System/Config/Form/Field/Countriesmap.php Block/Adminhtml/System/Config/Form/Field/CustomRowOne.php Controller/Adminhtml/Order/CustomTab.php Controller/Adminhtml/Order/UpdateOrder.php Controller/Adminhtml/Shipment/Index.php Controller/Adminhtml/Shipment/Printlabel.php etc/adminhtml/di.xml etc/adminhtml/routes.xml etc/adminhtml/system.xml etc/config.xml etc/events.xml etc/frontend/di.xml etc/module Model/Carrier/Parcelpro.php Model/CustomConfigProvider.php Model/Parcelpro.php Model /Resource/Parcelpro/Collection.php Model /Resource/Parcelpro.php Model/System/Config/Source/Country.php Observer/Shipment.php Observer/Trackinfo.php Plugin/PluginBefore.php registration.php Setup/InstallSchema.php Setup/UpgradeSchema.php View/adminhtml/layout/adminhtml_system_config_edit.xml View/adminhtml/layout/sales_order_view.xml View/adminhtml/templates/order/view/tab/custom.phtml View/adminhtml/ui_component/sales_order_grid.xml View/adminhtml/web/css/parcelpro.css View/adminhtml/web/css/parcelpro.min.css View/Frontend/layout/checkout_cart_index.xml View/Frontend/layout/checkout_index_index.xml View/Frontend/layout/default.xml View/Frontend/layout/shipping_tracking_popup.xml View/Frontend/require-config.js View/Frontend/templates/tracking/popup.phtml View/Frontend/web/css/parcelpro.css View/Frontend/web/js/action/set-shipping-information.js View/Frontend/web/js/model/shipping-rates-validation-rules/ parcelpro_shipment.js View/Frontend/web/js /model/shipping-rates-validation-rules.js View/Frontend/web/js /model/shipping-rates-validator.js View/Frontend/web/js /model/shipping-save-processor/default.js View/Frontend/web/js /model/shipping-save-processor.js View/Frontend/web/js/view/billing-address/list.js View/Frontend/web/js/view/billing-address.js View/Frontend/web/ js /view/shipping-rates-validation.js View/Frontend/web/ js/view/shipping.js View/Frontend/web/template/onepage/2columns.html View/Frontend/web/template/onepage/3columns.html View/Frontend/web/template/onepage/shipping/methods.html View/Frontend/web/template/shipping.html ``` **Stap 3** **Bestanden op de FTP plaatsen** Kopieer deze bestanden naar de map **app/code/Parcelpro/Shipment** met behulp van een FTP programma, bijvoorbeeld het gratis te verkrijgen [FileZilla](https://filezilla-project.org/). Er worden geen files overschreven. **⚠️ Let op! Je moet zelf de map Shipment aanmaken.** ![magento-stap-3](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-3.png?width=278&name=magento-stap-3.png) **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. **Code:**'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 kan je vinden in de Magento documentatie: [http://devdocs.magento.com/guides/v2.0/install-gde/install/cli/install-clisubcommands-enable.html](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 doe je in de back-end van Magento bij **System** \> **Tools** \> **Cache Management**. Vink alle aankruisvakjes aan en refresh de cache via de opties linksboven. ![magento-stap-6](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-6.png?width=688&name=magento-stap-6.png) **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 Shops United is hierbij de nieuwe verzendmethode voor je Magento webwinkel. Voeg in dit scherm je **Gebruiker-ID** en **API key** toe. ### 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. ![magento-stap-7](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-7.png?width=688&name=magento-stap-7.png) Per verzendmethode kan er een tarief worden ingesteld. Voor de optie buitenland kan er per land een tariefregel worden ingesteld. Je hebt de optie om elke bestelling die via uw webshop binnenkomt direct door te laten schieten naar ons verzendsysteem. Als je hier geen gebruik van wilt maken kan je een bestelling of een reeks bestellingen handmatig via ons verzendsysteem aanmelden. Een bestelling handmatig aanmelden kan via de knop **Zending aanmelden** in het overzicht van de betreffende order. ![magento-stap-8](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-8.png?width=688&name=magento-stap-8.png) Op het moment dat de zending succesvol aangemeld is kan er via de knop **Print label** in ditzelfde menu direct een verzendlabel afgedrukt worden. ![magento-stap-9](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-9.png?width=688&name=magento-stap-9.png) Meerdere bestellingen tegelijk aanmelden kan in het bestellingen overzicht. Kies de gewenste bestellingen en selecteer linksboven in het dropdown menu **Zendingen aanmelden**. Het kan even duren om meerdere orders aan te melden, wees geduldig en vernieuw de pagina niet voordat er een melding verschijnt dat het aanmelden wel of niet is geslaagd. ![magento-stap-10](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-10.png?width=688&name=magento-stap-10.png) Als de zending verzonden wordt, kan de zending via de track en trace code gevolgd worden. Deze wordt per order in het overzicht opgeslagen.   ![magento-stap-11](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-11.png?width=415&name=magento-stap-11.png) Als je klikt op de link **Track Order**  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. ![magento-stap-12](https://support.shops-united.nl/hs-fs/hubfs/magento-stap-12.png?width=369&name=magento-stap-12.png) ### Veelgestelde vragen  **Kan je met een Magento shop ook de pakketpunten van DHL en/of PostNL tonen in de checkout?** Ja je kan in de Magento koppeling de optie DHL Parcelshop of PostNL Parcelshop instellen om alle punten te tonen. Zo kunnen klanten die bestellen zelf een afhaalpunt kiezen. **Een order doorzetten d.m.v. de knop lukt niet.** Controleer of de **ID** en **LoginID** gegevens juist zijn ingevuld in de configuratie van de plugin. Deze kan je terugvinden in het verzendsysteem via **Instellingen \> Koppelingen \> Magento**. **Welke vervoerders worden ondersteund?** De vervoerders [Brenger](https://support.shops-united.nl/vervoerders/brenger?hsLang=nl), [DHL](https://support.shops-united.nl/vervoerders/dhl?hsLang=nl), [Fedex Cross Border](https://support.shops-united.nl/vervoerders/fedex-cross-border?hsLang=nl), [PostNL](https://support.shops-united.nl/vervoerders/postnl?hsLang=nl) en [UPS](https://support.shops-united.nl/vervoerders/ups?hsLang=nl) worden ondersteund op basis van de geactiveerde contracten onder je 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. ### Technische updates #### Februari 2024: **In de check-out nu ook een realtime tijdsverwachting bij DHL verzendmethoden.** #### **December 2023:** **Een realtime tijdsverwachting bij PostNL verzendmethode in de check-out.** Op basis van de actuele aflevertijden van PostNL kan nu een tijdsverwachting in je Magento check-out zichtbaar gemaakt worden. Dit wordt berekend op basis van de dag van afgifte. Door middel van een dag-eind selectie kan je bepalen of dat op de dag dat de order wordt aangemaakt door klant nog gaat lukken (om af te geven bij PostNL), of dat het toch de volgende werkdag wordt. De eindtijd staat standaard om 12 u 's nachts ingesteld, maar deze tijdselectie kan je zelf aanpassen naar een eerder tijdstip, bijvoorbeeld 11 uur. ![magento\_nieuw](https://support.shops-united.nl/hs-fs/hubfs/magento_nieuw.png?width=688&height=673&name=magento_nieuw.png)     - [Account](https://support.shops-united.nl/account?hsLang=nl) - [Zendingen](https://support.shops-united.nl/zendingen?hsLang=nl) - [Financieel](https://support.shops-united.nl/financieel?hsLang=nl) - [Koppelingen](https://support.shops-united.nl/koppelingen?hsLang=nl) - [Vervoerders](https://support.shops-united.nl/vervoerders?hsLang=nl) - [Instellingen](https://support.shops-united.nl/instellingen?hsLang=nl) - [Verpakkingen webshop](https://support.shops-united.nl/verpakkingen-webshop?hsLang=nl) # Shops United Copyright © 2026, Shops United