Gå til hovedinnhold

[Order Intake - GCW] Sette opp Lookups for API-integrasjon

Skrevet av Kyle Sawyer

Hva er oppslag, og hvorfor er de viktige?

Oppslag i GelatoConnect fungerer som oversiktstabeller som gjør om data fra systemet ditt til formater Gelato forstår. De er avgjørende for en smidig API-integrasjon, spesielt når du skal koble sammen:

  • Produkt-ID-er/SKU-er: Gjør dine personlig tilpassede produktidentifikatorer om til Gelatos standardiserte produkt-UID-er

  • Fraktmetoder: Koble navnene på fraktmetodene dine til Gelatos transportkoder

  • Transportøridentifikatorer: Oversett transportørnavn mellom systemer

  • Andre personlig tilpassede koblinger: Verdier som må oversettes likt mellom systemene

Uten oppslag kan det hende at bestillinger ikke går gjennom hvis systemets identifikatorer ikke stemmer med det Gelato forventer. Oppslag fungerer som en bro mellom systemene og sørger for at bestillingene behandles jevnt og sikkert.

Viktige fordeler med å bruke oppslag

✅ Standardisering: Sikrer datakonsistens mellom systemet ditt og Gelato
✅ Feilforebygging: Reduserer feil på grunn av ikke-matchende identifikatorer
✅ Fallback-beskyttelse: Gir standardverdier hvis eksakte treff ikke blir funnet
✅ Skalerbarhet: gjør det enklere å legge til nye produkter eller fraktmetoder
✅ Vedlikehold: Sentralisert håndtering av tilordninger for enklere oppdateringer

Slik setter du opp oppslag: steg-for-steg-guide

1. Gå til oppslagsiden

  1. Logg inn på GelatoConnect-kontoen din

  2. Gå til Arbeidsflyt > Ordremottak i menyen til venstre

  3. Klikk på Oppslag for å se eksisterende koblinger eller lage nye

2. Lag en ny oppslagstabell

Alternativ A: Manuell opprettelse

  1. Klikk på Create-knappen øverst på siden

  2. Skriv inn et beskrivende navn for oppslaget ditt (for eksempel «Produkt–SKU-tilknytning»).

  3. Velg kunde denne Lookups-en skal gjelde for, fra rullegardinmenyen

  4. Legg til en beskrivelse (valgfritt, men anbefalt) for å gjøre det enklere å forstå hva Lookups brukes til

  5. Skriv inn et malfelt – dette er referansen som brukes i template mapper-kode for å få tilgang til denne Lookups-en

  6. Legg til koblinger ved å klikke på +-ikonet:

    • Nøkkel: Skriv inn verdien fra systemet ditt (f.eks. produktets SKU eller kode)

    • Verdi: Skriv inn den tilsvarende Gelato-verdien (f.eks. Gelatos produkt-UID)

  7. Gjenta for alle verdier som må kobles

  8. Klikk Lagre endringer for å ta i bruk konfigurasjonen

Alternativ B: Masseimport (anbefales hvis du har mange verdier)

  1. Lag en Excel- eller CSV-fil med to kolonner:

    • Kolonne A: overskriften «lookup key» etterfulgt av systemverdiene dine

    • Kolonne B: overskrift «product UID» etterfulgt av Gelato sine tilsvarende verdier

  2. Klikk på Opprett for å starte et nytt oppslag

  3. Fyll inn navn, kunde, beskrivelse og malfelt som vist over

  4. Klikk på Importer i stedet for å legge til oppføringer manuelt

  5. Velg din klargjorte Excel- eller CSV-fil

  6. Se gjennom de importerte koblingene

  7. Klikk på Lagre endringer for å fullføre oppsettet

3. Legg til oppslag i malbehandleren din

Når du har satt opp oppslagstabellene dine, må du vise til dem i malmapper-koden din (med Jinja2):

  1. Gå til Arbeidsflyt > Ordremottak > Maler

  2. Rediger malen der du vil bruke oppslag

  3. I delen for maltilordning bruker du lookups()-funksjonen for å få tilgang til kartleggings­tabellene dine

  4. Grunnleggende syntaks: ##{{ lookups({"alias": value_to_lookup}, strict=False, default="fallback_value")|js }}

Eksempel 1: Kartlegging av produkt-UID

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

Eksempel 2: Koble fraktmetode

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

Parameteren strict=False gjør at koden ikke feiler hvis det ikke finnes et treff, og default-parameteren gir en reserveverdi.

Slik sjekker du oppslagene dine

Test alltid oppslagene dine før du bruker dem i produksjon:

  1. Gå til malen din i Maler-delen

  2. Gå til fanen Template Testing

  3. Bruk testskjemaet for å sjekke at oppslagene dine oversetter verdier riktig

  4. Sjekk at manglende nøkler faktisk bruker standardverdien din

  5. Send inn en testbestilling og sjekk at bestillingen blir behandlet som forventet

Vanlige bruksområder

Produkt-SKU til Gelato UID-tilknytning

Koble dine interne produktkoder til Gelatos produkt-UID-er:

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

Oversettelse av fraktmetode

Gjør om navnene på fraktmetodene dine til Gelatos UID-er for fraktmetoder:

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

Transportøroversikt

Koble sammen transportør-ID-er mellom systemene:

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

Landsbasert oversikt over statskoder

Håndter spesielle tilfeller for delstatskoder i enkelte land:

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

Feilsøking av oppslag

Hvis oppslagene dine ikke fungerer som de skal:

  • Sjekk etter nøyaktige treff: Nøklene skiller mellom store og små bokstaver og må være helt like det som står i API-dataene dine

  • Sjekk navn på malfeltene: Pass på at feltnavnet i oppslaget ditt stemmer med det som brukes i malen din

  • Bruk strict=False: Da unngår du feil hvis en oppslagsnøkkel mangler

  • Ha alltid standardvalg: Sett passende standardverdier for å håndtere manglende koblinger

  • Sjekk hele forespørselen: Gå til Requests-siden for å se hva som faktisk behandles

Gode vaner

  • Bruk beskrivende navn: Gi oppslag tydelige navn som viser hva de brukes til

  • Legg til beskrivelser: Fortell når og hvor hvert oppslag brukes

  • Hold oversiktene oppdatert: Gå jevnlig gjennom og oppdater oppslagene når produkter eller tjenester endrer seg

  • Bruk masseimport for store datasett: Spar tid ved å importere oppslag i én omgang

  • Test grundig: Prøv alltid oppslag med både treff og ikke-treff

  • Dokumenter oppslagene dine: Hold oversikt over hvilke oppslag som brukes i hvilke maler

Hva skjer nå

Nå som du har satt opp oppslag for API-integrasjonen din, kan det være lurt å:

  1. Lær om å lage en mal for Order intake

  2. Utforsk avanserte teknikker med Template Mapper

  3. Sett opp automatiske Postbacks for å holde kundene oppdatert

Trenger du mer hjelp? Kontakt brukerstøtte på [email protected]

Relaterte artikler
Svarte dette på spørsmålet?