Introduction

Avertissements:

• Vous devez bien comprendre HTTP et XML
• Pour visualiser les fichiers d'exemples XML, vous devez utiliser un fureteur qui supporte les fichiers XML ou n'importe quel éditeur de textes.
• Vous devez connaître les liste codes d'état qui peuvent être retournées par le serveur Cybervente.

Interface

La communication entre le serveur CyberVente et votre application doit être faites par la commande POST du protocole HTTP(S).

• Construire la requête XML (texte) à partir de:
• l'identificateur de marchant assigné par by Postes Canada
• l'adresse de destination
• la liste des items (poids et dimensions) contenus dans le panier virtuel du consommateur

Le format de la requête XML est défini dans notre DTD (cybercolis-f.dtd)
Des exemples de requête XML se trouvent ici (exempledemande-f.xml) et ici (interfacehttp-f.html) et peuvent être réutilisés

Veuillez prendre note des points suivants concernant le format d'une requête XML:
1. Assurez-vous d'insérer au moins une espace entre deux descripteurs s'il n'y a pas d'autres renseignements.
2. Le caractère & a une signification bien spéciale en XML. Il est utilisé pour encoder les caractères Unicode. Si ce caractère est utilisé à d'autres fins (p. ex. s'il fait partie de la description d'un article), cela causera vraisemblablement des problèmes et la requête ne sera pas traitée.
3. N'ajoutez pas de champs optionnels non utilisés.
4. Les champs suivants sont requis pour que le système puisse traiter la demande pour chacune des destinations (les autres champs qui ne sont pas utilisés doivent être conformes au point 1):
   • Pour les envois à destination du Canada, les champs du pays et du code postal sont requis.
   • Pour les envois à destination des É.-U., les champs du pays et du nom ou code postal de l'état sont requis.
   • Pour les envois du régime international, seul le champ du pays est requis.
• Envoyer la requête XML à CyberVente en utilisant la commande POST de HTTP(S).
• Si vous utilisez Java, référez vous à la documentation sur Java(java.sun.com)
• Si vous utilisez ASP/VBScript, nous suggérons de visiter le site de AspObjects.com qui offre plusieurs composantes COM pour les communications HTTP.
  Un exemple complet en ASP est présenté ici.
• Si vous utilisez Perl, référez vous à la documentation du produit.
• Recevoir la réponse du serveur en XML (ou en HTML, voir plus loin).
  
• Le format de la réponse XML est défini dans notre DTD (cybercolis-f.dtd)
• Un exemple d'une transaction réussie se trouve ici (exemplereponse-f.xml).
• Un exemple d'une réponse incluant la calcul de l'espace libre se trouve ici (exemplereponseespacevide-f.xml).
• Un exemple retournant un erreur se trouve ici (exempleerreur-f.xml).
• La liste de tous les codes d'états se trouve ici.
• Chaque produit a un identificateur numérique. La liste des identificateurs se trouve ici.


Vous pouvez recevoir la réponse en format HTML. Avec cette méthode, vous incorporez directement la réponse dans votre page HTML. De cette manière, vous évitez les tâches suivantes:
• Comprendre la réponse de CyberVente
• Intégrer un analyseur XML à votre site
• Écrire le code pour transformer la réponse en code HTML
Si vous désirez plus d'information, télécharger la documentation et jetez un coup d'oeil à notre exemple écrit en ASP
• Analyser la réponse XML en utilisant votre analyseur syntaxique XML préféré.
Si votre profile est configuré pour retourner la réponse en format HTML, passez cette étape..
Il existe plusieurs analyseurs syntaxique XML sur le marché.
Tout dépendant de votre plate-forme de développement/utilisation, voici quelques produits disponibles:
• Si vous utilisez Java: Sun's XML parser
• Si vous utilisez ASP/VBScript de Microsoft: MSXML 4.0
• Si vous utilisez Perl: Active State
• Présenter les options de livraison au client.
• Nous recommandons que vous utilisiez les formats d'affichage suivants.

Tests d'intégration

Récapitulatif des paramètres d'entrée / sortie