Expédition sans convention

Exemples de codes pour l'expédition sans convention : Java (.zip) | PHP (.zip) | C# (.zip)

Obtenir le reçu de l'envoi sans convention – Module SOAP

Résumé

Nom : Obtenir le reçu de l'envoi sans convention
Raison pour utiliser le service : Cette demande de service permet d'obtenir les frais liés à l'étiquette et les renseignements sur le règlement en format XML. Les données de la réponse peuvent être formatées pour imprimer un reçu de carte de crédit.
Données d'entrée : Numéro d'identification de l'envoi
Données de sortie : Détails du reçu en format XML
Demande de service précédente habituelle : Créer l'envoi sans convention ou Obtenir l'envoi sans convention
Prochaine demande de service habituelle : Obtenir l'artefact ou Créer l'envoi sans convention
Historique des versions : Notes de mise à jour

Détails sur la demande

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

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 reçu de l'envoi sans convention – Éléments de la demande
Nom de l'élément Type Requis/Optionnel Description

get-non-contract-shipment-receipt-request

complexe

requis

Élément XML de niveau supérieur de la structure de la réponse.

mailed-by

simple

requis

(1 à 10 caractères numériques)

Il s'agit du numéro de client à 10 chiffres du client « Expédié par ».

Si le numéro fourni compte moins de 10 chiffres, le système ajoutera des zéros au début.

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 fournie, la langue par défaut est « Anglais ».

shipment-id

simple

requis

(Chaîne alphanumérique – Jusqu'à 32 lettres/chiffres)

Numéro d'identification représentant l'envoi existant pour lequel les renseignements sont demandés.

Nota : Il faut récupérer les numéros d'identification des envois fournis dans le cadre des demandes de service précédentes « Créer l'envoi sans
convention » et « Obtenir l'envoi sans convention ». Les données de sortie de ces services comprendront un numéro d'identification pour l'envoi.

Demande – Diagramme XML

Obtenir le reçu de l'envoi sans convention – Structure de la demande XML

Obtenir le reçu de l'envoi sans convention – 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 du reçu de l'envoi sans convention. Pour obtenir la hiérarchie de la réponse, consultez le diagramme XML.

Obtenir le reçu de l'envoi sans convention – Éléments de la réponse
Nom de l'élément Type Description

get-non-contract-shipment-receipt-response

complexe

Il s'agit de l'élément XML de niveau supérieur de la structure de la réponse.

Il affichera les résultats d'une exécution réussie ou la structure d'un message d'erreur.

non-contract-shipment-receipt

complexe

Structure XML contenant les résultats liés à l'exécution réussie du service en question.

final-shipping-point

Simple

Il s'agit du code postal du bureau de poste où l'envoi doit être déposé.

shipping-point-name

Simple

Il s'agit du nom descriptif du point d'expédition.

shipping-point-id

Simple

Il s'agit du numéro d'identification de Postes Canada pour le point d'expédition.

mailed-by-customer

Simple

Il s'agit du numéro de client à 10 chiffres pour le client « Expédié par ».

cc-receipt-details

Complexe

Cette structure contient les détails requis pour un reçu de carte de crédit.

merchant-name

Simple

La valeur sera la suivante : “Canada Post”.

merchant-url

Simple

La valeur sera la suivante : “www.canadapost.ca”.

name-on-card

Simple

Nom figurant sur la carte de crédit par défaut sauvegardée par Postes Canada.

auth-code

Simple

Code d'autorisation reçu de la société émettrice de la carte de crédit.

auth-timestamp Simple

Date et heure de l'autorisation.
La date et l'heure sont précisées dans le format XML standard « AAAA-MM-JJThh:mm:ss » lorsque :

  • « AAAA » = Année
  • « MM » = Mois
  • « JJ » = Journée
  • « T » = Début de la section de temps requise
  • « hh » = Heure
  • « mm » = Minute
  • « ss » = Seconde

card-type

Simple

Type de carte utilisé pour l'achat.

La valeur doit être l'une des suivantes :
- MC
- VIS
- AME

charge-amount

Simple

Montant total facturé sur la carte de crédit pour l'étiquette ou le service d'expédition.

currency

Simple

Devise de la transaction : CAD.

transaction-type

Simple

Type de transaction par carte de crédit : Sale.

service-code

Simple

Il s'agit du service de livraison de Postes Canada utilisé pour expédier l'article.

Peut être l'un des services suivants :

Service-Code Description
Régime intérieur
DOM.RP Colis standard
DOM.EP Colis accélérés
DOM.XP Xpresspost
DOM.PC Priorité
États-Unis

USA.PW.ENV

Enveloppe Priorité Mondial – É.-U.

USA.PW.PAK

Paquet Priorité Mondial – É.-U.

USA.PW.PARCEL

Colis Priorité Mondial – É.-U.

USA.XP

Xpresspost É.-U.

USA.EP

Colis accélérés É.-U.

USA.SP.AIR

Petit paquet-avion à destination des É.-U.

USA.SP.SURF

Petit paquet de surface à destination des É.-U.

Régime international

INT.PW.ENV

Enveloppe Priorité Mondial – International

INT.PW.PAK

Paquet Priorité Mondial – International

INT.PW.PARCEL

Colis Prioritié Mondial – International

INT.XP

Xpresspost – International

INT.SP.AIR

Petits paquets-avion du régime international

INT.SP.SURF

Petits paquets de surface du régime international

Il s'agit du code du service de livraison utilisé pour la livraison de l'envoi.

base-amount

Simple

Il s'agit du coût de base pour l'expédition en dollars canadiens.

priced-options

Complexe

Cette structure contient la liste d'options appliquées à cet envoi et l'incidence tarifaire connexe.

Cet élément sera absent s'il n'y a aucune option appliquée au tarif de cet envoi.

priced-option

Complexe

Occurrence (1 à N fois).

Chaque occurrence correspond à une structure représentant une option d'expédition qui s'applique à l'envoi et qui pourrait avoir une incidence sur le tarif de cet envoi.

option-code

Simple

Il s'agit du code d'option pour une option appliquée à cet envoi.

Voici des exemples de codes d'option :
COD – Contre remboursement
COV – Couverture
CYL – Tube d'expédition
DC – Confirmation de livraison
PA18 – Preuve d'âge (18 ans)
PA19 – Preuve d'âge (19 ans)
SO – Option Signature
UP – Non emballé

option-price

Simple

Il s'agit de la composante totale du tarif attribuable à l'option. Les unités s'affichent en dollars canadiens.

adjustments

Complexe

Cette structure contient la liste de rajustements appliqués à cet envoi et l'incidence tarifaire connexe.

Cet élément sera absent s'il n'y a aucun rajustement appliqué au tarif de cet envoi.

adjustment

Complexe

Occurrence (1 à N fois).

Cette structure représente un rajustement apporté à l'expédition qui s'applique à l'envoi, ce qui pourrait avoir une incidence tarifaire sur l'envoi.

adjustment-code

Simple

Il s'agit du code de rajustement désignant le rajustement appliqué à cet envoi.

adjustment-amount

Il s'agit du coût total attribuable au rajustement.

pre-tax-amount

Simple

Il s'agit du montant total avant les taxes pour le tarif d'expédition.

gst-amount

Simple

Il s'agit du montant de TPS ajouté au prix de base.

pst-amount

Simple

Il s'agit du montant de TVP ajouté au prix de base.

hst-amount

Simple

Il s'agit du montant de TVH ajouté au prix de base.

service-standard

Complexe

Cette structure représente la norme de service selon laquelle cet envoi sera livré.

am-delivery

Simple

{vrai, faux}

Cela indique si la livraison le matin fait partie de la norme de service.

guaranteed-delivery

Simple

{vrai, faux}

Cela indique si la garantie de livraison fait partie de la norme de service.

expected-transit-time

Simple

Il s'agit du nombre de jours pendant lesquels le paquet devrait se trouver dans le flot du courrier, c'est-à-dire depuis le dépôt jusqu'à la livraison.

expected-delivery-date

Simple

Il s'agit de la date de livraison approximative en fonction de la date de création de l'envoi ou de la date de dépôt prévue fournie dans la demande de création si elle dépasse la date de livraison prévue.

rated-weight

Simple

Il désigne le poids réel ou l'équivalent volumétrique utilisé pour déterminer le tarif de base, dans le cadre des limites prescrites en matière de poids et de dimensions pour le produit concerné, à partir du calcul de Postes Canada ou de votre déclaration, selon la plus élevée des deux valeurs.

Réponse – Diagramme XML

Obtenir le reçu de l'envoi sans convention – Structure de la réponse XML
Obtenir le reçu de l'envoi sans convention – 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.

Exemples

Exemple de demande XML selon le module SOAP – Obtenir le reçu de l'envoi sans convention

<get-non-contract-shipment-receipt-request>
<mailed-by>1111111</mailed-by>
<locale>EN</locale>
<shipment-id>406951321983787352</shipment-id>
</get-non-contract-shipment-receipt-request>

Exemple de réponse XML selon le module SOAP – Obtenir le reçu de l'envoi sans convention

<get-non-contract-shipment-receipt-response>
<non-contract-shipment-receipt>
<final-shipping-point>K1A0B1</final-shipping-point>
<shipping-point-name>CANADA POST PLACE PO #1</shipping-point-name>
<shipping-point-id>2011</shipping-point-id>
<mailed-by-customer>0003798235</mailed-by-customer>
<service-code>DOM.EP</service-code>
<rated-weight>15.000</rated-weight>
<base-amount>16.38</base-amount>
<pre-tax-amount>17.16</pre-tax-amount>
<gst-amount>0.00</gst-amount>
<pst-amount>0.00</pst-amount>
<hst-amount>2.23</hst-amount>
<priced-options>
<priced-option>
<option-code>DC</option-code>
<option-price>0</option-price>
</priced-option>
</priced-options>
<adjustments>
<adjustment>
<adjustment-code>AUTDISC</adjustment-code>
<adjustment-amount>-0.49</adjustment-amount>
</adjustment>
<adjustment>
<adjustment-code>FUELSC</adjustment-code>
<adjustment-amount>1.27</adjustment-amount>
</adjustment>
</adjustments>
<cc-receipt-details>
<merchant-name>Canada Post</merchant-name>
<merchant-url>www.canadapost.ca</merchant-url>
<name-on-card>John Doe</name-on-card>
<auth-code>454819</auth-code>
<auth-timestamp>2012-04-15T12:17:16-04:00</auth-timestamp>
<card-type>MC</card-type>
<charge-amount>19.39</charge-amount>
<currency>CAD</currency>
<transaction-type>Sale</transaction-type>
</cc-receipt-details>
<service-standard>
<am-delivery>false</am-delivery>
<guaranteed-delivery>true</guaranteed-delivery>
<expected-transit-time>1</expected-transit-time>
<expected-delivery-date>2012-04-17</expected-delivery-date>
</service-standard>
</non-contract-shipment-receipt>
</get-non-contract-shipment-receipt-response>