Méthode business/deals/send

Last modified: 11. mars 2022

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 :

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éviationACTIONGÉNÈRE LE DOCUMENT
RRefuser la commande (reject)ORDERRESPONSE
CConfirmer la commande (confirm)ORDERRESPONSE
AMarquer comme envoyé (advise)DISPATCHNOTIFICATION
IMarquer 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

Was this article helpful?
Dislike 0
Views: 22