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.
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.
S’il n’y a pas encore de connexion API, l’outil web simple ITscope Simple OpenTrans 2.1 Validator peut également être utilisé. C’est le même validateur qui est également utilisé pour l’API. Toutefois, nous ne recommandons l’outil web que si vous n’êtes qu’en phase de développement des documents.
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.
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.