DataTransfer – Anhang 5

Sprachnavigation

Zurück

DataTransfer – Anhang 5

[Sidebar | Close]

    DataTransfer – Anhang 5

    Beschreibung der Kundenschnittstelle DataTransfer

    Einlieferung EAD (Electronic Advance Data) für internationale Briefsendungen mit Wareninhalt

     

    1. Einleitung

    1.1 An wen richtet sich diese Anleitung?

    Dieser Anhang enthält die technischen Informationen für die elektronische Dateneinlieferung von EAD (Electronic Advance Data) an die Post.

    1.2 Welche Informationen erhalten Sie zu DataTransfer?

    DataTransfer-Handbuch: Übersicht und funktionale Beschreibungen zu DataTransfer

    Kurzbeschreibung der Dienstleistungen DataTransfer, Briefe mit Barcode (BMB) via DataTransfer, «Aufgabeverzeichnis erstellen» via DataTransfer und Paketversand easy via SFTP, Erläutern der Funktionsweise und Aufzeigen des Anmelde- und Testverfahrens. Es richtet sich primär an Entscheidungsträger für DataTransfer.

    DataTransfer – Anhang 1: Beschreibung der Kundenschnittstelle DataTransfer: Pakete, Express, Lösungen und Briefe mit Barcode (BMB)

    Beschreibung der Nachrichtenstruktur und Dateninhalte für die Dateneinlieferung für Pakete, Express, Lösungen und BMB und die technischen Spezifikationen wie z. B. die Einlieferungsformate und die Namenskonventionen.

    DataTransfer – Anhang 2: Beschreibung der Kundenschnittstelle «Aufgabeverzeichnis erstellen»

    Beschreibung der Dateninhalte für die Dateneinlieferung und Darstellung der Berichte von «Aufgabeverzeichnis erstellen».

    DataTransfer – Anhang 3: Beschreibung der DataTransfer-Berichte

    Beschreibung der Dateninhalte der Berichte für BMB,Pakete und Swiss-Express, jedoch ohne «Aufgabeverzeichnis erstellen».

    1.3 Gültigkeit

    Das Handbuch wird online aktualisiert. Änderungen werden in der Änderungshistorie im Kapitel 5 festgehalten.

    Mit Erscheinen der neuen Anleitungen verlieren die alten PDFs ihre Gültigkeit. Diese Seite stellt jeweils die aktuelle Version dar.

    1.4 Verwendete Abkürzungen

    Abkürzung Beschreibung
    BMB Briefe mit Barcode
    DataTransfer Dienstleistungsname für die elektronische Datenübermittlung an die Post
    KDP-Nummer
    		 Kundenidentifikationsnummer der Post
    Letter ID Die adressierten und eindeutig identifizierbaren Briefe (mittels DMC) werden mit dem Provider Letter ID übermittelt
    LSO Lieferschein für Briefsendungen mit Barcode, wird beim Provider BMB zur Aufgabe der Sendungen verwendet
    Paketversand easy Paketaufgabe ohne Aufgabeverzeichnis
    PKZIP 2.0 Kompressionsstandard zur Verkleinerung von Dateien. Beinahe alle Dateien mit der Endung .zip sind heute im PKZIP 2.0-Format
    XSD XML-Schema-Definition: Zur Erstellung und Überprüfung der XML-Datei

    1.5 Support

    Post CH AG
    Support DataTransfer
    Wankdorfallee 4
    3030 Bern

    E-Mail datatransfer@post.ch

    2. Technische Spezifikation

    2.1 Einlieferung

    Die Daten können Sie auf folgende Arten übermitteln:

    • Als Anhang in einem E-Mail
    • Via ein SFTP-Konto bei der Post
    • Über die sedex-Plattform des Bundes (nur XML)

    Vorgaben für die Aufbereitung der Dateien finden Sie im Kapitel 2.3.

    2.1.1 E-Mail

    Um die Dateneinlieferung per E-Mail zu nutzen, benötigen Sie ein E-Mail-Konto, mit dem Sie E-Mails bis zu einer Grösse von 2 MB versenden können. Der Anhang des E-Mail muss als base64 oder uuencoded eingeliefert werden.

    Ablauf der Dateneinlieferung per E-Mail

    Bereiten Sie die Daten im XML-Format auf und fügen Sie die Datei als Anhang in ein E-Mail ein. Die maximale Dateigrösse für die Dateneinlieferung per E-Mail ist auf 2 MB pro Einlieferung beschränkt.

    Damit auch bei der Einlieferung via E-Mail die angehängten Dateien eindeutig identifiziert werden können, wird zusätzlich im Nachrichtenteil (Body) des E-Mails ein Stichwort mitgegeben. Sollte dieses Stichwort falsch sein, so wird das E-Mail gelöscht (inkl. Anhang). Das Stichwort im E-Mail lautet:

    • In der Testphase: T-770809dfu01input
    • In der Produktivphase: 770809dfu01input

    Achtung: es darf nur das Stichwort und die Datei im E-Mail enthalten sein. Zusätzliche Texte wie z.B. automatische Signatures sind nicht erlaubt.

    Das E-Mail senden Sie an paketversand.dfu@post.ch.

    2.1.2 SFTP

    Für die Einlieferung der Daten über SFTP benötigen Sie ein SFTP-Konto bei der Post. Sollte dieses SFTP-Konto noch nicht bestehen, wird es nach der Anmeldung eröffnet.

    Eine Anleitung zum Datenimport via SFTP finden Sie unter in dieser Anleitung oder erhalten Sie beim Support DataTransfer.

    2.1.3 sedex

    Für sedex-Teilnehmer der Domäne eSchKG ist der elektronische Austausch von Sendungsdaten über die sedex-Plattform des Bundes möglich. Die bestehenden DataTransfer-Dienstleistungen wurden mit einem Adapter erweitert.

    Die Anmeldungen beim Bundesamt für Statistik werden vom Support DataTransfer durchgeführt.

    Eine Anleitung zur Datenübermittlung über sedex finden Sie unter Datatransfer -> Briefe mit Barcode.

    2.2 Dateiformat

    Die Dateien werden im XML- (UTF-8) oder ZIP-Format (PKZIP 2.0) entgegengenommen. Die Struktur ist im Kapitel 3.1.1 ersichtlich.

    2.2.1 Sonderzeichen im XML-Format

    Die XML-Dateien müssen gemäss XML-Standard wohlgeformt sein, damit diese von DataTransfer verarbeitet werden können. Dies bedeutet für die Einlieferung der Sendungsdaten:

    Sonderzeichen, wie z. B. spitze Klammern (<>) oder Anführungszeichen («»), dürfen nicht ohne Kodierung in den Attributwerten im XML-File stehen.

    Damit Sie die Sonderzeichen einliefern können, müssen Sie diese mit aus den HTML bekannten Sonderzeichen kodieren. Diese benannten Zeichen sind nach folgendem Muster aufgebaut: &[Name];

    Das Beispiel zeigt die Codierung des kaufmännischen «und» («&»): Name1=»Moser &amp; Cie.»(Moser & Cie.)

    Nachfolgend eine Auflistung der Sonderzeichen und den entsprechenden Codierungen, welche codiert eingeliefert werden müssen:

    Sonderzeichen Codierung
    & &amp;
    < &lt;
    > &gt;
    “ &quot;
    ’ &apos;

    Normale Umlaute dürfen nicht HTML-encodiert werden.

    Sie können auf einfache Weise prüfen, ob ein XML wohlgeformt ist und von DataTransfer verarbeitet werden kann: Öffnen Sie die Datei in einem Browser (z. B. Internet Explorer oder Mozilla Firefox). Bei nicht wohlgeformten Dateien erscheint eine entsprechende Fehlermeldung.

    2.3 Namenskonventionen

    2.3.1 Dateinamen für Einlieferung

    Für alle Übermittlungsarten (SFTP, E-Mail) gelten für die Dateikennung dieselben Anforderungen. Liefern Sie Dateien ein, deren Dateinamen nicht untenstehender Namenskonvention entsprechen, so werden diese Dateien nicht abgeholt und nach einer bestimmten Zeit automatisch gelöscht. Aus Sicherheitsgründen werden Sie darüber nicht benachrichtigt. Die nachfolgende Namenskonvention ist deshalb zwingend einzuhalten. 

    Namenskonvention

    SenderID_EAD_INPUT_YYYYMMDD_HHMMSS_FileID.xml

    SenderID_EAD_RcptMsg_YYYYMMDD_HHMMSS_FileID.xm

    SenderID_EAD_ConfMsg_YYYYMMDD_HHMMSS_FileID.xml

    Die FileID der EAD INPUT Message und der dazugehörigen BMB Einlieferdatei müssen identisch sein. Nur so können wir und sie auf eine einfache Art und Weise die Vollständigkeit der Uebermittlungen prüfen.

    Tip

    Und wenn sie in der BMB Einlierferdatei noch die FileID in das Element SendingID abfüllen, dann haben sie auf allen Sendungen auf diesem LSO in den Berichten den entsprechenden Hinweis.

    <SendingID>1</SendingID>

    Beispiel

    829_EAD_RcptMsg_20190708_101305_447204.xml

    Maximale Filegrösse für Einlieferdateien

    Das Einlieferfile darf maximal eine Grösse von 6 MB aufweisen. Überschreitet das File diese Grösse, wird es nicht verarbeitet und Sie erhalten eine entsprechende Fehlermeldung «max. filesize exceeded».

    3. Dateninhalte der Kundenschnittstelle

    3.1 Einlieferung für DataTransfer für internationale Sendungen mit Wareninhalt

    Pro Dateneinlieferung erhalten Sie eine Empfangsbestätigung und ein Verarbeitungsprotokoll. Beides wird per SFTP zugestellt.

    Die Empfangsbestätigung sagt aus, ob die Datei erfolgreich übermittelt wurde und von DataTransfer erkannt werden konnte. Dabei werden die Felder «FileID», «SenderID» und «KDPNumber» auf ihre Richtigkeit überprüft. Die Datei wird auf Parsing-Fähigkeit und exakte Konformität des Schnittstellenschemas (Elemente und Attribute) geprüft. Allfällige Fehler werden im Verarbeitungsprotokoll einzeln aufgeführt. Die Empfangsbestätigung können Sie via das Attribut «SendOKMail = 1» in der eingelieferten Datei unterdrücken; im Fehlerfall wird Ihnen die Empfangsbestätigung immer übermittelt.

    Das Verarbeitungsprotokoll zeigt Ihnen, ob die eingelieferten Daten von DataTransfer formell verarbeitet werden konnten. Die fehlerhaften Datensätze erhalten einen Fehlercode und eine Fehlerbeschreibung, um Ihnen die Fehlersuche zu erleichtern. Das Verarbeitungsprotokoll macht jedoch keine Aussage über die eingelieferte Adressqualität. Über das Attribut «SendOKMail = 1» in der eingelieferten Datei können Sie wählen, ob Sie das Verarbeitungsprotokoll auch dann erhalten wollen, wenn die Daten in Ordnung sind; im Fehlerfall wird Ihnen das Protokoll immer übermittelt.

    Die Übersichtstabelle mit allen Fehlercodes und deren Erklärungen finden Sie unter Technische Unterstützung DataTransfer → Briefe mit Barcode.

    <Element>
    Element/Attribute    		 Description Features Char Set Format
    (min./max. Length)    		 Default Value Remarks
    <envelope> - Min. 1 / Max. 1/td> - - - -
    OriginVersion
    		 Declaration of the OriginVersion
    		 Mandatory
    		 Alphanumeric
    		 - - N° of the Msg Version

    <​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/>
    <​Language/>
    <​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

    Für die Erstellung und Überprüfung der XML-Schnittstelle wird ein Schema angeboten. Das Schema ist als XSD (XML-Schema-Definition) hinterlegt und kann unter folgender Adresse aufgerufen, bzw. direkt in das XML eingebunden werden: Technische Unterstützung DataTransfer

    3.1.3 Muster XML-Format für internationale Briefe mit Wareninhalt

    Ein Muster-XML der Einlieferdatei für internationale Briefe mit Wareninhalt finden Sie auf Technische Unterstützung DataTransfer

    3.1.4 Beispiel einer XML-DataTransfer-Datei für 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 Bestätigungen

    Der Inhalt der Bestätigungen ist immer in englischer Sprache. Die Erklärungen zu den Fehlermeldungen finden Sie unter Technische Unterstützung DataTransfer.

    3.2.1 Confirmation Message

    Die Confirmation Message enthält Rückmeldungen über den Inhalt der Message.

    Beispiel Confirmation Message 12 DataTransfer

    <?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

    Die Receipt Message ist die Empfangsbestätigung. DT sendet diese bei erfolgreicher Entgegennahmen. Bei nicht erfolgreicher Übernahme wird keine Rückmeldung an den Sender generiert. Mit der Receipt Message werden keine inhaltlichen Aussagen gemacht.

    Beispiel 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 Fehlercodes bei fehlerhafter Dateneinlieferung

    Eine Excel-Liste mit allen Fehlercodes, die im Verarbeitungsprotokoll oder in der Empfangsbestätigung aufgeführt sein können, erhalten Sie auf unserer Homepage unter Technische Unterstützung DataTransfer.

    4. Weitere Publikationen

    5. Release Notes

    5.1 Neuerungen

    • Neues Dokument eingefügt
    • Implementierung auf Microsite

    Footer