Expédition sans convention
Créer l'envoi sans convention – Module SOAP
Résumé
Nom : | Créer l'envoi sans convention |
---|---|
Raison pour utiliser le service : | Pour permettre aux clients de Postes Canada sans convention commerciale de demander et de payer une étiquette d'expédition |
Données d'entrée : | Détails de l'envoi et du paiement |
Données de sortie : | Détails de l'étiquette et du reçu |
Exemple d'erreur : | Poids supérieur aux limites du service |
Prochaine demande de service habituelle : | |
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 : | CreateNonContractShipment |
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.
Créer l'envoi sans convention – Éléments de la demande | |||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Nom de l'élément | Type | Requis/Optionnel | Description | ||||||||||||||||||||||||||||||||||||
create-non-contract-shipment-request |
complexe |
requis |
Élément XML de niveau supérieur de la structure de la réponse. |
||||||||||||||||||||||||||||||||||||
create-qr-code |
Simple |
optionnel |
Il s'agit d'un élément facultatif, utilisé pour demander l'image de code QR de l'étiquette publique au format base64, ainsi que contient l'URL de l'étiquette de clé publique et la date d'expiration. Si c'est vrai, deux nouveaux liens sont fournis : publicLabel et publicKeyInfo. Remarque : Applicable uniquement à 8 1/2 X 11 papier codé en pdf |
||||||||||||||||||||||||||||||||||||
create-public-key |
Simple |
optionnel |
Il s'agit d'un élément facultatif, utilisé pour demander l'URL de l'étiquette de clé publique et la date d'expiration. Si c'est vrai, deux nouveaux liens sont fournis : publicLabel et publicKeyInfo Remarque : Applicable uniquement à 8 1/2 X 11 papier codé en pdf |
||||||||||||||||||||||||||||||||||||
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 Si aucune valeur n'est fournie, la langue par défaut est « Anglais ». |
||||||||||||||||||||||||||||||||||||
non-contract-shipment |
complexe |
requis |
Structure XML contenant les données d'entrée pour un envoi. |
||||||||||||||||||||||||||||||||||||
requested-shipping-point |
Simple |
Requis |
(Chaîne de six caractères alphanumériques) Doit être dans un format de code postal valide. Exemple : A9A9A9 Le format est « [A-Z]\d[A-Z]\d[A-Z]\d ». Il s'agit du code postal de l'emplacement de l'expéditeur (origine). Utilisé pour trouver le bureau de poste le plus près aux fins de tarification. Cet élément est requis si :
|
||||||||||||||||||||||||||||||||||||
delivery-spec |
Complexe |
Requis |
Cette structure comprend toute l'information nécessaire pour décrire la demande de livraison (l'envoi et sa destination). |
||||||||||||||||||||||||||||||||||||
service-code |
Simple |
Requis |
Cette structure contient des données sur l'expéditeur et ces données correspondent à l'adresse de l'expéditeur figurant sur l'étiquette. Les champs vides seront retirés du formatage des adresses. Il s'agit du service de livraison de Postes Canada utilisé pour expédier l'article. Peut être l'un des services suivants :
|
||||||||||||||||||||||||||||||||||||
sender |
Complexe |
Requis |
Cette structure contient des données sur l'expéditeur. Ces données correspondent à l'adresse de l'expéditeur figurant sur l'étiquette. Les champs vides seront retirés du formatage des adresses. Remarque : l’adresse de l’expéditeur doit être du régime intérieur. |
||||||||||||||||||||||||||||||||||||
name |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à caractères) Nom de l'expéditeur correspondant avec qui il faut communiquer. |
||||||||||||||||||||||||||||||||||||
company |
Simple |
Requis |
(Chaîne de caractères – Jusqu'à 44 caractères) Nom de l'entreprise de l'expéditeur correspondant. |
||||||||||||||||||||||||||||||||||||
contact-phone |
Simple |
Requis |
(Chaîne de caractères – Jusqu'à 25 caractères) Numéro de téléphone de l'expéditeur. |
||||||||||||||||||||||||||||||||||||
address-details |
Complexe |
Requis |
Cette structure contient les données d'adressage de l'expéditeur. Les champs vides seront supprimés au moment de l'impression sur les étiquettes d'expédition. Remarque : l’adresse de l’expéditeur doit être du régime intérieur. |
||||||||||||||||||||||||||||||||||||
address-line-1 |
Simple |
Requis |
(Chaîne de caractères – Jusqu'à 44 caractères) Ligne d'adresse 1 de l'expéditeur. |
||||||||||||||||||||||||||||||||||||
address-line-2 |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 44 caractères) Ligne d'adresse 2 de l'expéditeur. |
||||||||||||||||||||||||||||||||||||
city |
Simple |
Requis |
(Chaîne de caractères – Jusqu'à 40 caractères) Ville de l'expéditeur. |
||||||||||||||||||||||||||||||||||||
prov-state |
Simple |
Requis |
(Chaîne de caractères – Jusqu'à 2 caractères) Province de l'expéditeur. Utilisez les codes standards des provinces canadiennes. |
||||||||||||||||||||||||||||||||||||
postal-zip-code |
Simple |
Requis sous condition |
(Six caractères alphanumériques) Code postal de l'expéditeur. Format [A-Z]\d[A-Z]\d[A-Z]\d |
||||||||||||||||||||||||||||||||||||
destination |
Complexe |
Requis |
Cet élément doit toujours contenir l'adresse du destinataire du courrier, et ce, même si vous utilisez l'option « Livrer au bureau de poste ». Pour les envois réguliers, ces données s'afficheront dans l'adresse de destination figurant sur l'étiquette. Pour les envois assortis de l'option « Livrer au bureau de poste », le système remplacera l'adresse du bureau de poste sur l'étiquette. Les champs vides seront retirés pendant le formatage des adresses. |
||||||||||||||||||||||||||||||||||||
name |
Simple |
Requis sous condition |
(Chaîne de caractères – Jusqu'à 44 caractères) Nom du destinataire avec qui il faut communiquer. Nota : Si l'option « Livrer au bureau de poste » est sélectionnée, l'élément Si l'expédition se fait à l'extérieur du Canada, au moins un des champs « name » ou « company » est requis pour respecter les règlements douaniers internationaux. |
||||||||||||||||||||||||||||||||||||
company |
Simple |
Requis sous condition |
(Chaîne de caractères – Jusqu'à 44 caractères) Nom de l'entreprise du destinataire. Si l'expédition se fait à l'extérieur du Canada, au moins un des champs « name » ou « company » est requis pour respecter les règlements douaniers internationaux. |
||||||||||||||||||||||||||||||||||||
additional-address-info |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 44 caractères) Données d'adressage supplémentaires pour la destination. Si ces données sont présentes, elles seront imprimées directement au-dessus de la ligne d'adresse 1. |
||||||||||||||||||||||||||||||||||||
client-voice-number |
Simple |
Requis sous condition |
(Chaîne de caractères – Jusqu'à 25 caractères) Numéro de téléphone du destinataire. Il n'est pas requis pour les envois du régime intérieur et n'apparaîtra pas sur l'étiquette d'expédition. Il est requis pour la destination lorsqu'il s'agit d'un colis ou d'un paquet du service Colis accélérés É.-U., Xpresspost É.-U., Xpresspost – International.(USA.EP, USA.XP, INT.XP) Il est également requis pour la destination lorsque l'option « Livrer au bureau de poste » est sélectionnée. Remarque : En plus des chiffres, les caractères suivants sont acceptés dans ce champ :
|
||||||||||||||||||||||||||||||||||||
address-details |
Complexe |
Requis |
Cette structure contient les données d'adressage du destinataire. Les champs vides seront supprimés au moment de l'impression sur les étiquettes d'expédition. |
||||||||||||||||||||||||||||||||||||
address-line-1 |
Simple |
Requis |
(Chaîne de caractères – Jusqu'à 44 caractères) Ligne d'adresse 1 de la destination. |
||||||||||||||||||||||||||||||||||||
address-line-2 |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 44 caractères) Ligne d'adresse 2 de la destination. |
||||||||||||||||||||||||||||||||||||
city |
Simple |
Requis sous condition |
(Chaîne de caractères – Jusqu'à 40 caractères) Requis pour les envois du régime intérieur et à destination des É.-U., mais optionnel pour les envois du régime international. |
||||||||||||||||||||||||||||||||||||
prov-state |
Simple |
Requis sous condition |
(Chaîne de caractères – Jusqu'à 20 caractères) Province ou État de la destination. Requis pour les envois du régime intérieur et à destination des É.-U., mais optionnel pour les envois du régime international. Il faut utiliser l'un des codes suivants :
|
||||||||||||||||||||||||||||||||||||
country-code |
Simple |
Requis |
(Code de pays valide à deux caractères) Code de pays de la destination. |
||||||||||||||||||||||||||||||||||||
postal-zip-code |
Simple |
Requis sous condition |
Peut être :
Requis pour les destinations du régime intérieur et aux É.-U. Code postal ou code ZIP du destinataire. |
||||||||||||||||||||||||||||||||||||
options |
Complexe |
Optionnel |
Cette structure comprend des renseignements sur les options d'expédition demandées. |
||||||||||||||||||||||||||||||||||||
option |
Complexe |
Requis sous condition |
Occurrence (1 à 20 fois). Au moins une occurrence est nécessaire si l'élément XML parent correspondant « options » existe. Sélection d'une option d'expédition (p. ex. CR, couverture). |
||||||||||||||||||||||||||||||||||||
option-code |
Simple |
Requis sous condition |
(Chaîne alphanumérique – Jusqu'à 10 lettres/chiffres) Requis si l'élément XML parent correspondant « option » existe. Il s'agit du code d'option indiquant l'option qui s'applique à l'envoi. Les codes d'option valides sont les suivants : SO – Signature Nota : L'option « D2PO » indique que le colis sera livré directement à un bureau de poste proche. Les éléments XML suivants sont requis pour l'option « D2PO » :
Remarque : Si vous choisissez l'option de contre remboursement (COD), l'option Annoncer par carte (HFP) ou l'option Livrer au bureau de poste (D2PO). La perception de fonds pour des envois contre remboursement est ainsi facilitée au bureau de poste. Si aucune option n'est choisie, le système sélectionnera par défaut l'option HFP. Codes de traitement pour la non-livraison |
||||||||||||||||||||||||||||||||||||
option-amount |
Simple |
Requis sous condition |
(Champ numérique de six chiffres, suivis de deux décimales [p. ex. format 999999.99]) Requis si l'élément XML parent correspondant « option » existe, selon la valeur du code d'option. Requis pour certaines options, notamment la couverture (COV) et l'option CR. Remarque : Le montant maximal des envois CR est fixé à 1 000 $ (y compris les frais d’expédition, le cas échéant) pour les clients des Solutions pour petites entreprises. Ne pas fournir pour COV dans le cas des envois à destination des États-Unis ou du régime international si vous voulez que le système calcule la couverture maximale permise (voir l’élément option-qualifier-1 ci-dessous). |
||||||||||||||||||||||||||||||||||||
option-qualifier-1 |
Simple |
Requis sous condition |
Attribut booléen – {vrai, faux} Peut être utilisé pour fournir un qualificatif pour les options CR ou COV. Pour indiquer si le montant du paiement CR comprend les frais d’expédition ou non :
À utiliser avec l’option COV pour les envois à destination des États-Unis ou du régime international pour indiquer que le système peut appliquer le montant de la couverture maximale permise, qui devrait correspondre à la valeur totale de vos articles, jusqu’à la limite maximale permise pour le produit et le pays en question :
Si le qualificatif n’est pas fourni, l’attribut « Faux » est sélectionné par défaut. |
||||||||||||||||||||||||||||||||||||
option-qualifier-2 |
Simple |
Requis sous condition |
{Chaîne de caractères – Jusqu'à 12 caractères} Requis si l'élément XML parent correspondant « option » existe et qu'un deuxième qualificatif est nécessaire pour le code d'option. Ce qualificatif est disponible pour toutes les options pouvant nécessiter un deuxième qualificatif. À l'heure actuelle, les options nécessitant un deuxième qualificatif sont les suivants : Livrer au bureau de poste |
||||||||||||||||||||||||||||||||||||
parcel-characteristics |
Complexe |
Requis |
Cette structure décrit les caractéristiques du colis (p. ex. poids). |
||||||||||||||||||||||||||||||||||||
weight |
Simple |
Requis |
(Champ numérique de trois chiffres, suivis de trois décimales [p. ex. format 999.999]) Poids total du colis en kilogrammes. |
||||||||||||||||||||||||||||||||||||
dimensions |
Complexe |
Optionnel |
Cette structure contient les dimensions physiques du colis qui sont utilisées pour déterminer les frais d'expédition de façon plus précise. Ce groupe est requis, à moins que l'envoi soit un document. |
||||||||||||||||||||||||||||||||||||
length |
Simple |
Requis sous condition |
(Champ numérique de trois chiffres, suivis d'une décimale [p. ex. format 999.9]) Longueur du colis en centimètres. Requis si l'élément XML parent correspondant « dimensions » existe. Si la longueur est précisée, un prix plus exact peut être défini. La valeur est indiquée en centimètres. |
||||||||||||||||||||||||||||||||||||
width |
Simple |
Requis sous condition |
(Champ numérique de trois chiffres, suivis d'une décimale [p. ex. format 999.9]) Largeur du colis en centimètres. Requis si l'élément XML parent correspondant « dimensions » existe. Si la largeur est précisée, un prix plus exact peut être défini. |
||||||||||||||||||||||||||||||||||||
height |
Simple |
Requis sous condition |
(Champ numérique de trois chiffres, suivis d'une décimale [p. ex. format 999.9]) Hauteur du colis en centimètres. Requis si l'élément XML parent correspondant « dimensions » existe. Si la hauteur est précisée, un prix plus exact peut être défini. |
||||||||||||||||||||||||||||||||||||
document |
Simple |
Optionnel |
{vrai, faux} Indique si l'envoi est un document ou non. (Si cette valeur est omise ou « Faux », les dimensions sont requises.) |
||||||||||||||||||||||||||||||||||||
unpackaged |
Simple |
Optionnel |
{vrai, faux} Indique si un envoi est emballé ou non. Par exemple, les pneus d'une voiture peuvent constituer un envoi non emballé. |
||||||||||||||||||||||||||||||||||||
mailing-tube |
Simple |
Optionnel |
{vrai, faux} Indique si un envoi est inséré dans un tube d'expédition (p. ex. tube contenant une affiche). |
||||||||||||||||||||||||||||||||||||
notification |
Complexe |
Requis sous condition |
Cette structure comprend les préférences des clients quant à la fonction d'avis électronique pour les activités de suivi (p. ex. livraison). Cet élément est requis si l'option « Livrer au bureau de poste » (D2PO) a été sélectionnée. Pour la livraison au bureau de poste, le courriel désigné dans l'élément « notification » sera utilisé pour aviser le client qu'il peut ramasser son colis. |
||||||||||||||||||||||||||||||||||||
Simple |
Requis sous condition |
(Chaîne de caractères – Jusqu'à 60 caractères) Il doit s'agir d'une adresse électronique valide. Format (['_A-Za-z0-9\-\+])(\.['_A-Za-z0-9\-\+])@([A-Za-z0-9-])(\.[A-Za-z0-9-])(\.[A-Za-z]{2,}) Cet élément est obligatoire si l'élément « notification » existe. Adresse électronique pour recevoir des mises à jour de suivi automatiques. |
|||||||||||||||||||||||||||||||||||||
on-shipment |
Simple |
Requis sous condition |
{true, false} Cet élément est obligatoire si l'élément « notification » existe. Indique si le client souhaite recevoir un avis électronique concernant un envoi. |
||||||||||||||||||||||||||||||||||||
on-exception |
Simple |
Requis sous condition |
{vrai, faux} Cet élément est obligatoire si l'élément « notification » existe. Indique si le client souhaite recevoir un avis électronique concernant un envoi. |
||||||||||||||||||||||||||||||||||||
on-delivery |
Simple |
Requis sous condition |
{vrai, faux} Cet élément est obligatoire si l'élément « notification » existe. Indique si le client souhaite recevoir un avis électronique concernant un envoi. |
||||||||||||||||||||||||||||||||||||
preferences |
Complexe |
Requis |
Cette structure comprend un certain nombre de préférences des clients en ce qui a trait à l'impression des étiquettes. |
||||||||||||||||||||||||||||||||||||
show-packing-instructions |
Simple |
Requis |
{vrai, faux} Cet élément indique si les directives d'emballage doivent être inscrites sur l'étiquette ou non. |
||||||||||||||||||||||||||||||||||||
show-postage-rate |
Simple |
Optionnel |
{vrai, faux} Cet élément indique si le tarif postal doit être inscrit sur l'étiquette ou non. Il s'applique seulement aux envois à destination des États-Unis et du régime international. Si cet élément n'est pas précisé, la valeur « Faux » s'affiche par défaut. |
||||||||||||||||||||||||||||||||||||
show-insured-value |
Simple |
Optionnel |
{vrai, faux} Cet élément indique si la valeur assurée doit être inscrite sur l'étiquette ou non. Il s'applique seulement aux envois à destination des États-Unis et du régime international. Si cet élément n'est pas précisé, la valeur « Faux » s'affiche par défaut. |
||||||||||||||||||||||||||||||||||||
references |
Complexe |
Optionnel |
Cette structure contient des champs de référence que vous pouvez attribuer. Ces autres numéros d'identification (pouvant être uniques) sont attribués à l'envoi pour une raison quelconque utile pour vous. |
||||||||||||||||||||||||||||||||||||
cost-centre |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 30 caractères) Il s'agit d'une valeur définie par l'utilisateur disponible pour vos applications. La valeur que vous saisissez ici apparaîtra sur votre facture et dans le courriel sécurisé PosteCS que nous utilisons pour envoyer votre facture. |
||||||||||||||||||||||||||||||||||||
customer-ref-1 |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 35 caractères) Il s'agit d'une valeur définie par l'utilisateur disponible pour vos applications (p. ex. vous pourriez utiliser ce champ pour le numéro d'identification d'une commande interne). La valeur que vous saisissez ici apparaîtra sur l'étiquette d'expédition, dans l'outil Repérer et, pour les clients qui sont inscrits à notre service de suivi automatisé des colis, dans votre fichier SAC. |
||||||||||||||||||||||||||||||||||||
customer-ref-2 |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 35 caractères) Il s'agit d'une valeur définie par l'utilisateur disponible pour vos applications. La valeur que vous saisissez ici apparaîtra sur l'étiquette d'expédition, dans l'outil Repérer et, pour les clients qui sont inscrits à notre service de suivi automatisé des colis, dans votre fichier SAC. |
||||||||||||||||||||||||||||||||||||
customs |
Complexe |
Optionnel |
Cette structure comprend des renseignements qui doivent être imprimés sur l'étiquette pour faciliter le dédouanement transfrontalier. |
||||||||||||||||||||||||||||||||||||
currency |
Simple |
Requis sous condition |
(Chaîne de caractères – Trois caractères alphabétiques) La valeur doit être :
Requis si l'élément XML parent correspondant « customs » existe. Il s'agit de la devise du pays de destination. |
||||||||||||||||||||||||||||||||||||
conversion-from-cad |
Simple |
Requis sous condition |
(Champ numérique de trois chiffres, suivis de trois décimales [p. ex., format 999.999]) Requis si l'élément XML parent correspondant « customs » existe et si la devise n'est pas canadienne. Le taux de conversion du dollar canadien à la devise que vous avez entrée dans l’élément de devise ci-dessus; par exemple, si vous entré les dollars américains comme devise cible et que 1,00 $ CAD = 0,85 $ US, le taux de conversion est de 0,85. |
||||||||||||||||||||||||||||||||||||
reason-for-export |
Simple |
Requis sous condition |
(Trois caractères) Requis si l'élément XML parent correspondant « customs » existe. Il s'agit d'un code représentant la raison de l'exportation, lequel facilite le passage transfrontalier. Voici les codes et leurs significations : DOC = Document |
||||||||||||||||||||||||||||||||||||
other-reason |
Simple |
Optionnel |
(Chaîne de caractères – Minimum de quatre caractères; maximum de 44 caractères) Il s'agit de la raison de l'exportation si l'élément reason-for-export la décrivant est « Autre ». |
||||||||||||||||||||||||||||||||||||
duties-and-taxes-prepaid |
Simple |
Optionnel |
Réservé aux fins d'utilisation ultérieure. |
||||||||||||||||||||||||||||||||||||
certificate-number |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 10 caractères) Si requis par les douanes du pays de destination, le numéro du certificat ou du permis du gouvernement ou de l'organisme. |
||||||||||||||||||||||||||||||||||||
licence-number |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 10 caractères) Si requis par les douanes du pays de destination, le numéro de la licence d'importation ou d'exportation du gouvernement ou de l'organisme. |
||||||||||||||||||||||||||||||||||||
invoice-number |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 10 caractères) Si requis par les douanes du pays de destination, le numéro de la facture commerciale. |
||||||||||||||||||||||||||||||||||||
ioss-id |
simple |
optionnel |
(Chaîne de caractères – Jusqu'à 13 caractères) Champ facultatif pour la saisie des numéros ou ID d’inscription à l’impôt (p. ex., ID d’inscription à l’impôt, numéro IRS, TVA, numéro IOSS) aux fins de transmission électronique au poste de réception. Remarque : Le numéro IOSS doit être saisi selon le format « IMxxxxxxxxxx ». |
||||||||||||||||||||||||||||||||||||
sku-list |
Complexe |
Requis sous condition |
S'il existe un élément parent douanier correspondant, cet élément est obligatoire. Cette structure contient la liste de types d'articles uniques inclus dans cet envoi ainsi que les renseignements connexes. Une quantité de un ou plus peut être associée à chaque type d'article. Ces renseignements sont imprimés sur l'étiquette ou sur le document douanier pour faciliter le traitement des colis aux douanes. |
||||||||||||||||||||||||||||||||||||
item |
Complexe |
Requis |
Occurrence (1 à 500 fois) Il doit y avoir au moins une occurrence pour l'envoi. Il y a une limite de 500 éléments pour une sku-list. Cette structure contient les renseignements sur le type d'article (nombre d'unités, valeur par unité, etc.) que comprend l'envoi. |
||||||||||||||||||||||||||||||||||||
hs-tariff-code |
Simple |
Optionnel |
(Champ numérique de format général 9999.99.99.99) Le format est \d{4}(\.\d{2}(\.\d{2}(\.\d{2})?)?)?. Code de tarification de l'article |
||||||||||||||||||||||||||||||||||||
sku |
Simple |
Optionnel |
(Chaîne de caractères – Jusqu'à 15 caractères) Nom ou numéro de l'article aux fins de dédouanement Nota : La version 3 permet seulement un maximum de 15 caractères. Les versions précédentes permettent un maximum de 44 caractères, mais les données seront tronquées en 15 caractères. Les limites de longueur sont nécessaires à des fins de conformité aux règlements douaniers internationaux. |
||||||||||||||||||||||||||||||||||||
customs-description |
Simple |
Requis sous condition |
(Chaîne de caractères – Jusqu'à 45 caractères) Requis si l'élément XML parent correspondant «item » existe. Description pour douanes de l'article. |
||||||||||||||||||||||||||||||||||||
unit-weight |
Simple |
Requis sous condition |
(Champ numérique de trois chiffres, suivis de trois décimale [p. ex. format 999.999]) Requis si l'élément XML parent correspondant « item » existe. Poids unitaire de l'article en kilogrammes |
||||||||||||||||||||||||||||||||||||
customs-value-per-unit |
Simple |
Requis sous condition |
(Champ numérique de cinq chiffres, suivis de deux décimales [p. ex. format 99999.99]) Requis si l'élément XML parent correspondant « item » existe. Valeur unitaire de l'article en devise canadienne |
||||||||||||||||||||||||||||||||||||
customs-number-of-units |
Simple |
Requis sous condition |
(Champ numérique de quatre chiffres [p. ex. format 9999]) Requis si l'élément XML parent correspondant « item » existe. Nombre d'unités dans le colis |
||||||||||||||||||||||||||||||||||||
customs-unit-of-measure |
Simple |
Optionnel |
(Code de pays ISO à trois caractères) Indique l'unité de mesure pour l'élément customs-number-of-units.
|
||||||||||||||||||||||||||||||||||||
country-of-origin |
Simple |
Optionnel |
(Code de pays valide à deux caractères) Il s'agit du pays d'origine de l'article correspondant et il doit être fourni si l'élément XML parent correspondant « item » existe (et si le pays d'origine est connu). Si le pays d'origine n'est pas connu, l'élément peut être omis. |
||||||||||||||||||||||||||||||||||||
province-of-origin |
Simple |
Requis sous condition |
(Code de province valide à deux caractères) Obligatoire si le pays d'origine est le Canada. Province d'origine des biens |
||||||||||||||||||||||||||||||||||||
settlement-info |
Complexe |
Optionnel |
Structure comprenant des éléments liés au paiement ou à la tarification. |
||||||||||||||||||||||||||||||||||||
promo-code |
Simple |
Optionnel |
Chaîne de caractères – Jusqu'à 10 caractères. Code de réduction promotionnelle. Veuillez noter qu'un code de promotion est uniquement valide pour un certain produit et pendant une certaine période. Converti en majuscules. Aux fins de mise à l'essai, vous pouvez utiliser le code de promotion DEVPROTEST dans l'environnement de développement (« Bac à sable »). Il est valide pour les produits suivants :
|
Demande – Diagramme XML
N/A
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 de création d'un envoi sans convention. Pour obtenir la hiérarchie de la réponse, consultez le diagramme XML.
Créer l'envoi sans convention – Éléments de la réponse | ||
---|---|---|
Nom de l'élément | Type | Description |
create-non-contract-shipment-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-info |
complexe |
Structure XML contenant les résultats liés à l'exécution réussie du service en question. |
shipment-id |
simple |
Il s'agit d'un numéro d'identification unique pour l'envoi. Il peut être utilisé pour toute demande future concernant le service « Transmettre les envois » afin de préciser que cet envoi doit être exclu du transfert. |
tracking-pin |
simple |
NIP de repérage pour l'envoi. Il peut être utilisé en tant que donnée d'entrée pour toute autre demande de service pour les colis, notamment le service « Obtenir les détails de repérage ». |
artifacts |
complexe |
Cette structure contient une série d'artefacts (étiquettes) propre à l'envoi. |
artifact |
complexe |
Représente un artefact (étiquette) individuel pour l'envoi. Occurrence (1 à N fois). (Nota : L'élément XML lié à l'artefact est désigné comme « Complexe », car il contient de nombreux attributs. Il ne contient aucun sous-élément.) Cet élément inclura le type d'attribut « XXX » Voici les valeurs possibles pour cet attribut :
|
artifact-id |
simple |
Numéro d'identification unique pour l'étiquette (artefact) pouvant être utilisé dans le cadre de la demande de service « Obtenir l'artefact » pour récupérer l'étiquette. |
page-index |
simple |
Nota : Cet élément est toujours zéro pour le PDF étant donné que ce dernier appuie plusieurs pages. Il n'est pas requis dans les demandes de récupération des documents PDF. |
Réponse – Diagramme XML
N/A
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.
Voici des réponses d'erreur possibles :
Code |
Description |
---|---|
1459 |
La valeur du code de la raison de l’exportation n’est pas valide. (Remarque : À compter du mois d’avril 2016, l’option de cadeau n’est plus valide.) |
1719 |
Le montant de la couverture ne doit pas excéder la valeur totale de vos articles, et ce, jusqu’à la limite maximale permise pour le produit et le pays en question. |
7272 |
Le code de promotion n'est pas valide (n'existe pas ou ne s'applique pas au service sélectionné). |
7282 |
Au moins un nom de destinataire ou un nom d'entreprise est requis conformément aux règlements douaniers. |
7289 |
Le service sélectionné n'est pas valide pour le client ou le contrat indiqué. |
7322 |
Le code de devise n’est pas un code de devise ISO à trois caractères valide (comme USD). |
Exemples
Exemple de demande XML selon le module SOAP – Créer l'envoi sans convention
<create-non-contract-shipment-request>
<mailed-by>1111111</mailed-by>
<locale>EN</locale>
<non-contract-shipment>
<requested-shipping-point>K2K2A9</requested-shipping-point>
<delivery-spec>
<service-code>DOM.EP</service-code>
<sender>
<company>Canada Post Corporation</company>
<contact-phone>1-555-555-5555</contact-phone>
<address-details>
<address-line-1>2701 Riverside Drive</address-line-1>
<city>Ottawa</city>
<prov-state>ON</prov-state>
<postal-zip-code>K1A0B1</postal-zip-code>
</address-details>
</sender>
<destination>
<name>John Smith</name>
<company>12345678 Ont. Limited</company>
<address-details>
<address-line-1>123 Any Street</address-line-1>
<city>Ottawa</city>
<prov-state>ON</prov-state>
<country-code>CA</country-code>
<postal-zip-code>K1K4T3</postal-zip-code>
</address-details>
</destination>
<options>
<option>
<option-code>DC</option-code>
</option>
</options>
<parcel-characteristics>
<weight>15</weight>
<dimensions>
<length>1</length>
<width>1</width>
<height>1</height>
</dimensions>
</parcel-characteristics>
<preferences>
<show-packing-instructions>true</show-packing-instructions>
</preferences>
</delivery-spec>
</non-contract-shipment>
</create-non-contract-shipment-request>
Exemple de réponse XML selon le module SOAP – Créer l'envoi sans convention
<create-non-contract-shipment-response>
<non-contract-shipment-info>
<shipment-id>406951321983787352</shipment-id>
<tracking-pin>12345678901234</tracking-pin>
<artifacts>
<artifacttype="label">
<artifact-id>10238</artifact-id>
<page-index>0</page-index>
</artifact>
</artifacts>
</non-contract-shipment-info>
</create-non-contract-shipment-response>