1.Samenvatting

Dit is de handleiding voor de koppeling tussen Prestashop en Moneybird. De koppeling zorgt dat er van bestellingen in Prestashop automatisch een factuur wordt aangemaakt in Moneybird. Omdat de bestellingen direct in het boekhoudsysteem van de webwinkelier komen bespaart deze tijd op de financiële administratie.

Via deze website kun je een proefperiode voor deze koppeling aanvragen. Je ontvangt na aanvraag een licentiesleutel en deze installatie-handleiding. Er is een proefperiode van 30 dagen.

Tip: Andere klanten met deze koppeling hebben veel gehad aan de tips in de specifieke FAQs: https://faq.webwinkelfacturen.nl/category/27/prestashop.html en https://faq.webwinkelfacturen.nl/category/30/moneybird.html.

2.Features

Bestellingen uit je OpenCart webwinkel worden doorgezet naar facturen in Moneybird. Hierbij worden doorgezet:
- De regels uit de bestelling, inclusief de prijs, de BTW en de naam van het product.
- De debiteur-gegevens zoals naam, e-mailadres, adres, woonplaats en indien mogelijk het BTW nummer. De koppeling kijkt eerst of de debiteur al in Moneybird bestaat. Zo ja, dan wordt deze debiteur genomen. Zo nee dan maakt de koppeling de debiteur aan in Moneybird. Matching van debiteuren tussen OpenCart en Moneybird gebeurt op basis van het e-mailadres.

3.Nodig: Prestashop API sleutel

Voor het aanmaken van de API-sleutel in je PrestaShop webwinkel ga je via het menu naar Advanced parameters - Webservices.

 

PrestaShop API sleutel menu webservices

 

Klik op Add New om een nieuwe API sleutel aan te maken.

 

PrestaShop API sleutel aanmaken

 

Als je op het volgende scherm op Generate klikt wordt er automatisch een API-sleutel gegenereerd. Je kunt ook zelf een API sleutel bedenken maar het is veiliger als je het het systeem laat doen. Geef ook een beschrijving op, zodat je later weet waarvoor je de API sleutel gebruikt.

 

PrestaShop API sleutel naam en omschrijving

 

Tot slot dien je de rechten voor de API-sleutel in the stellen. De koppeling wil alleen lezen uit de PrestaShop webwinkel. Dus alleen View rechten aanklikken en wel voor de volgende onderdelen:
addresses
categories
countries
customers
order details
orders
order state
producten
statussen
taxes

 

PrestaShop API sleutel instellen rechten

4.Installatie

Via deze website kun je een proefperiode voor deze koppeling aanvragen. Je ontvangt na aanvraag een licentiesleutel en deze installatie-handleiding.

Het activeren van de koppeling bestaat uit drie stappen:
1. Het leggen van de connectie met de OpenCart webwinkel. Via deze stap autoriseer je de koppeling om de gegevens uit jullie webwinkel te lezen.
2. Het leggen van de connectie met Moneybird. Hiermee autoriseer je de koppeling transacties naar jullie Moneybird administratie te schrijven en informatie te lezen.
3. Het configureren van extra gegevens, zoals de BTW instellingen.

Voordat de koppeling gebruikt kan worden dienen eerst de voorwaarden geaccepteerd te worden. De voorwaarden zijn gebaseerd op de algemene ICT Voorwaarden (brancheorganisatie) en de algemene AVG richtlijnen. Ook hebben we een naam, emailadres en het land van de webwinkel nodig.

Authenticatie PrestaShop webwinkel:
De authenticatie met je PrestaShop webwinkel gebeurt via de API sleutel die je in een vorige sectie hebt aangemaakt. Klik op de rode Connect knop naast PrestaShop en vul de API sleutel in in het popup-window. Als de connectie correct gelegd is dan wordt het bolletje groen. Is de connectie niet gelegd controleer dan dat de webservice aanstaat in de PrestaShop webwinkel.

Authenticatie Moneybird:
De authenticatie met Moneybird loopt via OAuth. Zorg dat je bent uitgelogd bij Moneybird voordat je de connectie start. Je klikt nu op de rode Connect knop. Er verschijnt automatisch een inlogscherm voor je Moneybird account. Als je inlogt krijg je een scherm waarin gevraagd wordt of je de connectie toestaat. Als je dit bevestigt dan wordt de connectie met Moneybird gelegd.

Inrichten BTW tarieven en grootboekrekeningen
Bij het inrichten van de BTW tarieven en de grootboekrekeningen wordt er een link gelegd tussen de BTW tarieven in de webwinkel en de BTW tarieven en evt grootboekrekeningen in het boekhoudsysteem. Dat kan heel gemakkelijk via drop-down boxjes. Let op: Standaard gebruikt PrestaShop BTW tarieven met vreemde tekens voor oa de landen Griekenland, Bulgarije en Cyprus. De koppeling kan helaas niet met deze vreemde tekens om gaan. Als je deze tekens in PrestaShop bij de BTW tarieven verwijderd dan kun je daarna de BTW tarieven configureren.

Betaalmethoden inrichten
Je kunt hier een relatie leggen tussen de betaalmethoden in de webwinkel en een vaste debiteur uit je boekhoudpakket. Bestellingen met een betaalmethode worden dan altijd onder deze debiteur geboekt. Er worden in dat geval geen nieuwe vaste debiteuren aangemaakt. Let op: Vaste debiteuren kan niet voor ICP bestellingen. Bij ICP bestellingen moet een geldig BTW nummer worden doorgezet. Daarom wordt er voor ICP bestellingen altijd een debiteur aangemaakt in Moneybird.

5.Day-to-day: Vanuit Prestashop

Nieuwe bestellingen uit je webwinkel worden minimaal eenmaal per uur opgehaald. Daarnaast worden iedere nacht de bestellingen bekeken die eerder zijn opgehaald en die nog niet zijn doorgestuurd naar je boekhoudsysteem.

Per bestelling wordt de status van de bestelling bekeken. Je hebt vooraf aangegeven wanneer je wilt dat bestellingen worden doorgezet naar je boekhoudsysteem. Voor bestellingen met de juiste status gebeurt dat. Nadat ze zijn doorgestuurd en er een succesmelding is ontvangen van het boekhoudsysteem wordt de bestelling als afgehandeld beschouwd. Op die manier wordt er voor gezorgd dat bestellingen die succesvol zijn doorgezet niet nogmaals kunnen worden doorgezet.

Indien het boekhoudsysteem het toelaat, wordt er een extra controle uitgevoerd op de transactie die is toegevoegd aan het boekhoudsysteem en de gerelateerde bestelling in de webwinkel. De klantgegevens en de totalen worden hierbij vergeleken. Is het verschil te groot, dan wordt de factuur niet doorgezet, en verschijnt hij in het tabblad >>Fouten op het Dashboard.

6.Day-to-day: Naar Moneybird

De bestellingen uit de webwinkel worden naar MoneyBird doorgezet als facturen. Indien nodig maakt de koppeling een nieuwe debiteur aan voor de factuur. Voor de nieuwe debiteur wordt standaard ingevuld dat de factuur handmatig, en dus niet automatisch via de email, verstuurd moet worden.

Als de bestelling of factuur in de webwinkel betaald is dan geeft de koppeling de volgende 2 extra requests mee na het aanmaken van de factuur in Moneybird:

I. Verzend-request
Dit request voegt de actie Verzenden toe aan de Moneybird factuur. Wij geven als default door dat de factuur verstuurd moet worden met de tag handmatig. Op verzoek kunnen wij deze instelling veranderen voor alle facturen die we doorzetten, naar: verzenden per email. In dat geval ontvangt de klant de factuur via de email.

II. Betaalstatus-request
Daarnaast sturen wij het 'betaal'-request door. De factuur staat nu op Betaald in Moneybird.

Let op, bij sommige webwinkelsoftware wordt de factuur eerder aangemaakt dan dat de betaling is verwerkt. In dat geval wordt er dus geen betaal-request door de koppeling doorgestuurd. De enige remedy is contact met ons op te nemen met het verzoek 'hard in te stellen dat alle bestellingen altijd de status betaald meekrijgen'.

Tot slot, binnen Moneybird zijn ook workflows actief waardoor facturen toch onbedoeld naar klanten worden gestuurd ondanks alle voorzorgsmaatregelen die genomen worden. Om extra werk te voorkomen adviseren wij om een aparte factuur-layout aan te maken voor de koppeling en in de factuur aan te geven dat de betaling al binnen is. Daarmee voorkom je dubbele betalingen en acties om deze betalingen terug te storten.