Spring videre til hovedindholdet

[Order Intake - GCW] Opsætning af Lookups til API-integration

Skrevet af Kyle Sawyer

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

✅ Standardisering: Sikrer datakonsistens mellem dit system og Gelato
✅ Forebyggelse af fejl: Reducerer fejl på grund af forkerte identifikatorer
✅ Fallback-beskyttelse: Giver standardværdier, hvis der ikke findes nøjagtige match
✅ Skalerbarhed: Gør det nemmere at håndtere tilføjelse af nye produkter eller forsendelsesmetoder
✅ Vedligeholdelse: Centraliseret styring af mappings for nemmere opdateringer

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

1. Gå til Lookups-siden

  1. Log ind på din GelatoConnect-konto

  2. Gå til Workflow > Order Intake i menuen til venstre

  3. Klik på Lookups for at se eksisterende mappinger eller oprette nye

2. Opret en ny opslagstabel

Mulighed A: Opret manuelt

  1. Klik på Opret-knappen øverst på siden

  2. Indtast et beskrivende Navn til din opslagstabel (f.eks. "Produkt VARENUMMER Mapping")

  3. Vælg den kunde, som dette lookup skal gælde for, fra rullemenuen

  4. Tilføj en Beskrivelse (valgfrit, men anbefalet) for at hjælpe med at identificere lookup'ets formål

  5. Indtast et skabelonfelt – dette er referencen, der bruges i template mapper-koden til at få adgang til dette lookup

  6. Tilføj tilknytninger ved at klikke på +-ikonet:

    • Nøgle: Indtast værdien fra dit system (f.eks. dit produkts varenummer eller kode)

    • Værdi: Indtast den tilsvarende Gelato-værdi (f.eks. Gelatos produkt-UID)

  7. Gentag for alle værdier, der skal mappes

  8. Klik på Gem ændringer for at anvende konfigurationen

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

  1. Forbered et Excel- eller CSV-ark med to kolonner:

    • Kolonne A: Overskrift "lookup key" efterfulgt af dine systemværdier

    • Kolonne B: Overskrift "produkt UID" efterfulgt af Gelatos tilsvarende værdier

  2. Klik på Opret for at starte en ny søgning

  3. Udfyld navn, kunde, beskrivelse og skabelonfelt som ovenfor

  4. Klik på Importér i stedet for at taste alt ind manuelt

  5. Vælg din klargjorte Excel- eller CSV-fil

  6. Gennemgå de importerede mappinger

  7. Klik på Gem ændringer for at gøre opsætningen færdig

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):

  1. Gå til Workflow > Order Intake > Templates

  2. Rediger skabelonen der, hvor du vil bruge opslag

  3. I Template Mapper-sektionen kan du bruge lookups()-funktionen til at få adgang til dine mapping-tabeller

  4. 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:

  1. Gå til din skabelon i Skabeloner-sektionen

  2. Gå til fanen Template Testing

  3. Brug testformularen til at tjekke, at dine opslag bliver oversat korrekt

  4. Tjek, at manglende nøgler bruger din standardværdi som de skal

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

Hvad sker der nu?

Nu hvor du har sat opslag op til din API-integration, vil du måske gerne:

  1. Lær om at oprette en skabelon til Order Intake

  2. Udforsk avancerede Template Mapper-teknikker

  3. Opsæt automatiske postbacks for at opdatere kunder

Brug for mere hjælp? Kontakt vores supportteam på [email protected]

Relaterede artikler
Besvarede dette dit spørgsmål?