Hvad er lookups, og hvorfor betyder de noget?

Lookups i GelatoConnect fungerer som oversættelsestabeller, der omdanner data fra dit system til formater, som Gelato kan forstå. De er uundværlige for en gnidningsfri API-integration, især når det gælder mapping:

Produkt-ID'er/VARENUMRE: Omdan dine tilpassede produkt-id'er til Gelatos standardiserede produkt UID'er
Forsendelsesmetoder: Match dine forsendelsesmetoder med Gelatos transportørkoder
Transportør-id'er: Oversæt transportørnavne mellem systemer
Andre tilpassede mappinger: Alle værdier, der skal oversættes ensartet mellem systemer

Uden opslag kan ordrer gå galt, hvis dit systems ID’er ikke matcher de værdier, Gelato forventer. Opslag hjælper med at bygge bro over det hul, så dine ordrer altid bliver behandlet korrekt.

De største fordele ved at bruge lookups

✅ Lookups sikrer, at data er ensartede til Gelatos system. Det forhindrer, at der opstår forskelle mellem kundespecifikke og Gelato-kompatible værdier.
✅ De giver mulighed for at bruge en reserveværdi, så du undgår fejl, hvis der mangler en kobling.
✅ Bulk CSV-upload gør det nemmere for dig at håndtere store mængder mapping på én gang.

Sådan opsætter du opslag: En trin-for-trin guide

1. Gå til Lookups-siden

Log ind på din GelatoConnect-konto
Gå til Workflow > Order Intake i menuen til venstre
Klik på Lookups for at se eksisterende mappinger eller oprette nye

2. Opret en ny opslagstabel

Mulighed A: Opret manuelt

Klik på Opret-knappen øverst på siden.
Indtast et beskrivende Navn til din opslagstabel (f.eks. "Produkt VARENUMMER Mapping")
Vælg den kunde, denne søgning skal gælde for, i rullemenuen.
Tilføj en beskrivelse (valgfrit, men anbefales) for at gøre det nemmere at forstå formålet med opslaget.
Indtast et skabelonfelt – det er den reference, du bruger i template mapper-koden for at få adgang til dette opslag. Skabelonfeltet til opslaget skal være omgivet af dobbelte krøllede parenteser (f.eks. ##{{sku}}).
Tilføj tilknytninger ved at klikke på +-ikonet:
- Nøgle: Indtast værdien fra dit system (for eksempel dit produkt VARENUMMER eller kode).
- Værdi: Indtast den tilsvarende Gelato-værdi (f.eks. Gelatos produkt UID).
Gentag for alle værdier, der skal matches.
Klik på Gem ændringer for at gemme dine indstillinger.

Mulighed B: Masseimport (anbefales, hvis du har mange værdier)

Forbered et Excel- eller CSV-ark med to kolonner:
- Kolonne A: Overskrift "Lookup key" efterfulgt af værdierne fra dit system
- Kolonne B: Overskrift "Product UID" efterfulgt af Gelatos tilsvarende værdier
Klik på Opret for at starte en ny søgning
Udfyld navn, kunde, beskrivelse og skabelonfelt som ovenfor
Klik på Importér i stedet for at taste alt ind manuelt
Vælg din klargjorte Excel- eller CSV-fil
Gennemgå de importerede mappinger
Klik på Gem ændringer for at gøre opsætningen færdig

Videoguide

3. Tilføj opslag i din skabelon-mapper

Når du har sat dine opslagstabeller op, skal du henvise til dem i din template mapper-kode (med Jinja2):

Gå til Workflow > Order Intake > Templates
Rediger skabelonen der, hvor du vil bruge opslag
I Template Mapper-sektionen kan du bruge lookups()-funktionen til at få adgang til dine mapping-tabeller
Grundlæggende syntaks: ##{{ lookups({"alias": value_to_lookup}, strict=False, default="fallback_value")|js }}

Eksempel 1: Produkt UID-tilknytning

{% set productUid = lookups({"sku": item.sku}, strict=False, default=item.sku) %}"productUid": ##{{ productUid|js }},

Eksempel 2: Kortlægning af forsendelsesmetode

"shipmentMethodUid": ##{{ lookups({"shipping_code": order.shipping.method}, strict=False, default="normal")|js }},

Parameteren strict=False sikrer, at koden ikke fejler, hvis der ikke findes et match, og parameteren default giver en reserveværdi.

Test af dine opslag

Test altid dine opslag, før du bruger dem i produktionen:

Gå til din skabelon i Skabeloner-sektionen
Gå til fanen Template Testing
Brug testformularen til at tjekke, at dine opslag bliver oversat korrekt
Tjek, at manglende nøgler bruger din standardværdi som de skal
Afgiv en testordre og tjek, at ordren bliver behandlet, som du forventer

Typiske anvendelser

VARENUMMER til Gelato UID-kobling

Match dine interne produktkoder med Gelatos produkt-UID'er:

{% set productUid = lookups({"sku": item.sku}, strict=False, default=item.sku) %}"productUid": ##{{ productUid|js }},

Oversættelse af leveringsmetode

Lav dine forsendelsesmetodenavne om til Gelatos UID’er for forsendelsesmetoder:

{% set shipMethod = lookups({"shipping_method": order.shipping_type}, strict=False, default="normal") %} "shipmentMethodUid": ##{{ shipMethod|js }},

Transportørkortlægning

Match transportør-id’er mellem systemer:

{% set carrier = lookups({"carrier_code": shipment.carrier}, strict=False, default=shipment.carrier) %} "carrier": ##{{ carrier|js }},

Landspecifik oversigt over statskoder

Håndter særlige tilfælde for statskoder i bestemte lande:

{% 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 }},

Fejlfinding af opslag

Hvis dine opslag driller:

Tjek for præcise match: Nøgler skelner mellem store og små bogstaver og skal matche nøjagtigt med det, der står i dine API-data
Tjek feltnavne i skabelonen: Sørg for, at feltet i din søgning matcher det, der er brugt i din skabelon
Brug strict=False: Så undgår du fejl, hvis en søgenøgle mangler
Hav altid standardindstillinger klar: Sæt passende standardværdier, så du er dækket ind, hvis der mangler noget
Tjek hele anmodningsdataen: Brug siden Anmodninger for at se de data, der bliver behandlet

Bedste fremgangsmåder

Brug beskrivende navne: Giv opslag navne, der tydeligt viser, hvad de bruges til
Tilføj beskrivelser: Skriv hvornår og hvor hver opslag bruges
Hold styr på dine mappings: Gennemgå og opdater dine lookups jævnligt, så de følger med, når produkter eller services ændrer sig
Brug bulkimport til store datasæt: Spar tid ved at importere opslag på én gang
Test grundigt: Prøv altid opslag med både værdier, der passer, og dem, der ikke gør
Dokumentér dine opslag: Hold styr på, hvilke opslag du bruger i hvilke skabeloner