Tarification

Exemples de codes de tarification : Java (.zip) | PHP (.zip) | C# (.zip)

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 :

Créer l'envoi ou Créer l'envoi sans convention

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
FR = Français

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 » remettra le tarif réduit en place pour le client commercial ou le client du programme Solutions pour petites entreprises.
  • Si l'option « Counter » est sélectionnée, le prix courant payé par les consommateurs s'affiche.

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
COV – Couverture (qualificatif requis)
COD – CR (qualificatif requis)
PA18 – Preuve d'âge requise (18 ans)
PA19 – Preuve d'âge requise (19 ans)
HFP – Annoncer par carte
DNS – Ne pas laisser en lieu sûr
LAD – Laisser à la porte – Pas d'avis

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

  • La valeur par défaut est « faux ».
  • La mention « vrai » signifie que le colis ne sera pas emballé (p. ex. pneus).

mailing-tube

simple

optionnel

vrai | faux

  • La valeur par défaut est « faux ».
  • La mention « vrai » signifie que l'objet sera expédié dans un tube d'expédition.

oversized

simple

optionnel

vrai | faux

  • La valeur par défaut est « faux ».
  • La mention « vrai » signifie que l'objet est surdimensionné.
  • La valeur est définie correctement si les dimensions sont fournies.

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é.

Code Description
DOM.RP

Colis standard

DOM.EP

Colis accélérés

DOM.XP

Xpresspost

DOM.XP.CERT

Xpresspost certifié

DOM.PC

Priorité

DOM.LIB

Documents de bibliothèque

USA.EP

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

USA.SP.AIR

Petits paquets-avion à destination des É.-U.

USA.TP

Paquet repérable – É.-U.

USA.TP.LVM

Paquet repérable – É.-U. (GEC)
(gros expéditeur de courrier)

USA.XP

Xpresspost É.-U.

INT.XP Xpresspost International
INT.IP.AIR

Colis-avion du régime international

INT.IP.SURF

Colis de surface du régime international

INT.SP.AIR

Petits paquets-avion du régime international

INT.SP.SURF

Petits paquets de surface du régime international

INT.TP

Paquet repérable – International

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
FUELSC – Supplément pour carburant
V1DISC – Tarif réduit pour les clients du programme Solutions pour petites entreprises
PROMODISC – Réduction promotionnelle (si le code de promotion est invalide ou expiré, le montant de la réduction sera indiqué comme étant zéro sous adjustment-cost)
PLATFMDISC – Réduction pour utilisation d’une plateforme de cybercommerce
NEWREGDISC – Réduction accordée lors de l’inscription au Programme pour
SAADJ – Ajustement pour zone de service (rajustement tarifaire à la hausse ou à la baisse pour des combinaisons précises de codes postaux d’origine et de destination)

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

Obtenir les tarifs – Structure de la réponse XML
Obtenir les tarifs – 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 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>