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.

    La version actuelle contient déjà les nouveaux champs exigés dans le cadre de la réforme douanière de l’UE à partir du 1.11.2026. 

    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. 
    DT DataTransfer
    EAD
    Electronic Advance Data
    PDDP
    Postal Delivery Duties Paid
    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
    Digital Integration
    Wankdorfallee 4
    3030 Berne
    Suisse

    E-mail: digitalintegration@poste.ch

    Page d’erreur: help.post.ch

    2. Spécifications techniques

    2.1 Transmission des données

    Les données peuvent être transmises via le compte SFTP de la Poste. 

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

    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.2 Format des fichiers

    Les fichiers sont acceptés au format XML (UTF-16) 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.“(Moser & 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.xml

    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

    3.1.1 Généralités

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

    L’accusé de réception vous indique si le fichier a bien été transmis et a pu être reconnu par DataTransfer. Les champs «FileID» et «SenderID» (du nom du fichier) ainsi que le statut de l’expéditeur (activé) et l’autorisation de service sont vérifiés. 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.

    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.

    Vous trouverez de plus amples informations sur les confirmations au chapitre 3.2

    3.1.2 Structure des données

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

    Dans la section suivante, vous trouverez les valeurs selon le schéma XML sous une forme simplifiée.

    La graphie dans la représentation simplifiée est une désignation abrégée. La cardinalité et le statut obligatoire sont obligatoires dans la description de l’élément. Vous trouverez un exemple XML réel avec des valeurs en-dessous de cette section.

    <​/SendItemInfo
    xmlns
    OriginVersion>
    <​FileInfos>
    <​FileID/>
    <​FileDate/>
    <​FileTime/>
    <​/FileInfo>
    <​ItemInfo>
    <​InfoEvent>
    <​Date/>
    <​PostcodeUPU/>
    <​Source/>
    <​/InfoEvent>
    <​ItemInfoData>
    <​Barcode/>
    <​TotalValue/>
    <​TotalCurrency/>
    <​MailSourceExport/>
    <​PostagePrice/>
    <​PostageCurrency/>
    <​DeclaredGrossWeight/>
    <​NatureOfTransactionCode/>
    <​AssociatedDocumentType/>
    <​AssociatedDocumentIdentifier/>
    <​DestinationCountryIso/>
    <​DeliveryInstructions/>
    <​/ItemInfoData>
    <​Addressee>
    <​Name1/>
    <​Name2/>
    <​Name3/>
    <​Address1/>
    <​Address2/>
    <​Address3/>
    <​ZipCode/>
    <​City/>
    <​Region/>
    <​CountryIso/>
    <​Language/>
    <​Tel/>
    <​Email/>
    <​Vat/>
    <​Taxnumber/>
    <​Contact/>
    <​/Addressee>
    <​Sender>
    <​Name1/>
    <​Name2/>
    <​Name3/>
    <​Address1/>
    <​Address2/>
    <​Address3/>
    <​ZipCode/>
    <​City/>
    <​CountryIso/>
    <​Contact/>
    <​Email/>
    <​Tel/>
    <​Reference/>
    <​Vat/>
    <​Taxnumber/>
    <​IossRightToUseReference/>
    <​/Sender>
    <​ItemPosition>
    <​Position/>
    <​OriginLocation/>
    <​ProductDescription/>
    <​TariffHeading/>
    <​NetWeight/>
    <​Amount/>
    <​Value/>
    <​ValueCurrency/>
    <​MerchantProductIdentifier/>
    <​ManufacturerNonStandardizedProductIdentifier/>
    <​ManufacturerStandardizedProductIdentifier/>
    <​/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

    Exemple de fichier XML-DataTransfer pour EAD

    <?xml version="1.0" encoding="utf-16"?>
    <SendItemInfo xmlns="http://www.post.ch/datatransfer/schemas/2019/02/ead" OriginVersion="11">
           <FileInfo>
                  <FileID>20260910083706</FileID>
                  <FileDate>20260910</FileDate>
                  <FileTime>083706</FileTime>
           </FileInfo>
           <ItemInfo>
                  <InfoEvent>
                         <Date>2026-09-10T08:37:06</Date>
                         <PostcodeUPU>CHZRHB</PostcodeUPU>
                         <Source>EXT</Source>
                  </InfoEvent>
                  <ItemInfoData>
                         <Barcode>RF115700015CH</Barcode>
                         <TotalValue>89.80</TotalValue>
                         <TotalCurrency>CHF</TotalCurrency>
                         <MailSourceExport>E02</MailSourceExport>
                         <PostagePrice>14.50</PostagePrice>
                         <PostageCurrency>CHF</PostageCurrency>
                         <DeclaredGrossWeight>0.350</DeclaredGrossWeight>
                         <NatureOfTransactionCode>2</NatureOfTransactionCode>
                         <AssociatedDocumentType>380</AssociatedDocumentType>
                         <AssociatedDocumentIdentifier>INV-2026-10482</AssociatedDocumentIdentifier>
                         <DestinationCountryIso>DE</DestinationCountryIso>
                         <DeliveryInstructions>_PDDP</DeliveryInstructions>
                  </ItemInfoData>
                  <Addressee>
                         <Name1>Lena Fischer</Name1>
                         <Name2>Shipping</Name2>
                         <Name3>Musterhandel GmbH</Name3>
                         <Address1>Friedrichstrasse 123</Address1>
                         <Address2>3. Obergeschoss</Address2>
                         <Address3>Appartment 24</Address3>
                         <ZipCode>10117</ZipCode>
                         <City>Berlin</City>
                         <Region>Berlin</Region>
                         <CountryIso>DE</CountryIso>
                         <Language>DEU</Language>
                         <Tel>+493012345678</Tel>
                         <Email>lena.fischer@example.com</Email>
                         <Vat>DE123456789</Vat>
                         <Taxnumber>27/123/45678</Taxnumber>
                         <Contact>Lena Fischer</Contact>
                  </Addressee>
                  <Sender>
                         <Name1>Alpine Optics AG</Name1>
                         <Name2>Multichannel</Name2>
                         <Name3>Online Shop</Name3>
                         <Address1>Badenerstrasse 123</Address1>
                         <Address2>Gebaeude B</Address2>
                         <Address3>Rampe 4</Address3>
                         <ZipCode>8004</ZipCode>
                         <City>Zuerich</City>
                         <CountryIso>CH</CountryIso>
                         <Contact>Daniela Meier</Contact>
                         <Email>shipping@example.com</Email>
                         <Tel>+41441234567</Tel>
                         <Reference>ORDER-2026-10482</Reference>
                         <Vat>CHE123456789MWST</Vat>
                         <Taxnumber>CHE123456789</Taxnumber>
                         <IossRightToUseReference>IM2760000001</IossRightToUseReference>
                  </Sender>
                  <ItemPosition>
                         <Position>1</Position>
                         <OriginLocation>CH</OriginLocation>
                         <ProductDescription>Reading glasses +1.5 black</ProductDescription>
                         <TariffHeading>90049090</TariffHeading>
                         <NetWeight>0.120</NetWeight>
                         <Amount>1</Amount>
                         <Value>69.90</Value>
                         <ValueCurrency>CHF</ValueCurrency>
                         <MerchantProductIdentifier>SKU-RG-150-BLK</MerchantProductIdentifier>
                         <ManufacturerNonStandardizedProductIdentifier>AO-READ-150-
                         BLACK</ManufacturerNonStandardizedProductIdentifier>
                         <ManufacturerStandardizedProductIdentifier>
                         7612345678900</ManufacturerStandardizedProductIdentifier>
                  </ItemPosition>
                  <ItemPosition>
                         <Position>2</Position>
                         <OriginLocation>CH</OriginLocation>
                         <ProductDescription>Protective glasses case</ProductDescription>
                         <TariffHeading>42023290</TariffHeading>
                         <NetWeight>0.080</NetWeight>
                         <Amount>1</Amount>
                         <Value>19.90</Value>
                         <ValueCurrency>CHF</ValueCurrency>
                         <MerchantProductIdentifier>SKU-CASE-BLK</MerchantProductIdentifier>
                         <ManufacturerNonStandardizedProductIdentifier>AO-CASE-HARD-
                         BLACK</ManufacturerNonStandardizedProductIdentifier>
                         <ManufacturerStandardizedProductIdentifier>7612345678917
                         </ManufacturerStandardizedProductIdentifier>
                  </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 Receipt Message

    Le Receipt Message constitue une confirmation de réception. DT envoie ce message pour accuser bonne réception; Le Receipt Message est envoyé à chaque livraison – en cas d’erreurs, en plus avec un bloc <ErrorMessage> (Type/Code/Message). Le Receipt Message ne comporte pas d’informations sur le contenu.

    3.2.2 Confirmation Message

    Le Confimation Message indique si les données d’envoi ont pu être traitées.

    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>NOK</ns0:ResponseStatus> 
                <ns0:ItemInfoStatus> 
                         <ns0:Barcode>RO995078912CH</ns0:Barcode> 
                         <ns0:Status>NOK</ns0:Status> 
                         <ns0:ErrorMessage> 
                                   <ns0:Type> ERROR</ns0:Type>
                                   <ns0:Code>13207</ns0:Code> 
                                   <ns0:Message>invalid: Country</ns0:Message>
                                   <ns0:Detail>IsoCode: IC not found.</ns0:Detail>
                          </ns0:ErrorMessage>
                 </ns0:ItemInfoStatus> 
    </ns0:ConfMsg>

    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 (XLSX, 67 KB)Média inaccessible.

    4. Autres publications

    5. Release Notes

    5.1 Nouveautés

    • DeliveryInstructions
    • IossRightToUseReference
    • MerchantProductIdentifier
    • ManufacturerNonStandardizedProductIdentifier
    • ManufacturerStandardizedProductIdentifier