Wat zijn lookups en waarom zijn ze belangrijk?
Lookups in GelatoConnect fungeren als vertaaltabellen die gegevens uit jouw systeem omzetten naar formaten die Gelato kan begrijpen. Ze zijn essentieel voor een naadloze API-integratie, vooral voor het in kaart brengen van:
Product-ID's/SKU's: Zet je gepersonaliseerde productcodes om naar de gestandaardiseerde product-UID's van Gelato
Verzendmethoden: Koppel je verzendmethoden aan de vervoerderscodes van Gelato
Vervoerdersidentificaties: Vertaal vervoerdersnamen tussen systemen
Andere gepersonaliseerde koppelingen: Elke waarde die je steeds hetzelfde wilt vertalen tussen systemen
Zonder lookups kunnen bestellingen mislukken als de codes in jouw systeem niet overeenkomen met wat Gelato verwacht. Lookups zorgen ervoor dat alles netjes op elkaar aansluit, zodat je bestellingen altijd soepel worden verwerkt.
Belangrijkste voordelen van het gebruik van Lookups
✅ Lookups zorgen ervoor dat gegevens gestandaardiseerd zijn voor het systeem van Gelato. Ze voorkomen verschillen tussen klantspecifieke en Gelato-compatibele waarden.
✅ Ze zorgen ervoor dat er altijd een reservewaarde is, zodat je geen fouten krijgt als er iets ontbreekt.
✅ Bulk CSV-upload maakt het makkelijker om grote hoeveelheden koppelingen te beheren.
Lookups instellen: stap-voor-stap handleiding
1. Ga naar de Opzoekpagina
Log in op je GelatoConnect-account
Navigeer naar Workflow > Orderontvangst in het linkermenu
Klik op Lookups om bestaande koppelingen te bekijken of nieuwe aan te maken.
2. Maak een nieuwe opzoektabel
Optie A: Handmatig aanmaken
Klik op de knop Maken bovenaan de pagina.
Voer een beschrijvende Naam in voor je opzoeking (bijv. \"SKU-mapping van producten\")
Selecteer de Klant waarop deze zoekopdracht van toepassing is uit de vervolgkeuzelijst.
Voeg een Beschrijving toe (optioneel maar aanbevolen) om het doel van de zoekopdracht te verduidelijken.
Voer een Sjabloonveld in - dit is de referentie die in de sjabloonmapper-code wordt gebruikt om toegang te krijgen tot deze opzoekopdracht. Het opzoeksjabloonveld moet worden omgeven door dubbele accolades (bijv., ##{{sku}}).
Voeg koppelingen toe door op het +-icoon te klikken:
Sleutel: Vul de waarde in vanuit je eigen systeem (bijvoorbeeld je product-SKU of code).
Waarde: Voer de bijbehorende Gelato-waarde in (bijv. het product-UID van Gelato).
Herhaal dit voor alle waarden die je moet koppelen.
Klik op Wijzigingen opslaan om de configuratie toe te passen.
Optie B: bulk importeren (aanbevolen bij veel waarden)
Maak een Excel- of CSV-bestand met twee kolommen:
Kolom A: koptekst "Lookup key" gevolgd door de waarden uit jouw systeem
Kolom B: Koptekst "Product UID" gevolgd door de bijbehorende waarden van Gelato
Klik op Maken om een nieuwe zoekopdracht te starten
Vul de naam, klant, omschrijving en sjabloonveld in zoals hierboven
Klik op Importeren in plaats van handmatig gegevens toe te voegen
Selecteer je voorbereide Excel/CSV-bestand
Bekijk de geïmporteerde koppelingen
Klik op Wijzigingen opslaan om de installatie te voltooien
Videogids
3. Implementeer lookups in je sjabloonmapper
Nadat je je opzoektabellen hebt ingesteld, moet je ze verwijzen in je template mapper-code (met Jinja2):
Ga naar Workflow > Order Intake > Sjablonen
Bewerk de sjabloon waar je lookups wilt gebruiken
In het gedeelte Template Mapper kun je de
lookups()functie gebruiken om toegang te krijgen tot je koppelingstabellenBasissyntaxis:
##{{ lookups({\"alias\": value_to_lookup}, strict=False, default=\"fallback_value\")|js }}
Voorbeeld 1: Product UID-koppeling
{% set productUid = lookups({"sku": item.sku}, strict=False, default=item.sku) %}"productUid": ##{{ productUid|js }},Voorbeeld 2: verzendmethode koppelen
"shipmentMethodUid": ##{{ lookups({"shipping_code": order.shipping.method}, strict=False, default="normal")|js }},De parameter strict=False zorgt ervoor dat de code geen foutmelding geeft als er geen overeenkomst wordt gevonden, en de parameter default biedt een terugvalwaarde.
Je opzoekingen testen
Test je zoekopdrachten altijd even voordat je ze echt gaat gebruiken:
Ga naar je template in het gedeelte Templates
Navigeer naar het tabblad Template Testing
Gebruik het testformulier om te controleren of je zoekopdrachten de waarden correct vertalen
Controleer of ontbrekende sleutels correct je standaardwaarde gebruiken
Plaats een testbestelling en controleer of de bestelling wordt verwerkt zoals verwacht
Veelvoorkomende toepassingen
Product SKU naar Gelato UID Mapping
Koppel je interne productcodes aan de product UID's van Gelato:
{% set productUid = lookups({\"sku\": item.sku}, strict=False, default=item.sku) %}\"productUid\": ##{{ productUid|js }},
Verzendmethode Vertaling
Zet je verzendmethode namen om naar Gelato's verzendmethode UID's:
{% set shipMethod = lookups({\"shipping_method\": order.shipping_type}, strict=False, default=\"normal\") %} \"shipmentMethodUid\": ##{{ shipMethod|js }},
Vervoerder mapping
Koppel vervoerderidentificaties tussen systemen:
{% set carrier = lookups({\"carrier_code\": shipment.carrier}, strict=False, default=shipment.carrier) %} \"carrier\": ##{{ carrier|js }},
Landspecifieke staatscode-toewijzing
Ga slim om met bijzondere gevallen voor provinciecodes in bepaalde landen:
{% set stateCode = shipTo.state %}{% if shipTo.country|upper == \"US\" %} {% set stateCode = lookups({\"us_state\": shipTo.state}, strict=False, default=shipTo.state) %}{% endif %}\"state\": ##{{ stateCode|js }},
Problemen oplossen bij zoekopdrachten
Als je zoekopdrachten niet werken zoals verwacht:
Controleer op exacte overeenkomsten: Sleutels zijn hoofdlettergevoelig en moeten precies overeenkomen met wat er in je API-gegevens staat
Controleer sjabloonveldnamen: Zorg ervoor dat het sjabloonveld in je zoekopdracht overeenkomt met wat er in je sjabloon wordt gebruikt
Gebruik
strict=False: Dit voorkomt fouten wanneer een zoeksleutel ontbreektAltijd standaardwaarden instellen: Stel geschikte standaardwaarden in om ontbrekende koppelingen af te handelen
Bekijk de volledige aanvraaggegevens: Gebruik de pagina Verzoeken om de gegevens die worden verwerkt te bekijken
Beste praktijken
Gebruik beschrijvende namen: Geef zoekopdrachten duidelijke namen die hun doel aangeven
Beschrijvingen toevoegen: Voeg details toe over wanneer en waar elke opzoeking wordt gebruikt
Houd je mappings actueel: kijk regelmatig je lookups na en werk ze bij als producten of diensten veranderen
Gebruik bulk import voor grote datasets: Bespaar tijd door lookups in bulk te importeren
Grondig testen: Test lookups altijd met zowel overeenkomende als niet-overeenkomende waarden
Documenteer je zoekopdrachten: Houd bij welke zoekopdrachten in welke sjablonen worden gebruikt
Wil je meer informatie?
Nu je lookups hebt ingesteld voor je API-integratie, wil je misschien:
Lees meer over het maken van een sjabloon voor orderontvangst
Postbacks instellen om je klanten te updaten