Repérage

Obtenir un certificat de confirmation de livraison – Module SOAP

Résumé

Nom :	Obtenir le certificat de confirmation de livraison
Raison pour utiliser le service :	Pour récupérer l'image du certificat de confirmation de livraison (qui est un document présentant une preuve de livraison avec détails) pour un colis donné
Données d'entrée :	NIP
Données de sortie :	Document PDF
Exemples d'erreurs :	NIP introuvable, signature non disponible
Demandes de service précédentes habituelles :	Obtenir un résumé du repérage, Obtenir les détails de repérage
Prochaine demande de service habituelle :	Aucune demande de service directement lié
Historique des versions :	Notes de mise à jour

Détails sur la demande

WSDL:	track.wsdl
Point final (Conception) :	https://ct.soa-gw.canadapost.ca/vis/soap/track
Point final (Production) :	https://soa-gw.canadapost.ca/vis/soap/track
Espace de nommage :	http://www.canadapost.ca/ws/soap/track
Opération :	GetDeliveryConfirmationCertificate

Corps – SOAP

La présente section décrit les éléments XML d'entrée pour ce service. Pour obtenir la structure hiérarchique, consultez le diagramme XML.

Obtenir le certificat de confirmation de livraison – Éléments de la demande
Nom de l'élément	Type	Requis/Optionnel	Description
get-delivery-confirmation-certificate-request	complexe	requis	Élément XML de niveau supérieur de la structure de la réponse.
locale	simple	optionnel	Indique votre langue de préférence pour recevoir les messages d'erreur. EN = Anglais FR = Français Si aucune valeur n'est saisie, la langue par défaut est l'anglais.
pin	simple	requis	Le numéro d'identification du produit (NIP) est attribué par Postes Canada au cours de la création de l'étiquette d'expédition et utilisé aux fins de repérage. (12, 13 ou 16 caractères)

Demande – Diagramme XML

Obtenir le certificat de confirmation de livraison – Structure de la demande XML

Détails de la réponse

Réponse – Éléments

Le tableau suivant décrit les éléments XML figurant dans la réponse à la demande d'obtention d'un certificat de confirmation de livraison. Pour obtenir la hiérarchie de la réponse, consultez le diagramme XML.

Obtenir le certificat de confirmation de livraison – Éléments de réponse
Nom de l'élément	Type	Description
get-delivery-confirmation-certificate-response	complexe	Il s'agit de l'élément XML de niveau supérieur pour les données de la réponse. Il affichera les résultats d'une exécution réussie ou la structure d'un message d'erreur.
delivery-confirmation-certificate	complexe	Cette structure contient les résultats liés à l'exécution réussie du service.
filename	simple	Représente le nom du fichier du fichier image.
image	simple	Contenu du fichier codé en base 64.
mime-type	simple	Représente le fichier de type MIME (type/sous-type).

Réponse – Diagramme XML

Obtenir le certificat de confirmation de livraison – Structure de la réponse XML

Réponse – Réponses d'erreur possibles

La réponse à des conditions d'erreur pour ce service en ligne respecte l'approche standard SOAP liée à la réponse d'erreur, laquelle est utilisée pour tous les services en ligne de Postes Canada. Pour obtenir de plus amples renseignements, consultez les Principes de base liés au module SOAP pour les services en ligne de Postes Canada.

Les messages d'erreur possibles pour ce service sont les suivants :

Code	Message
007	Aucune donnée de livraison n'est disponible

Exemples

Exemple de demande XML selon le module SOAP – Obtenir le certificat de confirmation de livraison

<get-delivery-confirmation-certificate-request>

<locale>EN</locale>
<pin>1371134583769923</pin>

</get-delivery-confirmation-certificate-request>

Exemple de réponse XML selon le module SOAP – Obtenir le certificat de confirmation de livraison

<get-delivery-confirmation-certificate-response>

<delivery-confirmation-certificate>

<filename>1371134583769923.pdf</filename>
<image>JVBERi0xLjQKJeLjz(etc...base64 encoded PDF)</image>
<mime-type>application/pdf</mime-type>

</delivery-confirmation-certificate>

</get-delivery-confirmation-certificate-response>