Introduction
Ce guide explique la terminologie essentielle et les concepts que vous rencontrerez en travaillant avec les systèmes de gestion des commandes de GelatoConnect. Comprendre ces termes vous aidera à naviguer plus facilement sur la plateforme et à communiquer plus clairement sur les processus de gestion des commandes.
Principes de base des commandes
Commander
Une demande pour un ou plusieurs produits à produire et à expédier vers une adresse spécifiée. Une commande est l'unité de travail fondamentale dans GelatoConnect.
Identifiant de référence de commande
Votre identifiant unique pour une commande. Celui-ci doit correspondre à un ID de commande dans votre système et vous permet de suivre la relation entre les commandes GelatoConnect et vos systèmes internes.
N° de référence du client
Votre identifiant unique pour le client qui passe la commande. Cela permet d’associer les commandes à des clients précis dans votre système.
Type de commande
Définit la façon dont une commande doit être traitée. Il existe deux principaux types :
Commande : Une commande classique qui sera traitée sans attendre
Brouillon : Une commande enregistrée pour être modifiée et envoyée plus tard
Statut de la commande
Indique l'étape actuelle d'une commande dans le processus de traitement des commandes. Les statuts principaux sont les suivants :
Brouillon : Commande créée mais non soumise pour traitement
Reçu : Commande envoyée et en cours de validation initiale
Réussi : La commande a passé les vérifications de validation
Échec : La commande n'a pas passé les contrôles de validation
Créé : Commande validée et prête pour la production
En production : votre commande est en cours de traitement
Imprimé : la production est terminée
Emballé : La commande est prête à être expédiée
Expédié : La commande a été remise au transporteur
Livré : La commande a été livrée au destinataire
Annulée : La commande a été annulée à la demande ou par le système
Article commandé
Un produit individuel au sein d'une commande. Chaque article possède ses propres spécifications, quantités et fichiers. Plusieurs articles peuvent être inclus dans une seule commande.
N° de référence de l'article
Votre identifiant unique pour un article spécifique au sein d'une commande. Cela permet de suivre les produits individuels dans une commande plus importante.
Méthodes d'identification des produits
UID du produit
Un identifiant unique pour une configuration produit spécifique dans le système GelatoConnect. Les UID de produit suivent un format structuré qui encode les caractéristiques du produit.
Exemple : flat_product_pf_a4_pt_200-g/m²-non couché_cl_4-0_ct_none_prt_none_sft_none_set_none_hor
Cet identifiant contient des informations codées sur :
Type de produit (
flat_product
)Format papier (
pf_a4
)Type de papier (
pt_200-gsm-uncoated
)Configuration des couleurs (
cl_4-0
signifie 4 couleurs à l'avant, aucune couleur à l'arrière)Autres spécifications (découpe, impression, etc.)
Orientation (
hor
pour horizontal)
Produit client
Une méthode simplifiée pour identifier les produits grâce à un nom de produit et une structure de variantes. Cette approche est plus facile à lire et à gérer, surtout pour les catalogues des produits complexes.
Exemple :
{\"productName\": \"Carte de visite\","productVariant": {\"Taille\" : \"Standard\",\"Papier\" : \"Mat premium\",\"Couleur\" : \"Quadrichromie recto verso\"}}
Gestion des fichiers
Imprimer le fichier
Le fichier source contenant l'œuvre d'art à imprimer. Généralement un fichier PDF, PNG ou JPEG, selon les exigences du produit.
URL du fichier
L'emplacement où le fichier d'impression peut être consulté. Doit être une URL accessible publiquement à partir de laquelle GelatoConnect peut télécharger.
Type de fichier
Définit le rôle du fichier dans le produit. Les types courants incluent :
par défaut : Le fichier d'impression principal du produit
avant : Le fichier pour l'avant d'un produit
verso : Le fichier pour le verso d'un produit
couverture : Le fichier pour la couverture d’un livre
intérieur : Le fichier pour les pages intérieures d'un livre
Fichier traité
La version prête à l'impression du fichier d'impression après que GelatoConnect a appliqué toutes les transformations nécessaires.
Aperçu
Une représentation visuelle du rendu final du produit, basée sur les fichiers d'impression fournis.
Informations sur la livraison
Adresse de livraison
L'adresse de destination où la commande doit être livrée, avec les informations du destinataire.
UID du mode d'expédition
Un identifiant pour la méthode d'expédition à utiliser pour la commande. Il peut être précis (par exemple, fed_ex_2_day
) ou général (par exemple, express
).
Adresse de retour
L'adresse qui sera utilisée comme adresse de l'expéditeur sur le colis et pour tout retour.
Code de suivi
Un identifiant unique fourni par le transporteur pour suivre la progression de la livraison du colis.
URL de suivi
Une adresse web où le client peut suivre l’état actuel de son envoi.
Concepts d'intégration
API
Interface de programmation d'applications – la méthode permettant d'interagir avec GelatoConnect de façon automatisée. Utilise les méthodes HTTP standard (GET, POST, PUT, etc.) pour gérer les commandes.
Clé API et secret
Identifiants de sécurité utilisés pour authentifier les requêtes à l'API GelatoConnect. Composés d'une paire clé et secret qui doit être fournie dans l'en-tête X-API-KEY au format \"clé:secret\".
Webhook
Un rappel HTTP qui transmet des notifications concernant les événements dans GelatoConnect à votre système en temps réel.
Postback
Une notification envoyée depuis GelatoConnect vers votre système (ou vos clients) lorsque le statut d'une commande change.
Mappeur de modèles
Un outil pour transformer vos données dans votre format et dans celui de GelatoConnect, en utilisant le langage de template Jinja2.
Recherche
Un tableau de correspondance qui transforme les valeurs de votre système (comme les SKU de produits) en valeurs GelatoConnect (comme les identifiants uniques de produits).
Vitrine
Une plateforme e-commerce (comme Shopify, Etsy ou WooCommerce) que vous pouvez connecter à GelatoConnect pour importer automatiquement vos commandes.
FTP
Protocole de transfert de fichiers - une méthode pour téléverser des fichiers de commande vers GelatoConnect pour un traitement par lots.
Termes financiers et de facturation
Devise
L'unité monétaire dans laquelle les commandes seront facturées. Elle doit être précisée pour chaque commande en utilisant les codes de devise ISO (par exemple, USD, EUR, GBP).
Prix de vente
Le prix facturé au client final pour un produit, généralement utilisé pour les déclarations douanières lors d'expéditions internationales.
Concepts avancés
Demande de commande
La soumission initiale d'une commande avant qu'elle n'ait été entièrement traitée et validée.
Métadonnées
Informations supplémentaires associées à une commande sous forme de paires clé-valeur, utilisées à des fins de suivi, d'analyse ou d'intégration. Les métadonnées peuvent être appliquées à des articles individuels de la commande ou à l'ensemble de la commande.
Vérification avant lancement
Validation automatisée des fichiers d'impression pour garantir qu'ils répondent aux exigences de production.
Créateur de workflow
Un outil pour définir les étapes de production pour chaque type de produit.
Glossaire des abréviations
Abréviation
| Définition
|
PSP
| Prestataire de services d'impression
|
API
| Interface de programmation d'application
|
FTP
| Protocole de transfert de fichiers
|
UID
| Identifiant unique
|
Interface utilisateur
| Interface utilisateur
|
SLA
| Accord de niveau de service
|
EDI
| Échange de données informatisé
|
B2B
| Business to Business
|
B2C
| De l'entreprise au consommateur
|
CSV
| Valeurs séparées par des virgules
|
JSON
| JavaScript Object Notation
|
XML
| Langage de balisage extensible
|
Vous voulez en savoir plus ?
Maintenant que vous connaissez les termes et concepts courants utilisés dans les systèmes de prise de commandes de GelatoConnect, vous êtes mieux préparé pour :
Comprendre la documentation et les messages d'erreur
Naviguez sur la plateforme avec plus d'assurance
Pour des informations plus détaillées sur les aspects spécifiques de la prise de commande, veuillez consulter les sections pertinentes dans notre Centre d'aide.