Repérage

Exemples de codes de repérage : Java (.zip) | PHP (.zip) | C# (.zip)

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

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

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>