Naar de hoofdinhoud

[Order Intake - GCW] Lookups instellen voor API-integratie

Geschreven door Kyle Sawyer

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

✅ Standaardisatie: Zorgt voor gegevensconsistentie tussen jouw systeem en Gelato
✅ Foutpreventie: vermindert fouten door niet-overeenkomende id’s
✅ Fallback-beveiliging: zorgt voor standaardwaarden als er geen exacte overeenkomsten worden gevonden
✅ Schaalbaarheid: maakt het eenvoudiger om nieuwe producten of verzendmethoden toe te voegen en te beheren
✅ Onderhoud: Gecentraliseerd beheer van mappings voor eenvoudigere updates

Lookups instellen: stap-voor-stap handleiding

1. Ga naar de Opzoekpagina

  1. Log in op je GelatoConnect-account

  2. Navigeer naar Workflow > Orderontvangst in het linkermenu

  3. Klik op Lookups om bestaande koppelingen te bekijken of nieuwe aan te maken.

2. Maak een nieuwe opzoektabel

Optie A: Handmatig aanmaken

  1. Klik bovenaan de pagina op de knop Create

  2. Voer een beschrijvende Naam in voor je opzoeking (bijv. \"SKU-mapping van producten\")

  3. Selecteer de Customer waarop deze lookup van toepassing is in de vervolgkeuzelijst

  4. Voeg een beschrijving toe (optioneel maar aanbevolen) om te helpen het doel van de lookup te bepalen

  5. Voer een templateveld in - dit is de verwijzing die in de template mapper-code wordt gebruikt om deze lookup te benaderen

  6. Voeg koppelingen toe door op het +-icoon te klikken:

    • Sleutel: Vul de waarde uit je eigen systeem in (bijvoorbeeld je product-SKU of -code)

    • Waarde: Vul de bijbehorende Gelato-waarde in (bijv. de product-UID van Gelato)

  7. Herhaal dit voor alle waarden die je moet koppelen

  8. Klik op Wijzigingen opslaan om de configuratie toe te passen

Optie B: bulk importeren (aanbevolen bij veel waarden)

  1. Maak een Excel- of CSV-bestand met twee kolommen:

    • Kolom A: kop "lookup key" gevolgd door de waarden van je eigen systeem

    • Kolom B: kop "product UID" gevolgd door de bijbehorende waarden van Gelato

  2. Klik op Maken om een nieuwe zoekopdracht te starten

  3. Vul de naam, klant, omschrijving en sjabloonveld in zoals hierboven

  4. Klik op Importeren in plaats van handmatig gegevens toe te voegen

  5. Selecteer je voorbereide Excel/CSV-bestand

  6. Bekijk de geïmporteerde koppelingen

  7. Klik op Wijzigingen opslaan om de installatie te voltooien

3. Implementeer lookups in je sjabloonmapper

Nadat je je opzoektabellen hebt ingesteld, moet je ze verwijzen in je template mapper-code (met Jinja2):

  1. Ga naar Workflow > Order Intake > Sjablonen

  2. Bewerk de sjabloon waar je lookups wilt gebruiken

  3. In het gedeelte Template Mapper kun je de lookups() functie gebruiken om toegang te krijgen tot je koppelingstabellen

  4. Basissyntaxis: ##{{ 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:

  1. Ga naar je template in het gedeelte Templates

  2. Navigeer naar het tabblad Template Testing

  3. Gebruik het testformulier om te controleren of je zoekopdrachten de waarden correct vertalen

  4. Controleer of ontbrekende sleutels correct je standaardwaarde gebruiken

  5. 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 ontbreekt

  • Altijd 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

Volgende stappen

Nu je lookups hebt ingesteld voor je API-integratie, wil je misschien:

  1. Meer leren over het maken van een template voor Order intake

  2. Ontdek geavanceerde technieken voor template mapper

  3. Automatische Postbacks instellen om klanten te updaten

Meer hulp nodig? Neem contact op met ons ondersteuningsteam via [email protected]

Gerelateerde artikelen
Was dit een antwoord op uw vraag?