From 9f7712b4ad004e0fff5fc96550d98564499ceda5 Mon Sep 17 00:00:00 2001
From: Richard Perdaan <richard@myparcel.nl>
Date: Fri, 17 Mar 2023 09:59:32 +0100
Subject: [PATCH] docs(shopify): add instruction movies (#49)

* docs: add shopify instruction movies

* docs(shopify): update manual

---------

Co-authored-by: Edie Lemoine <edie@myparcel.nl>
---
 src/nl/documentatie/14.shopify.md | 243 ++++++++++++++++++------------
 1 file changed, 149 insertions(+), 94 deletions(-)

diff --git a/src/nl/documentatie/14.shopify.md b/src/nl/documentatie/14.shopify.md
index dac81f035..c383db94c 100644
--- a/src/nl/documentatie/14.shopify.md
+++ b/src/nl/documentatie/14.shopify.md
@@ -1,14 +1,18 @@
 # Shopify
 
+[MyParcel NL app voor Shopify](https://apps.shopify.com/myparcel-nl-1?search_id=928e7ca5-0757-4db5-be59-2c2680f57f87&surface_detail=myparcel&surface_inter_position=1&surface_intra_position=3&surface_type=search)
+
+[MyParcel BE app voor Shopify](https://apps.shopify.com/myparcel-nl-1?search_id=928e7ca5-0757-4db5-be59-2c2680f57f87&surface_detail=myparcel&surface_inter_position=1&surface_intra_position=3&surface_type=search)
+
 ## Introductie
 
 Met onze Shopify plugin kun je vijf soorten MyParcel zendingen aanmaken:
 
-* Pakketten binnen Nederland (huisadres en ophaallocaties PostNL)
-* Pakketten binnen de EU en buiten de EU
-* Brievenbuspakje
-* Digitale Postzegel
-* Ongefrankeerd label
+- Pakketten binnen Nederland (huisadres en ophaallocaties PostNL)
+- Pakketten binnen de EU en buiten de EU
+- Brievenbuspakje
+- Digitale Postzegel
+- Ongefrankeerd label
 
 ::: tip
 Plugins van derden die we ondersteunen:
@@ -33,10 +37,18 @@ Om de MyParcel-plugin te installeren, volg je de volgende stappen:
 - Typ 'MyParcel' in de zoekbalk en klik op enter.
 - Klik op de app 'MyParcel NL' en vervolgens op Add app.
 
+<Stack class="flex">
+    <iframe 
+        class="rounded-xl"
+        width="560" 
+        height="315" 
+        src="https://www.youtube.com/embed/xr8nR8pxd8g" 
+        title="Shopify MyParcel: Installatie" allowfullscreen />
+</Stack>
+
 ### Bijwerken bestaande installatie
 
-De app wordt bij wijzigingen automatisch bijgewerkt, je hebt hier zelf geen
-onderhoud aan.
+De app wordt bij wijzigingen automatisch bijgewerkt, je hebt hier zelf geen onderhoud aan.
 
 ## Configuratie
 
@@ -46,36 +58,24 @@ onderhoud aan.
 
 #### Standaard paginakeuze
 
-Hier geef je aan of je het label op een standaard (A4) of op een labelprinter (
-A6) wilt printen.
+Hier geef je aan of je het label op een standaard (A4) of op een labelprinter (A6) wilt printen.
 
 #### Beschrijving op label
 
-Met deze optie kun je een beschrijving toevoegen aan de zending. Dit zal worden
-afgedrukt op de linkerbovenhoek van het label en kun je gebruiken om de zending
-in het MyParcel zendingenoverzicht op te zoeken. Gebruik `{order_name}` om de
-titel van de order of `{order_number}` om het ordernummer te vermelden.
+Met deze optie kun je een beschrijving toevoegen aan de zending. Dit zal worden afgedrukt op de linkerbovenhoek van het label en kun je gebruiken om de zending in het MyParcel zendingenoverzicht op te zoeken. Gebruik `{order_name}` om de titel van de order of `{order_number}` om het ordernummer te vermelden.
 
 <MPImg src="/documentation/shopify/shopify-label-description.jpg" alt="Shopify label description" />
 
 #### Fulfillment
 
-Je hebt de mogelijkheid om jouw orders automatisch de status 'Fulfilled' te
-geven, wanneer PostNL jouw zending heeft gescand. Wil je dit liever handmatig
-doen? Selecteer dan de optie Manueel. Ga naar Bestellingen, selecteer de
-gewenste orders en klik bovenaan het orderoverzicht op Bestellingen vervullen om
-deze status te veranderen.
+Je hebt de mogelijkheid om jouw orders automatisch de status 'Fulfilled' te geven, wanneer PostNL jouw zending heeft gescand. Wil je dit liever handmatig doen? Selecteer dan de optie Manueel. Ga naar Bestellingen, selecteer de gewenste orders en klik bovenaan het orderoverzicht op Bestellingen vervullen om deze status te veranderen.
 
 ### Account
 
 #### API key
 
-Het belangrijkste van de koppeling is de API key. Deze kan je in
-jouw [MyParcel backoffice] terugvinden. Klik links onderin
-op `Shop instellingen > Selecteer de gewenste shop > Algemeen > API instellingen`
-.
-Wanneer je nog geen API key hebt, kan je deze aanmaken door op Genereer API key
-te klikken.
+Het belangrijkste van de koppeling is de API key. Deze kan je in jouw [MyParcel backoffice] terugvinden. Klik links onderin op `Shop instellingen > Selecteer de gewenste shop > Algemeen > API instellingen`.
+Wanneer je nog geen API key hebt, kan je deze aanmaken door op Genereer API key te klikken.
 
 <MPImg src="/documentation/shopify/shopify-api-settings.jpg" alt="Shopify api settings" />
 
@@ -83,97 +83,112 @@ te klikken.
 
 ### Herinneringsmail afhaallocatie
 
-De MyParcel-plugin heeft niet de mogelijkheid om de afhaallocaties in de
-checkout zelf te tonen. Jouw klant kan de gewenste locatie selecteren op de
-bedankpagina na het plaatsen van zijn/haar bestelling. Zet deze functie aan om
-jouw klant na 30 minuten automatisch een herinneringsmail te sturen wanneer
-hij/zij is vergeten om een postpunt te selecteren.
+De MyParcel-plugin heeft niet de mogelijkheid om de afhaallocaties in de checkout zelf te tonen. Jouw klant kan de gewenste locatie selecteren op de bedankpagina na het plaatsen van zijn/haar bestelling. Zet deze functie aan om jouw klant na 30 minuten automatisch een herinneringsmail te sturen wanneer hij/zij is vergeten om een postpunt te selecteren.
 
 <MPImg src="/documentation/shopify/shopify-reminder-email-pickup-location.jpg" alt="Shopify reminder email pickup location" />
+
 ### Wereldzendingen
 
-Om voor een wereldzending een douaneformulier op te stellen, zijn ook de '
-HS-code', het 'gewicht per pakket' en 'land van oorsprong' benodigd. Hier kan je
-de standaard waarden in vullen welke worden gebruikt wanneer je dit niet bij de
-producten zelf hebt ingevuld.
+Om voor een wereldzending een douaneformulier op te stellen, zijn ook de 'HS-code', het 'gewicht per pakket' en 'land van oorsprong' benodigd. Hier kan je de standaard waarden in vullen welke worden gebruikt wanneer je dit niet bij de producten zelf hebt ingevuld.
 
 ::: note
-Let op: wanneer je meer dan één soort product verzendt, is het belangrijk dat je
-per product een HS-code hebt ingesteld. Als je dit niet doet, is de kans
-aanwezig dat het pakket niet door de douane komt.
+Let op: wanneer je meer dan één soort product verzendt, is het belangrijk dat je per product een HS-code hebt ingesteld. Als je dit niet doet, is de kans aanwezig dat het pakket niet door de douane komt.
 :::
 
 ### Standaard exportinstellingen
 
-Met de standaard exportinstellingen heb je de mogelijkheid om aan de hand van de
-door jouw klant gekozen verzendmethode automatisch een gewenst pakkettype zoals
-een pakket of een brievenbuspakje aan te maken. De door jou aangemaakte
-verzendmethoden worden hier direct ingeladen, zodat je gelijk aan de slag kunt
-met het instellen van de exportvoorkeuren. Heb je nog geen verzendmethoden
-aangemaakt? Bekijk dan de [handleiding van Shopify] hoe je dit in kunt stellen.
+Met de standaard exportinstellingen heb je de mogelijkheid om aan de hand van de door jouw klant gekozen verzendmethode automatisch een gewenst pakkettype zoals een pakket of een brievenbuspakje aan te maken. De door jou aangemaakte verzendmethoden worden hier direct ingeladen, zodat je gelijk aan de slag kunt met het instellen van de exportvoorkeuren. Heb je nog geen verzendmethoden aangemaakt? Bekijk dan de [handleiding van Shopify] hoe je dit in kunt stellen.
 
 ![Shopify default export settings](/documentation/shopify/shopify-default-export-settings.gif)
 
-Wanneer je op een verzendmethode klikt, opent een pop-up. In de pop-up kan je
-aangeven of de zending met MyParcel verzonden mag worden, welk type verzending
-en pakket er gebruikt moet worden en of er extra opties aan toegevoegd moeten
-worden.
+Wanneer je op een verzendmethode klikt, opent een pop-up. In de pop-up kan je aangeven of de zending met MyParcel verzonden mag worden, welk type verzending en pakket er gebruikt moet worden en of er extra opties aan toegevoegd moeten worden.
 
 #### Nederland
 
-Beschikbare verzendtypes: Thuislevering en Afhaalpunt Beschikbare pakkettypes:
-Brievenbuspakket, Pakket, Ongefrankeerd label en Digitale postzegel Beschikbare
-opties: Handtekening voor ontvangst, Alleen geadresseerde, Retour bij geen
-gehoor, Extra groot formaat, 18+-check en verzekering tot € 5000
+**Beschikbare verzendtypes:**
+
+- Thuislevering en Afhaalpunt
 
-#### PostNL Locaties
+**Beschikbare pakkettypes:**
 
-Wanneer je jouw klanten een PostNL-locatie wilt aanbieden in de checkout, zul je
-een extra verzendmethode aan moeten maken in Shopify. Deze verzendmethode kan je
-daarna koppelen in de "Standaard Exportinstellingen".
+- Brievenbuspakket
+- Pakket
+- Ongefrankeerd label
+- Digitale postzegel
+
+**Beschikbare opties:**
+
+- Handtekening voor ontvangst
+- Alleen geadresseerde
+- Retour bij geen gehoor
+- Extra groot formaat
+- 18+-check
+- Verzekering tot €&nbsp;5.000,–
+
+#### PostNL-locaties
+
+Wanneer je jouw klanten een PostNL-locatie wilt aanbieden in de checkout, zul je een extra verzendmethode aan moeten maken in Shopify. Deze verzendmethode kan je daarna koppelen in de "Standaard Exportinstellingen".
 
 <MPImg src="/documentation/shopify/shopify-postnl-location.jpg" alt="Shopify PostNL-locatie" />
 
 1. Ga in Shopify naar "Apps"
 2. Ga naar de MyParcel App
 3. In de MyParcel App klik op "Instellingen" links bovenaan de pagina
-4. Scroll in de instellingen naar beneden tot je "Standaard exportinstellingen"
-   ziet
-5. Klik hier de verzendmethode die je hebt aangemaakt voor de PostNL-locaties
-   aan
+4. Scroll in de instellingen naar beneden tot je "Standaard exportinstellingen" ziet
+5. Klik hier de verzendmethode die je hebt aangemaakt voor de PostNL-locaties aan
 6. Zet "Verzenden via MyParcel" aan en "Type verzending" op "Afhaalpunt"
-7. Klik na het instellen van de verzendmethode op "Opslaan" Na het opslaan van
-   deze instellingen zal de klant na betaling gevraagd worden om een
-   PostNL-locatie te selecteren.
-8. Mocht dit vergeten worden, zal er na ongeveer 30 minuten een email ter
-   herinnering verstuurd worden.
+7. Klik na het instellen van de verzendmethode op "Opslaan". Na het opslaan van deze instellingen zal de klant na betaling gevraagd worden om een PostNL-locatie te selecteren.
+8. Mocht dit vergeten worden, zal er na ongeveer 30 minuten een email ter herinnering verstuurd worden.
 
 #### België
 
-- Beschikbare verzendtypes: Thuislevering en Afhaalpunt
-- Beschikbare pakkettypes: Pakket
-- Beschikbare opties: Extra groot formaat en standaard verzekering tot € 500,-
+**Beschikbare verzendtypes**
+
+- Thuislevering
+- Afhaalpunt
+
+**Beschikbare pakkettypes**
+
+- Pakket
+
+**Beschikbare opties**
+
+- Extra groot formaat
+- Standaard verzekering tot €&nbsp;500,–
 
 #### Europa
 
-- Beschikbare verzendtypes: Thuislevering
-- Beschikbare pakkettypes: Pakket
-- Beschikbare opties: Standaard verzekering tot € 500,-
+**Beschikbare verzendtypes**
+
+- Thuislevering
+
+**Beschikbare pakkettypes**
+
+- Pakket
+
+**Beschikbare opties**
+
+- Standaard verzekering tot €&nbsp;500,–
 
 #### Wereld
 
-- Beschikbare verzendtypes: Thuislevering
-- Beschikbare pakkettypes: Pakket
-- Beschikbare opties: Standaard verzekering tot € 200,-
+**Beschikbare verzendtypes**
+
+- Thuislevering
+
+**Beschikbare pakkettypes**
+
+- Pakket
+
+**Beschikbare opties**
+
+- Standaard verzekering tot €&nbsp;200,–
 
 ### Veelgestelde vragen over de configuratie
 
-#### Waar kan ik de 'HS-code' en 'land van oorsprong' op productniveau instellen?
+#### Hoe kan ik de 'HS-code' en 'land van oorsprong' op productniveau instellen?
 
-Selecteer het gewenste product op de pagina `Producten`. Onderaan de pagina vind
-je de onderstaande gegevens. Maak je gebruik van 'varianten'? In dat geval vind
-je het onderstaande nadat je de gewenste variant binnen het product hebt
-aangeklikt.
+Selecteer het gewenste product op de pagina `Producten`. Onderaan de pagina vind je de onderstaande gegevens. Maak je gebruik van 'varianten'? In dat geval vind je het onderstaande nadat je de gewenste variant binnen het product hebt aangeklikt.
 
 <MPImg src="/documentation/shopify/shopify-questions.jpg" alt="Shopify questions" />
 
@@ -181,30 +196,21 @@ aangeklikt.
 
 ### Aanmaken van één verzendlabel
 
-Bij het openen van een bestelling vind je bovenaan de pagina de
-knop `Meer acties`. In de dropdown kan je de optie `Print label`. Je wordt
-doorgestuurd naar de MyParcel app waarna je het label gelijk kunt downloaden.
+Bij het openen van een bestelling vind je bovenaan de pagina de knop `Meer acties`. In de dropdown kan je de optie `Print label`. Je wordt doorgestuurd naar de MyParcel app waarna je het label gelijk kunt downloaden.
 
 ### Aanmaken meerdere verzendlabels
 
-Wanneer je meerdere bestellingen in één keer wilt downloaden, kan je deze in het
-bestellingenoverzicht aanvinken, op de knop `Meer acties` bovenaan de pagina
-klikken. In de dropdown vind je de optie `Print label`. Je wordt doorgestuurd
-naar de MyParcel app waarna je de labels gelijk kunt downloaden.
+Wanneer je meerdere bestellingen in één keer wilt downloaden, kan je deze in het bestellingenoverzicht aanvinken, op de knop `Meer acties` bovenaan de pagina klikken. In de dropdown vind je de optie `Print label`. Je wordt doorgestuurd naar de MyParcel app waarna je de labels gelijk kunt downloaden.
 
 ### Aanpassen van een enkele zending
 
-Wanneer je de bestelling als een ander pakkettype wilt exporteren dan de eerder
-ingestelde standaard exportinstellingen, kan je dit binnen de MyParcel app doen.
-Ga naar `Apps > MyParcel NL` en open de gewenste order. Hier vind je de
-mogelijkheid om een export te maken met een aangepast pakkettype en eventuele
-verzendopties toevoegen of verwijderen.
+Wanneer je de bestelling als een ander pakkettype wilt exporteren dan de eerder ingestelde standaard exportinstellingen, kan je dit binnen de MyParcel app doen. Ga naar `Apps > MyParcel NL` en open de gewenste order. Hier vind je de mogelijkheid om een export te maken met een aangepast pakkettype en eventuele verzendopties toevoegen of verwijderen.
 
 <MPImg src="/documentation/shopify/shopify-change-shipment.jpg" alt="Shopify api settings" />
 
 ### Checkout afhaallocatie
 
-Wanneer je de optie 'afhaallocatie' aan een verzendmethode hebt gekoppeld (zie hoofdstuk 2.3) hebben jouw klanten de mogelijkheid om op de bedankpagina na de betaling een afhaallocatie te selecteren. Wil je jouw klanten een herinnering sturen wanneer ze vergeten om het postpunt te selecteren? Zet dan de optie 'Herinneringsmail afhaallocatie' uit hoofdstuk 2.4 aan.
+Wanneer je [de optie 'afhaallocatie' aan een verzendmethode hebt gekoppeld](#standaard-exportinstellingen) hebben jouw klanten de mogelijkheid om op de bedankpagina na de betaling een afhaallocatie te selecteren. Wil je jouw klanten een herinnering sturen wanneer ze vergeten om het postpunt te selecteren? Zet dan de optie ['Herinneringsmail afhaallocatie'](#herinneringsmail-afhaallocatie) aan.
 
 <MPImg src="/documentation/shopify/shopify-checkout-pickup.jpg" alt="Shopify checkout pickup" />
 
@@ -224,15 +230,64 @@ Let op: digitale postzegels worden wel direct in rekening gebracht.
 
 #### Waarom kan mijn klant alleen na de checkout voor een afhaallocatie kiezen?
 
-Om de veiligheid van betalingen te waarborgen, laat Shopify het niet toe dat partijen code aan een checkout toevoegen. Na de checkout is dit wél mogelijk waardoor we de optie toch aan de plugin toe hebben kunnen voegen. Samen met de herinneringsmail (zie hoofdstuk 2.4) kan je jouw klanten deze optie op de best mogelijke manier toevoegen.
+Om de veiligheid van betalingen te waarborgen, laat Shopify het niet toe dat partijen code aan een checkout toevoegen. Na de checkout is dit wél mogelijk waardoor we de optie toch aan de plugin toe hebben kunnen voegen. Samen met de [herinneringsmail](#herinneringsmail-afhaallocatie) kan je jouw klanten deze optie op de best mogelijke manier toevoegen.
 
 #### Ik heb de plugin geïnstalleerd, maar wanneer ik een zending probeer te exporteren, krijg ik een error.
 
-Mogelijk zijn de actieve verzendmethoden bij het configureren van de plugin nog niet aan pakkettypes gekoppeld. Volg de stappen in hoofdstuk 2.3 om dit in te stellen.
+Mogelijk zijn de actieve verzendmethoden bij het configureren van de plugin nog niet aan pakkettypes gekoppeld. Volg [de stappen in 'Standaard exportinstellingen'](#standaard-exportinstellingen) om dit in te stellen.
 
+#### Hoe krijg ik de melding "Standaardinstellingen voor wereldzendingen ontbreken" weg?
 
-[Delivery options]: https://github.com/myparcelnl/delivery-options
+De melding "Standaardinstellingen voor wereldzendingen ontbreken" kan heel eenvoudig worden verholpen door op de knop "Vul aan" te klikken en vervolgens de juiste HS-code in te vullen, die te vinden is op de website van de douane. Het is ook van belang om het gewicht van de verpakking waarin de zending wordt verzonden op te geven. Na het opslaan van de keuze zal de melding verdwijnen.
 
-[MyParcel backoffice]: https://backoffice.myparcel.nl/
+<Stack class="flex">
+    <iframe
+        class="rounded-xl"
+        width="560"
+        height="315"
+        src="https://www.youtube.com/embed/P4USKp17Eb8"
+        title="Standaardinstellingen voor wereldzendingen ontbreken" allowfullscreen />
+</Stack>
+
+#### Hoe krijg ik de melding "Geen exportinstellingen gevonden voor de verzendmethode. Vul aan bij instellingen" weg?
+
+De melding "Geen exportinstellingen gevonden voor de verzendmethode. Vul aan bij instellingen." kan heel eenvoudig verholpen worden door op de knop "Vul aan" te klikken en vervolgens een keuze te maken of al dan niet met MyParcel te verzenden. Selecteer een type verzending en vervolgens een type pakket. Het is ook mogelijk om eventuele andere opties aan te geven. Na het opslaan van de keuze zal de melding verdwijnen.
 
+<Stack class="flex">
+    <iframe
+        class="rounded-xl"
+        width="560"
+        height="315"
+        src="https://www.youtube.com/embed/wNPGEkif8uA" 
+        title="Geen exportinstellingen gevonden voor de verzendmethode" allowfullscreen />
+</Stack>
+
+#### Hoe krijg ik de melding "Geen verzendadres gevonden" weg?
+
+De melding "Geen verzendadres" kan worden verholpen door het bezorgadres te wijzigen op de bestelling detailpagina. Waarschijnlijk heeft de desbetreffende bestelling geen verzendadres.
+
+<Stack class="flex">
+    <iframe
+        class="rounded-xl"
+        width="560"
+        height="315"
+        src="https://www.youtube.com/embed/lBkdAPYDzTU"
+        title="Geen verzendadres gevonden" allowfullscreen />
+</Stack>
+
+#### Hoe krijg ik de melding "Verzendmethode werd niet herkend door de app. Exporteer de verzending op detailpagina van de bestelling." weg?
+
+De melding "Verzendmethode werd niet herkend door de app. Exporteer de verzending op detailpagina van de bestelling." kan worden verholpen door op de detailpagina een keuze te maken voor het 'Type verzending' en 'Type pakket'. Het is ook mogelijk om eventuele andere opties aan te geven. Vervolgens klik je op de knop 'Printen' en zal het verzendlabel worden aangemaakt. Controleer ook de barcode die nu bij de bestelling staat.
+
+<Stack class="flex">
+    <iframe 
+        class="rounded-xl"
+        width="560" 
+        height="315" 
+        src="https://www.youtube.com/embed/4ak3eqLkwk4" 
+        title="Verzendmethode werd niet herkend door de app" allowfullscreen />
+</Stack>
+
+[Delivery options]: https://github.com/myparcelnl/delivery-options
+[MyParcel backoffice]: https://backoffice.myparcel.nl/
 [PostNL Pick-up points]: https://apps.shopify.com/pick-up-points?locale=nl