Testez minutieusement vos configurations de produits, vos emballages et vos flux de commandes à l'aide de l'API GelatoConnect.
1. Préparation pour passer une commande test
Avant de passer une commande test, assurez-vous d'avoir :
Configuration du produit client : Créez le produit client avec les attributs et les variantes requis. Suivez ces étapes :
Accédez à la section Produits clients dans GelatoConnect.
Sélectionnez le modèle de produit concerné (par ex., Poster Product).
Définissez les attributs de base et les variantes, en veillant à ce qu'ils correspondent au format de données préféré du client. Associez les valeurs fournies par le client (par exemple, la couleur ou la taille) aux attributs internes de Gelato.
Enregistrer la configuration.
Accès API : Confirmez que vous disposez d'identifiants API valides et des autorisations d'accès nécessaires pour passer des commandes.
Fichiers test : Assurez-vous d'avoir des fichiers d'exemple prêts à télécharger (par exemple, des PDF prêts à imprimer).
2. Passer une commande test en utilisant l'API GelatoConnect
Suivez les étapes suivantes pour passer une commande test via l'API :
Point de terminaison API
POST https://order.ie.live.gelato.tech/api/v4/orders
Structure d'exemple de requête API
{
"clientId": "your-client-id",
"orderReferenceId": "test-order-ref",
"customerReferenceId": "test-customer-ref",
"orderType": "order",
"currency": "USD",
"retailCurrency": "USD",
"retailShippingPriceInclVat": 5.99,
"shippingAddress": {
"country": "US",
"firstName": "John",
"lastName": "Doe",
"addressLine1": "123 Test St",
"city": "Testville",
"postCode": "12345",
"state": "CA",
"email": "[email protected]",
"phone": "1234567890"
},
"items": [
{
"itemReferenceId": "test-item-ref",
"productName": "Sample Product",
"productVariant": {
"paper": "a1",
"color": "front"
},
"files": [
{
"type": "default",
"url": "https://example.com/test-file.pdf"
}
],
"quantity": 1,
"retailPriceInclVat": 19.99
}
]
}
Champs clés
productName: Doit correspondre exactement au nom de votre Produit Client dans GelatoConnect.
productVariant: Spécifiez les options telles que le type de papier, la taille ou la couleur en fonction de votre configuration.
fichiers : Fournissez l'URL du fichier à utiliser en production.
3. Validation de la commande test
Une fois la commande test passée, vérifiez les éléments suivants :
Confirmation de commande : Vérifiez la réponse de l'API pour vous assurer que la commande a été créée avec succès. Notez l'identifiant de la commande et l'état du traitement des commandes.
Affichage de la commande dans GNX : Connectez-vous à GelatoConnect (GNX) pour consulter les détails de la commande test.
Confirmez que tous les attributs et variantes sont correctement appliqués.
Vérifiez que les fichiers ont été téléchargés avec succès et qu'ils répondent aux exigences de production.
Vérification de l'emballage :
Examinez les détails de l'emballage dans l'affichage GNX.
Assurez-vous que les options sélectionnées (par exemple, l'emballage cadeau) correspondent à vos attentes.
Créer des contrôles d'emballage personnalisés (voir section 9 pour référence)
Créez des étagères personnalisées (voir section 9 pour référence)
Saisissez le code-barres manuellement avec le numéro de travail d'impression pour tester le flux de la station d'emballage
4. Résolution des problèmes
Si la commande test ne répond pas à vos attentes :
Vérifier la configuration du produit :
Vérifiez que les champs productName et productVariant dans la requête API correspondent à la configuration de votre Produit Client.
Assurez-vous que toutes les options requises sont incluses et correctement mappées.
Vérifier les fichiers : Confirmez que les fichiers téléchargés répondent aux exigences de taille et de format du Produit Client.
Vérifier les identifiants API : Assurez-vous que les identifiants utilisés disposent des autorisations nécessaires pour passer des commandes test.
Contacter l'assistance : Pour les problèmes persistants, contactez l'assistance GelatoConnect en indiquant l'identifiant de commande et les détails du problème.
Prochaine étape : 🔗 [Commencer - GCW] Surveillance de la production et gestion des exceptions