Import van PrestaShop naar Odoo — overname van de catalogus

De Webservice, in JSON

PrestaShop 9 biedt twee API’s aan. De nieuwe, met OAuth2, dekt de catalogus nog niet; deze module bevraagt dus de historische Webservice — die producten, combinaties, categorieën, klanten en bestellingen dekt en die in de documentatie van versie 9 nog steeds gedocumenteerd is.

De Webservice geeft standaard XML. De module vraagt uitdrukkelijk om JSON: een connector die dat vergeet, ontvangt XML en concludeert dat de webwinkel leeg is.

De drie valkuilen van deze API, behandeld

De authenticatie heeft geen wachtwoord. De sleutel van tweeëndertig tekens fungeert als gebruikersnaam, het wachtwoord is leeg. Het is PrestaShop zelf die dat zegt in zijn weigeringsheader, en het is de eerste halve dag die verloren gaat voor wie deze connector schrijft.

De meertalige velden veranderen van vorm. name is "Mug" in een eentalige webshop en een lijst van vertalingen in een webshop met twee talen. De module aanvaardt beide: zonder dat zou ze werken bij de eerste klant en crashen bij de tweede.

De prijs van een combinatie is een verschil, geen prijs. Een variant met 2.00 op een artikel van 11.20 kost 13,20 €. De module noemt dit veld “prijsverschil” zodat niemand het voor iets anders aanziet — de omgekeerde fout zou een catalogus tegen belachelijke prijzen importeren en onzichtbaar blijven, aangezien de waarden aannemelijk blijven.

Getoetst aan een echte PrestaShop

Geen enkele openbare demonstratie van PrestaShop stelt zijn Webservice beschikbaar. De uitgever heeft dus een volledige PrestaShop 8-instantie opgezet, met Webservice geactiveerd en een tweede taal geïnstalleerd, en er de module op laten draaien: lezen van de demonstratiecatalogus, meertalige velden in hun lijstvorm, combinaties gekoppeld aan hun product, paginering, en een volledige import die twee keer opnieuw is uitgevoerd zonder één enkel dubbel te produceren. De werkwijze om deze instantie weer op te zetten staat in de tests van de module.

Wat de module niet doet

Ze synchroniseert niets continu: het is een hersteltool, geen verkoopconnector. Ze schrijft niets in PrestaShop. Ze neemt de afbeeldingen niet over, die bij PrestaShop een afzonderlijke binaire stroom zijn. Ze vereist de gratis basismodule dyo_import_boutique.