docs: add prestashop v2 installation instructions (#105)

src/nl/documentatie/11.prestashop-v1.10.md

@@ -0,0 +1,221 @@
+---
+title: PrestaShop
+---
+
+<Stack class="grid-flow-col auto-cols-max gap-1">
+    <GitHubShield repo="myparcelnl/prestashop" />
+    <GitHubShield repo="myparcelnl/prestashop" link="issues" />
+    <GitHubShield repo="myparcelnl/prestashop" link="pulls" />
+</Stack>
+
+## Introductie
+
+Deze plugin werkt met PrestaShop 1.7+.
+
+### Features
+
+- [Delivery options] integrated in your checkout
+- Export your PrestaShop orders to MyParcel with a simple click, single orders or in batch
+- Print shipping labels directly (PDF)
+- Create multiple shipments for the same order
+- Choose your package type (Parcel, digital stamp, mailbox package)
+- Define default MyParcel shipping options (signature, only recipient, insurance, etc.)
+- Modify the MyParcel shipping options per order before exporting
+- View the status of the shipment in the order details page
+
+## Installatie
+
+You can download the .zip file of the latest release below:
+
+<GitHubShield repo="myparcelnl/prestashop" />
+
+Om gebruik te maken van de module heb je een MyParcel-account nodig. Je kunt je registreren op [MyParcel.nl] voor een Nederlands account en op [sendmyparcel.be] voor een Belgisch account.
+
+1. Verwijder de oude module als je hiervan gebruik hebt gemaakt
+2. Download het .zip-bestand van de [laatste versie] van de plugin. (Let op dat
+   je de juiste versie downloadt)
+3. Open je Prestashop admin en ga naar `Modules > Manager`
+4. Klik op `Upload` en upload het .zip-bestand
+5. Klik op `Configure` om de plugin te configureren
+
+Je kunt de module vinden onder `Verzending > MyParcel`.
+
+## Configuratie
+
+### Algemene instellingen
+
+<MPImg src="/documentation/prestashop/v1/prestashop-general-settings.jpg" alt="PrestaShop general settings" />
+
+#### Deel mailadres klant
+
+Deel het mailadres van je klant met MyParcel om Track en trace te kunnen versturen vanuit MyParcel.
+
+#### Deel telefoonnummer klant
+
+Deel het telefoonnummer van je klant met MyParcel.
+
+#### Gebruik tweede adresveld als huisnummer
+
+Deze instelling zal er voor zorgen dat adresveld 2 als huisnummer wordt genomen bij het aanmaken van een zending.
+
+### Order opties
+
+<MPImg src="/documentation/prestashop/prestashop-order-options.jpg" alt="PrestaShop order options" />
+
+#### Automatische orderstatus
+
+Stel in welke status je orders krijgen na exporteren, scannen bij PostNL en wanneer de zending is afgeleverd.
+
+#### Negeer orderstatussen
+
+Hier kun je orderstatussen selecteren die genegeerd moeten worden bij `Automatische orderstatus`.
+
+#### Order status mail
+
+Wanneer er een notificatie moet worden verstuurd op het moment van veranderen van de orderstatus.
+
+#### Moment van notificatie versturen
+
+Kies er voor om de notificatie te versturen na het scannen van het label bij PostNL of na het downloaden van het label.
+
+#### Moment van notificatie versturen
+
+Kies er voor om de notificatie te versturen na het scannen van het label bij PostNL of na het downloaden van het label.
+
+#### Notificatie versturen bij digitale postzegels
+
+Als je een notificatie wilt verzenden op het moment van downloaden van een digitale postzegel, kies je hier voor 'Ja'.
+
+### Customs instellingen
+
+Ga naar `Catalogus > Producten > -product-` om de gegevens die nodig zijn voor de customs declaration in te stellen. Om een zending te kunnen zult een gewicht en een HS-code moeten instellen. Ook is een land van herkomst nodig.
+
+<MPImg src="/documentation/prestashop/prestashop-customs-settings.jpg" alt="PrestaShop custom settings" />
+
+Kies voor 'Verzending' om een gewicht in te stellen. Klik daarna op 'Modules' en kies voor `MyParcel > Customs` om in te stellen welke HS code voor dit product moet worden gebruikt en geef aan wat het land van herkomst is. Wanneer hier niets is ingevuld, kun je bij de instellingen van de module `Modules > Module Manager > MyParcelNL/MyParcelBE > Configureren > Customs Options`standaard waarden instellen.
+
+#### Default customs form
+
+Je kunt bij het product zelf kiezen om dit product op het customs formulier te tonen of juist over te slaan. Ga naar `Catalogus > Producten > -product- > Modules > MyParcel > Customs` om dit in te stellen per product.
+
+#### Default customs code
+
+Hier vul je een HS-code in die wordt gebruikt wanneer er geen HS-code is ingevuld bij het product. Ga naar `Catalogus > Producten > -product- > Modules > MyParcel > Customs` om dit in te stellen per product.
+
+#### Default customs origin
+
+Geef hier aan welk land van herkomst er moet worden gebruikt als er geen land is ingevuld bij het product. Ga naar `Catalogus > Producten > -product- > Modules > MyParcel > Customs` om dit in te stellen per product.
+
+#### Default customs age check
+
+Wanneer er standaard op leeftijd moet worden gecontroleerd, kies je hier voor "Ja". Ga naar `Catalogus > Producten > -product- > Modules > MyParcel > Customs` om dit in te stellen per product.
+
+### Vervoerders opties
+
+Bij installatie van de plugin wordt automatisch de vervoerder PostNL (in België bpost, dpd en PostNL) aangemaakt. Het is ook mogelijk om andere en reeds aangemaakte vervoerders te koppelen, waardoor de MyParcel bezorgopties en acties beschikbaar worden voor orders met deze vervoerder. Dit doe je vanuit de Carrier options tab in de plugin. Klik hier op het plusteken (+) om een vervoerder te koppelen aan MyParcel. In het scherm wat hierop volgt, kun je via "Select PS carrier" een bestaande vervoerder kiezen of via carrier name een nieuwe vervoerder aanmaken. In de plugin staat de 'Carrier option' standaard op PostNL. Nadat de vervoerder gekoppeld is, kun je voor deze vervoerder bezorgopties configureren en kun je voor orders gedaan met deze vervoerder (met terugwerkende kracht) labels printen in het orderoverzicht.
+
+<MPImg src="/documentation/prestashop/prestashop-carrier-settings.jpg" alt="PrestaShop carrier settings" />
+
+#### Checkout delivery form
+
+Stel hier de titel van de bezorgopties in. Dit zal boven de bezorgopties worden getoond in de checkout. Geef hier ook aan op welke dagen je de pakketten bij PostNL inlevert en welke cut-off tijd je hiervoor aanhoudt. De bezorgopties zullen aan de hand van deze gegevens worden getoond.
+
+Geef ook aan welke dagen afwijken van de standaard drop off days, bijvoorbeeld bij feestdagen of vakanties.
+
+Met **_Delivery days window_** optie kun je aangeven tot hoever in de toekomst jouw klanten een leverdag kunnen kiezen. Wanneer je kiest voor "Hide days" worden er geen dagen getoond in de checkout.
+
+Bij **_Drop off delay_** geef je aan hoeveel dagen er nodig zijn tot een pakket kan worden verstuurd. Bijvoorbeeld wanneer je het product nog moet maken op het moment van bestellen.
+
+Bij de verschillende bezorgopties is het mogelijk een toeslag in te stellen. Deze zal worden getoond in de checkout en worden doorberekend aan jouw klant.
+
+#### Delivery
+
+Stel hier in welk pakkettype er standaard moet worden gebruikt, wanneer er geen pakkettype is ingevuld bij het product. Om dit bij het product in te stellen, ga je naar `Catalogus > Producten > -product- > Modules > MyParcel > Delivery` en stel je de juiste waarden voor dat product in. Je kunt er hier ook voor kiezen om alle zendingen een bezorgoptie mee te geven.
+
+::: note
+Let op: Dit kan alleen voor pakketten binnen Nederland!
+:::
+
+#### Returns
+
+Stel hier in welk pakkettype er standaard moet worden gebruikt voor retourzendingen.
+
+### API instellingen
+
+<MPImg src="/documentation/prestashop/prestashop-api-settings.jpg" alt="PrestaShop api settings" />
+
+#### Jouw API key
+
+Om de module te gebruiken moet je een API key uit je MyParcel-account invullen. Als je ingelogd bent in jouw MyParcel account, kun je deze vinden bij het `Shopinstellingen > Integratie`. Het kan zijn dat je de API key nog niet ziet en deze eerst nog moet genereren. Klik dan op `Genereer API-key` en kopieer de API-key.
+
+#### API logging
+
+Zet dit aan als je problemen ervaart met de module. Support kan hiermee de communicatie tussen de API bekijken.
+
+### Label instellingen
+
+<MPImg src="/documentation/prestashop/prestashop-label-settings.jpg" alt="PrestaShop label settings" />
+
+#### Eigen kenmerk label
+
+Geef hier aan wat je als eigen kenmerk wilt tonen op je label. Je kunt hier ook kiezen voor een ordernummer of referentie door hier een variabele in te vullen. De beschikbare variabelen zijn:
+
+- `{order.id}`
+- `{order.reference}`
+
+#### Label formaat
+
+Hier geef je aan of je het label op een standaard (A4) of op een labelprinter (A6) wilt printen.
+
+#### Standaard label positie
+
+Hier geef je aan op welke plek je het label standaard wilt hebben, wanneer je kiest voor het A4-labelformaat.
+
+#### Label openen of alleen downloaden
+
+Kies hier of het label gelijk moet worden geopend na downloaden.
+
+#### Vraag om startpositie bij printen
+
+Met deze optie kan je verder gaan met printen waar je de laatste keer was gebleven. Hierdoor kun je alle stickers op het A4-vel gebruiken.
+
+## Gebruik van de plugin
+
+### Aanmaken van labels
+
+Het aanmaken van labels kan op verschillende manieren. Je kunt dit doen vanuit het bestellingenoverzicht zoals te zien is op onderstaand filmpje. Op deze manier maak je gemakkelijk meerdere labels tegelijk aan.
+
+<figure class="video_container">
+    <video controls="true" allowfullscreen="true">
+        <source src="/documentation/prestashop/prestashop-create-label-bulk.mp4" type="video/mp4">
+    </video>
+</figure>
+
+Ook kun je het pakkettype per zending vanuit het bestellingoverzicht wijzigen. Dit doe je door op 'Aanmaken' te klikken bij de bestelling en een ander pakkettype te kiezen en op te slaan. In het filmpje wordt getoond hoe je dit doet.
+
+<figure class="video_container">
+    <video controls="true" allowfullscreen="true">
+        <source src="/documentation/prestashop/prestashop-create-label-get-label.mp4" type="video/mp4">
+    </video>
+</figure>
+
+Ook wanneer je een bestelling opent, kun je labels aanmaken. Hoe je dit doet, zie je in onderstaand filmpje.
+
+<figure class="video_container">
+    <video controls="true" allowfullscreen="true">
+        <source src="/documentation/prestashop/prestashop-create-label-orderdetails.mp4" type="video/mp4">
+    </video>
+</figure>
+
+## FAQ
+
+### Er zijn geen MyParcel acties beschikbaar in het orderoverzicht. Wat moet ik doen?
+
+Het kan zijn dat je geen gebruik wil maken van de vervoerder die standaard door de plugin wordt aangemaakt, of dat je oude orders hebt die je wil verwerken met een andere vervoerder. Voor deze vervoerders zijn de MyParcel acties in het order overzicht niet standaard zichtbaar, daarvoor moet de vervoerder eerst gekoppeld worden. Volg hiervoor de stappen die beschreven staan onder vervoerders koppelen. Mocht je vervoerder al gekoppeld zijn, maar je ziet nog steeds geen bezorgopties, probeer dan een nieuwe vervoerder aan te maken en die te koppelen. Als je dan nog steeds geen MyParcel acties ziet, kun je contact opnemen met [[email protected]]
+
+[Delivery options]: https://github.com/myparcelnl/delivery-options
+[laatste versie]: https://github.com/myparcelnl/prestashop/releases/latest
+[myparcel.nl]: https://myparcel.nl
+[sendmyparcel.be]: https://sendmyparcel.be
+[source code]: https://github.com/myparcelnl/prestashop
+[[email protected]]: mailto:[email protected]