Tarification
Obtenir les tarifs – Module SOAP
Résumé
| Nom : | Obtenir les tarifs |
|---|---|
| Raison pour utiliser le service : | Pour obtenir une liste de services, de tarifs et de délais de transit pour un envoi |
| Données d'entrée : | Renseignements de base sur les adresses et les colis |
| Données de sortie : | Services, tarifs, délais de transit et date de livraison prévue |
| Exemple d'erreur : | Aucun service n'est approprié pour l'expédition du colis désigné. Il faut donc comparer les critères du colis aux spécifications du produit. |
| Demande de service précédente habituelle : | Aucune demande de service précédente directement liée |
| Prochaine demande de service habituelle : | |
| Historique des versions : | Notes de mise à jour |
Détails sur la demande
| WSDL: | rating.wsdl |
|---|---|
| Point final (Conception) : | https://ct.soa-gw.canadapost.ca/rs/soap/rating/v4* |
| Point final (Production) : | https://soa-gw.canadapost.ca/rs/soap/rating/v4 |
| Espace de nommage : | http://www.canadapost.ca/ws/soap/ship/rate/v4 |
| Opération : | GetRates |
*Si vous n'êtes pas un client commercial de Postes Canada titulaire d'une convention, mais que vous mettez en place une solution d'expédition par tierce partie destinée aux clients commerciaux, veuillez lire les renseignements importants sur la façon de mettre à l'essai les services d'expédition avec convention dans notre environnement « Bac à sable ».
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 les tarifs – Éléments de la demande | |||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Nom de l'élément | Type | Requis/Optionnel | Description | ||||||||||||||||||||||||||||||||||||
get-rates-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 Si aucune valeur n'est saisie, la langue par défaut est l'anglais. |
||||||||||||||||||||||||||||||||||||
mailing-scenario |
complexe |
requis |
Structure XML générale pour les données d'entrée de la demande. |
||||||||||||||||||||||||||||||||||||
customer-number |
simple |
requis sous condition |
Numéro de client du propriétaire du courrier (Expédié au nom de) (Format numérique – Jusqu'à 10 chiffres) Cet élément est exigé pour obtenir des tarifs réduits pour les clients commerciaux et les clients du programme Solutions pour petites entreprises. Il faut l'omettre pour obtenir les tarifs au comptoir (c.-à-d. tarifs des particuliers). |
||||||||||||||||||||||||||||||||||||
contract-id |
simple |
requis sous condition |
Cet élément est exigé pour obtenir des tarifs réduits pour les clients commerciaux lorsque le numéro de client n'est pas fourni. Il faut omettre le numéro d'identification de la convention pour les clients du programme Solutions pour petites entreprises ou les utilisateurs commerciaux généraux. (Format numérique – Jusqu'à 10 chiffres) |
||||||||||||||||||||||||||||||||||||
promo-code |
simple |
optionnel |
Si vous avez un code de réduction promotionnelle, saisissez-le ici. Le montant de la réduction sera affiché dans la réponse sous la structure <adjustment>. |
||||||||||||||||||||||||||||||||||||
quote-type |
simple |
optionnel |
Option « Commercial » ou « Counter »
L'option « Commercial » s'affiche par défaut si aucune option n'est sélectionnée. |
||||||||||||||||||||||||||||||||||||
expected-mailing-date |
simple |
optionnel |
Date d'expédition prévue pour le colis Cette date est utilisée pour calculer la date de livraison prévue. Cependant, toutes les propositions tarifaires sont fonction de la date actuelle du système. (Format de la date : AAAA-MM-JJ) |
||||||||||||||||||||||||||||||||||||
options |
complexe |
optionnel |
Structure contenant la liste d'options voulues pour l'envoi |
||||||||||||||||||||||||||||||||||||
option |
complexe |
requis |
Occurrence (1 à 20 fois) Comprend le code d'option et le qualificatif pour une option sélectionnée. |
||||||||||||||||||||||||||||||||||||
option-code |
simple |
requis |
(10 caractères alphanumériques) Comprend le code d'option propre à Postes Canada. Valeurs valides : SO – Signature |
||||||||||||||||||||||||||||||||||||
option-amount |
simple |
requis (selon le code d'option) |
Requis pour COV – Montant de l'assurance à acheter Cinq chiffres, suivis de deux décimales (p. ex. 99999.99) |
||||||||||||||||||||||||||||||||||||
parcel-characteristics |
complexe |
requis |
Détails liés au colis (p. ex. poids, dimensions et apparence) |
||||||||||||||||||||||||||||||||||||
weight |
simple |
requis |
Poids du colis en kilogrammes (99.999) |
||||||||||||||||||||||||||||||||||||
dimensions |
complexe |
optionnel |
Détails liés aux dimensions du colis en centimètres. |
||||||||||||||||||||||||||||||||||||
length |
simple |
requis |
Dimension la plus longue (Trois chiffres, suivis d'une décimale [p. ex. format 999.9]) |
||||||||||||||||||||||||||||||||||||
width |
simple |
requis |
Deuxième plus longue dimension (Trois chiffres, suivis d'une décimale [p. ex. format 999.9]) |
||||||||||||||||||||||||||||||||||||
height |
simple |
requis |
Dimension la plus courte (Trois chiffres, suivis d'une décimale [p. ex. format 999.9]) |
||||||||||||||||||||||||||||||||||||
unpackaged |
simple |
optionnel |
vrai | faux
|
||||||||||||||||||||||||||||||||||||
mailing-tube |
simple |
optionnel |
vrai | faux
|
||||||||||||||||||||||||||||||||||||
oversized |
simple |
optionnel |
vrai | faux
|
||||||||||||||||||||||||||||||||||||
services |
complexe |
optionnel |
Précise les services pour lesquels il faut déterminer le tarif pour ce scénario d'expédition. |
||||||||||||||||||||||||||||||||||||
service-code |
simple |
requis |
Occurrence (1 à 20 fois) Le tarif doit être déterminé pour un service précis. Si aucun service-code n'est inclus dans la demande, le tarif sera déterminé pour tous les services liés à l'envoi et à la destination, puis l'envoi sera retourné.
|
||||||||||||||||||||||||||||||||||||
origin-postal-code |
simple |
requis |
Code postal à partir duquel le colis sera envoyé Format ANANAN (seulement accepté avec majuscules) |
||||||||||||||||||||||||||||||||||||
destination |
complexe |
requis |
Définit la destination du colis. |
||||||||||||||||||||||||||||||||||||
domestic |
complexe |
choix |
Définit la destination au Canada. |
||||||||||||||||||||||||||||||||||||
postal-code |
simple |
requis |
Code postal de destination Format ANANAN (seulement accepté avec majuscules) |
||||||||||||||||||||||||||||||||||||
united-states |
complexe |
choix |
Définit la destination aux États-Unis. |
||||||||||||||||||||||||||||||||||||
zip-code |
simple |
requis |
Il est utilisé lorsque le code de pays est « US ». Le format est de cinq chiffres ou de cinq chiffres suivis de quatre autres chiffres (pour les codes ZIP prolongés). Exemple : 12345 ou 12345-6789 |
||||||||||||||||||||||||||||||||||||
international |
complexe |
choix |
Il s'agit de la destination internationale (destination autre que les États-Unis ou le Canada). Seule une destination (internationale, États-Unis ou régime intérieur) peut être précisée. |
||||||||||||||||||||||||||||||||||||
country-code |
simple |
requis |
Code de pays de destination – Code de pays standard à deux caractères (code de pays valide autre que CA ou US) |
||||||||||||||||||||||||||||||||||||
postal-code |
simple |
choix |
Le champ relatif au code postal peut être fourni si le client aimerait recevoir une garantie de date de livraison pour un pays membre du Kahala Post Group (KPG). |
||||||||||||||||||||||||||||||||||||
Demande – Diagramme XML
Détails de la réponse
Éléments de réponse
Le tableau suivant décrit les éléments XML figurant dans la réponse à la demande d'obtention des tarifs. Pour obtenir la hiérarchie de la réponse, consultez le diagramme XML.
| Obtenir les tarifs – Éléments de la réponse | ||
|---|---|---|
| Nom de l'élément | Type | Description |
get-rates-response |
complexe |
Niveau supérieur de l'élément XML pour la réponse. Ce niveau affichera les résultats d'une exécution réussie ou la structure d'un message d'erreur. |
price-quotes |
complexe |
Une ou plusieurs propositions tarifaires sont fondées sur le nombre de services postaux disponibles ou sélectionnés pour l'envoi. |
price-quote |
complexe |
Coûts et normes de livraison pour un service postal distinct |
service-code |
simple |
Code du service postal faisant l'objet d'une proposition tarifaire |
service-name |
simple |
Nom du service dans la langue de préférence |
price-details |
complexe |
Analyse détaillée des coûts pour l'envoi s'il est expédié à l'aide de ce service |
base |
simple |
Coût de base de l'envoi avant les taxes |
taxes |
complexe |
Contient des détails liés aux taxes facturées pour cet envoi s'il est envoyé à l'aide de ce service. (Ne contiendra pas les trois types de taxes à la fois.) |
gst |
simple |
Taxe sur les produits et services |
pst |
simple |
Taxe de vente provinciale |
hst |
simple |
Taxe de vente harmonisée |
percent |
Attribut de la TVH, de la TVP ou de la TPS |
Indique le pourcentage des taxes appliquées au montant de base. |
due |
simple |
Coût total de l'envoi s'il est expédié à l'aide de ce service (y compris les taxes, les réductions, les suppléments et les options sélectionnés ou nécessaires) |
options |
complexe |
Cette structure contient les options sélectionnées ainsi que les options gratuites et les caractéristiques de colis pour les tubes d'expédition, les articles surdimensionnés ou non emballés si elles ont été sélectionnées ou justifiées selon les dimensions. |
option |
complexe |
Cette structure contient les détails liés à une seule option. |
option-code |
simple |
Code unique pour l'option Structure présentant les détails supplémentaires liés à l'option (le cas échéant) |
option-name |
simple |
Nom de l'option dans la langue de préférence |
option-price |
simple |
Coût de cette option pour le colis en question |
qualifier |
complexe |
Contient des détails supplémentaires liés à l'option (le cas échéant). |
step-size |
simple |
Indique la taille de la tranche aux fins de tarification par tranche supplémentaire (p. ex. montant de la couverture achetée dans une tranche, soit 100 $). |
step-cost |
simple |
Indique le coût lié à la taille d'une tranche (p. ex. 75 cents pour chaque tranche (100 $) de la couverture. |
included-amount |
simple |
Désigne la couverture offerte par le service de base (p. ex. la première tranche de 100 $ de la couverture est incluse). |
max-value |
simple |
Indique le montant maximal de l'option (p. ex. couverture maximale de 5 000 $). |
included |
simple |
Indique que l'option est offerte gratuitement. |
percent |
simple |
Si l'option est fonction de la valeur du pourcentage, le pourcentage en question s'affichera. |
adjustments |
complexe |
Structure contenant les détails liés aux rajustements tarifaires |
adjustment |
complexe |
Structure contenant les détails liés à un rajustement tarifaire |
adjustment-code |
simple |
Code désignant le rajustement AUTDISC – Réduction à l'automatisation |
adjustment-name |
simple |
Nom du rajustement dans la langue de préférence |
adjustment-cost |
simple |
Montant du rajustement en dollars et en cents |
qualifier |
complexe |
Contient le qualificatif du rajustement (le cas échéant). |
percent |
simple |
Si le rajustement est fonction de la valeur du pourcentage, le pourcentage en question s'affichera (p. ex. supplément pour carburant). |
weight-details |
complexe |
Il sera vide si les dimensions ne sont pas fournies ou si le poids réel du colis dépasse le poids volumétrique standard propre aux dimensions. |
cubed-weight |
simple |
L'équivalent volumétrique du poids réel (EV) du paquet. L'EV n'est pas une unité de mesure ni une masse ou un volume. Il assure une tarification plus exacte d'un article, compte tenu de son poids et de l'espace qu'il occupe. |
service-standard |
complexe |
Contient les détails liés à la livraison du colis si le service ayant fait l'objet d'une proposition tarifaire est sélectionné. |
am-delivery |
simple |
vrai | faux Indique si la livraison le matin est définie dans le cadre de la norme de service pour le service en question. |
guaranteed-delivery |
simple |
vrai | faux Indique si la date de livraison est garantie. |
expected-transit-time |
simple |
Indique le nombre de jours entre le dépôt ou le ramassage et la première tentative de livraison. |
expected-delivery-date |
simple |
Date approximative de livraison en fonction de la date d'expédition prévue |
Réponse – Diagramme 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 les tarifs
<get-rates-request>
<mailing-scenario>
<customer-number>1111111</customer-number>
<contract-id>12345678</contract-id>
<parcel-characteristics>
<weight>1</weight>
</parcel-characteristics>
<services>
<service-code>DOM.XP</service-code>
</services>
<origin-postal-code>V6B4A2</origin-postal-code>
<destination>
<domestic>
<postal-code>J0E1X0</postal-code>
</domestic>
</destination>
</mailing-scenario>
</get-rates-request>
Exemple de réponse XML selon le module SOAP – Obtenir les tarifs
<get-rates-response>
<price-quotes>
<price-quote>
<service-code>DOM.XP</service-code>
<service-name>Xpresspost</service-name>
<price-details>
<base>24.09</base>
<taxes>
<gstpercent="5.0">1.32</gst>
<pst>0.00</pst>
<hst>0.00</hst>
</taxes>
<due>27.73</due>
<options>
<option>
<option-code>DC</option-code>
<option-name>Delivery confirmation</option-name>
<option-price>0</option-price>
</option>
</options>
<adjustments>
<adjustment>
<adjustment-code>AUTDISC</adjustment-code>
<adjustment-name>Automation discount</adjustment-name>
<adjustment-cost>-0.72</adjustment-cost>
<qualifier>
<percent>3.000</percent>
</qualifier>
</adjustment>
<adjustment>
<adjustment-code>FUELSC</adjustment-code>
<adjustment-name>Fuel surcharge</adjustment-name>
<adjustment-cost>3.04</adjustment-cost>
<qualifier>
<percent>13.0</percent>
</qualifier>
</adjustment>
</adjustments>
</price-details>
<weight-details></weight-details>
<service-standard>
<am-delivery>false</am-delivery>
<guaranteed-delivery>true</guaranteed-delivery>
<expected-transit-time>3</expected-transit-time>
<expected-delivery-date>2012-04-19</expected-delivery-date>
</service-standard>
</price-quote>
</price-quotes>
</get-rates-response>
