DataTransfer – Annexe 5

Guidage vocal

DataTransfer – Annexe 5

[Sidebar | Close]

    DataTransfer – Annexe 5

    Description de l'interface clients DataTransfer

    Transmission des données EAD (Electronic Advance Data) pour envois internationaux contenant des marchandises

    1. Introduction

    1.1 Destinataires du présent manuel

    Cette annexe contient les informations techniques concernant la livraison électronique des données EAD (Electronic Advance Data) à la Poste.

    1.2 Quelles informations obtenez-vous sur DataTransfer?

    Vue d’ensemble et description des fonctions DataTransfer

    Décrit brièvement les prestations DataTransfer, Lettres
    avec code à barres (BMB) via DataTransfer, «Établir un bordereau de dépôt» via DataTransfer et Envoi de colis easy via SFTP, explique le fonctionnement et décrit la procédure d’inscription et de test. S’adresse principalement aux décideurs pour DataTransfer.

    DataTransfer – Annexe 1: Description de l’interface clients DataTransfer: Colis, Express, Solutions et Lettres avec code à barres (BMB)

    Description de la structure des messages et des contenus des données pour la livraison des données de Colis, Express, Solution et BMB et les spécifications techniques telles que les formats de livraison et les conventions de noms.

    DataTransfer – Annexe 2: Description de l’interface clients «Établir un bordereau de dépôt»

    Décrit les contenus de données pour la livraison des données «Établir un bordereau de dépôt» et présente les rapports de «Établir un bordereau de dépôt».

    DataTransfer – Annexe 3: Description des rapports DataTransfer

    Décrit les contenus de données des rapports BMB, Colis et Swiss-Express, mais sans «Établir un bordereau de dépôt.

    DataTransfer – Annexe 5: Description de l’interface clients DataTransfer: livraison EAD

    Description des informations techniques pour la transmission électronique des données d’EAD (Electronic Advance Data) pour envois de lettres internationaux contenant des marchandises.

    1.3 Validité

    Le manuel est actualisé en ligne. Les modifications sont consignées dans les Release Notes au chapitre 5.

    Avec la parution des nouvelles instructions, les anciens PDF perdent leur validité. Cette page présente toujours la version actuelle.

    1.4 Abréviations et termes utilisés

    Abréviation Description
    BMB Lettres avec code à barres 
    DataTransfer Nom de la prestation permettant la transmission électronique de données à la Poste. 
    Envoi de colis easy Dépôt de colis sans bordereau de dépôt
    Letter ID Les lettres adressées et clairement identifiables (par DmC) sont transmises avec l’opérateur Letter ID 
    LSO Bulletin de livraison pour les lettres avec code à barres, est utilisé par l'opérateur BMB pour le dépôt des envois
    N° KDP
    Numéro d’identification des clients de la Poste
    PKZIP 2.0 Standard de compression pour réduire la taille des fichiers. Aujourd’hui, presque tous les fichiers avec le suffixe .zip sont au format PKZIP 2.0
    XSD XML-Schema-Definition: permet de créer et de vérifier le fichier XML

    1.5 Assistance

    Poste CH SA
    Support DataTransfer
    Wankdorfallee 4
    3030 Berne
    Suisse

    E-mail: datatransfer@poste.ch

    2. Spécifications techniques

    2.1 Transmission des données

    Vous pouvez transmettre les données des manières suivantes:

    • en tant que fichier joint dans un e-mail
    • par un compte SFTP auprès de la Poste
    • par la plateforme sedex de la Confédération (seulement XML)

    Vous trouverez les directives pour la préparation des fichiers au chapitre 2.3.

    2.1.1 E-mail

    Si vous voulez transmettre vos données par e-mail, vous devez disposer d’un accès de messagerie vous permettant d’envoyer des messages d’une taille maximale de 2 Mo. La pièce jointe à l’e-mail doit être fournie comme base64 ou uuencoded.

    Déroulement de la transmission des données par e-mail

    Conditionnez les données au format XML et joignez le fichier à l’e-mail. La taille maximale d’un fichier est fixée à 2 Mo par e-mail transmis.

    Afin que les fichiers joints au message électronique puissent être clairement identifiés lors de leur transmission, ils doivent contenir un mot-clé comme texte du message (Body). Si ce mot-clé est erroné, l’e-mail sera effacé (y c. les fichiers joints). Le mot-clé à ajouter dans l’e-mail est le suivant:

    • Pendant la phase de test: T-770809dfu01input
    • En cours d’exploitation: 770809dfu01input

    Attention: L’e-mail ne doit contenir que le mot-clé et le fichier. Aucun texte supplémentaire (p. ex. signature automatique) n’est admis.

    Vous devez envoyer l’e-mail à paketversand.dfu@poste.ch.

    2.1.2 SFTP

    Pour transmettre vos données par la passerelle SFTP, vous devez disposer d’un compte SFTP auprès de la Poste. Si tel n’est pas le cas, le compte SFTP sera ouvert après la demanded’enregistrement.

    Vous pouvez obtenir un guide pour la livraison des données via SFTP sous ce manuel ou auprès du Support DataTransfer.

    2.1.3 Sedex

    Pour les participants Sedex du domaine e-LP, l’échange élect-ronique de données d’envoi est possible via la plateforme sedex de la Confédération. Un adaptateur a été ajouté auxp-restations DataTransfer existantes.

    Les inscriptions auprès de l’Office fédéral de la statistique sont réalisées par le support DataTransfer.

    Vous trouverez un guide pour la transmission des données via Sedex sous DataTransfer -> Lettres avec code à barres..

    2.2 Format des fichiers

    Les fichiers sont acceptés au format XML (UTF-8) ou au format ZIP (PKZIP 2.0). La structure est présentée au chapitre 3.1.1.

    2.2.1 Caractères spéciaux avec le format XML

    Les fichiers XML doivent être correctement formatés selon le standard XML pour pouvoir être traités par DataTransfer. Cela signifie pour la livraison des données des envois:

    Les caractères spéciaux tels que les parenthèses triangulaires (<>) ou les guillemets (“) ne doivent pas être contenus sans code dans les valeurs d’attribut du fichier XML.

    Pour pouvoir livrer les caractères spéciaux, vous devez les coder avec les caractères spéciaux connus dans le format HTML. Ces caractères connus se fondent sur le modèle suivant: &[Name];

    L’exemple suivant montre le code du signe «et» commercial («&»): REC_Name1=“Moser &amp; Cie.“

    Voici une liste des caractères spéciaux et des codes corres-pondants, tels qu‘ils doivent être livrés:

    Caractères spéciaux Code
    & &amp;
    < &lt;
    > &gt;
    &quot;
    &apos;

    Les trémas normaux ne doivent pas être encodés en HTML.

    Vous pouvez vérifier simplement si un fichier XML est correc-tement formaté et s’il peut être traité par DataTransfer: ouv-rez le fichier dans un navigateur (p. ex. Internet Explorer ou Mozilla Firefox). Si le fichier n’est pas correctement formaté, un message d’erreur s’affiche.

    2.3 Conventions des noms

    2.3.1 Noms des fichiers pour la transmission

    Si vous transmettez des fichiers dont le nom ne correspond pas à la convention de noms ci-dessous, ceux-ci ne seront pas acceptés et seront automatiquement effacés après un certain temps. Pour des raisons de sécurité, vous n’en serez pas informé. Il faut donc impérativement respecter la convention de noms suivante.

    Convention de noms

    SenderID_EAD_INPUT_YYYYMMDD_HHMMSS_FileID.xml

    SenderID_EAD_RcptMsg_YYYYMMDD_HHMMSS_FileID.xm

    SenderID_EAD_ConfMsg_YYYYMMDD_HHMMSS_FileID.xml

    Le FileID de l’EAD INPUT Message et du fichier de transmission BMB associé doivent être identiques. Ce n’est qu’à ce titre que nous pouvons, vous et nous, vérifier d’une manière l’exhaustivité des transmissions.

    Conseil

    Et si vous remplissez encore le FileID dans l’élément SendingID dans le fichier de transmission BMB, alors vous disposerez de l’information correspondante sur ce LSO dans les rapports sur tous les envois.

    <SendingID>1</SendingID>

    Exemple

    829_EAD_RcptMsg_20190708_101305_447204.xml

    Taille maximale des fichiers de livraison

    La taille du fichier de livraison ne doit pas dépasser 6 Mo. Tout fichier dépassant cette limite ne sera pas traité et vous recevrez alors un message d’erreur (max. filesize exceeded).

    3. Contenus des données de l’interface clients

    3.1 Transmission des données pour DataTransfer pour envois internationaux contenant des marchandises

    Vous recevrez un accusé de réception et un protocole de traitement pour chaque transmission de données. Ces deux documents vous seront envoyés par e-mail. L’adresse e-mail est tirée du fichier transmis ou, si l’attribut «ConfirmEMail» est vide, l’adresse e-mail communiquée lors de la demande d’enregistrement sera utilisée.

    L’accusé de réception vous indique si le fichier a bien été transmis et a pu être reconnu par DataTransfer. L’exactitude des champs «FileID», «SenderID» et «KDPNumber» est vérifiée. La capacité d’analyse syntaxique et l’exacte conformité du schéma d’interface (éléments et attributs) du fichier sont vérifiées. Les éventuelles erreurs sont indiquées individuellement dans le protocole de traitement. Vous pouvez désactiver l’accusé de réception par l’attribut «SendOKMail = 1» dans le fichier transmis. En cas d’erreur, l’accusé de réception vous sera toujours transmis.

    Le protocole de traitement vous montre si les données transmises ont pu être formellement traitées par DataTransfer. Les données erronées contiennent un code d’erreur et une description de l’erreur afin de vous faciliter la recherche des erreurs. Le protocole de traitement ne vous donne toutefois aucune indication sur la qualité des adresses transmises. Avec l’attribut «Send-OKMail = 1» dans le fichier transmis, vous pouvez déterminer si vous voulez aussi recevoir le protocole de traitement dans le cas OK. En cas d’erreur, le protocole vous est toujours transmis.

    Le tableau récapitulatif avec tous les codes d’erreur et leur explication est disponible sous Assistance technique DataTransfer → Lettres avec code à barres.

    <​​Envelope>
    OriginVersion
    xmlns
    <​FileInfos>
    <​FileID/>
    <​FileDate/>
    <​FileTime/>
    <​/FileInfo>
    <​ItemInfo>
    <​InfoEvent>
    <​Date/>
    <​PostcodeUPU/>
    <​Source/>
    <​/InfoEvent>
    <​ItemInfoData>
    <​Barcode/>
    <​TotalValue/>
    <​TotalCurrency/>
    <​MailSourceExport/>
    <​PostagePrice/>
    <​PostageCurrency/>
    <​DeclaredGrossWeight/>
    <​NatureOfTransaction-Code/>
    <​AssociatedDocumentType/>
    <​AssociatedDocumentIdentifier/>
    <​DestinationCountryIso/>
    <​/InfoEvent>
    <​ItemInfoData>
    <​Name1/>
    <​Name2/>
    <​Name3/>
    <​Address1/>
    <​Address2/>
    <​Address3/>
    <​ZipCode/>
    <​City/>
    <​Region/>
    <​CountryIso/>
    <​CountryIso/>
    <​Tel/>
    <​Email/>
    <​Vat/>
    <​Taxnumber/>
    <​Contact/>
    <​/Addressee>
    <​/Sender>
    <​Name1/>
    <​Name1/>
    <​Name1/>
    <​Address1/>
    <​Address2/>
    <​Address3/>
    <​ZipCode/>
    <​City/>
    <​CountryIso/>
    <​Contact/>
    <​Email/>
    <​Tel/>
    <​Reference/>
    <​Vat/>
    <​Taxnumber/>
    <​/Sender>
    <​ItemPosition>
    <​Position/>
    <​OriginLocation/>
    <​ProductDescription/>
    <​TariffHeading/>
    <​NetWeight/>
    <​Amount/>
    <​Value/>
    <​ValueCurrency/>
    <​/ItemPosition>
    <​/ItemInfo>
    <​/SendItemInfo>

    3.1.2 XML-Schema / XSD

    Un schéma est proposé pour l’établissement et le contrôle de l’interface XML. Ce schéma est enregistré comme XSD (XML-Schema-XDXefinition) et peut être consulté à l’adresse suivante ou directement intégré dans le fichier XML: Assistance technique DataTransfer 

    3.1.3 Exemple au format XML pour les envois internationaux contenant des marchandises

    Vous trouverez un exemple de fichier de livraison XML pour les envois internationaux contenant des marchandises sur Assistance technique DataTransfer.

    Exemple de fichier XML-DataTransfer pour EAD

    <?xml version="1.0" encoding="UTF-8"?>
    <SendItemInfo xmlns=http://www.post.ch/datatransfer/schemas/2019/02/ead OriginVersion="11">
           <FileInfo>
                 <FileID>8975</FileID>
                 <FileDate>20190619</FileDate>
                 <FileTime>100443</FileTime>
           </FileInfo>
           <ItemInfo>
                 <InfoEvent>
                        <Date>2019-06-19T10:04:43</Date>
                        <PostcodeUPU>CHZRHB</PostcodeUPU>
                        <Source>EXT</Source>
                 </InfoEvent>
                 <ItemInfoData>
                        <Barcode>RF115700015CH</Barcode>
                        <TotalValue>2250</TotalValue>
                        <TotalCurrency>CHF</TotalCurrency>
                        <MailSourceExport>AE</MailSourceExport>
                        <PostagePrice>36</PostagePrice>
                        <PostageCurrency>CHF</PostageCurrency>
                        <DeclaredGrossWeight>0.5</DeclaredGrossWeight>
                        <NatureOfTransactionCode>3</NatureOfTransactionCode>
                        <DestinationCountryIso>DE</DestinationCountryIso>
                 </ItemInfoData>
                 <Addressee>
                        <Name1>Max</Name1>
                        <Name2>Muster</Name2>
                        <Address1>rue dela vue Z2 0009</Address1>
                        <Address2>adresszusatz</Address2>
                        <Address3>p.b. 999</Address3>
                        <ZipCode>45678</ZipCode>
                        <City>aruba capitale</City>
                        <CountryIso>DE</CountryIso>
                        <Language>ENG</Language>
                        <Email>max.muster@gmx.ch</Email>
                 </Addressee>
                 <Sender>
                        <Name1>Daniela</Name1>
                        <Name2>Meier</Name2>
                        <Name3>Apotheke + Drogerie AG</Name3>
                        <Address1>Marktgasse 99</Address1>
                        <ZipCode>8600</ZipCode>
                        <City>Dübendorf</City>
                        <CountryIso>CH</CountryIso>
                        <Contact>Daniela Meier</Contact>
                        <Email>daniela.meier@apotheke.ch</Email>
                        <Tel>+31888777999</Tel>
                 </Sender>
                 <ItemPosition>
                        <Position>1</Position>
                        <OriginLocation>EG</OriginLocation>
                        <ProductDescription>Brillen &amp; Kontaktlinsen</ProductDescription>
                        <NetWeight>0.5</NetWeight>
                        <Amount>2250</Amount>
                        <Value>1</Value>
                        <ValueCurrency>CHF</ValueCurrency>
                 </ItemPosition>
           </ItemInfo>
    </SendItemInfo>

    3.2 Confirmations

    Le contenu des confirmations est toujours en anglais. Les explications relatives aux messages d’erreur se trouvent sur Assistance technique DataTransfer.

    3.2.1 Confirmation Message

    Le Confirmation Message contient des retours d’information sur le contenu du message.

    Exemple de Confirmation Message

    <?xml version="1.0" encoding="utf-8"?>
    <ns0:ConfMsg xmlns:ns0=http://www.post.ch/datatransfer/schemas/2019/02/ead>
           <ns0:FileID>200103</ns0:FileID>
           <ns0:FileDate>20200103</ns0:FileDate>
           <ns0:FileTime>100443</ns0:FileTime>
           <ns0:SenderID>982</ns0:SenderID>
           <ns0:ResponseStatus>OK</ns0:ResponseStatus>
           <ns0:ItemInfoStatus>
                 <ns0:Barcode>RO995078912CH</ns0:Barcode>
                 <ns0:Status>OK</ns0:Status>
                 <ns0:ErrorMessage>
                        <ns0:Type/>
                        <ns0:Code/>
                 </ns0:ErrorMessage>
           </ns0:ItemInfoStatus>
    </ns0:ConfMsg>

    3.2.2 Receipt Message

    Le Receipt Message constitue une confirmation de réception. DT envoie ce message pour accuser bonne réception; En cas de prise en charge infructueuse, aucun retour d’information n’est généré pour l’expéditeur. Le Receipt Message ne comporte pas d’informations sur le contenu.

    Exemple de Receipt Message

    <?xml version="1.0" encoding="utf-8"?>
    <ns0:RcptMsg xmlns:ns0=http://www.post.ch/datatransfer/schemas/2019/02/ead>
           <ns0:FileID>200103</ns0:FileID>
           <ns0:FileDate>20200103</ns0:FileDate>
           <ns0:FileTime>100443</ns0:FileTime>
           <ns0:SenderID>982</ns0:SenderID>
    </ns0:RcptMsg>

    3.2.3 Codes d’erreurs en cas de transmission de données incorrect

    Une liste Excel avec tous les codes d’erreur susceptibles de survenir dans le protocole de traitement ou dans l’accusé de réception se trouve sur notre page d’accueil sous Assistance technique DataTransfer.

    4. Autres publications

    5. Release Notes

    5.1 Nouveautés

    • Nouveau document inséré
    • Mise en œuvre sur le microsite