Aperçu
Cet article explique comment créer des produits clients dans Gelato et les utiliser lors de la passation de commandes via l'API de Gelato. Les produits clients vous permettent de personnaliser les configurations de produits pour différents clients, en liant leurs exigences spécifiques de format de données à un modèle de produit standard.
Un modèle de produit définit votre produit en interne (par exemple, ses composants, attributs et attributs dérivés), tandis qu'un produit client vous permet d'adapter la façon dont les clients envoient des données et interagissent avec votre produit lors de la passation de commandes.
Étapes pour créer des produits personnalisés
1. Configurer le modèle de produit
Avant de créer un produit client, assurez-vous d'avoir déjà configuré un modèle de produit. Par exemple, supposons que le modèle de produit s'appelle Poster Product et qu'il possède 9 attributs et plusieurs attributs dérivés. (Consultez le guide « Création d'un modèle de produit » pour plus de détails.)
2. Création du produit client
Un produit client est une version personnalisée de votre modèle de produit qui reflète la façon dont votre client préfère envoyer les données (par ex., taille, couleur, etc.). Voici comment configurer un produit client :
Étape 1 : Accédez à la section Produits clients.
Étape 2 : Sélectionnez le modèle de produit (par exemple, Poster Product) et donnez un nom à votre produit client. Ce nom est crucial car il sera utilisé lors de la passation d'une commande via l'API.
Par exemple, appelons ce produit Poster SP pour le client Sandbox Customer.
Note : Le nom du produit client peut être utilisé directement dans les demandes de commande envoyées via l'API de Gelato.
Étape 3 : Configurez les Attributs de base et les Variantes :
Attributs de base sont des attributs fixes qui sont identiques pour toutes les variantes de produit.
Variants représentent les options personnalisables, telles que la taille, la couleur ou le type de papier, que le client peut choisir.
3. Définition des attributs de base
Les attributs de base ont une valeur unique et fixe pour toutes les variantes. Par exemple :
Orientation : Toujours verticale
Revêtement : Sans revêtement
Ces attributs de base ne varient pas d'une variante de produit à une autre.
4. Configuration des variantes
Les variantes sont les options de produit que votre client peut sélectionner, comme la taille et la couleur. Voici comment les configurer :
Étape 1 : Ajoutez les options du client (par ex., taille et couleur) et liez-les aux attributs du modèle de produit.
Exemple : Le client souhaite envoyer des attributs nommés Taille, Type de papier et Couleur.
Étape 2 : Associer les valeurs fournies par le client aux attributs du modèle de produit interne :
Couleur : Le client peut appeler son option de couleur « Noir et blanc » pour les impressions en noir et blanc et « Couleur » pour les impressions en couleur. Vous pouvez associer ces options aux valeurs internes de Gelato « 1/1 » pour le noir et blanc et « 4/4 » pour la couleur.
Taille : Le client peut envoyer des dimensions en pouces, tandis que vous devez convertir ces valeurs dans le système métrique interne (par exemple, 20x28 pouces = 508x711 mm).
Étape 3 : Définissez une Valeur par défaut pour les attributs si nécessaire. Par exemple :
Si le client ne fournit pas d'option de couleur, vous pouvez définir la valeur par défaut sur Couleur complète (4/4).
Étape 4 : Configurer plusieurs valeurs d'option :
Vous pouvez associer plusieurs valeurs client à une seule valeur interne. Par exemple, un client peut utiliser \"Noir Blanc\" ou \"NB\" pour indiquer la même impression en noir et blanc, et vous pouvez associer ces deux termes à votre valeur interne \"1/1\".
5. Enregistrement du produit client
Une fois tous les attributs et variantes configurés, enregistrez le produit client. Vous disposez maintenant d'un produit client lié au modèle de produit interne, ce qui vous permet de recevoir et de traiter des commandes selon le format préféré du client.
Passer une commande via l'API en utilisant les produits clients
Une fois que le produit client est configuré, le client peut passer des commandes via l'API Gelato. Voici comment cela fonctionne :
1. La structure de la requête API
Lors de la passation d'une commande, le nom du produit client (par exemple, Poster SP) sera utilisé dans la requête API avec toutes les options sélectionnées. Voici un exemple de requête API :
{ \"items\": [ { \"productName\": \"Poster SP\", \"productVariant\": { \"color\": \"black-white\", \"paper-size\": \"20x28-pouces\" } } ]}
Dans cet exemple :
Le productName est défini sur Poster SP.
Le productVariant inclut les valeurs d'options de variante sélectionnées, comme « noir-blanc » pour la couleur et « 20x28 po » pour le format du papier.
2. Gestion de plusieurs produits clients
Vous pouvez configurer différents produits clients pour différents clients, chacun étant lié au même modèle de produit mais avec des configurations différentes. Par exemple :
Client A pourrait envoyer « format de papier » et « couleur » comme options.
Le client B pourrait envoyer « type de papier » et « taille » à la place.
Malgré ces différences, les deux produits clients pointeront vers le même Product UID interne dans le système de Gelato, garantissant ainsi des processus de production cohérents en coulisses.
3. Compatibilité ascendante
Le système de Gelato prend en charge la rétrocompatibilité avec les flux de travail existants, ce qui signifie que vous pouvez continuer à utiliser les UID de produit des configurations plus anciennes tout en adoptant de nouvelles configurations de produits clients dans le configurateur de flux.