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

✅ Oppslag sørger for at data er standardisert for Gelatos system. Det hindrer at verdier fra kunden ikke passer med det Gelato bruker.
✅ De gir deg mulighet til å bruke reserveverdier, så du slipper feil hvis noe mangler.
✅ Med bulkopplasting av CSV blir det mye enklere å holde oversikt når du har mange koblinger på én gang.

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

1. Gå til oppslagsiden

Logg inn på GelatoConnect-kontoen din
Gå til Arbeidsflyt > Ordremottak i menyen til venstre
Klikk på Oppslag for å se eksisterende koblinger eller lage nye

2. Lag en ny oppslagstabell

Alternativ A: Manuell opprettelse

Klikk på Opprett-knappen øverst på siden.
Skriv inn et beskrivende navn for oppslaget ditt (for eksempel «Produkt–SKU-tilknytning»).
Velg kunde fra rullegardinmenyen som dette oppslaget skal gjelde for.
Legg til en beskrivelse (valgfritt, men anbefales) for å gjøre det enklere å forstå hva oppslaget skal brukes til.
Skriv inn et malfelt – dette er referansen som brukes i malmapper-koden for å få tilgang til dette oppslaget. Malfeltet for oppslag må stå mellom doble krøllparenteser (for eksempel ##{{sku}}).
Legg til koblinger ved å klikke på +-ikonet:
- Nøkkel: Skriv inn verdien fra systemet ditt (for eksempel produktets SKU eller kode).
- Verdi: Skriv inn den tilhørende Gelato-verdien (for eksempel Gelatos produkt UID).
Gjenta dette for alle verdier som skal kobles sammen.
Klikk på Lagre endringer for å ta i bruk oppsettet.

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

Lag en Excel- eller CSV-fil med to kolonner:
- Kolonne A: Overskrift «Oppslagsnøkkel» etterfulgt av verdiene fra systemet ditt
- Kolonne B: Overskrift «Product UID» etterfulgt av Gelatos tilhørende verdier
Klikk på Opprett for å starte et nytt oppslag
Fyll inn navn, kunde, beskrivelse og malfelt som vist over
Klikk på Importer i stedet for å legge til oppføringer manuelt
Velg din klargjorte Excel- eller CSV-fil
Se gjennom de importerte koblingene
Klikk på Lagre endringer for å fullføre oppsettet

Videoguide

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

Gå til Arbeidsflyt > Ordremottak > Maler
Rediger malen der du vil bruke oppslag
I delen for maltilordning bruker du lookups()-funksjonen for å få tilgang til kartleggingstabellene dine
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:

Gå til malen din i Maler-delen
Gå til fanen Template Testing
Bruk testskjemaet for å sjekke at oppslagene dine oversetter verdier riktig
Sjekk at manglende nøkler faktisk bruker standardverdien din
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