Données de commande et de devis au format OpenTrans 2.1

Last modified: 29. juillet 2022

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
  • 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.

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 modificationChampChangement
Juillet 2022PRODUCT_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 2022AGREEMENT_END_DATE en AGREEMENTPlus de champ obligatoire
Novembre 2021ORDER_UNITListe des unités complétées par Z11 (hanging container)
Octobre 2021COUNTRY_CODED en ADDRESSListe des codes de pays complétée par XR (Kosovo)
Octobre 2021ART_ID
PROD_ID
SUPPLIER_AID
SUPPLIER_AIDREF
SUPPLIER_PIDREF
La longueur maximale est passée de 30 à 150 caractères
Octobre 2021MANUFACTURER_PIDLa longueur maximale est passée de 50 à 150 caractères
Septembre 2021Champs 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 2021DESCRIPTION_SHORTLa longueur maximale est passée de 150 à 1024 caractères
Juin 2021SERIAL_NUMBERAjout de l’attribut « type »
Juin 2021NAME en ADDRESSLa 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.

Was this article helpful?
Dislike 0
Views: 186