SST AG-Ergebnis Guide. Auskunftsportal & SFTP Datenabruf

Transkript

1 SST AG-Ergebnis Guide Auskunftsportal & SFTP Datenabruf Version

2 SST AG-Ergebnis Guide Inhalt 1. Übersicht Zielgruppe Voraussetzungen Auskunftsportal Adresse Login Suche Datei-Download Aufbewahrung Benachrichtigungs- bei Betrugsverdachtsfällen SFTP Protokoll Host Zugriff Ergebnisbereitstellung Dateibenennung und Aufbewahrung Ergebnisdatei JSON v CSV Version Format & Encoding Datenstruktur CSV Version Format & Encoding Datenstruktur Beispiel XML Version Format & Encoding Datenstruktur XML Version Format & Encoding Datenstruktur Beispiel Anlagen Übergreifende Datenstruktur Deutsche Post AG 1 / 17

3 Änderungshistorie Datum Änderung Fraud Manager kann Betrugsverdachtsfälle abrufen Anlagen > Übergreifende Datenstruktur: Statusliste überarbeitet SFTP: Hinweis zur Löschung überarbeitet Betrugsverdachtsmail: Hinweis auf -Benachrichtigung ergänzt 1. Übersicht Ergebnisdateien können auf zwei unterschiedlichen Wegen abgeholt werden: Zugriff über das Auskunftsportal. Hier erfolgt die Bereitstellung automatisch, je nach Status des Vorgangs. Abruf mithilfe der SFTP-Schnittstelle. Wenn gewünscht, kann die Bereitstellung per SFTP aktiviert werden. Zielgruppe Dieses Dokument richtet sich an Entwickler, die Identifikationen mit POSTIDENT in ihre Anwendung integrieren möchten. Voraussetzungen Im Zuge der Anbindung von IT-Systemen an das POSTIDENT-System werden je nach gewünschter Nutzung folgende Informationen von der DPAG bereitgestellt: Zugangsdaten für... Auskunftsportal SFTP Beschreibung Für den Zugriff auf die Ergebnisdateien über das Auskunftsportal wird ein Benutzername und ein Passwort benötigt. Sie können mehrere Zugänge anfragen, um mit unterschiedlichen Nutzern auf das Auskunftsportal zuzugreifen. Für jeden Zugang erhalten Sie zudem ein Datenpasswort. Dieses benötigen Sie, um die verschlüsselt bereitgstellten Daten nach dem Abruf zu Entschlüsseln. Für den Zugriff auf die Ergebnisdateien über SFTP wird ein Benutzername und ein Passwort benötigt. Sie erhalten zudem ein Datenpasswort. Dieses benötigen Sie, um die verschlüsselt bereitgstellten Daten nach dem Abruf zu Entschlüsseln. 2. Auskunftsportal Adresse Login Bei Aufruf der o.g. URL wird der Login des Auskunftsportals angezeigt. Dort geben Sie bitte den Benutzernamen und das Passwort des Auskunftsportalnutzers ein. Bestätigen Sie dann mit Enter bzw. durch Drücken des "Login"-Buttons Deutsche Post AG 2 / 17

4 Suche Nach erfolgreichem Login wird eine Vorgangssuche angezeigt. Hier ist eine einfache und eine erweiterte Suche möglich. Der Suchbereich Hier kann die Ergebnismenge eingeschränkt werden. Hierzu stehen folgende Möglichkeiten zur Verfügung: Abrechnungsnummer (ClientId) Die Suche kann auf einzelne Abrechnungsnummern (ClientIds) begrenzt oder Ergebnisse für alle ausgewählten Abrechnungsnummern angezeigt werden. Die Mehrfachauswahl ist durch Klick auf die entsprechenden Abrechnungsnummern und gleichzeitigem Drücken der Strg-Taste möglich. Zeitraum Definition des gewünschten Suchzeitraums bezogen auf das Änderungsdatum der Vorgänge. Die Eingabe des 2017 Deutsche Post AG 3 / 17

5 "von"-feldes ist obligatorisch. Das Ende des Suchzeitraums ("bis"-feld) muss größer oder gleich dem Beginn sein. Beide Datums-Eingaben dürfen nicht in der Zukunft liegen und müssen im Format TT.MM.JJJJ HH:MM angegeben werden. Bei Nutzung der erweiterten Suche haben Sie zusätzlich Zugriff auf die folgenden Suchfelder: Vorgangsnummer Referenznummer Nachname Vorname Hinweis: Alle gefüllten Suchfelder müssen entsprechend im Vorgang vorliegen, damit dieser gefunden wird. Der Ergebnisbereich Nach Betätigen des "Suche"-Buttons werden die Ergebnisse in Form einer Tabelle angezeigt. Die Tabelle beinhaltet folgende Spalten: Vorgangsnummer Referenznummer Nachname Vorname Änderungszeitpunkt Vorgangsstatus Verfahren Ident-Status Ident-Substatus (Vorgang herunterladen) Hinweis: Weitere Informationen über die genannten Datenfeldern sind der Anlage zu entnehmen. Datei-Download Durch Betätigen des Buttons hinter jedem Vorgang, können Daten und Dateien heruntergeladen werden. In welcher Repräsentation die Daten heruntergeladen werden sollen, kann mithilfe der Downloadoptionen eingestellt werden Deutsche Post AG 4 / 17

6 Neben dem Download einzelner Vorgänge können auch mehrere oder alle angezeigten Vorgänge gemeinsam heruntergeladen werden. Die Auswahl von Vorgängen erfolgt über Auswahlhaken vor jedem Eintrag in der Ergebnisliste bzw. mit dem Auswahlhaken in der ersten Spalte Tabellenüberschrift, um alle angezeigten Einträge auszuwählen. Mithilfe des Download-Buttons oberhalb des Suchergebnisses ( ) werden alle ausgewählten Vorgänge herunter geladen Deutsche Post AG 5 / 17

7 Die Downloadoption steuert in welcher Form die Daten heruntergeladen werden sollen. Dies betrifft sowohl den Download einzelner Vorgänge, als auch mehrerer Vorgänge. Zwischen folgenden Optionen kann gewählt werden: Identifikationsdaten JSON Die Daten der ausgewählten Vorgänge in Form mehrerer JSON-Dateien (eine Datei je Vorgang). Das Dateiformat ist JSON v1, die Beschreibung der Datenstruktur kann der Dokumentation der SCR Result-Schnittstelle entnommen werden (siehe CSV Die Daten der ausgewählten Vorgänge in Form einer CSV-Datei. Das Dateiformat ist entsprechend ihrer Anbindung entweder 2.0 oder 1.3 (Beschreibung der Struktur siehe unten). Bei einer Anbindung über SCR (und damit der Schnittstellenversion v1) werden die Daten auf das Format CSV 2.0 gemapped. Das Datenset CSV 2.0 enthält weniger Daten als JSON v1. XML Die Daten der ausgewählten Vorgänge in Form einer XML-Datei. Das Dateiformat ist entsprechend ihrer Anbindung entweder 2.0 oder 1.3 (Beschreibung der Struktur siehe unten). Bei einer Anbindung über SCR (und damit der Schnittstellenversion v1) werden die Daten auf das Format XML 2.0 gemapped. Das Datenset XML 2.0 enthält weniger Daten als JSON v1. Bilddateien Fotos von Ausweisen und Kunde (sofern für das Verfahren und Ihre Konfiguration vorhanden). Ergebnis-PDF Daten und Bilder (falls vorhanden) im PDF-Format. Hinweis: Die PDF-Funktion muss für die Abrechnungsnummer aktiviert werden. Die Ergebnis-PDFs werden erst ab dem Zeitpunkt der Aktivierung erzeugt (siehe Dokument "Ergebnis PDF Guide") Die o.g. Daten werden in ein Archiv (ZIP) verpackt, mit dem Datenpasswort des eingeloggten Users verschlüsselt und zum Download bereitgestellt. Weitere Informationen über die Ergebnisdatei können dem Kapitel Ergebnisdatei entnommen werden. Aufbewahrung Die Aufbewahrung der Identifikationsdaten kann individuell konfiguriert werden. Die maximale Aufbewahrungsfrist beträgt 150 Tage. Danach werden die Daten unwiderruflich gelöscht. Benachrichtigungs- bei Betrugsverdachtsfällen Es gibt die Nutzerrolle "Fraud Manager", die berechtigt ist Vorgänge markiert als "Betrugsverdacht" oder "Identifizierung mit Auffälligkeiten" abzurufen. Nutzer mit dieser Rolle werden automatisch per informiert, wenn neue Betrugsverdachtsfälle vorliegen. Der Versand der erfolgt aggregiert alle 4 Stunden. Die enthält einen Deeplink in das Auskunftsportal, der (nach dem erfolgreichen Login) die Suchkriterien vorbelegt mit Abrechnungsnummer/ClientId und Zeitraum vorbelegt. Die Suche wird automatisch ausgeführt, sodass sofort die in der aufgeführten Vorgänge eingeblendet werden Deutsche Post AG 6 / 17

8 3. SFTP Protokoll Es wird das Secure File Transfer Protocol (SFTP) verwendet. Hierbei handelt es sich um einen FTP Server, auf den über SSH zugegriffen werden kann. Host 2017 Deutsche Post AG 7 / 17

9 ebibkom.deutschepost.de Zugriff Jeder Kunde wird vom Postident Serviceteam explizit freigeschaltet. Hierzu bekommt der Geschäftskunde die Zugangsdasten für den Zugriff bereitgestellt. Ergebnisbereitstellung Das Intervall der Bereitstellung wird mit Ihnen abgestimmt, bspw. stündlich oder täglich. Die Ergebnisdaten werden ihm von ihnen gewünschten Format abgelegt - CSV oder XML. Die Details zu diesen Formaten sind unter 4. Ergebnisdatei beschrieben. Dateibenennung und Aufbewahrung Bereitgestellt werden ZIP-Archiv-Dateien, die folgender Namensgebung unterworfen sind: POSTIDENT_<BENUTZERNAME>_<ABRECHNUNGSNUMMER>_<DATUM_VON>_<UHRZEIT_VON>_<DATUM_BIS>_<UHRZEIT_BIS> Parametername Beschreibung Beispiel BENUTZERNAME Benutzername für den SFTP Zugriff NUTZER.SFTP ABRECHNUNGSNUMMER Abrechnungsnummer der ausgelieferten Identifikationen DATUM_VON UHRZEIT_VON DATUM_BIS UHRZEIT_BIS DATUM_VON und UHRZEIT_VON ist der Anfangszeitpunkt der konkreten Auslieferung DATUM_VON und UHRZEIT_VON ist der Anfangszeitpunkt der konkreten Auslieferung DATUM_BIS und UHRZEIT_BIS ist der Endzeitpunkt der konkreten Auslieferung DATUM_BIS und UHRZEIT_BIS ist der Endzeitpunkt der konkreten Auslieferung z.b. POSTIDENT_NUTZER.SFTP_ _ _113000_ _ zip Sollten in einen Zeitraum keine Vorgänge fallen, so wird ein leeres Archiv (Größe 0 Byte) bereitgestellt. Somit können von Ihnen die Verbindung und Bereitstellung einfach validiert werden. Hinweis zur Löschung von Dateien Die per SFTP Schnittstelle bereitgestellten Dateien werden nicht automatisch nach der Abholung gelöscht. Somit behält der Nutzer die volle Kontrolle über die Löschung der Dateien. Aus Datenschutzgründen werden die Dateien vom System nach Ablauf der konfigurierten Speicherdauer (maximal 150 Tage) automatisch gelöscht, auch von der SFTP Schnittstelle (wie aus dem Auskunftsportal auch, siehe oben). Achtung: Der Speicherplatz ist pro Kunde limitiert. Daher ist es wichtig, die nicht mehr benötigten Dateien regelmäßig über die SFTP Schnittstelle zu löschen, da sonst ggf. keine neuen Vorgänge mehr bereitgestellt werden können. 4. Ergebnisdatei 2017 Deutsche Post AG 8 / 17

10 JSON v1 Das empfohlene Dateiformat ist JSON v1. Die Beschreibung der Datenstruktur entnehmen Sie bitte der Dokumentation der SCR Result-Schnittstelle (siehe CSV Version 1.3 Die CSV Version 1.3 wird zurückgebaut und nur noch von einigen Bestandskunden verwendet. Format & Encoding Format Dateiname Separator Feldbegrenzerzeichen CSV-Datei data.csv ; (Semikolon) " (Anführungszeichen) Encoding ISO ( Fallback: ISO ) Datenstruktur Die Datenstruktur ist unabhängig vom ausgewähltem Format in den Anlage tabellarisch beschrieben. Das Format CSV 1.3 unterstützt folgende Datenfelder: Referenz- und Produktdaten Vorgangsnummer (wird befüllt mit Paginiernummer), Abrechnungsnummer, Abrechnungsprodukt, Referenznummer, Sendungsnummer, Verarbeitungszeitpunkt, Kas Identifikationsdaten Nachname, Vorname, Strasse und Hausnummer, PLZ, Ort, Ausweisart, Ausweisnummer, Geburtsdatum, Geburtsort, Staatsangehoerigkeit, Ausstellungsbehoerde, A Identifikation Sonstige Formularangaben Postvermerk, Empfaengeradresse Anhang Dateireferenz, Reserve Anhang, Manuelle Aenderungen, Merkmale Datenabgleich CSV Version 2.0 Format & Encoding Format Dateiname Separator Feldbegrenzerzeichen CSV-Datei data.csv ; (Semikolon) " (Anführungszeichen) Encoding ISO ( Fallback: ISO ) Datenstruktur Die Datenstruktur ist unabhängig vom ausgewähltem Format in den Anlage tabellarisch beschrieben. Das Format CSV 2.0 unterstützt folgende Datenfelder: Referenz- und Produktdaten 2017 Deutsche Post AG 9 / 17

11 Vorgangsnummer, Abrechnungsnummer, Abrechnungsprodukt, Referenznummer, Sendungsnummer, Verarbeitungszeitpunkt, Ka Identifikationsdaten Nachname, Vorname, Strasse und Hausnummer, PLZ, Ort, Ausweisart, Ausweisnummer, Geburtsdatum, Geburtsort, Staatsangehoerigkeit, Ausstellungsbehoerde, A und kartenspezifische Kennzeichen Sonstige Formularangaben Postvermerk, Empfaengeradresse, Paginiernummer Anhang Dateireferenz Sonstige Merkmale Merkmale Filiale, Merkmale Scanndienstleister, Merkmale eid, Merkmale Datenabgleich Neue Datenfelder in der Version 2.0 Merkmale Einwohnermeldeamt, Gesamttrefferguete Schufa, Merkmale Kontotransaktion, Merkmale E-Postbrief Anhang Audio (wird nicht mehr ausgeliefert) Dateireferenz Audio Substatus Merkmale Video Beispiel "Vorgangsnummer";"Abrechnungsnummer";"Abrechnungsprodukt";"Referenznummer";"Se und Hausnummer";"PLZ";"Ort";"Ausweisart";"Ausweisnummer";"Geburtsdatum";"Geburtsor und kartenspezifische Kennzeichen";"Postvermerk";"Empfaengeradresse";"Paginiernummer";"Dateireferenz Filiale";"Merkmale Scanndienstleister";"Merkmale eid";"merkmale Datenabgleich";"Merkmale Einwohnermeldeamt";"Gesamttrefferguete Schufa";"Merkmale Kontotransaktion";"Merkmale E-Postbrief";"Merkmale Video"; "9BGW449EM7YC";" ";"Postident Video";"9BGW449EM7YC";;" :36:02";;;;"Video";"411";"Muster geb. Müller";"Max";"Musterhausstr. 12";"56218";"Mülheim-Kärlich";"Personalausweis";"O XT9";" ";"Ko Wiesbaden";;" ";;;;;"9BGW449EM7YC_ _ tif";;;;;; 20:27:02";;;;"Basic";"130";;;;;;;;;;;;;;;;;;;;;;;;;;;; "PWBGPZUEZ236";" ";"Postident Basic Zusatzleistung 1";"1B37P62WZ212";;" :51:57";" ";" ";"58";"Basic";"110";"Muster geb. Müller";"Max";"Musterhausstr. 35";"56218";"Mülheim-Kärlich";"Personalausweis";"O XT9";" ";"Ko Wiesbaden";;" ";;;;;;"1";;;;;;;;; XML Version 1.3 Die XML Version 1.3 wird zurückgebaut und nur noch von einigen Bestandskunden verwendet. Format & Encoding Format: XML Encoding: ISO (Hinweis: Das Encoding in der Schemadatei ist abweichend) Schema: PostidentIdentifikationen.xsd 2017 Deutsche Post AG 10 / 17

12 Datenstruktur Die Datenstruktur ist unabhängig vom ausgewähltem Format in den Anlage tabellarisch beschrieben. XML Version 2.0 Format & Encoding Format: XML Encoding: ISO (Hinweis: Das Encoding in der Schemadatei ist abweichend) Schema: PostidentIdentifikationenVersionB.xsd Datenstruktur Die Datenstruktur ist unabhängig vom ausgewähltem Format in den Anlage tabellarisch beschrieben. Beispiel <?xml version="1.0" encoding="iso " standalone="yes"?> <postident_identifikationen> <postident_identifikation> <referenz_und_produktdaten> <vorgangsnummer>9bgw449em7yc</vorgangsnummer> <abrechnungsnummer> </abrechnungsnummer> <abrechnungsprodukt>postident Video</abrechnungsprodukt> <referenznummer>9bgw449em7yc</referenznummer> <verarbeitungszeitpunkt> t19:36: :00</verarbeitungszeitpunkt> <produkt>video</produkt> <status>411</status> </referenz_und_produktdaten> <identifikationsdaten> <nachname>muster geb. Müller</nachname> <vorname>max</vorname> <strasse_und_hausnummer>musterhausstr. 12</strasse_und_hausnummer> <plz>56218</plz> <ort>mülheim-kärlich</ort> <ausweisart>personalausweis</ausweisart> <ausweisnummer>o xt9</ausweisnummer> <geburtsdatum> </geburtsdatum> <geburtsort>koblenz</geburtsort> <staatsangehörigkeit>deutsch</staatsangehörigkeit> <ausstellungsbehörde>landeshauptstadt Wiesbaden</ausstellungsbehörde> <ausstellungsort></ausstellungsort> <ausstellungsdatum> </ausstellungsdatum> </identifikationsdaten> <sonstige_formularangaben/> <anhang> <dateireferenz>9bgw449em7yc_ _ tif</dateireferenz> </anhang> <sonstige_merkmale/> </postident_identifikation> <postident_identifikation> 2017 Deutsche Post AG 11 / 17

13 <referenz_und_produktdaten> <vorgangsnummer>xz7j </vorgangsnummer> <abrechnungsnummer> </abrechnungsnummer> <referenznummer>xz7j </referenznummer> <verarbeitungszeitpunkt> t20:27: :00</verarbeitungszeitpunkt> <produkt>basic</produkt> <status>130</status> </referenz_und_produktdaten> <sonstige_formularangaben/> <sonstige_merkmale/> </postident_identifikation> <postident_identifikation> <referenz_und_produktdaten> <vorgangsnummer>pwbgpzuez236</vorgangsnummer> <abrechnungsnummer> </abrechnungsnummer> <abrechnungsprodukt>postident Basic Zusatzleistung 1</abrechnungsprodukt> <referenznummer>1b37p62wz212</referenznummer> <verarbeitungszeitpunkt> t20:51: :00</verarbeitungszeitpunkt> <kassenvermerk> <kassenschluessel> </kassenschluessel> <kassentag> :00</kassentag> <journalsatznummer>58</journalsatznummer> </kassenvermerk> <produkt>basic</produkt> <status>110</status> </referenz_und_produktdaten> <identifikationsdaten> <nachname>muster geb. Müller</nachname> <vorname>max</vorname> <strasse_und_hausnummer>musterhausstr. 35</strasse_und_hausnummer> <plz>56218</plz> <ort>mülheim-kärlich</ort> <ausweisart>personalausweis</ausweisart> <ausweisnummer>o xt9</ausweisnummer> <geburtsdatum> </geburtsdatum> <geburtsort>koblenz</geburtsort> <staatsangehörigkeit>deutsch</staatsangehörigkeit> <ausstellungsbehörde>landeshauptstadt Wiesbaden</ausstellungsbehörde> <ausstellungsdatum> </ausstellungsdatum> </identifikationsdaten> <sonstige_formularangaben/> <sonstige_merkmale> <merkmale_filiale>1</merkmale_filiale> 2017 Deutsche Post AG 12 / 17

14 </sonstige_merkmale> </postident_identifikation> </postident_identifikationen> 5. Anlagen Übergreifende Datenstruktur Feldnamen Wertebereich / Beispiel Beschreibung Referenz- und Produktdaten Vorgangsnummer x x ABC123DEF456 Identifiziert eindeutig einen Vorgang im System. Die Vorgangsnummer ist 12 Stellen lang und beinhaltet die Zeichen 0-9 und A-Z ohne I, L und O. Abrechnungsnummer x x Eindeutiger Identifier eines Kunden Accounts. Die 14-stellig Nummer setzt sich wie folgt zusammen: Abrechnungsnummer = EKP (10 Stellen) + Verfahren (37 bei Basic, 34 bei Comfort und Special) + Teilnahme (2 Stellen) Abrechnungsprodukt x x Wertebereich /Bedeutung: Erbrachte Leistung, welche für die Durchführung des Vorgang in Rechnung gestellt wird. Postident Basic Zusatzprodukt 1 / Elektronische Formulardaten Postident Basic Zusatzprodukt 2 / Elektronische Formulardaten und Anlagenhandling Postident Basic Zusatzprodukt 3 /Elektronische Formulardaten und Anlagenimage bis 3 Seiten Postident Basic Zusatzprodukt 4 /Elektronische Formulardaten und Anlagenimage bis 10 Seiten Postident npa Identifizierung mit Postident npa Postident Video Identifizierung mit Postident Video -"Postident Digital"- Wird nicht mehr unterstützt "Postident Online" Wird nicht mehr unterstützt "Foto Mobility" Identifikation mit Postident Foto Für Comfort und Special wird dieses Feld daher keinen Wert enthalten, da hier eine separate Abrechnung (über das Porto) stattfindet. Referenznummer x x Die Referenznummer wird vom Auftraggeber beim initiieren eines Vorgangs übergeben und dient der Identifikation des Vorgangs im Auftraggeber-System. Nur bei Verfahren: Postident Basic offline (Filial- & Scandaten) & online, npa und Video // Nicht Special & Comfort. Die alphanumerische Referenznummer ist 14 Stellen lang. Sendungsnummer x x Nur bei Postident Comfort oder Special. 13-stellige Sendungsnummer z. B. AF DE AA = Comfort AF = Spezial Wenn keine Sendungsnummer verwendet wird, bleibt das Feld leer. Verarbeitungszeitpunkt x x DD.MM.YYYY HH24:MI:SS (bei CSV) Zeitpunkt der Verarbeitung im Web (= Basic Online, npa, Video) oder Basic Offline (= Filial- oder Scandaten), sowie Special & Comfort YYYY-MM-DD HH24:MI:SS (bei XML) Kassenvermerk x x Optionaler Kassenvermerk (Tag in der xml-datei): Nur Basic Online (= Filial-Datensatz) --> Nicht bei Special und Comfort Kassenvermerk = Kassenschluessel + Kassentag + Journalsatznummer 2017 Deutsche Post AG 13 / 17

15 Kassenschluessel x x Verfügbar bei Identifikation in der Filiale (nur Basic Offline // Nicht Special & Comfort): Kassentag x x Verfügbar bei Identifikation in der Filiale: Kassenschlüssel der Filialkasse, an der die Identifikation erfasst wurde. Kassenschlüssel + Kassentag + Journalsatznummer = eindeutiger Schlüssel zum Auffinden zusammengehöriger Sätze Tag, an dem die Identifikation an der Filialkasse erfasst wurde. Journalsatznummer x x Verfügbar bei Identifikation in der Filiale: Bildet zusammen mit Kassentag und Journalsatznummer einen eindeutigen Schlüssel zum Auffinden zusammengehöriger Sätze (s.feld Status ) Satznummer innerhalb des täglichen Kassenjournals, die der Erfassung der Identifikation an der Filialkasse entspricht. Kassenschlüssel + Kassentag + Journalsatznummer = eindeutiger Schlüssel zum Auffinden zusammengehöriger Sätze Produkt x x Basic Comfort Special npa echeck Video Photo Status x x Basic: Verwendete Postidentverfahren Statuswerte die innerhalb entsprechenden Postidentverfahren eingenommen werden können. 100=Vorläufiger (Normal-) Satz 110=Endgültiger (Normal-) Satz / Filialdaten oder Filial- und Scandaten sind in der AG-Init-SST bereitgestellt 120=Stornosatz / Erfolgreiche Identifizierung wurde nachträglich durch Kunde storniert (finaler Status) 130=Coupon wurde bereitgestellt / Kunde hat noch die Möglichkeit ein anderes Verfahren zu wählen. 151=Abgelehnt wegen Betrugsverdacht npa: Video: Foto 200=nPA erfolgreich (nach Abschluss erfolgreicher Identifizierung) 205=nPA nicht erfolgreich (alle Versuche den npa auszulesen sind fehlgeschlagen) 400=Lieferung Videoident, Identifikation vorläufig erfolgreich 411=Lieferung Videoident, nach erfolgreicher Identifizierung 421=Lieferung Videoident nach erfolgloser Identifizierung 511=Lieferung Fotoident, nach erfolgreicher Identifizierung 521=Lieferung Fotoident, nach erfolgloser Identifizierung Substatus x x Abgelehnt: Im CSV: Feld Weitere Daten / Merkmale Video 11 = Betrugsverdacht Identifikationsdaten Nachname x x Nachname gegebenenfalls inklusive Geburtsnamen // Nicht bei Special Vorname x x Alle Vornamen // Nicht bei Special Strasse und Hausnummer x x Sonderfall Ausweisart ohne Adresse: Plz x x Nicht bei Spezial Ort x x Nicht bei Spezial Falls der Filialmitarbeiter bei Ausweisdokumenten ohne Adresse trotzdem eine Adresse erfasst, enthalten die Filial- und Scandatensatz diese mit Sternchen am Ende: * erfragt bei Verwendung eines deutschen Reisepasses oder eines vorläufigen deutschen Reisepasses; ** ggf. erfragt bei ausländischem Reisepass oder ausländischer Identitätskarte 2017 Deutsche Post AG 14 / 17

16 Ausweisart x x Wertebereich Video-Datensatz Ausweisarten entsprechend des gelieferten Datensatzes. "Personalausweis" "Reisepass" "Aufenthaltstitel" "Vorläufig ausgestellter Personalausweis" "Vorläufig ausgestellter Reisepass" Wertebereich Filial-Datensatz "Personalausweis" "Identitätskarte (Personalausweis Ausland) "Reisepass" "Reisepass (Inland)" "Reisepass (Ausland)" "Vorläufig ausgestellter Personalausweis" "Vorläufig ausgestellter Reisepass" Wertebereich Scan-Datensatz "Personalausweis" "Reisepass" Wertebereich npa-datensatz "Personalausweis" "Aufenthaltstitel" Ausweisnummer x x Ausweisnummer auf dem Ausweis. Geburtsdatum x x dd.mm.yyy Geburtsort x x Nicht bei Spezial Staatsangehörigkeit x x Nicht bei Spezial Ausstellungsbehörde x x Die Behörde, die den Ausweis ausgestellt hat (teilweise inklusive Ausstellungsort). Nicht bei Postidenverfahren npa & Spezial Ausstellungsort x x Nicht bei npa Ausstellungsdatum x x dd.mm.yyy Dienste und kartenspezifische Kennzeichen Sonstige Formularangaben x x Nur eid Postvermerk x x 0 = keine Sendung ausgehaendigt 1 = persoenlich_ausgehaendigt 2 = benachrichtigt 4 = Annahme verweigert 8 = unzustellbar Ausstellungsdatum lt. Ausweisdokument. Nicht bei Postidenverfahren npa & Spezial Ein dienste- und kartenspezifisches Kennzeichen ist eine Zeichenfolge, die im Speicher- und Verarbeitungsmedium des Personalausweises berechnet wird. Es dient der eindeutigen elektronischen Wiedererkennung eines Personalausweises durch den Diensteanbieter, für den es errechnet wurde, ohne dass weitere personenbezogene Daten übermittelt werden müssen (Definition nach PAuswG-Personalausweisgesetz // Quelle: 2.html). Definiert, wie mit der Postidentsendung im Übergabe(versuch) verfahren wurde. Verfügbar nur bei Postident Comfort und Special. Empfaengeradresse x x Anschrift des Empfängers (bei Comfort) Paginiernummer x x Eindeutige Paginiernummer von Scan-Daten vom Scandiensteister Anhang 1-3: Julianischer Tag 4: Standort ID 5: Scanner ID 6-10: Doc ID z.b Ist es ein Filialsatz, ist dieses Feld leer. Verfügbar bei Basic, Comfort & Spezial 2017 Deutsche Post AG 15 / 17

17 Dateireferenz x x Referenziert werden hier nur Multitiff-Dateien: Basic (falls Scanservices gebucht): gescanntes PI-Formular und ggf. Anlagen, Name der Bilddatei (sofern aktiv liegt diese im selben Archiv wie die XML/CSV-Datei): [Vorgangsnummer]_[Paginiernummer]_[Sendungsnummer].tif Liegen Paginiernummer oder Sendungsnummer nicht vor, wird mit Nullen aufgefüllt (10 für Paginiernummer, 13 für BZL-Sendungsnummer) Beispiel: AB_ _AA DE.tif Video: Fotos aus Videoidentifikation Sonstige Merkmale Weitere Dateien können je nach Verfahren und Konfiguration in der Lieferung enthalten sein. Diese werden nicht referenziert, können jedoch durch die Namenskonvention (Vorgangsnummer am Beginn des Dateinamens) zugeordnet werden Basic Identifikationen: <Vorgangsnummer>_ < abrechnungsnr >_ <referenznr>_<lfdnr>.jpg (Ausweisbild; optional) <Vorgangsnummer>_result_basic.pdf (Ergebnis-PDF mit Daten und Bildern; optional) <Vorgangsnummer>_resultdata_basic.pdf (Ergebnis-PDF nur Daten; optional) <Vorgangsnummer>_resultimages_basic.pdf (Ergebnis-PDF nur Bilder; optional) Video Identifikationen: <Vorgangsnummer>_ausweisgesichtsfoto.jpg <Vorgangsnummer>_ausweisrueckseite.jpg <Vorgangsnummer>_ausweisvorderseite.jpg <Vorgangsnummer>_result_video.pdf (Ergebnis-PDF mit Daten und Bildern; optional) <Vorgangsnummer>_resultdata_video.pdf (Ergebnis-PDF nur Daten; optional) <Vorgangsnummer>_resultimages_video.pdf (Ergebnis-PDF nur Bilder; optional) npa Identifikationen: <Vorgangsnummer>_result_npa.pdf (Ergebnis-PDF nur Daten; optional) <Vorgangsnummer>_resultdata_npa.pdf (Ergebnis-PDF nur Daten; optional) Merkmale_filiale x x LEER = Keine Daten aus ZORA (Filial-Daten) erhalten 1 = Filial-Daten erhalten Gibt an, ob Daten über ZORA-Schnittstelle eingegangen sind Merkmale_scanndienstleister x x 0 = Daten vom Scandienstleister erhalten. Formular beinhaltet keine handschriftlichen Änderungen. 1= Daten vom Scandienstleister erhalten. Formular beinhaltet handschriftliche Änderungen. Merkmal_eID x x LEER = keine Identifizierung über npa bzw. eat durchgeführt 0 = Identifizierung über npa bzw. eat durchgeführt (Versuch); keine Daten über eid-schnittstelle erhalten 1 = Identifizierung über npa bzw. eat durchgeführt; Daten über eid-schnittstelle erhalten Gibt an, ob Daten vom Scandiensteister eingegangen sind und ob das Postident-Formular beim Scandienstleister bereits korrigiert wurde. Gibt an, ob Identifizierung über npa bzw. eat durchgeführt wurde und ob Daten von npa übernommen wurden Merkmale_Datenabgleich x x LEER = Kein Abgleich durchgeführt. 0 = Abgleich ohne Ergebnis 1 = Nachsendeauftrag Inland bekannt 2 = Nachsendeauftrag Ausland bekannt 4 = Soll verstorben sein 8 = Postalisch unzustellbar Ergebnis Abgleich mit Adressdatenbanken Bei Kombinationen wird die Summe der Werte geliefert. Merkmale_einwohnermeldeamt x LEER = kein Abgleich durchgeführt 0 = Abgleich ohne Ergebnis 1 = Ohne Abweichung getroffen 2 = Auf abweichender Inlandsadresse gemeldet 4 = Auf abweichender Auslandsadresse gemeldet 8 = Abgemeldet 16 = ohne festen Wohnsitz/Meldeverhältnis nicht eindeutig 32 = Auskunftssperre 64 = Verstorben OBSOLET - derzeit ungenutzt Ergebnis des Abgleichs mit Adressabgleichssystem "Riser", Gesamtscorewert_schufa (Feldname im CSV: Gesamttreffergüte Schufa) x LEER = Kein Abgleich mit Schufa durchgeführt 0 = keine Übereinstimmung getroffen = Güte der Übereinstimmung OBSOLET - derzeit ungenutzt Ergebnis Identitätscheck Schufa 2017 Deutsche Post AG 16 / 17

18 Merkmale_kontotransaktion x LEER = Keine Kontotransaktion angestoßen 0 = keine Ergebnisse 1: Land der Kontoverbindung ist in der Whitelist (z.b. sichere Drittstaaten enthalten) 2: Nachname und Vorname des Kontoinhabers entsprechen den Identifikationsdaten 4: Konto des Kunden ist der Schufa bekannt 8: Kontonummerncheck wurde von Schufa durchgeführt 16: Konto ist ein deutsches Konto OBSOLET - derzeit ungenutzt Ergebnis der Kontotransaktion und des Kontonummerncheck bei Schufa Merkmale_e_postbrief x LEER = kein Abgleich mit E-Postbrief durchgeführt 0 = Abgeleich mit E-Postbrief durchgeführt (Versuch); keine Daten erhalten 1 = Abgleich mit E-Postbrief erfolgreich; Daten aus E-Postbrief übernommen OBSOLET - derzeit ungenutzt Merkmale Video (nicht in XML) x Substatus für Video Im XML: Feld <substatus> 2017 Deutsche Post AG 17 / 17