Versie 2026-09-01

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.

Shopify-logo

Directe toestemming

Shopify

Officiële Shopify-installatie
App installeren en toestaan
Lotzano-concept
  1. 1Start bij Lotzano Connect en kies Shopify. Je hoeft geen winkeladres, Client ID, secret of Admin API-token op te zoeken.
  2. 2Klik op ‘Open Shopify en installeer de app’. Lotzano opent uitsluitend de officiële Shopify-installatiepagina; controleer dat de app ‘Lotzano Connect’ heet.
  3. 3Log in als bevoegde Shopify-beheerder, controleer de gevraagde rechten en kies Installeren of Toestaan. Shopify levert de permanente winkelidentiteit rechtstreeks aan Lotzano.
  4. 4Shopify keert terug naar de Lotzano-conceptkoppeling. Voer daar de verbindingstest, mapping en voorbeeldimport uit. Er gaat nog niets live zonder afzonderlijke activering.
Huidige vrijgave: de API-adapter is met een echte Shopify-development-store beproefd voor producten, varianten, voorraad en een testorder. Nieuwe publieke installaties blijven geblokkeerd totdat de Sales Channel-opzet, stabiele HTTPS-staging, verplichte privacywebhooks en Shopify-review aantoonbaar zijn afgerond.
WooCommerce-logo

Toestemming plus gratis uitbreiding

WooCommerce

WooCommerce-webshop
Toestaan en uitbreiding activeren
Lotzano-concept
  1. 1Controleer dat de webshop via een geldig HTTPS-adres bereikbaar is en dat WooCommerce actief is.
  2. 2Vul alleen het openbare webshopadres in. Je hoeft geen Consumer Key of Consumer Secret op te zoeken of te kopiëren.
  3. 3Lotzano opent de officiële /wc-auth/v1/authorize-pagina. Log in als WooCommerce-beheerder en keur de read_write-toegang goed.
  4. 4WooCommerce geeft de sleutels rechtstreeks terug aan Lotzano. Download daarna hieronder de gratis Lotzano Connect-uitbreiding.
  5. 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.
  6. 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.
Waarom deze uitbreiding? WooCommerce zelf heeft geen uniforme structuur voor deelleveringen, tracking en fysieke retourstatus. De uitbreiding voegt alleen die Lotzano-velden en een eenvoudige beheerpagina toe. Zij werkt uitsluitend op orders die aantoonbaar door Lotzano zijn aangemaakt en maakt nooit zelfstandig een refund aan.
PrestaShop-logo

Webservice-sleutel

PrestaShop 8/9

  1. 1Open PrestaShop Back Office → Advanced Parameters → Webservice en schakel de webservice in.
  2. 2Voeg een aparte sleutel met een herkenbare omschrijving zoals ‘Lotzano Connect’ toe.
  3. 3Geef alleen GET-rechten op configurations, currencies, products, combinations, categories, product_option_values, product_options en stock_availables.
  4. 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.
Minimale rechten: geef geen DELETE- of onnodige schrijfpermissies. Lotzano controleert eerst alleen lezen.
Officiële PrestaShop-documentatie
Odoo-logo

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.

  1. 1Maak voor langdurige automatisering een aparte botgebruiker met uitsluitend de benodigde product-, voorraad- en orderrechten.
  2. 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.
  3. 3Kopieer de sleutel direct; Odoo toont haar maar één keer. Vul haar uitsluitend in het beveiligde Lotzano-formulier in.
  4. 4Vul het Odoo HTTPS-adres in en alleen bij multi-database-hosting ook de databasenaam. Plan sleutelrotatie uiterlijk vóór de Odoo-vervaldatum.
Officiële Odoo 19-documentatie

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.

Kan worden geïmporteerd

Verplichte gegevens zijn aanwezig en categorie, kleur en maat passen bij de vaste Lotzano-waarden. De voorbeeldkaart krijgt een groen vinkje.

Nog geblokkeerd

De kaart toont waarom, bijvoorbeeld ontbrekend producttype, onbekende kleur of onduidelijk maatsysteem. Lotzano gokt niet en slaat het product niet ongemerkt over.

Bestaande koppeling veilig gepauzeerd

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

  1. 1Bekijk bij het probleem de precieze bronwaarde, het aantal geraakte producten en het genoemde voorbeeldproduct.
  2. 2Kies een passende bestaande Lotzano-categorie, kleur of maat. Die keuze wordt als herbruikbare vertaling voor dezelfde bronwaarde opgeslagen.
  3. 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’.
  4. 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.
  5. 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.
Belangrijk: klik niet alleen op ‘Ik heb dit opgelost’. Lotzano controleert de bron opnieuw. Een groen vinkje verschijnt pas wanneer de herhaalde controle de correctie daadwerkelijk kan lezen.

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

Officiële systeem-API
Alleen-lezen beoordeling
Klantspecifieke proef
  1. 1Geef de officiële naam en versie van het bronsysteem door.
  2. 2Deel het vaste HTTPS-basisadres van de API en de officiële online documentatielink.
  3. 3Geef alleen aan welk beveiligingstype wordt gebruikt. Stuur in deze eerste aanvraag nog geen token of wachtwoord.
  4. 4Lotzano controleert documentatie, limieten, paginering, wijzigingsmomenten en de betekenis van product-, variant-, voorraad-, prijs- en packvelden.
  5. 5Pas na een goedgekeurd ontwerp worden tijdelijke testcredentials veilig uitgegeven en wordt met echte voorbeelddata een alleen-lezen proef uitgevoerd.

Route 3

Lotzano Partner API

IT-partner
Ondertekende batches
Lotzano intake

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.