Stap-voor-stap handleiding: Lightspeed PIM koppeling instellen

Deze handleiding begeleidt Lightspeed-gebruikers bij het integreren van een Product Information Management (PIM) systeem. Leer hoe u uw omgevingen voorbereidt, attributen configureert, data mapt en doorlopende synchronisatie instelt voor efficiënt productdatabeheer. Optimaliseer uw e-commerce activiteiten door productinformatie te centraliseren en te verrijken.

Inleiding tot PIM en Lightspeed integratie

Product Information Management (PIM) centraliseert alle productgerelateerde data, waardoor het de enige bron van waarheid wordt voor uw e-commerce activiteiten. Voor Lightspeed-gebruikers biedt een PIM-systeem aanzienlijke voordelen door ervoor te zorgen dat productdata consistent, accuraat en direct beschikbaar is via alle verkoopkanalen. Deze centralisatie verbetert de datakwaliteit, vermindert handmatige fouten en versnelt de time-to-market voor nieuwe producten. Door productbeschrijvingen, specificaties, afbeeldingen en andere attributen binnen een PIM te verrijken, kunnen Lightspeed webshops een aantrekkelijkere en informatievere winkelervaring bieden aan klanten.

Veel Lightspeed webshops ondervinden veelvoorkomende uitdagingen bij het beheren van hun productdata. Data bevindt zich vaak in verschillende systemen, zoals spreadsheets, ERP's of leveranciersportalen, wat leidt tot inconsistenties en verouderde informatie. Handmatige data-invoer is foutgevoelig en wordt tijdrovend naarmate productcatalogi groeien. Het beheren van productinformatie voor meerdere talen, valuta's of verkoopkanalen compliceert de operatie verder, wat efficiënte productlanceringen en updates belemmert. Deze knelpunten in databeheer kunnen bedrijfsprocessen vertragen en de klanttevredenheid beïnvloeden.

Het integreren van een PIM-systeem met Lightspeed stroomlijnt deze processen. Deze tutorial beschrijft de stappen die nodig zijn om uw PIM te koppelen aan uw Lightspeed webshop. Het algehele proces omvat het voorbereiden van uw data-omgeving, het configureren van productattributen binnen de PIM, het nauwkeurig mappen van deze attributen naar de datastructuur van Lightspeed, het uitvoeren van een initiële import van uw productcatalogus en het opzetten van doorlopende synchronisatie om alle data automatisch up-to-date te houden. Het volgen van deze stappen zorgt voor een robuuste en efficiënte stroom van productinformatie, wat uw e-commerce activiteiten optimaliseert.

Voorbereiding van uw Lightspeed en PIM omgeving

Voordat u Lightspeed integreert met een PIM-systeem, is het essentieel om beide omgevingen voor te bereiden. Begin met het genereren of verkrijgen van de benodigde API keys vanuit uw Lightspeed eCom-backend. Navigeer naar "Instellingen" > "Tools" > "API" om een nieuwe API key aan te maken. Wijs bij het aanmaken van de key specifieke permissies toe die het PIM-systeem in staat stellen productdata te lezen en te schrijven, inclusief productdetails, varianten, afbeeldingen en categorieën. Door alleen de vereiste permissies toe te kennen, minimaliseert u beveiligingsrisico's. Documenteer deze keys veilig, aangezien ze programmatische toegang tot uw Lightspeed-winkel bieden.

Voer vervolgens een initiële data-audit uit binnen uw Lightspeed-omgeving. Deze audit helpt u de bestaande productdatastructuren, attribuutsets en categoriehiërarchieën te begrijpen. Controleer hoe producttitels, beschrijvingen, SKU's, prijzen en voorraad momenteel worden beheerd. Identificeer eventuele aangepaste velden of attributen die al in gebruik zijn. Deze stap is cruciaal voor het later nauwkeurig mappen van gegevens en voor het bepalen welke gegevens verrijking of standaardisatie nodig hebben binnen het PIM. Inzicht in uw huidige datalandschap voorkomt mappingfouten en zorgt voor een soepele overgang.

Stel tegelijkertijd uw PIM-account in en definieer de fundamentele structuur voor uw productcatalogus. Dit omvat het aanmaken van productfamilies, attribuutgroepen en initiële attributen die aansluiten bij uw bedrijfsbehoeften en de gegevens die tijdens uw Lightspeed-audit zijn geïdentificeerd. Als Lightspeed bijvoorbeeld "Kleur" en "Maat" gebruikt als variantopties, zorg er dan voor dat deze attributen in uw PIM zijn gedefinieerd. WISEPIM biedt flexibele attribuutcreatie en categorisatie, wat helpt bij het vanaf het begin logisch structureren van gegevens. Creëer een duidelijke producthiërarchie die uw Lightspeed-categorieën weerspiegelt of verbetert.

Zorg er tot slot voor dat alle benodigde gebruikersrollen en permissies correct zijn geconfigureerd in zowel Lightspeed als uw PIM-systeem. Controleer in Lightspeed of de gebruiker die aan de API key is gekoppeld, de juiste toegangsniveaus heeft. Stel binnen het PIM gebruikersaccounts in voor teamleden die productdata zullen beheren, en wijs rollen toe die passende lees-, schrijf- of goedkeuringspermissies verlenen. Correct permissiebeheer voorkomt ongeautoriseerde datawijzigingen en handhaaft de data-integriteit over beide platforms heen.

PIM-kanalen en attributen configureren voor Lightspeed

Voordat u uw PIM integreert met Lightspeed, creëert u een specifiek Lightspeed verkoopkanaal binnen uw PIM-oplossing. Dit kanaal fungeert als een specifieke uitvoerconfiguratie, waarmee u productdata nauwkeurig kunt afstemmen op de vereisten van Lightspeed. Door Lightspeed-data binnen een eigen kanaal te isoleren, handhaaft u de data-integriteit over al uw verkoopplatformen heen en zorgt u ervoor dat Lightspeed alleen de relevante en correct geformatteerde informatie ontvangt. Deze opzet voorkomt dataconflicten en stroomlijnt het synchronisatieproces, omdat het PIM precies weet welke attributen en waarden het moet voorbereiden voor Lightspeed.

Definieer en structureer vervolgens uw productattributen in het PIM, zodat deze aansluiten bij het verwachte datamodel van Lightspeed. Essentiële attributen omvatten doorgaans Productnaam, Beschrijving, Prijs, Voorraad en Afbeeldingen. Naast deze basisattributen, overweegt u attributen zoals SKU, EAN, Merk, Kleur, Materiaal en Gewicht. Het is cruciaal om de verschillende attribuuttypen in uw PIM te begrijpen: Tekst voor korte beschrijvingen of namen, Rich Text voor gedetailleerde productbeschrijvingen met opmaak, Nummer voor prijzen en voorraadniveaus, Boolean voor waar/onwaar-vlaggen (bijv. 'Is nieuw product'), en Media voor productafbeeldingen en video's. Elk PIM-attribuuttype moet logisch vertalen naar een overeenkomstig veld in Lightspeed om een nauwkeurige gegevensoverdracht te garanderen.

Maak gebruik van de mogelijkheden van uw PIM om kanaalspecifieke attribuutvariaties te beheren. Een productbeschrijving die geschikt is voor een printcatalogus kan bijvoorbeeld te lang zijn voor een Lightspeed productpagina. Uw PIM moet u in staat stellen een kortere, kanaalspecifieke Lightspeed Beschrijving attribuut te definiëren. Op dezelfde manier heeft u mogelijk verschillende prijsstrategieën of afbeeldingsvereisten voor Lightspeed in vergelijking met andere kanalen. PIM-oplossingen zoals WISEPIM bieden robuuste functies voor het creëren en beheren van deze kanaalspecifieke overrides, zodat elk verkoopkanaal geoptimaliseerde productcontent ontvangt zonder data te dupliceren of handmatige aanpassingen te vereisen. Deze aanpak vermindert aanzienlijk de inspanning die nodig is om consistente en hoogwaardige productinformatie over al uw e-commerce platforms te handhaven.

Productdata voorbereiden voor Lightspeed

Een bedrijf moet de data voor een nieuw product, de 'Luxe Leren Portemonnee', voorbereiden voor zijn Lightspeed webshop. Het PIM bevat uitgebreide productinformatie, maar Lightspeed vereist specifieke attributen en formaten.

1. Creëer een dedicated 'Lightspeed Webshop' kanaal binnen het PIM-systeem.
2. Definieer kernattributen voor de 'Luxe Leren Portemonnee' in het PIM, waaronder: Productnaam (Tekst), Korte Beschrijving (Rich Text), Prijs (Nummer), Voorraad (Nummer), Hoofdafbeelding (Media), Kleur (Tekst) en Materiaal (Tekst).
3. Vul de productdata voor 'Luxe Leren Portemonnee' in met waarden zoals: 'Luxe Leren Portemonnee', 'Handgemaakt van premium Italiaans leer...', '€89.99', '150', 'luxe_portemonnee_hoofd.jpg', 'Zwart', 'Italiaans Leer'.
4. Map het PIM-attribuut Korte Beschrijving naar het hoofdproductbeschrijvingsveld van Lightspeed, en Hoofdafbeelding naar het primaire afbeeldingsveld van Lightspeed. Zorg ervoor dat andere attributen zoals Prijs en Voorraad zijn gemapt naar hun respectievelijke Lightspeed-velden.

Result: De productdata van de 'Luxe Leren Portemonnee' is correct gestructureerd en klaar voor export naar Lightspeed, waardoor alle vereiste velden aanwezig en correct geformatteerd zijn voor de webshop.

De Lightspeed API koppelen aan uw PIM

Om communicatie tussen uw PIM en Lightspeed tot stand te brengen, begint u met het invoeren van de benodigde API-gegevens in de integratie-instellingen van uw PIM. Dit doet u meestal in de sectie 'Connectors' of 'Integraties' van uw PIM-systeem. U moet de Lightspeed API key en API secret invoeren, of, als u OAuth 2.0 gebruikt, de Client ID en Client Secret die u vanuit uw Lightspeed-backend heeft verkregen. Zorg ervoor dat het juiste Lightspeed API-endpoint is geconfigureerd, wat doorgaans https://api.lightspeed.com/api/ is. De keuze van de authenticatiemethode, of dit nu een API key of OAuth 2.0 is, hangt af van de beveiligingseisen en de specifieke mogelijkheden van uw PIM- en Lightspeed-setup. OAuth 2.0 biedt verbeterde beveiliging via token-gebaseerde authenticatie, wat vaak vereist dat een redirect URL in Lightspeed wordt geconfigureerd om de initiële autorisatiestroom mogelijk te maken.

Nadat u de inloggegevens en het endpoint heeft geconfigureerd, voert u een verbindingstest uit binnen uw PIM. Deze test controleert of uw PIM de Lightspeed API succesvol kan bereiken en authenticeren met de opgegeven gegevens. Een succesvolle test bevestigt dat de fundamentele communicatieverbinding actief is, wat verdere gegevensuitwisseling mogelijk maakt. Als de verbindingstest mislukt, zijn veelvoorkomende problemen onder andere onjuiste API keys of secrets, een verkeerd geformatteerde API-endpoint URL, of onvoldoende API-permissies die in uw Lightspeed-account zijn toegekend. Firewallbeperkingen op de server van uw PIM kunnen ook uitgaande verbindingen naar Lightspeed blokkeren. Controleer de foutmeldingen van uw PIM en raadpleeg de Lightspeed API-documentatie voor specifieke foutcodes om verbindingsproblemen te diagnosticeren en op te lossen. WISEPIM biedt bijvoorbeeld gedetailleerde logging voor API-verbindingspogingen, wat helpt bij het vaststellen van de exacte oorzaak van een storing.

Dit JSON-fragment illustreert een typische configuratiestructuur voor het verbinden van een PIM met de Lightspeed API via OAuth 2.0. Het bevat het API-endpoint, de authenticatiemethode, clientgegevens, een redirect URI voor de autorisatiestroom en de gevraagde API-scopes (permissies).

json
{
"integrationName": "Lightspeed PIM Connector",
"apiEndpoint": "https://api.lightspeed.com/api/",
"authenticationMethod": "OAuth2.0",
"clientId": "YOUR_LIGHTSPEED_CLIENT_ID",
"clientSecret": "YOUR_LIGHTSPEED_CLIENT_SECRET",
"redirectUri": "https://yourpim.com/integrations/lightspeed/callback",
"scope": "products.read,products.write,categories.read"
}


Productdata mappen en transformeren

Nadat u uw PIM met Lightspeed heeft gekoppeld, definieert u hoe productdata tussen de twee systemen stroomt. Dit proces, dat datamapping heet, koppelt specifieke attributen in uw PIM aan de corresponderende velden in Lightspeed. Uw PIM-attribuut 'short_description' kan bijvoorbeeld direct gekoppeld worden aan het Lightspeed 'summary' veld, terwijl een 'long_description' attribuut naar Lightspeed's 'description' veld map. Een goed gedefinieerde mapping zorgt ervoor dat alle relevante productinformatie, van basisdetails tot rijke content, correct wordt weergegeven in uw Lightspeed webshop. Dit omvat ook het beheer van productvariaties, of SKU's. Elke variatie (bijv. een T-shirt in verschillende maten en kleuren) vereist specifieke attribuutmappings om ervoor te zorgen dat Lightspeed alle beschikbare opties en hun unieke details, zoals variatie-specifieke afbeeldingen of prijzen, correct weergeeft.

Datatransformatie-regels zijn essentieel om PIM-data aan te passen aan de specifieke vereisten van Lightspeed. Deze regels kunnen verschillende scenario's afhandelen, zoals het formatteren van numerieke waarden, het converteren van eenheden of het toepassen van conditionele logica. Een PIM kan bijvoorbeeld productgewicht in kilogram opslaan, maar Lightspeed vereist dit in gram; een transformatieregel converteert deze waarde tijdens de synchronisatie. Op dezelfde manier kunt u conditionele logica gebruiken om de zichtbaarheid van een product in Lightspeed in te stellen op basis van de voorraadstatus in de PIM. Geavanceerde PIM-systemen, zoals WISEPIM, bieden robuuste transformatie-engines waarmee u meerdere PIM-attributen kunt samenvoegen tot één Lightspeed-veld, zoals het combineren van 'brand' en 'model_number' om een complete producttitel te vormen. Dit zorgt voor dataconsistentie en nauwkeurigheid over de platforms heen.

Tot slot is het correct mappen en optimaliseren van media-assets cruciaal voor een aantrekkelijke productpresentatie. Afbeeldingen en video's die in uw PIM zijn opgeslagen, moeten worden gekoppeld aan de mediavelden van Lightspeed. Dit omvat het zorgen dat afbeeldings-URL's correct zijn gekoppeld en dat de assets voldoen aan de technische specificaties van Lightspeed voor grootte, resolutie en formaat. Uw PIM moet verschillende afbeeldingsweergaven (bijv. thumbnails, hoofdafbeeldingen, galerijafbeeldingen) beheren en de juiste URL's voor Lightspeed leveren. Het optimaliseren van deze assets voor webprestaties, zoals het comprimeren van afbeeldingen zonder kwaliteitsverlies, heeft directe invloed op de laadtijden van pagina's en de algehele gebruikerservaring in uw Lightspeed webshop.

Een product mappen met prijstransformatie en media

Een nieuw product 'Luxe Horloge' moet vanuit de PIM naar Lightspeed worden gepubliceerd. De PIM bevat de productnaam, een korte beschrijving, de prijs als decimaal getal (bijv. 1299.99) en een URL voor de hoofdafbeelding van het product.

1. Map het PIM-attribuut 'product_name' naar het Lightspeed-veld 'title'.
2. Map het PIM-attribuut 'short_description' naar het Lightspeed-veld 'summary'.
3. Map het PIM-attribuut 'retail_price_usd' naar het Lightspeed-veld 'price'. Pas een transformatieregel toe om het getal te formatteren naar twee decimalen met een komma als decimaalscheidingsteken (bijv. 1299.99 wordt '1.299,99').
4. Map het PIM-attribuut 'main_image_url' naar het Lightspeed-veld 'images[0].src' om ervoor te zorgen dat de primaire afbeelding wordt weergegeven.

Result: Het product 'Luxe Horloge' wordt in Lightspeed aangemaakt met de juiste titel, een geformatteerde prijs van '1.299,99', en de hoofdafbeelding wordt weergegeven.

Dit JSON-fragment illustreert een vereenvoudigde mappingconfiguratie. Het toont directe mappings voor productnaam en korte beschrijving. Het attribuut 'retail_price_usd' bevat een transformatieregel om het getal te formatteren naar twee decimalen, met een punt als decimaalscheidingsteken en een komma als duizendtallen-scheidingsteken, geschikt voor veel internationale locales. De 'main_image_url' wordt gemapt naar de eerste afbeeldingspositie in Lightspeed.

json
{
"product_mappings": [
{
"pim_attribute": "product_name",
"lightspeed_field": "title"
},
{
"pim_attribute": "short_description",
"lightspeed_field": "summary"
},
{
"pim_attribute": "retail_price_usd",
"lightspeed_field": "price",
"transformation": {
"type": "format_number",
"parameters": {
"decimals": 2,
"decimal_separator": ".",
"thousands_separator": ","
}
}
}
],
"media_mappings": [
{
"pim_attribute": "main_image_url",
"lightspeed_field": "images[0].src"
}
]
}


Initiële datasynchronisatie uitvoeren

Nadat u uw PIM-kanaal heeft geconfigureerd, attributen heeft gemapt en de API-verbinding tot stand heeft gebracht, is de volgende stap het uitvoeren van de initiële volledige datasynchronisatie. Dit proces stuurt alle geselecteerde productdata vanuit uw PIM-systeem naar uw Lightspeed-omgeving. Start deze synchronisatie vanuit het integratiedashboard van uw PIM of via de specifieke Lightspeed-kanaalinstellingen. Afhankelijk van de omvang van uw productcatalogus kan deze eerste synchronisatie enkele minuten tot meerdere uren duren. Gedurende deze periode verwerkt uw PIM-systeem elk product, past het de gedefinieerde mappingregels toe en stuurt het de gegevens via de Lightspeed API.

Het monitoren van het synchronisatieproces is cruciaal. De meeste PIM-systemen, waaronder WISEPIM, bieden gedetailleerde logboeken of een realtime dashboard waar u de status van de synchronisatie kunt volgen. Let goed op eventuele fouten, waarschuwingen of overgeslagen items. Veelvoorkomende problemen zijn onder meer ongeldige attribuutwaarden, ontbrekende verplichte velden in Lightspeed, of het bereiken van API rate limits. Pak deze problemen onmiddellijk aan door de datakwaliteit in het PIM te controleren, uw mapping aan te passen of de Lightspeed API-documentatie te raadplegen voor specifieke foutcodes. Het begrijpen van de oorzaak van elke fout voorkomt vergelijkbare problemen bij toekomstige synchronisaties.

Zodra de synchronisatie is voltooid, verifieert u de geïmporteerde productdata direct in uw Lightspeed backoffice. Navigeer naar de sectie 'Producten' en inspecteer een representatieve selectie van producten. Controleer kerndetails zoals productnamen, beschrijvingen, prijzen, voorraadniveaus en categorietoewijzingen. Controleer ook of productafbeeldingen correct zijn gekoppeld en weergegeven, en of varianten (bijv. maten, kleuren) correct zijn gestructureerd. Na verificatie in de backoffice controleert u de live Lightspeed webshop om ervoor te zorgen dat de producten er voor klanten uitzien zoals verwacht. Let op opmaak, beeldkwaliteit en algehele presentatie.

Eventuele inconsistenties of ontbrekende datapunten die tijdens de verificatie worden geïdentificeerd, vereisen onmiddellijke actie. Als u wijdverspreide problemen constateert, pauzeer dan verdere synchronisatie en controleer uw PIM-kanaalconfiguratie en datamapping opnieuw. Voor geïsoleerde problemen kunt u de gegevens mogelijk direct in het PIM corrigeren en een gedeeltelijke synchronisatie voor specifieke producten activeren. Het documenteren van deze initiële uitdagingen helpt bij het verfijnen van uw integratie-instellingen en zorgt voor een soepeler doorlopend databeheer. Een succesvolle initiële synchronisatie legt de basis voor accurate en consistente productinformatie over al uw verkoopkanalen.

Continue synchronisatie en onderhoud

Na de initiële datasynchronisatie vereist het actueel en nauwkeurig houden van productinformatie in Lightspeed doorlopende, geautomatiseerde processen. Configureer uw PIM-systeem om incrementele updates uit te voeren, waarbij alleen wijzigingen in productdata sinds de laatste synchronisatie worden overgedragen. Deze aanpak minimaliseert API-aanroepen en optimaliseert de prestaties, zodat uw Lightspeed-catalogus de meest recente productdetails uit het PIM weerspiegelt zonder volledige data-herladingen. Implementeer webhooks voor real-time of bijna real-time dataflow, waarbij het PIM updates naar Lightspeed pusht onmiddellijk na een wijziging. Voor minder tijdgevoelige data kunt u taken plannen die met regelmatige intervallen, zoals dagelijks of elk uur, batch-updates verwerken.

Proactieve monitoring is cruciaal voor een stabiele integratie. Controleer regelmatig de synchronisatielogs en foutrapporten die door uw PIM-systeem worden gegenereerd. Deze logs bieden gedetailleerd inzicht in succesvolle updates, overgeslagen items en eventuele fouten, inclusief specifieke foutmeldingen van de Lightspeed API. Pak eventuele gerapporteerde fouten snel aan om data-discrepanties of onvolledige productvermeldingen te voorkomen. Veelvoorkomende problemen zijn onder meer ongeldige attribuutwaarden, ontbrekende verplichte velden of API rate limits. Het instellen van een routine voor het controleren van deze rapporten helpt bij het identificeren en oplossen van problemen voordat ze uw e-commerce activiteiten beïnvloeden.

Voer periodieke data-audits rechtstreeks in Lightspeed uit om de data-integriteit en consistentie te verifiëren. Vergelijk een steekproef van productdata in Lightspeed met de brondata in uw PIM om ervoor te zorgen dat alle attributen, afbeeldingen en beschrijvingen nauwkeurig worden weergegeven. Deze stap helpt bij het opsporen van subtiele verschillen die mogelijk geen synchronisatiefout veroorzaken, maar wel de klantervaring of vindbaarheid kunnen beïnvloeden. PIM-oplossingen zoals WISEPIM bieden functionaliteiten zoals datakwaliteitsdashboards en versiebeheer, die het identificeren en corrigeren van inconsistenties stroomlijnen, waardoor deze audits efficiënter worden. Regelmatig onderhoud van uw PIM-Lightspeed-integratie zorgt ervoor dat uw productdata een betrouwbaar bezit blijft voor uw webshop.

Veelvoorkomende problemen oplossen

Bij de integratie van een PIM-systeem met Lightspeed kunnen diverse problemen ontstaan die een vlotte gegevensstroom belemmeren. Inzicht in veelvoorkomende problemen en hun oplossingen helpt bij het handhaven van een efficiënte productdataworkflow. Een veelvoorkomende uitdaging zijn de API rate limits van Lightspeed. Lightspeed legt limieten op aan het aantal API-verzoeken dat een applicatie binnen een bepaalde tijd kan doen om de systeemstabiliteit te waarborgen. Het overschrijden van deze limieten resulteert in een "429 Too Many Requests" HTTP-statuscode. Om dit op te lossen, implementeert u een exponential backoff-strategie in de integratielogica van uw PIM, die mislukte verzoeken na toenemende intervallen opnieuw probeert. Het groeperen van productupdates en -creaties in minder, grotere verzoeken vermindert ook het totale aantal API-calls. Raadpleeg de API-documentatie van Lightspeed voor specifieke rate limit-details om uw verzoekpatronen te optimaliseren.

Data validatiefouten zijn een andere veelvoorkomende integratiehorde. Deze treden op wanneer de gegevens die vanuit het PIM worden verzonden, niet voldoen aan de specifieke vereisten van Lightspeed voor een bepaald veld. Voorbeelden zijn het verzenden van een tekststring naar een veld dat een numerieke waarde verwacht, het opgeven van een waarde die een tekenlimiet overschrijdt, of het weglaten van een verplicht veld. De integratielogs van uw PIM geven doorgaans gedetailleerde foutmeldingen van Lightspeed, die het problematische attribuut en de reden van de fout aangeven. Om problemen op te lossen, vergelijkt u het datatype en de inhoud van het PIM-attribuut met de veldspecificaties van Lightspeed. Pas datatransformatie-regels binnen uw PIM aan om ervoor te zorgen dat de gegevens voldoen aan de verwachtingen van Lightspeed. Als Lightspeed bijvoorbeeld een decimaal voor 'prijs' vereist, zorg er dan voor dat het PIM eventuele komma-gescheiden waarden omzet naar punt-gescheiden decimalen.

Problemen met afbeeldingensynchronisatie kunnen zich manifesteren als kapotte afbeeldingslinks, incorrecte afbeeldingsformaten of afbeeldingen die niet verschijnen op productpagina's. Lightspeed heeft vaak specifieke vereisten voor afbeeldings-URL's (bijvoorbeeld publiekelijk toegankelijk, specifieke bestandstypen zoals JPG of PNG). Controleer of de afbeeldings-URL's die in uw PIM zijn opgeslagen correct zijn en verwijzen naar toegankelijke bronnen. Zorg ervoor dat uw PIM is geconfigureerd om afbeeldingen te verwerken en te exporteren in formaten die compatibel zijn met Lightspeed. Als afbeeldingen extern worden gehost, bevestig dan dat de hosting-server toegang toestaat vanaf de servers van Lightspeed. WISEPIM kan bijvoorbeeld worden geconfigureerd om afbeeldingen automatisch te verkleinen en te converteren om te voldoen aan kanaalspecifieke vereisten, wat veel van deze problemen voorkomt.

Tot slot kunnen verbindingsproblemen de gehele integratie verstoren. Deze kunnen voortkomen uit incorrecte API-gegevens, netwerkfirewallbeperkingen of tijdelijke service-onderbrekingen. Controleer eerst of de API key en secret die in uw PIM zijn geconfigureerd voor de Lightspeed-verbinding correct zijn en de benodigde permissies hebben. Controleer uw netwerkinfrastructuur op firewalls of proxyservers die uitgaande verbindingen van uw PIM-server naar de API-endpoints van Lightspeed mogelijk blokkeren. Als alle referenties en netwerkinstellingen correct lijken, kan een tijdelijke storing aan de kant van het PIM of Lightspeed de oorzaak zijn; controleer de servicestatuspagina's voor updates.

Een data validatiefout voor productgewicht oplossen

U synchroniseert productupdates van uw PIM naar Lightspeed. Eén product, "Organic Cotton T-shirt", kan niet worden bijgewerkt en de PIM-logs tonen een fout met betrekking tot het 'weight'-attribuut.

1. Controleer PIM-integratielogs: Open de integratielogs van uw PIM voor het Lightspeed-kanaal. U vindt een foutmelding vergelijkbaar met "Validation error: 'weight' expects a numeric value, received '0.25 kg'."
2. Controleer Lightspeed-attribuutvereisten: Raadpleeg de API-documentatie van Lightspeed of uw Lightspeed-productinstellingen. U bevestigt dat het 'weight'-veld in Lightspeed een decimaal getal (bijv. 0.25) zonder eenheden verwacht.
3. Pas PIM-datatransformatie aan: Ga naar de sectie voor datamapping of -transformatie in uw PIM voor het 'weight'-attribuut. Pas de regel aan om het achtervoegsel " kg" te verwijderen en de waarde om te zetten naar een floating-point getal. Een transformatie kan bijvoorbeeld "0.25 kg" omzetten naar "0.25".
4. Synchroniseer het product opnieuw: Activeer een resynchronisatie voor het "Organic Cotton T-shirt" vanuit uw PIM naar Lightspeed.

Result: Het product "Organic Cotton T-shirt" wordt succesvol bijgewerkt in Lightspeed, met het 'weight'-attribuut correct ingesteld op 0.25.