Généralités
- La norme industrielle OpenTrans 2.1 est utilisée comme format pour les commandes
- téléchargez la documentation et les exemples de fichiers d’OpenTrans 2.1 ici
- le MimeType doit être application/xml
- l’envoi ne fonctionne que via HTTP POST
- dans le corps du POST, seul l’ORDER doit être au format OpenTrans 2.1 et codé en UTF-8
- une commande ne peut être envoyée directement qu’à un seul distributeur. Une nouvelle commande OpenTrans doit donc être créée pour chaque distributeur.
Une liste de tous les distributeurs et de leurs données de base peut être récupérée via l’API. Le Supplier->ID est le numéro unique du distributeur dans ITscope.
L’ordre est soumis à plusieurs validations avant d’être effectivement envoyé
- Validation au format OpenTrans 2.1
- numéro de commande : 18 caractères maximum
- validation si les différents articles sont également disponibles dans notre catalogue pour le distributeur mentionné ci-dessus
- PAS de validation sur un prix ou une disponibilité valide
- valider si le total des articles individuels et des quantités correspond au total final
- pour les commandes de projets : PAS de validation si le numéro de projet spécifié est inclus dans la liste de projets établie sur ITscope.com.
Bien entendu, des erreurs peuvent également se produire lors de l’envoi ou de la synchronisation des messages d’erreur du système du distributeur.
L’API renvoie toujours les messages d’erreur appropriés et les HTTPCodes >400
Si une commande est envoyée complètement, le HTTPCode 200 est envoyé et une réponse avec les données suivantes :
- Le nouvel OrderID
- l’état actuel de la commande.
Soumettre une commande de test au fournisseur de tests du partenaire ITscope
Les commandes de test peuvent être envoyées au système en direct via l’API à un fournisseur de test maintenu par ITscope appelé ITscope Partner Test. Ce fournisseur de test a le numéro de fournisseur 10000735. Vous avez besoin d’une activation supplémentaire d’ITscope pour pouvoir voir ce fournisseur de test et donc aussi pour commander chez lui.
Il est facile de vérifier si le fournisseur de tests est activé de deux façons :
- Test via la plateforme ITscope. Si ce lien https://www.itscope.com/red/app#companies/page/21353a78-b8da-4eef-8e60-27408e023ee6 montre une entreprise, alors le fournisseur de test est activé
- directement sur l’API via API-Key une liste de tous les distributeurs peut être chargée, là le fournisseur devrait être disponible.
Ex : https://api.itscope.com/2.0/business/deals/send/10000735
Créer automatiquement les documents de réponse
Pour que vous puissiez tester de manière réaliste si votre système peut également traiter les documents de réponse de notre part (confirmation de commande, avis d’expédition et facture), vous avez la possibilité de spécifier les documents à générer et leur nombre.
Note : le nombre de documents à générer est limité à 6 dans chaque cas.
Vous pouvez contrôler cela via le numéro de commande (Order-ID). Pour ce faire, il suffit d’ajouter un caractère « § » au numéro d’ordre suivi des paramètres énumérés ci-dessous. Les paramètres sont spécifiés comme suit :
§<Abréviation1><Nombre1><Abréviation2><Nombre2> etc.
Les abréviations suivantes conduisent à la génération du document correspondant :
| Abréviation | ACTION | GÉNÈRE LE DOCUMENT |
|---|---|---|
| R | Refuser la commande (reject) | ORDERRESPONSE |
| C | Confirmer la commande (confirm) | ORDERRESPONSE |
| A | Marquer comme envoyé (advise) | DISPATCHNOTIFICATION |
| I | Marquer comme calculé (invoice) | INVOICE |
Les majuscules et les minuscules ne doivent pas être prises en compte.
Exemples de numéro de commande :
TEST180620§C3A1I2
Notre système émettra immédiatement 3 confirmations de commande (C3), 1 avis d’expédition (A1) et 2 factures (I2) pour une commande portant ce numéro de commande.
TEST180620§R1
Notre système émettra 1 document de réponse (R1) pour une commande avec ce numéro de commande, dans lequel la commande est rejetée.
TEST180620
Sans spécifier aucun paramètre, l’ordre de test est simplement déclenché sans générer aucun document de réponse.
Envoi d’une commande à un fournisseur
Le document de commande doit être créé comme décrit dans les sections ci-dessus, validé et ensuite envoyé au distributeur concerné en utilisant l’identifiant du distributeur.
L’envoi doit être effectué via HTTP POST et le contenu du POST est l’ORDER simple en XML. Le type de contenu du poste doit être défini dans le formulaire application/xml;charset=UTF-8.
Ex : https://api.itscope.com/2.0/business/deals/send/10000136