Odoo Connector: volledige gids
De realtimesynchronisatie PrestaShop ⇄ Odoo (producten en combinaties, voorraad, klanten, bestellingen, facturen, verzendingen) installeren, configureren en benutten voor PrestaShop 8 en 9 en Odoo 14 tot 20.
De Odoo Connector synchroniseert uw producten en combinaties, uw voorraad, uw klanten, uw bestellingen, uw facturen en uw verzendingen in real time en in beide richtingen tussen PrestaShop en Odoo. Deze gids behandelt de installatie, de verbinding, elk tabblad met instellingen, de initiële synchronisatie, de cron, de Odoo-webhooks en de probleemoplossing.
Vereisten
- PrestaShop 8.0 tot 9.x.
- PHP 7.4 tot 8.5 met de cURL-extensie.
- Odoo 14 tot 20, zelfgehost, Odoo.sh of Odoo Online, bereikbaar vanaf uw PrestaShop-server. Bij Odoo Online moet uw abonnement toegang tot de externe API omvatten.
- De Odoo-apps Verkoop en Voorraad, plus Facturatie als u de facturen aanmaakt. De app Levering is nodig om het trackingnummer naar PrestaShop terug te sturen.
- Een speciale Odoo-gebruiker, met rechten voor Verkoop, Voorraad en Facturatie, en een API-sleutel.
De module communiceert met Odoo via JSON-RPC. De PHP-extensie xmlrpc, die uit PHP 8 is verwijderd, is niet nodig.
Installeer de app Voorraad in Odoo voordat u uw producten verzendt. Sinds Odoo 18 hangt het bijhouden van de voorraad van een product af van deze app: producten die zonder deze app zijn aangemaakt, zouden niet in de voorraad worden bijgehouden.
Installatie en update
- Open in de backoffice Modules > Modulebeheer, klik op Een module uploaden en upload het zip-bestand van de module.
- Open vervolgens de configuratie via de knop Configureren of het menu Odoo Connector.
Om te updaten uploadt u de nieuwe versie op dezelfde manier: PrestaShop start de update, en uw instellingen, uw API-sleutel en uw koppelingen blijven behouden.
Een API-sleutel genereren in Odoo
- Log in bij Odoo met de gebruiker die voor de synchronisatie is bestemd.
- Klik op uw avatar, daarna op Mijn profiel (of Voorkeuren), tabblad Accountbeveiliging, en op Nieuwe API key.
- Kopieer de sleutel: deze wordt maar één keer getoond.
Een speciale gebruiker (bijvoorbeeld “PrestaShop Sync”) in plaats van een persoonlijk beheerdersaccount geeft u een duidelijke geschiedenis in Odoo en maakt het mogelijk de toegang op elk moment in te trekken.
Tabblad Verbinding
- Odoo-URL: het adres van uw instantie, beginnend met
https://(ofhttp://), bijvoorbeeldhttps://mijn-bedrijf.odoo.com. - Database: de exacte naam van de Odoo-database.
- Login: de login (vaak het e-mailadres) van de speciale gebruiker.
- API-sleutel: versleuteld opgeslagen. Laat het veld leeg om de huidige sleutel te behouden.
Klik op De verbinding testen: de module toont de Odoo-versie, de gebruiker en het bedrijf. Klik vervolgens op Lijsten laden uit Odoo om het bedrijf, het magazijn, de locatie, het verkoopteam, de verkoper en het betalingsdagboek uit lijsten te kiezen. Sla op en vink daarna Synchronisatie inschakelen aan.
Om veiligheidsredenen wordt de opgeslagen API-sleutel nooit naar een ander adres, een andere database of een andere login verzonden dan de opgeslagen gegevens: voer de API-sleutel van een andere server in om die te testen.
Hetzelfde tabblad biedt ook de realtime verwerking (wijzigingen worden verzonden direct nadat de pagina aan de bezoeker is getoond; uitgeschakeld verzendt de cron ze), de testmodus, het gedetailleerde logboek, de lijst met toegestane IP’s voor de webhook, en de activering van elke stroom: klanten, producten, voorraad, bestellingen.
Tabblad Producten
- Productrichting: PrestaShop naar Odoo, Odoo naar PrestaShop, of in beide richtingen.
- Hoofdafbeelding, categorieboom (met de bovenliggende Odoo-categorie) en inkoopprijs verzonden als kostprijs (uit te schakelen als Odoo de kosten berekent met gewogen gemiddelde of FIFO).
- Odoo-varianten archiveren die ontbreken in PrestaShop.
- Extra veldkoppeling: één regel per veld, in de vorm
odoo_field=prestashop_field. - Odoo naar PrestaShop: prijs, naam, referentie en EAN13, actieve status, naar keuze.
- Nieuwe Odoo-producten importeren: verkoopbare producten die in Odoo zijn aangemaakt, worden in PrestaShop aangemaakt, met hun varianten als combinaties, in de gekozen categorie en belastingregel, al dan niet ingeschakeld.
Tabblad Voorraad
- Leidend systeem voorraad: Odoo (aanbevolen), PrestaShop, of beide. Mutaties die met bestellingen samenhangen, worden nooit dubbel geteld.
- Naar PrestaShop verzonden hoeveelheid: de vrij verkoopbare hoeveelheid (na aftrek van de reserveringen, aanbevolen om oververkoop te voorkomen) of de hoeveelheid op voorraad.
- Odoo-magazijn, ook toegepast op de bestellingen, en optionele specifieke locatie.
Tabblad Bestellingen
- Bestellingen naar Odoo verzenden: zodra ze worden aangemaakt of pas na betaling, met een datum waarvóór bestellingen worden genegeerd.
- De Odoo-offerte bevestigen bij de bestelling of bij de betaling: de bevestiging maakt de leveringsorder in Odoo aan.
- Belastingen: PrestaShop-tarieven (de Odoo-belastingen met hetzelfde tarief worden gebruikt en de totalen komen overeen) of Odoo laten berekenen (productbelastingen en fiscale posities van Odoo).
- PrestaShop-statussen die de Odoo-order annuleren, verkoopteam en verkoper.
- Leveringen in Odoo werken PrestaShop bij: bij de validatie van de levering krijgt de bestelling de gekozen status (standaard Verzonden) met het trackingnummer, en ontvangt de klant de verzendmail.
- Annuleringen in Odoo werken PrestaShop bij.
Elke bestelregel verwijst naar de Odoo-variant van de combinatie. Verzending, cadeauverpakking en kortingen worden als afzonderlijke regels toegevoegd, waarbij de kortingen per belastingtarief worden uitgesplitst. De module vergelijkt het Odoo-totaal met dat van PrestaShop en meldt elk verschil in het logboek.
Tabblad Facturatie
- Odoo-facturen: niet aanmaken, als concept aanmaken, of aanmaken en boeken. De factuur wordt aangemaakt op basis van de bevestigde order, bij de bestelling of bij de betaling.
- De betaling in Odoo registreren: de geboekte factuur van een betaalde bestelling wordt als betaald gemarkeerd in het bijbehorende dagboek.
- Standaard betalingsdagboek, en dagboek per betaalmodule: één regel per module, in de vorm
module_name=journal_id, bijvoorbeeldstripe_official=7.
Zonder geconfigureerd dagboek wordt de betaling niet geregistreerd: het logboek meldt dit met een waarschuwing die de betreffende betaalmodule vermeldt.
Initiële synchronisatie
Vul Odoo bij een bestaande winkel vanuit het tabblad Hulpmiddelen, in deze volgorde:
- Alle klanten verzenden.
- Alle producten verzenden.
- Alle Odoo-voorraad importeren als Odoo het leidende systeem voor de voorraad is.
- Bestellingen verzenden die geplaatst zijn sinds een datum.
De taken worden in batches via de cron verzonden. Als uw catalogus of uw klanten al in Odoo staan, worden ze teruggevonden in plaats van opnieuw aangemaakt: klanten op hun e-mailadres, adressen op hun referentie, eenvoudige producten op hun referentie (of PS-<id> zonder referentie), producten met combinaties op de referenties van hun varianten en bestellingen op hun oorsprong.
Begin met de testmodus ingeschakeld: elke operatie wordt in het logboek geregistreerd zonder iets in Odoo te schrijven. Schakel hem uit zodra het resultaat is gecontroleerd.
Cron
De cron verwerkt de wachtrij en leest de wijzigingen die in Odoo zijn gemaakt (voorraad, producten, leveringen, annuleringen). Plan hem elke 1 tot 5 minuten in met de URL die in het dashboard wordt getoond:
curl -s "https://uw-winkel.com/module/dfodooconnect/cron?token=UW_TOKEN"
of, zonder HTTP-tijdslimiet, via de opdrachtregel op de server:
php /pad/naar/prestashop/modules/dfodooconnect/cron.php
Twee uitvoeringen lopen nooit tegelijk. De knop Nu synchroniseren in het dashboard start onmiddellijk een uitvoering.
Odoo-webhooks (realtime vanuit Odoo)
Zonder webhook leest de cron de wijzigingen in Odoo bij elke uitvoering. Voor een onmiddellijke terugkoppeling maakt u vanaf Odoo 17 zonder code één regel per model aan in Instellingen > Technisch > Automatiseringsregels:
- Modellen: Product, Productvariant, Aantallen of Voorraadverplaatsing, Verplaatsing, Verkooporder.
- Trigger: Bij het opslaan.
- Actie: Webhook notificatie verzenden naar de webhook-URL die in het dashboard wordt getoond.
Het token is verplicht: de webhook-URL in het dashboard bevat het al (?token=). Voor uw eigen scripts kan het ook in de header X-DF-Token worden meegestuurd. De ontvangen inhoud wordt nooit zomaar toegepast: die geeft alleen aan welk record is gewijzigd, en de module leest het via de API opnieuw in Odoo in.
Een request zonder geldig token wordt geweigerd met code 403. U kunt daarnaast de toegestane IP-adressen beperken in het tabblad Verbinding.
Dashboard en monitoring
Het dashboard toont de systeemstatus (laatste cron, laatste geslaagde Odoo-aanroep, oudste wachtende taak, fouten en waarschuwingen over 24 u), de tellers van de wachtrij (In behandeling, Nieuwe poging, In quarantaine, Voltooid) en het aantal gekoppelde records. De tabbladen Wachtrij, Koppelingen en Logboek zijn filterbaar, en een Odoo-kader op de bestel-, product- en klantpagina’s biedt een knop Nu synchroniseren.
De veerkrachtige wachtrij
Elke wijziging wordt in een wachtrij geplaatst die wordt verwerkt nadat de pagina naar de klant is verzonden: het besteltraject wacht nooit op Odoo. Bij een mislukking wordt de taak opnieuw gestart met een oplopende wachttijd (van 1 minuut tot 24 uur); na het geconfigureerde aantal pogingen (standaard 8) gaat ze in quarantaine en kan ze met één klik opnieuw worden gestart. Reageert Odoo niet meer, dan schort een circuitbreaker de aanroepen op en blijven de taken bewaard zonder hun pogingen te verbruiken; daarna hervat de synchronisatie vanzelf zodra Odoo weer beschikbaar is.
Van Odoo-database wisselen
Als u van de ene Odoo-database naar een andere overstapt (testdatabase naar productie, migratie), detecteert de module dit aan de hand van de unieke identificatie van de database. Hij vergeet dan de koppelingen en de instellingen die eigen zijn aan de oude database (bedrijf, magazijn, locatie, team, verkoper, dagboek) en meldt dit met een bericht: laad de lijsten opnieuw uit Odoo en controleer de instellingen. Bij de volgende synchronisatie worden de records van de nieuwe database teruggevonden aan de hand van hun referenties.
Gesynchroniseerde velden
Klanten
Odoo-contact met naam (of bedrijf), e-mail, btw-nummer, SIRET, land, regio, taal en telefoon. De factuur- en afleveradressen worden onderliggende contacten op het moment dat de bestellingen worden verzonden. Een btw-nummer dat door Odoo wordt geweigerd, verhindert de verzending niet: het contact wordt zonder btw-nummer aangemaakt en er wordt een waarschuwing aan het logboek toegevoegd.
Producten en combinaties
Naam, prijs exclusief btw, kostprijs, gewicht omgerekend naar kg, referentie, barcode, belasting tegen hetzelfde tarief (dienstenbelasting voor virtuele producten), categorie en afbeelding. Elke combinatie is gekoppeld aan een Odoo-variant; attributen en hun waarden worden indien nodig aangemaakt. Een ongewijzigd product wordt niet opnieuw naar Odoo geschreven.
Voorraad
Per combinatie, op het gekozen magazijn of de gekozen locatie.
Bestellingen
Klant, factuur- en afleveradres, regels per variant, verzending, cadeauverpakking, kortingen, valuta via prijslijst, magazijn, team en verkoper.
Probleemoplossing
- “Authentication refused by Odoo”: de login of de API-sleutel is onjuist, of de sleutel is ingetrokken. Genereer een nieuwe sleutel.
- “Odoo closed the connection: check the database name”: de opgegeven database bestaat niet op deze server.
- “Odoo redirects this URL”: gebruik het adres dat in het bericht wordt vermeld (vaak de
https://-versie). - “No Odoo sale tax at 20%”: maak in Odoo een verkoopbelasting aan tegen het vermelde tarief, als percentage en exclusief belasting.
- “No Odoo payment journal for payment module…”: kies een standaard betalingsdagboek of een dagboek per module in het tabblad Facturatie.
- Het trackingnummer komt niet door: installeer de app Levering in Odoo. De status Verzonden werkt ook zonder deze app.
- “Total mismatch”: het Odoo-totaal verschilt van dat van PrestaShop; controleer de Odoo-belastingen die overeenkomen met de tarieven van de bestelling.
- De voorraad of de leveringen komen niet door: controleer of de cron draait (datum van de laatste cron in het dashboard) en welke richting is ingesteld.
- Een taak staat in quarantaine: lees het bericht ervan in het tabblad Wachtrij, verhelp de oorzaak en start de taak daarna opnieuw.
De-installatie
De de-installatie verwijdert de koppelings-, wachtrij- en logboektabellen en de instellingen van de module. Uw gegevens in Odoo worden niet gewijzigd. Bij een herinstallatie worden de bestaande records in Odoo teruggevonden aan de hand van hun referenties, zonder duplicaten.