Overview
In dit artikel lees je hoe je gepersonaliseerde producten maakt in Gelato en hoe je ze gebruikt bij het plaatsen van bestellingen via de API van Gelato. Met gepersonaliseerde producten kun je productinstellingen aanpassen voor verschillende klanten, zodat je hun specifieke data-indelingen koppelt aan een standaard productmodel.
Een productmodel beschrijft intern hoe je product in elkaar zit (denk aan onderdelen, eigenschappen en afgeleide kenmerken). Met een klantproduct kun je bepalen hoe klanten gegevens aanleveren en met je product omgaan als ze een bestelling plaatsen.
Stappen om gepersonaliseerde producten te maken
1. Stel het productmodel in
Voordat je een gepersonaliseerd product maakt, zorg je ervoor dat je al een productmodel hebt ingesteld. Stel bijvoorbeeld dat het productmodel Poster product heet en 9 eigenschappen en een aantal afgeleide eigenschappen heeft. (Bekijk de gids "Een productmodel maken" voor meer informatie.)
2. Het maken van het gepersonaliseerde product
Een klantproduct is een gepersonaliseerde versie van je productmodel die laat zien hoe jouw klant graag gegevens aanlevert (zoals maat, kleur, enzovoort). Zo stel je een klantproduct in:
Stap 1: Ga naar het gedeelte Klantproducten.
Stap 2: Kies het productmodel (bijvoorbeeld Poster product) en geef je gepersonaliseerd product een naam. Die naam is belangrijk, want die gebruik je straks als je een bestelling plaatst via de API.
Bijvoorbeeld, laten we dit product Poster SP noemen voor de klant Sandbox Customer.
Let op: De naam van het klantproduct kan direct gebruikt worden in bestellingen die via de API van Gelato worden verstuurd.
Stap 3: Stel de basiskenmerken en varianten in:
Basisattributen zijn vaste attributen die hetzelfde zijn voor alle productvarianten.
Varianten vertegenwoordigen de aanpasbare opties, zoals maat, kleur of papiersoort, waaruit de klant kan kiezen.
3. Basisattributen instellen
Basisattributen hebben een enkele, vaste waarde voor alle varianten. Bijvoorbeeld:
Oriëntatie: Altijd verticaal
Coating: Geen coating
Deze basiskenmerken variëren niet van de ene productvariant naar de andere.
4. Varianten instellen
Varianten zijn de productopties waaruit je klant kan kiezen, zoals maat en kleur. Zo stel je ze in:
Stap 1: Voeg de opties van de klant toe (bijv. maat en kleur) en koppel deze aan de productmodelattributen.
Voorbeeld: De klant wil attributen versturen met de namen Maat, Papiersoort en Kleur.
Stap 2: Koppel door de klant opgegeven waarden aan de interne productmodelattributen:
Kleur: De klant kan hun kleurkeuze "Black White" noemen voor zwart-wit prints en "Full Color" voor kleurenprints. Je kunt deze koppelen aan de interne Gelato-waarden "1/1" voor zwart-wit en "4/4" voor full color.
Afmeting: De klant kan maten in inches doorgeven, terwijl jij deze moet omrekenen naar het metrische systeem (bijvoorbeeld 20x28 inch = 508x711 mm).
Stap 3: Stel indien nodig een Standaardwaarde in voor attributen. Bijvoorbeeld:
Als de klant geen kleuroptie aangeeft, kun je de standaardinstelling op Full Color (4/4) zetten.
Stap 4: Stel meerdere optiewaarden in:
Je kunt meerdere klantwaarden aan één interne waarde koppelen. Een klant kan bijvoorbeeld \"Zwart Wit\" of \"ZW\" gebruiken om dezelfde zwart-witafdruk aan te geven, en je kunt beide koppelen aan je interne waarde \"1/1.\"
5. Het opslaan van het klantproduct
Zodra alle attributen en varianten zijn ingesteld, sla je het klantproduct op. Je hebt nu een klantproduct gekoppeld aan het interne productmodel, waardoor je bestellingen kunt ontvangen en verwerken op basis van het gewenste formaat van de klant.
Een bestelling plaatsen via de API met behulp van klantproducten
Zodra het klantproduct is ingesteld, kan de klant bestellingen plaatsen via de Gelato API. Zo werkt dat:
1. De API-verzoekstructuur
Bij het plaatsen van een bestelling wordt de naam van het klantproduct (bijv. Poster SP) gebruikt in het API-verzoek, samen met eventueel geselecteerde opties. Hier is een voorbeeld van een API-verzoek:
{ \"items\": [ { "productName": "Poster SP", "productVariant": { "color": "zwart-wit", "paper-size": "20x28 inch" } } ]}
In dit voorbeeld:
Het productName is ingesteld op Poster SP.
De productVariant bevat de gekozen opties, zoals "zwart-wit" voor kleur en "20x28 inch" voor papierformaat.
2. Meerdere klantproducten beheren
Je kunt voor elke klant verschillende gepersonaliseerde producten instellen, die allemaal aan hetzelfde productmodel gekoppeld zijn, maar met andere instellingen. Bijvoorbeeld:
Klant A kan bijvoorbeeld "papierformaat" en "kleur" als opties doorgeven.
Klant B stuurt misschien in plaats daarvan "papiersoort" en "formaat".
Ondanks deze verschillen verwijzen beide klantproducten naar dezelfde interne Product UID in het systeem van Gelato. Zo blijft het productieproces achter de schermen altijd hetzelfde.
3. Achterwaartse compatibiliteit
Het systeem van Gelato ondersteunt achterwaartse compatibiliteit met bestaande workflows. Je kunt dus gewoon Product UIDs uit oudere configuraties blijven gebruiken, terwijl je nieuwe gepersonaliseerde productinstellingen toevoegt in de flow configurator.