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
✅ Standardisering: Säkerställer datakonsekvens mellan ditt system och Gelato
✅ Förebyggande av fel: Minskar misslyckanden på grund av felaktiga identifierare
✅ Reservskydd: Tillhandahåller standardvärden om exakta matchningar inte hittas
✅ Skalbarhet: Gör det enklare att hantera nya produkter eller fraktmetoder
✅ Underhåll: Centraliserad hantering av mappningar för enklare uppdateringar
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å knappen Skapa högst upp på sidan
Skriv in ett beskrivande namn för din sökning (t.ex. "Produkt-SKU-koppling")
Välj den kund som denna lookup ska gälla för från rullgardinsmenyn
Lägg till en Beskrivning (valfritt men rekommenderat) för att hjälpa till att identifiera lookupens syfte
Ange ett mallfält – detta är referensen som används i template mapper-koden för att komma åt denna lookup
Lägg till kopplingar genom att klicka på +-ikonen:
Nyckel: Ange värdet från ditt system (t.ex. din produkt-SKU eller kod)
Värde: Ange motsvarande Gelato-värde (t.ex. Gelatos produkt-UID)
Upprepa för alla värden som behöver mappas
Klicka på Spara ändringar för att tillämpa konfigurationen
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 dina systems värden
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
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 mappningstabellerGrundlä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 saknasHa 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
Vad händer nu
Nu när du har fixat uppslag för din API-integration kanske du vill:
Lär dig mer om att skapa en mall för Order intake
Utforska avancerade tekniker för Template Mapper
Konfigurera automatiska Postbacks för att uppdatera kunder
Behöver du mer hjälp? Kontakta vår kundtjänst på [email protected]