Klantreviews.online voor Shopware 6
===================================

Plug-in: KlantreviewsOnline
Versie: 1.0.0
Vereist: Shopware 6.5 of nieuwer, PHP 8.2 of nieuwer
Licentie: MIT

Geeft afgeronde bestellingen door aan Klantreviews.online, dat op het door jou
gekozen moment om een review vraagt.


Welke gegevens je winkel verstuurt
----------------------------------

Bij elke doorgegeven bestelling gaat er naar https://klantreviews.online:

* Het bestelnummer
* Het e-mailadres van de klant
* De voornaam van de klant
* Het moment waarop de bestelling is geplaatst
* De artikelen, alleen als je dat aanzet: artikelnummer en naam
* De vestigingscode, alleen als je die invult

Er gaat geen adres mee, geen bedrag, geen betaalgegevens, geen telefoonnummer en
geen aantekening bij de bestelling.

Je bent zelf verantwoordelijk voor de gegevens van je klanten. Klantreviews.online
verwerkt ze in jouw opdracht; de voorwaarden staan op klantreviews.online.


Installeren
-----------

Pak het archief uit in custom/plugins/KlantreviewsOnline, en dan:

    bin/console plugin:refresh
    bin/console plugin:install --activate KlantreviewsOnline
    bin/console cache:clear

De instellingen staan in het beheer onder Extensions, My extensions, bij de plug-in
zelf.

Vul daar de API-sleutel in die je bij Klantreviews.online aanmaakt onder
Ontwikkelaars, met het recht om bestellingen aan te leveren. Kies daarna bij welke
bestelstatus er wordt doorgegeven. Afgerond is het gewone antwoord; kies In
behandeling als je alles digitaal levert.

Alles staat per verkoopkanaal, want een Shopware-installatie draagt er vaak meer
dan een en die hebben elk hun eigen bedrijfspagina bij Klantreviews.online.


De wachtrij
-----------

Er wordt nooit iets verstuurd tijdens de statusovergang zelf: die gebeurt soms
midden in het afrekenen, en dan zou een klant met zijn kaartgegevens op onze
server wachten. De bestelling gaat in een eigen tabel, en de takenplanner van
Shopware werkt die elke vijf minuten af.

Draait je takenplanner niet, dan blijft de wachtrij staan. Dat is te zien in het
beheer onder Settings, System, Tasks.


Als er iets misgaat
-------------------

De uitkomst komt in het logboek van de winkel te staan, met het bestelnummer erbij.

Een netwerkfout of een storing wordt opnieuw geprobeerd, met oplopende tussenpozen
tot ruim een dag, zes keer. Een geweigerde sleutel of een bestelling zonder
e-mailadres wordt niet herhaald: dat komt niet goed door het opnieuw aan te
bieden.
