Technische handleiding Lotzano Connect
Voor de IT-persoon die een webshop, WMS of ERP met Lotzano wil verbinden. Deze pagina bevat geen leveranciersgegevens en vraagt nergens om een geheime sleutel te delen.
Veilig uitgangspunt
- Gebruik HTTPS en een aparte integratiegebruiker met minimale rechten.
- Vul geheimen alleen in het afgeschermde Lotzano-formulier in.
- Een aanvraag of geslaagde login is nog geen gecertificeerde synchronisatie.
- Lotzano start met alleen-lezen data en een zichtbare voorbeeldcontrole.
Vier directe routes
Kies de officiële route van het bronsysteem
Lotzano ondersteunt één bronsysteem per leverancier. Rechten worden per functie getest; een groen vinkje geldt alleen voor de functie die werkelijk is beproefd.
Directe toestemming
Shopify
- 1Start bij Lotzano Connect en kies Shopify. Je hoeft geen winkeladres, Client ID, secret of Admin API-token op te zoeken.
- 2Klik op ‘Open Shopify en installeer de app’. Lotzano opent uitsluitend de officiële Shopify-installatiepagina; controleer dat de app ‘Lotzano Connect’ heet.
- 3Log in als bevoegde Shopify-beheerder, controleer de gevraagde rechten en kies Installeren of Toestaan. Shopify levert de permanente winkelidentiteit rechtstreeks aan Lotzano.
- 4Shopify keert terug naar de Lotzano-conceptkoppeling. Voer daar de verbindingstest, mapping en voorbeeldimport uit. Er gaat nog niets live zonder afzonderlijke activering.
Toestemming plus gratis uitbreiding
WooCommerce
- 1Controleer dat de webshop via een geldig HTTPS-adres bereikbaar is en dat WooCommerce actief is.
- 2Vul alleen het openbare webshopadres in. Je hoeft geen Consumer Key of Consumer Secret op te zoeken of te kopiëren.
- 3Lotzano opent de officiële /wc-auth/v1/authorize-pagina. Log in als WooCommerce-beheerder en keur de read_write-toegang goed.
- 4WooCommerce geeft de sleutels rechtstreeks terug aan Lotzano. Download daarna hieronder de gratis Lotzano Connect-uitbreiding.
- 5Open in WordPress Plugins → Nieuwe plugin → Plugin uploaden. Kies het gedownloade ZIP-bestand, klik op Nu installeren en daarna op Plugin activeren. Pak het ZIP-bestand niet zelf uit.
- 6Ga terug naar de conceptkoppeling in Lotzano en kies ‘Controleer WooCommerce en uitbreiding’. Lotzano controleert de webshop, rechten, uitbreiding en functies voordat de product- en orderproeven starten.
Webservice-sleutel
PrestaShop 8/9
- 1Open PrestaShop Back Office → Advanced Parameters → Webservice en schakel de webservice in.
- 2Voeg een aparte sleutel met een herkenbare omschrijving zoals ‘Lotzano Connect’ toe.
- 3Geef alleen GET-rechten op configurations, currencies, products, combinations, categories, product_option_values, product_options en stock_availables.
- 4Vul het HTTPS-webshopadres en de sleutel in Lotzano in. De huidige directe PrestaShop-route leest producten, varianten en voorraad; orderexport wordt niet als ondersteund beloofd.
Odoo 19 JSON-2
Odoo
De officiële Odoo 19-documentatie vermeldt dat externe API-toegang alleen beschikbaar is bij een Custom-abonnement, niet bij One App Free of Standard.
- 1Maak voor langdurige automatisering een aparte botgebruiker met uitsluitend de benodigde product-, voorraad- en orderrechten.
- 2Open Preferences → Account Security → New API Key. Geef de sleutel een herkenbare naam en beperkte geldigheidsduur; Odoo 19 staat volgens de officiële documentatie maximaal drie maanden toe.
- 3Kopieer de sleutel direct; Odoo toont haar maar één keer. Vul haar uitsluitend in het beveiligde Lotzano-formulier in.
- 4Vul het Odoo HTTPS-adres in en alleen bij multi-database-hosting ook de databasenaam. Plan sleutelrotatie uiterlijk vóór de Odoo-vervaldatum.
Vaste Lotzano-productgegevens
Waarom een product soms nog niet kan worden geïmporteerd
Lotzano neemt onbekende categorieën, kleuren en maten niet stilzwijgend over. Daardoor ontstaat geen rommelige catalogus met bijvoorbeeld meerdere namen voor dezelfde kleur of een schoenmaat zonder EU-, UK- of US-maatsysteem. De controlepagina noemt altijd de bronwaarde, hoeveel producten geraakt worden en waar mogelijk een voorbeeldproduct.
Verplichte gegevens zijn aanwezig en categorie, kleur en maat passen bij de vaste Lotzano-waarden. De voorbeeldkaart krijgt een groen vinkje.
De kaart toont waarom, bijvoorbeeld ontbrekend producttype, onbekende kleur of onduidelijk maatsysteem. Lotzano gokt niet en slaat het product niet ongemerkt over.
Bij een al actieve koppeling kunnen geldige producten vóór de fout al zijn bijgewerkt. Het getroffen product en de afhankelijke voorraad blijven geblokkeerd; verdere automatische synchronisatie pauzeert om tegenstrijdigheden te voorkomen.
Zo los je een geblokkeerd product op
- 1Bekijk bij het probleem de precieze bronwaarde, het aantal geraakte producten en het genoemde voorbeeldproduct.
- 2Kies een passende bestaande Lotzano-categorie, kleur of maat. Die keuze wordt als herbruikbare vertaling voor dezelfde bronwaarde opgeslagen.
- 3Of verbeter het producttype, de kleur of maat in Shopify, WooCommerce, PrestaShop of Odoo en kies daarna ‘Voorbeeld opnieuw controleren’ of, bij een gepauzeerde actieve koppeling, ‘Correcties opnieuw controleren’.
- 4Bestaat er echt geen passende Lotzano-waarde? Kies ‘Geen passende keuze? Vraag toevoeging aan’. Lotzano beoordeelt de centrale cataloguswaarde; tot goedkeuring blijft alleen de betrokken import veilig geblokkeerd.
- 5Controleer na de herhaling de groene en rode kaarten. Een nieuwe koppeling kan pas worden geactiveerd wanneer het voorbeeld nul blokkerende problemen toont en de leverancier het afzonderlijk goedkeurt.
Mijn systeem staat er niet bij
Drie veilige routes, geen achterpoort
Lotzano installeert geen Bridge in het interne netwerk en biedt geen algemene uploadinbox. Het bedrijf houdt zelf de controle over de bron of de IT-partner gebruikt een afgeschermde API.
Route 1
Bestaande online API laten beoordelen
- 1Geef de officiële naam en versie van het bronsysteem door.
- 2Deel het vaste HTTPS-basisadres van de API en de officiële online documentatielink.
- 3Geef alleen aan welk beveiligingstype wordt gebruikt. Stuur in deze eerste aanvraag nog geen token of wachtwoord.
- 4Lotzano controleert documentatie, limieten, paginering, wijzigingsmomenten en de betekenis van product-, variant-, voorraad-, prijs- en packvelden.
- 5Pas na een goedgekeurd ontwerp worden tijdelijke testcredentials veilig uitgegeven en wordt met echte voorbeelddata een alleen-lezen proef uitgevoerd.
Route 2
Bestand ophalen via een beveiligde HTTPS-link
- 1Laat het bronsysteem op een vaste HTTPS-link automatisch CSV, XLSX, JSON of XML klaarzetten. Het is geen Lotzano-inbox en derden kunnen daar niets uploaden.
- 2Beveilig de link met een aparte, intrekbare toegangscode en geef alleen leesrecht. Gebruik geen persoonswachtwoord.
- 3Zorg voor stabiele externe product- en variant-ID’s, SKU, naam, categorie, kleur, maat, prijs, valuta, voorraad, verkoopeenheid, MOQ en packinhoud waar van toepassing.
- 4Lotzano valideert bestandstype, grootte, structuur en voorbeeldregels. Onbekende categorieën, kleuren en maten worden niet automatisch toegevoegd maar wachten op mapping of Super Admin-beoordeling.
- 5De definitieve ophaalplanning wordt pas na de concrete bestandstest ingesteld; de leverancier hoeft geen UTC-tijd om te rekenen.
Route 3
Lotzano Partner API
Lokaal bewezen contract
- OpenAPI 3.1, versie
2026-08-30. - Maximaal 500 records en 2 MiB per batch.
- Bearer-token plus HMAC-SHA256 over
<timestamp>.<exacte body>. - Vijf minuten replayvenster, unieke event-ID en duurzame idempotente verwerking.
Nog vereist vóór echte aansluiting
- Publieke Lotzano-stagingomgeving met HTTPS.
- Goedgekeurde verbinding, subscription-ID en eenmalige veilige sleutellevering.
- Contract-, fout-, replay-, belasting- en herstelproeven van de concrete partnerimplementatie.
- Geen productiegegevens voordat die certificeringsstappen groen zijn.
Wanneer automatisch koppelen niet kan
Als het systeem geen veilige online API, geen door het bedrijf beheerde HTTPS-bestandslink en geen IT-partnerintegratie kan bieden, dan kan Lotzano het nu niet automatisch koppelen. Gebruik in dat geval de gecontroleerde CSV/XLSX-import. We markeren een onbewezen route nooit als werkend.
