Informations générales
ITscope utilise le standard industriel OpenTrans 2.1 comme format pour les commandes et les devis.
De nombreux systèmes (ERP, magasins) peuvent lire ou également générer ce format et donc l’envoyer directement à ITscope via l’API Deal.
Lors du développement de fichiers OpenTrans 2.1, nous vous recommandons de toujours définir les champs obligatoires. Elles sont très bien décrites dans la documentation du paquet de téléchargement respectif ci-dessous. Tous les documents OpenTrans 2.1 peuvent être validés par rapport aux définitions de schéma XML (XSD) d’OpenTrans 2.1 via la méthode API ITscope business/documents/validate avant l’envoi ou pendant la phase de développement.
ITscope prend en charge les documents OpenTrans 2.1 suivants :
- ORDER – Document de commande qui est envoyé au fournisseur respectif. De nombreux fournisseurs peuvent traiter directement ce format. Ce document peut être téléchargé pour un traitement ultérieur ou la création d’un nouveau devis dans d’autres systèmes via la méthode API ITscope /business/deals
- voir aussi le document de commande ESD ORDER
- ORDERRESPONSE – Document de réponse à une commande retourné à ITscope par de nombreux fournisseurs. Selon le fournisseur, différentes informations sur l’état actuel du traitement de la commande sont données
- DISPATCHNOTFICATION – Document d’avis d’expédition qui est retourné à ITscope par de nombreux fournisseurs. Selon le fournisseur, différentes informations sur l’expédition des marchandises sont données
- INVOICE – Document de facturation retourné à ITscope par de nombreux fournisseurs. Selon le fournisseur, différentes informations sont données pour le calcul des biens
- QUOTATION – Document de devis pour un devis créé sur ITscope. Ce document peut être téléchargé via la méthode API ITscope /business/quotes pour un traitement ultérieur ou la création d’une nouvelle cotation dans d’autres systèmes.
- Dans l’élément XML <BUYER_PID type= »itscope »> des positions d’offre, l’ID du supplierItem est stocké, si la position d’offre est un article ITscope. Par exemple : <ns2:BUYER_PID type= »itscope »>53514216</ns2:BUYER_PID>. Cela permet d’identifier une source unique (supplierItem) du produit.
- Dans l’élément XML <BUYER_PID type= »itscope »> des positions d’offre, l’ID du supplierItem est stocké, si la position d’offre est un article ITscope. Par exemple : <ns2:BUYER_PID type= »itscope »>53514216</ns2:BUYER_PID>. Cela permet d’identifier une source unique (supplierItem) du produit.
Validation des documents OpenTrans 2.1
Si OpenTrans 2.1 a déjà été implémenté et que l’API ITscope a été connectée, les documents OpenTrans peuvent être validés via la méthode API /business/documents/validate.
Il est important que les espaces de noms correspondants soient définis dans le document XML, c’est-à-dire que chaque élément qui n’appartient pas à l’espace de noms principal soit également marqué en conséquence. En principe, les exemples et la documentation doivent être utilisés pour créer de nouveaux documents et, en cas d’erreurs de validation, la documentation fournit une assistance concernant les champs obligatoires, l’ordre des champs, la longueur des champs, les types de données des champs et le formatage des champs.
Déviations de la norme XSD d’OpenTrans
Comme le schéma OpenTrans n’est plus développé, nous avons décidé de procéder à des adaptations pour nos cas d’application. Un fichier de schéma adapté peut être téléchargé ci-dessous sous Téléchargements.
Date de la modification | Champ | Changement |
Juillet 2022 | PRODUCT_STOCK_FIX | Élément supplémentaire dans ORDER_ITEM si la commande a été passée via la plateforme ITscope ou une suite B2B. Contient des informations sur le stock actuel au moment de la commande. |
Avril 2022 | AGREEMENT_END_DATE en AGREEMENT | Plus de champ obligatoire |
Novembre 2021 | ORDER_UNIT | Liste des unités complétées par Z11 (hanging container) |
Octobre 2021 | COUNTRY_CODED en ADDRESS | Liste des codes de pays complétée par XR (Kosovo) |
Octobre 2021 | ART_ID PROD_ID SUPPLIER_AID SUPPLIER_AIDREF SUPPLIER_PIDREF | La longueur maximale est passée de 30 à 150 caractères |
Octobre 2021 | MANUFACTURER_PID | La longueur maximale est passée de 50 à 150 caractères |
Septembre 2021 | Champs pour les informations sur les prix récurrents insérés, voir Structure du document de commande (ORDER) pour les commandes contenant des produits d’abonnement | |
Juillet 2021 | DESCRIPTION_SHORT | La longueur maximale est passée de 150 à 1024 caractères |
Juin 2021 | SERIAL_NUMBER | Ajout de l’attribut « type » |
Juin 2021 | NAME en ADDRESS | La longueur maximale est passée de 50 à 100 caractères |
OpenTrans 2.1 télécharger
La documentation et les XSDs d’OpenTrans 2.1 en anglais et en allemand.
Egalement un exemple de fichier pour les devis.