Översikt
Den här artikeln förklarar hur du skapar kundprodukter i Gelato och använder dem när du lägger beställningar via Gelatos API. Kundprodukter låter dig anpassa produktkonfigurationer för olika kunder, genom att koppla deras specifika datakrav till en standardproduktmodell.
En produktmodell definierar din produkt internt (t.ex. dess delar, attribut och härledda attribut), medan en kundprodukt låter dig anpassa hur kunder skickar data och interagerar med din produkt när de lägger beställningar.
Steg för att skapa kundprodukter
1. Konfigurera produktmodellen
Innan du skapar en kundprodukt, se till att du redan har en produktmodell inställd. Till exempel, låt oss anta att produktmodellen heter Poster Product och den har 9 attribut och flera härledda attribut. (Se guiden \"Skapa en produktmodell\" för detaljer.)
2. Skapa kundprodukten
En kundprodukt är en anpassad version av din produktmodell som återspeglar hur din kund föredrar att skicka data (t.ex. storlek, färg, osv.). Så här skapar du en kundprodukt:
Steg 1: Navigera till avsnittet Kundprodukter.
Steg 2: Välj produktmodell (t.ex. Poster Product) och ge din kundprodukt ett namn. Detta namn är avgörande eftersom det kommer att användas när du lägger en beställning via API:et.
Till exempel, låt oss kalla denna produkt Poster SP för kunden Sandbox Customer.
Obs: Kundens produktnamn kan användas direkt i beställningar som skickas via Gelatos API.
Steg 3: Konfigurera Basattribut och Varianter:
Basattribut är fasta attribut som är desamma för alla produktvarianter.
Varianter representerar de anpassningsbara alternativen, som storlek, färg eller papperstyp, som kunden kan välja mellan.
3. Ställa in grundattribut
Basattribut har ett enda, fast värde för alla varianter. Till exempel:
Orientering: Alltid vertikal
Beläggning: Ingen beläggning
Dessa grundläggande attribut varierar inte från en produktvariant till en annan.
4. Ställa in varianter
Varianter är de produktalternativ som din kund kan välja, som storlek och färg. Så här konfigurerar du dem:
Steg 1: Lägg till kundens alternativ (t.ex. storlek och färg) och koppla dem till produktmodellens attribut.
Exempel: Kunden vill skicka in attribut som heter Storlek, Papperstyp och Färg.
Steg 2: Koppla kundangivna värden till de interna produktmodellattributen:
Färg: Kunden kan kalla sina färgalternativ \"Black White\" för svartvita utskrifter och \"Full Color\" för färgutskrifter. Du kan koppla dessa till Gelatos interna värden \"1/1\" för svartvitt och \"4/4\" för fullfärg.
Storlek: Kunden kan skicka in mått i tum, medan du behöver konvertera dessa värden till det interna metriska systemet (t.ex. 20x28 tum = 508x711 mm).
Steg 3: Ange ett standardvärde för attribut om det behövs. Till exempel:
Om kunden inte väljer en färg, kan du ställa in standardalternativet till Full Color (4/4).
Steg 4: Ställ in flera olika alternativ:
Du kan koppla flera kundvärden till ett och samma internt värde. Till exempel kan en kund använda "Black White" eller "BW" för att mena samma svartvita tryck, och du kan koppla båda dessa till ditt interna värde "1/1".
5. Spara kundens produkt
När du har lagt till alla attribut och varianter, spara kundprodukten. Nu har du en kundprodukt som är kopplad till den interna produktmodellen, så att du kan ta emot och hantera beställningar på det sätt som kunden föredrar.
Lägga en beställning via API:et med kundprodukter
När kundprodukten är konfigurerad kan kunden lägga beställningar via Gelato API. Så här fungerar det:
1. API-förfrågans struktur
När du lägger en beställning kommer kundens produktnamn (t.ex. Poster SP) att användas i API-förfrågan tillsammans med alla valda alternativ. Här är ett exempel på en API-förfrågan:
{ \"items\": [ { \"productName\": \"Poster SP\", "productVariant": { \"color\": \"svart-vit\", \"paper-size\": \"20x28-tum\" } } ]}
I detta exempel:
productName är inställt på Poster SP.
productVariant inkluderar de valda variantalternativen, som till exempel \"svart-vit\" för färg och \"20x28 tum\" för pappersstorlek.
2. Hantering av flera kundprodukter
Du kan skapa olika kundprodukter för olika kunder, som alla kopplas till samma produktmodell men med olika konfigurationer. Till exempel:
Kund A kan skicka "pappersformat" och "färg" som alternativ.
Kund B kan skicka \"papperstyp\" och \"storlek\" istället.
Trots dessa skillnader kommer båda kundprodukterna att peka på samma interna Product UID i Gelatos system, vilket säkerställer konsekventa produktionsprocesser under ytan.
3. Bakåtkompatibilitet
Gelatos system stödjer bakåtkompatibilitet med befintliga arbetsflöden, vilket innebär att du kan fortsätta använda Produkt-UID från äldre konfigurationer samtidigt som du antar nya kundproduktinställningar i flödeskonfiguratorn.