När du skickar beställningar till GelatoConnect via API:et har du två alternativ för att specificera produkter: använda produkt-UID eller använda kundprodukter. Denna guide förklarar båda tillvägagångssätten, deras fördelar och när du bör använda respektive alternativ.
Så tänker vi kring produktens UID
Produkt-UID-metoden innebär att du använder unika produkt-ID:n (UID) för att ange produkter i dina beställningar.
Så här fungerar det
När du använder produkt-UID:er lägger du till parametern productUid i din orderrad:
{ "itemReferenceId": "ITEM-001", "productUid": "flat_product_pf_a4_pt_200-gsm-uncoated_cl_4-0_ct_none_prt_none_sft_none_set_none_hor", "antal": 1, "filer": [ { \"type\": \"default\", "url": "https://example.com/files/printfile.pdf" } ]}Struktur för produkt-UID
En produkt-UID är en strukturerad sträng som samlar produktens egenskaper. Till exempel, i flat_product_pf_a4_pt_200-gsm-uncoated_cl_4-0_ct_none_prt_none_sft_none_set_none_hor:
flat_product: Produkttyppf_a4: Pappersformat (A4-storlek)pt_200-gsm-uncoated: Papperstyp (200 gsm obestruket papper)cl_4-0: Färgkonfiguration (4-färgsprocess på framsidan, 0 färger på baksidan)ct_none: Ingen beskärningprt_none: Särskilda tryckeffekter (inga)sft_none: Ytbehandlingar (ingen)set_none: Specialeffekter (inga)hor: Orientering (liggande)
Tillvägagångssätt för kundprodukter
Med Customer Products-metoden skapar du egna produktdefinitioner i GelatoConnect och hänvisar till dem med namn och variant i dina beställningar.
Så här fungerar det
Först skapar du Kundprodukter i GelatoConnect, där du definierar produktnamn och deras variantalternativ. När du sedan lägger beställningar refererar du till dessa produkter med hjälp av parametrarna productName och productVariant:
{ "itemReferenceId": "ITEM-001", "productName": "Visitkort", "productVariant": { "Size": "Standard", "Paper": "Premium matt", \"Färg\": \"Fullfärg på båda sidor\" }, "quantity": 100, "filer": [ { \"type\": \"front\", "url": "https://example.com/files/front.pdf" }, { \"type\": \"back\", \"url\": \"https://example.com/files/back.pdf\" } ]}Så kommer du igång med kundprodukter
Innan du kan använda kundprodukter i dina API-beställningar behöver du först lägga till dem i GelatoConnect:
Navigera till sektionen Produkter i GelatoConnect
Skapa kundprodukter med unika namn och olika varianter
Matcha ihop de här kundprodukterna med Gelatos produktspecifikationer
När ska du använda vilket sätt?
Använd produkt-UID:er när:
Du har precis tagit första steget med GelatoConnect
Du har bara några få fasta produkter
Du vill komma igång snabbt utan extra krångel
Du håller på att bygga ett test eller en första version för att se om idén funkar
Använd kundprodukter när:
Du har en stor produktkatalog
Du vill ha mer självklara produktnamn i din kod
Dina produktnamn skiljer sig från Gelatos sätt att namnge produkter
Produktinställningar kan ändras med tiden
Exempel på hur du kan göra
Exempel på produkt-UID
curl --location 'https://api.partner-connect.io/api/{partner-prefix}/order' \--header 'Content-Type: application/json' \--header 'X-API-KEY: your-key:your-secret' \--data '{" "orderReferenceId": "ORDER-123", "orderType": "order", "currency": "USD", "shippingAddress": { "country": "US", "firstName": "John", "lastName": "Doe", "addressLine1": "123 Main St", "city": "New York", "postCode": "10001", \"state\": \"NY\", "email": "[email protected]", "phone": "123-456-7890" }, \"items\": [ { "itemReferenceId": "ITEM-001", "productUid": "flat_product_pf_a4_pt_200-gsm-uncoated_cl_4-0_ct_none_prt_none_sft_none_set_none_hor", \"quantity\": 1, "filer": [ { "type": "default", \"url\": \"https://example.com/files/printfile.pdf\" } ] } ]}'Exempel på kundprodukter
curl --location 'https://api.partner-connect.io/api/{partner-prefix}/order' \--header 'Content-Type: application/json' \--header 'X-API-KEY: your-key:your-secret' \\--data '{ "orderReferenceId": "ORDER-124", \"orderType\": \"order\", "currency": "USD", \"shippingAddress\": { "country": "US", "firstName": "John", \"lastName\": \"Doe\", "addressLine1": "123 Main St", \"city\": \"New York\", "postCode": "10001", \"state\": \"NY\", "email": "[email protected]", \"telefon\": \"123-456-7890\" }, "items": [ { "itemReferenceId": "ITEM-001", "productName": "Flyer", \"productVariant\": { \"Storlek\": \"A4\", \"Papper\": \"Obestruket 200 g/m²\", \"Tryck\": \"Fullfärg på en sida\" }, \"quantity\": 100, "filer": [ { \"type\": \"default\", "url": "https://example.com/files/flyer.pdf" } ] } ]}'"Bästa praxis
Oavsett vilken väg du väljer, se till att följa de här smarta tipsen:
Konsekvens: Håll dig till en och samma metod genom hela din implementation
Dokumentation: Upprätthåll tydlig dokumentation av dina produktkopplingar
Validering: Kolla att produkt-ID:n stämmer innan du skickar in beställningar
Testa ordentligt: Prova med några testbeställningar innan du kör igång på riktigt
Felfångst: Se till att hantera fel på ett smart sätt om produkterna inte funkar som de ska
Byta spår mellan olika sätt att jobba
Om du börjar med produkt-UIDs och senare vill byta till kundprodukter:
Ställ in dina kundprodukter i GelatoConnect
Koppla ihop dem med de produkt-ID:n du har använt
Uppdatera din API-implementation så att du använder productName och productVariant
Testa noggrant innan du lanserar i produktionsmiljön
Det går också att göra tvärtom, men det är inte lika vanligt.
Sammanfattning
Båda tillvägagångssätten har sina fördelar, och valet beror på dina specifika krav och begränsningar. Produkt-UID:n erbjuder enkelhet och direkt åtkomst till Gelatos katalog, medan Kundprodukter ger bättre läsbarhet, flexibilitet och centraliserad hantering.
För de flesta långsiktiga lösningarna är kundprodukter enklare att underhålla och ger bättre överblick. Men om du vill göra något snabbt eller har ett särskilt behov kan det vara smidigare att använda produkt-UID:er.
För mer information om hur du sätter upp kundprodukter i GelatoConnect, kolla in guiden Skapa kundprodukter.