Vad är lookups och varför spelar de roll?

Uppslag i GelatoConnect fungerar som översättningstabeller som gör om data från ditt system till format som Gelato förstår. De är nyckeln till smidig API-integration, särskilt när det gäller att matcha:

Produkt-ID/SKU: Gör om dina egna produktkoder till Gelatos standardiserade produkt-UID
Fraktsätt: Matcha dina fraktnamn med Gelatos transportörskoder
Transportörs-ID: Översätt namn på transportörer mellan olika system
Andra egna kopplingar: Alla värden som behöver översättas på samma sätt mellan olika system

Utan lookups kan beställningar gå i stöpet om ditt systems identifierare inte stämmer överens med de värden Gelato förväntar sig. Lookups fungerar som en bro som ser till att allt flyter på smidigt när du hanterar beställningar.

Viktigaste fördelarna med att använda lookups

✅ Med hjälp av lookups blir datan enhetlig för Gelatos system. Det minskar risken för att kundunika värden och Gelato-värden krockar med varandra.
✅ De gör att du kan använda reservvärden så att det inte blir fel om något saknas.
✅ Med bulkuppladdning av CSV blir det smidigare att hantera stora mängder kopplingar.

Så här gör du: steg-för-steg-guide för att komma igång med uppslag

1. Gå till sidan för uppslag

Logga in på ditt GelatoConnect-konto
Gå till Workflow > Order Intake i menyn till vänster
Klicka på Lookups för att se dina nuvarande kopplingar eller skapa nya

2. Skapa en ny uppslagstabell

Alternativ A: Skapa manuellt

Klicka på Skapa-knappen högst upp på sidan.
Skriv in ett beskrivande namn för din sökning (t.ex. "Produkt-SKU-koppling")
Välj vilken kund du vill att den här sökningen ska gälla för i rullgardinsmenyn.
Lägg till en beskrivning (valfritt men rekommenderas) så blir det enklare att förstå vad uppslaget ska användas till.
Fyll i ett Mallfält – det här är referensen du använder i template mapper-koden för att komma åt denna lookup. Mallfältet för uppslag måste omges av dubbla klamrar (t.ex. ##{{sku}}).
Lägg till kopplingar genom att klicka på +-ikonen:
- Nyckel: Skriv in värdet från ditt system (t.ex. din produkt-SKU eller kod).
- Värde: Skriv in det Gelato-värde som passar (till exempel Gelatos produkt UID).
Gör likadant för alla värden som behöver kopplas.
Klicka på Spara ändringar för att spara inställningarna.

Alternativ B: Massimport (rekommenderas om du har många värden)

Förbered en Excel- eller CSV-fil med två kolumner:
- Kolumn A: Rubrik "Lookup key" följt av värdena från ditt system
- Kolumn B: Rubrik "Product UID" följt av Gelatos motsvarande värden
Klicka på Skapa för att sätta igång en ny sökning
Fyll i namn, kund, beskrivning och mallfält som ovan
Klicka på Importera istället för att lägga till poster en och en
Välj din färdiga Excel- eller CSV-fil
Kolla igenom de importerade kopplingarna
Klicka på Spara ändringar för att bli klar med inställningen

Videoguide

3. Lägg till uppslag i din mallhanterare

När du har fixat dina uppslagstabeller är det dags att använda dem i din template mapper-kod (med Jinja2):

Gå till Workflow > Order Intake > Templates
Redigera mallen där du vill använda uppslag
I avsnittet Template Mapper använder du funktionen lookups() för att komma åt dina mappningstabeller
Grundläggande syntax: ##{{ lookups({"alias": value_to_lookup}, strict=False, default="fallback_value")|js }}

Exempel 1: Produkt-UID-koppling

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

Exempel 2: Matcha fraktsätt

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

Parametern strict=False ser till att koden inte kraschar om det inte finns någon träff, och med parametern default kan du ange ett reservvärde.

Testa dina kunskaper

Testa alltid dina uppslag innan du använder dem på riktigt:

Gå till din mall under Mallar-sektionen
Gå till fliken Template Testing
Använd testformuläret för att kolla att dina sökningar översätter värdena rätt
Kolla att saknade nycklar använder ditt standardvärde som de ska
Lägg en testbeställning och kolla att allt går som det ska

Vanliga användningsområden

Produktens SKU till Gelato UID-koppling

Koppla dina interna produktkoder till Gelatos produkt-UID:er:

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

Översättning av fraktsätt

Gör om dina fraktsättsnamn till Gelatos UID för leveranssätt:

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

Fraktbolagskoppling

Matcha transportörernas ID mellan systemen:

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

Landspecifik statuskodsmappning

Hantera undantag för delstatskoder i vissa länder:

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

Felsökning av sökningar

Om dina sökningar inte funkar som du tänkt dig:

Kolla efter exakta träffar: Nycklar är skiftlägeskänsliga och måste stämma exakt med det som finns i din API-data
Kolla mallfältsnamnen: Se till att fältet du söker efter har samma namn som det som används i din mall
Använd strict=False: Detta förhindrar fel när en uppslagsnyckel saknas
Ha alltid standardvärden: Sätt passande standardvärden så att det funkar även om något saknas
Kolla in hela begäran: Gå till sidan för förfrågningar och se vad som faktiskt behandlas

Bästa praxis

Använd beskrivande namngivning: Namnge uppslagningar tydligt för att visa deras syfte
Lägg till beskrivningar: Berätta när och var varje sökning används
Håll koll på dina kopplingar: Se till att gå igenom och uppdatera dina uppslag regelbundet när produkter eller tjänster förändras
Använd bulkimport för stora datamängder: Spara tid genom att importera uppslag på en gång
Testa ordentligt: Prova alltid att söka både med värden som finns och sådana som inte finns
Dokumentera dina sökningar: Håll koll på vilka sökningar du använder i vilka mallar