Tax Filing Service

<back to all web services

ProtokollRequest17

SyncDatenabholungVerarbeitungsprotokolle

Represents the service request to retrieve logs about a specified tax assessement.

Requires Authentication
The following routes are available for this service:
POST/datenabholungen/protokolle/17/verarbeitungsprotokoll
Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports PwC.xEric.Core.Services.Contracts.Datenabholungen.Requests.Protokolle
Imports PwC.xEric.Core.Domain.Concretes.Models
Imports PwC.DigitalHub.Utilities.IO.Core.Contracts.Models
Imports PwC.xEric.Core.Domain.Concretes.Datenabholungen.Models
Imports PwC.xEric.Core.Services.Contracts.Datenabholungen.Responses
Imports PwC.xEric.Core.Services.Contracts.Responses

Namespace Global

    Namespace PwC.DigitalHub.Utilities.IO.Core.Contracts.Models

        '''<Summary>
        '''Represents a base class for a file with raw data.
        '''</Summary>
        <Api(Description:="Represents a base class for a file with raw data.")>
        Public Partial Class FileBase
            Public Sub New()
                Content = New Byte(){}
            End Sub

            '''<Summary>
            '''The raw data content of the file.
            '''</Summary>
            <ApiMember(Description:="The raw data content of the file.", Name:="Content")>
            Public Overridable Property Content As Byte()
        End Class
    End Namespace

    Namespace PwC.xEric.Core.Domain.Concretes.Datenabholungen.Models

        '''<Summary>
        '''Represents the request to retrieve tax assessments by means of a specfied ID.
        '''</Summary>
        <Api(Description:="Represents the request to retrieve tax assessments by means of a specfied ID.")>
        Public Partial Class Abholung
            '''<Summary>
            '''The identifier of the data record.
            '''</Summary>
            <ApiMember(Description:="The identifier of the data record.")>
            Public Overridable Property Id As String

            '''<Summary>
            '''The ID number of the receipt owner. This attribute is only required for the tax type 'ElsterVaStDaten'.
            '''</Summary>
            <ApiMember(Description:="The ID number of the receipt owner. This attribute is only required for the tax type 'ElsterVaStDaten'.")>
            Public Overridable Property Idnr As String

            '''<Summary>
            '''The assessment year (YYYY) of the receipt. This attribute is only required for the tax type 'ElsterVaStDaten'.
            '''</Summary>
            <ApiMember(Description:="The assessment year (YYYY) of the receipt. This attribute is only required for the tax type 'ElsterVaStDaten'.")>
            Public Overridable Property Veranlagungsjahr As Nullable(Of Integer)

            '''<Summary>
            '''The transmission path used.
            '''</Summary>
            <ApiMember(Description:="The transmission path used.")>
            Public Overridable Property Uebertragungsweg As Nullable(Of Uebertragungsweg)

            '''<Summary>
            '''The character encoding of the data record (e.g. ISO-8859-15). The exception is the data type ElsterVaStDaten, here we submit KEIN ENCODING.
            '''</Summary>
            <ApiMember(Description:="The character encoding of the data record (e.g. ISO-8859-15). The exception is the data type ElsterVaStDaten, here we submit KEIN ENCODING.")>
            Public Overridable Property Encoding As String

            '''<Summary>
            '''The client number; only applicable to the tax type 'ElsterDIVADaten'.
            '''</Summary>
            <ApiMember(Description:="The client number; only applicable to the tax type 'ElsterDIVADaten'.")>
            Public Overridable Property Mandantennummer As String

            '''<Summary>
            '''The tax number; only applicable to the tax type 'ElsterDIVADaten'.
            '''</Summary>
            <ApiMember(Description:="The tax number; only applicable to the tax type 'ElsterDIVADaten'.")>
            Public Overridable Property Steuernummer As String

            '''<Summary>
            '''The asessment date; only applicable to the tax type 'ElsterDIVADaten'.
            '''</Summary>
            <ApiMember(Description:="The asessment date; only applicable to the tax type 'ElsterDIVADaten'.")>
            Public Overridable Property Bescheiddatum As Nullable(Of Date)

            '''<Summary>
            '''Das Datenpaket angeforderter Datensaetze. Nur bei der Direktsendung ueber das ERiClet.
            '''</Summary>
            <ApiMember(Description:="Das Datenpaket angeforderter Datensaetze. Nur bei der Direktsendung ueber das ERiClet.")>
            Public Overridable Property Datenpaket As Datenpaket

            '''<Summary>
            '''Download requested data records.  Ensure the second payload data block  is empty for bulk retrieval operations.
            '''</Summary>
            <ApiMember(Description:="Download requested data records.  Ensure the second payload data block  is empty for bulk retrieval operations.")>
            Public Overridable Property Download As Download
        End Class

        '''<Summary>
        '''Represents a request to retrieve data records by means of one or more IDs.
        '''</Summary>
        <Api(Description:="Represents a request to retrieve data records by means of one or more IDs.")>
        Public Partial Class Abholung17
            Inherits Abholung
            '''<Summary>
            '''The tax type (e.g. ESB) of the data record.
            '''</Summary>
            <ApiMember(Description:="The tax type (e.g. ESB) of the data record.")>
            Public Overridable Property Steuerart As Nullable(Of Steuerart)

            '''<Summary>
            '''The meta information of the identifier.
            '''</Summary>
            <ApiMember(Description:="The meta information of the identifier.")>
            Public Overridable Property MetaInformationen As MetaInformationen17

            '''<Summary>
            '''Die Transfertickets der Datensaetze. Es duerfen max. 100 Bereitstellungstickets in einem Request angegeben werden.
            '''</Summary>
            <ApiMember(Description:="Die Transfertickets der Datensaetze. Es duerfen max. 100 Bereitstellungstickets in einem Request angegeben werden.")>
            Public Overridable Property Bereitstellungsticket As String

            '''<Summary>
            '''The attachments of the data records.
            '''</Summary>
            <ApiMember(Description:="The attachments of the data records.")>
            Public Overridable Property Anhaenge As Anhaenge17

            '''<Summary>
            '''The identifier of the data record.
            '''</Summary>
            <ApiMember(Description:="The identifier of the data record.")>
            Public Overridable Property Id As String

            '''<Summary>
            '''The ID number of the receipt owner. This attribute is only required for the tax type 'ElsterVaStDaten'.
            '''</Summary>
            <ApiMember(Description:="The ID number of the receipt owner. This attribute is only required for the tax type 'ElsterVaStDaten'.")>
            Public Overridable Property Idnr As String

            '''<Summary>
            '''The assessment year (YYYY) of the receipt. This attribute is only required for the tax type 'ElsterVaStDaten'.
            '''</Summary>
            <ApiMember(Description:="The assessment year (YYYY) of the receipt. This attribute is only required for the tax type 'ElsterVaStDaten'.")>
            Public Overridable Property Veranlagungsjahr As Nullable(Of Integer)

            '''<Summary>
            '''The transmission path used.
            '''</Summary>
            <ApiMember(Description:="The transmission path used.")>
            Public Overridable Property Uebertragungsweg As Nullable(Of Uebertragungsweg)

            '''<Summary>
            '''The character encoding of the data record (e.g. ISO-8859-15). The exception is the data type ElsterVaStDaten, here we submit KEIN ENCODING.
            '''</Summary>
            <ApiMember(Description:="The character encoding of the data record (e.g. ISO-8859-15). The exception is the data type ElsterVaStDaten, here we submit KEIN ENCODING.")>
            Public Overridable Property Encoding As String

            '''<Summary>
            '''The client number; only applicable to the tax type 'ElsterDIVADaten'.
            '''</Summary>
            <ApiMember(Description:="The client number; only applicable to the tax type 'ElsterDIVADaten'.")>
            Public Overridable Property Mandantennummer As String

            '''<Summary>
            '''The tax number; only applicable to the tax type 'ElsterDIVADaten'.
            '''</Summary>
            <ApiMember(Description:="The tax number; only applicable to the tax type 'ElsterDIVADaten'.")>
            Public Overridable Property Steuernummer As String

            '''<Summary>
            '''The asessment date; only applicable to the tax type 'ElsterDIVADaten'.
            '''</Summary>
            <ApiMember(Description:="The asessment date; only applicable to the tax type 'ElsterDIVADaten'.")>
            Public Overridable Property Bescheiddatum As Nullable(Of Date)

            '''<Summary>
            '''Das Datenpaket angeforderter Datensaetze. Nur bei der Direktsendung ueber das ERiClet.
            '''</Summary>
            <ApiMember(Description:="Das Datenpaket angeforderter Datensaetze. Nur bei der Direktsendung ueber das ERiClet.")>
            Public Overridable Property Datenpaket As Datenpaket

            '''<Summary>
            '''Download requested data records.  Ensure the second payload data block  is empty for bulk retrieval operations.
            '''</Summary>
            <ApiMember(Description:="Download requested data records.  Ensure the second payload data block  is empty for bulk retrieval operations.")>
            Public Overridable Property Download As Download
        End Class

        '''<Summary>
        '''Represents a list of attachments.
        '''</Summary>
        Public Partial Class Anhaenge17
        End Class

        '''<Summary>
        '''Specifies the encoding of the metadata.
        '''</Summary>
        Public Enum Coding
            text
            base64
        End Enum

        '''<Summary>
        '''The data packet from the retrieval operation.
        '''</Summary>
        <Api(Description:="The data packet from the retrieval operation.")>
        Public Partial Class Datenpaket
            '''<Summary>
            '''Encoded (compressed and encrypted) requested data record
            '''</Summary>
            <ApiMember(Description:="Encoded (compressed and encrypted) requested data record")>
            Public Overridable Property Value As String
        End Class

        '''<Summary>
        '''Stellt den Datenteil eines Protokolls dar.
        '''</Summary>
        <Api(Description:="Stellt den Datenteil eines Protokolls dar.")>
        Public Partial Class DatenTeil06
            Public Sub New()
                Nutzdatenbloecke = New List(Of Nutzdatenblock06)
            End Sub

            '''<Summary>
            '''Das Transferticket der Datenlieferung.
            '''</Summary>
            <ApiMember(Description:="Das Transferticket der Datenlieferung.")>
            Public Overridable Property TransferTicket As String

            '''<Summary>
            '''Der Statuscode zur gesamten Datenlieferung. 0 (Datenlieferung ok - Alle Datensätze konnten verarbeitet werden). 1 (Es sind Fehler aufgetreten - die Nutzdatenblöcke konnten nur teilweise verarbeitet werden). 2 (Datenlieferung konnte gar nicht verarbeitet werden - alle Nutzdatenblöcke fehlerhaft). 3 (Datenlieferung wurde noch nicht verarbeitet - bitte fordern Sie das Protokoll noch mal zu einen späteren Zeitpunkt an; für Onlinebetrieb relevant).
            '''</Summary>
            <ApiMember(Description:="Der Statuscode zur gesamten Datenlieferung. 0 (Datenlieferung ok - Alle Datensätze konnten verarbeitet werden). 1 (Es sind Fehler aufgetreten - die Nutzdatenblöcke konnten nur teilweise verarbeitet werden). 2 (Datenlieferung konnte gar nicht verarbeitet werden - alle Nutzdatenblöcke fehlerhaft). 3 (Datenlieferung wurde noch nicht verarbeitet - bitte fordern Sie das Protokoll noch mal zu einen späteren Zeitpunkt an; für Onlinebetrieb relevant).")>
            Public Overridable Property Code As Nullable(Of Integer)

            '''<Summary>
            '''Der Datenteil des Protokolls.Datenlieferung ok - Alle Datensätze konnten verarbeitet werden. Es sind Fehler aufgetreten - die Nutzdatenblöcke konnten nur teilweise verarbeitet werden. Datenlieferung konnte gar nicht verarbeitet werden - alle Nutzdatenblöcke fehlerhaft. 3Datenlieferung wurde noch nicht verarbeitet - bitte fordern Sie das Protokoll noch mal zu einen späteren Zeitpunkt an; für Onlinebetrieb relevant.
            '''</Summary>
            <ApiMember(Description:="Der Datenteil des Protokolls.Datenlieferung ok - Alle Datensätze konnten verarbeitet werden. Es sind Fehler aufgetreten - die Nutzdatenblöcke konnten nur teilweise verarbeitet werden. Datenlieferung konnte gar nicht verarbeitet werden - alle Nutzdatenblöcke fehlerhaft. 3Datenlieferung wurde noch nicht verarbeitet - bitte fordern Sie das Protokoll noch mal zu einen späteren Zeitpunkt an; für Onlinebetrieb relevant.")>
            Public Overridable Property Text As String

            '''<Summary>
            '''Der Datenteil des Protokolls.
            '''</Summary>
            <ApiMember(Description:="Der Datenteil des Protokolls.")>
            Public Overridable Property Nutzdatenbloecke As List(Of Nutzdatenblock06)
        End Class

        '''<Summary>
        '''Represents the download of requested records. The downloaded content from the web server takes place: a) with https b) on port 443 c) on datenabholung1.elster.de or datenabholung2.elster.de. The HTTP Basic Authentication mechanism according to RFC 2617 is used for authentication.
        '''</Summary>
        <Api(Description:="Represents the download of requested records. The downloaded content from the web server takes place: a) with https b) on port 443 c) on datenabholung1.elster.de or datenabholung2.elster.de. The HTTP Basic Authentication mechanism according to RFC 2617 is used for authentication.")>
        Public Partial Class Download
            '''<Summary>
            '''The link to the data on the web server.
            '''</Summary>
            <ApiMember(Description:="The link to the data on the web server.")>
            Public Overridable Property Url As String

            '''<Summary>
            '''The user name for the web server.
            '''</Summary>
            <ApiMember(Description:="The user name for the web server.")>
            Public Overridable Property Benutzer As String

            '''<Summary>
            '''Password for the web server.
            '''</Summary>
            <ApiMember(Description:="Password for the web server.")>
            Public Overridable Property Passwort As String
        End Class

        '''<Summary>
        '''Represents the metadata of a data record.
        '''</Summary>
        <Api(Description:="Represents the metadata of a data record.")>
        Public Partial Class Meta17
            '''<Summary>
            '''The type of metadata, e.g. datei [file]
            '''</Summary>
            <ApiMember(Description:="The type of metadata, e.g. datei [file]")>
            Public Overridable Property Name As String

            '''<Summary>
            '''The encoding of the metadata (text or base64)
            '''</Summary>
            <ApiMember(Description:="The encoding of the metadata (text or base64)")>
            Public Overridable Property Coding As Nullable(Of Coding)

            '''<Summary>
            '''The content of the metadata
            '''</Summary>
            <ApiMember(Description:="The content of the metadata")>
            Public Overridable Property Value As String
        End Class

        '''<Summary>
        '''Represents a list of meta information maps.
        '''</Summary>
        Public Partial Class MetaInfoMaps17
        End Class

        '''<Summary>
        '''Represents meta information.
        '''</Summary>
        <Api(Description:="Represents meta information.")>
        Public Partial Class MetaInformationen17
            Public Sub New()
                Meta = New List(Of Meta17)
            End Sub

            '''<Summary>
            '''List of metadata.
            '''</Summary>
            <ApiMember(Description:="List of metadata.")>
            Public Overridable Property Meta As List(Of Meta17)

            '''<Summary>
            '''List of meta infomation maps.
            '''</Summary>
            <ApiMember(Description:="List of meta infomation maps.")>
            Public Overridable Property MetaInfoMaps As MetaInfoMaps17
        End Class

        '''<Summary>
        '''Stellt einen Nutzdatensatz-Fehler dar. Dabei besteht der Fehler aus: - einer laufenden Nummer(Attribut zum NdSFehler)- der KmId (Attribut zum NdSFehler) und/oder dem ordnungsMerkmal (Attribut zum NdSFehler)- einem Fehlernummer (Attribut zum NdSFehler)- einem Fehlertext (Inhalt des Tag NdSFehler)
        '''</Summary>
        <Api(Description:="Stellt einen Nutzdatensatz-Fehler dar. Dabei besteht der Fehler aus: - einer laufenden Nummer(Attribut zum NdSFehler)- der KmId (Attribut zum NdSFehler) und/oder dem ordnungsMerkmal (Attribut zum NdSFehler)- einem Fehlernummer (Attribut zum NdSFehler)- einem Fehlertext (Inhalt des Tag NdSFehler)")>
        Public Partial Class NdSFehler06
            '''<Summary>
            '''Die laufende Nummer des fehlerhaften Datensatzes in einem Nutzdatenblock.
            '''</Summary>
            <ApiMember(Description:="Die laufende Nummer des fehlerhaften Datensatzes in einem Nutzdatenblock.", Name:="LfdNr")>
            Public Overridable Property LfdNr As String

            '''<Summary>
            '''Bei der kmId handelt es sich um die durch den Verfasser vorgegebene KmId des Nutzdatensatzes.
            '''</Summary>
            <ApiMember(Description:="Bei der kmId handelt es sich um die durch den Verfasser vorgegebene KmId des Nutzdatensatzes.", Name:="KmId")>
            Public Overridable Property KmId As String

            '''<Summary>
            '''Die durch den Verfasser vorgegebene bundesweit eindeutige Identifikation des Nutzdatensatzes (z.B. bei LStB, Lohnersatzleistungen).
            '''</Summary>
            <ApiMember(Description:="Die durch den Verfasser vorgegebene bundesweit eindeutige Identifikation des Nutzdatensatzes (z.B. bei LStB, Lohnersatzleistungen).", Name:="OrdnungsMerkmal")>
            Public Overridable Property OrdnungsMerkmal As String

            '''<Summary>
            '''Es wird die vom Elstersystem für diesen Fehler vergebene Fehlernummer i.d.R. eine 9-stellige Nummer zurückgemeldet.
            '''</Summary>
            <ApiMember(Description:="Es wird die vom Elstersystem für diesen Fehler vergebene Fehlernummer i.d.R. eine 9-stellige Nummer zurückgemeldet.", Name:="FehlerNummer")>
            Public Overridable Property FehlerNummer As Nullable(Of UInt32)

            '''<Summary>
            '''Es wird der vom Elstersystem für diesen Fehler vergebene Fehlertext zurückgemeldet.
            '''</Summary>
            <ApiMember(Description:="Es wird der vom Elstersystem für diesen Fehler vergebene Fehlertext zurückgemeldet.", Name:="FehlerText")>
            Public Overridable Property FehlerText As String
        End Class

        '''<Summary>
        '''Stellt ein Element eines Nutztdatenblockes dar.
        '''</Summary>
        <Api(Description:="Stellt ein Element eines Nutztdatenblockes dar.")>
        Public Partial Class Nutzdatenblock06
            Public Sub New()
                NdSFehler = New List(Of NdSFehler06)
            End Sub

            '''<Summary>
            '''Über das Nutzdatenticket im Verarbeitungsprotokoll wird der Nutzdatenblock aus der Datenlieferung referenziert.
            '''</Summary>
            <ApiMember(Description:="Über das Nutzdatenticket im Verarbeitungsprotokoll wird der Nutzdatenblock aus der Datenlieferung referenziert.")>
            Public Overridable Property NutzdatenTicket As String

            '''<Summary>
            '''Der Statuscode zum Nutzdatenblock.
            '''</Summary>
            <ApiMember(Description:="Der Statuscode zum Nutzdatenblock.")>
            Public Overridable Property Code As Nullable(Of Integer)

            '''<Summary>
            '''Der Statustext zum Nutzdatenblock.
            '''</Summary>
            <ApiMember(Description:="Der Statustext zum Nutzdatenblock.")>
            Public Overridable Property Text As String

            '''<Summary>
            '''Anzahl der Verarbeiteten Nutzdatensätze.
            '''</Summary>
            <ApiMember(Description:="Anzahl der Verarbeiteten Nutzdatensätze.")>
            Public Overridable Property VerarbeiteteNds As Nullable(Of UInt32)

            '''<Summary>
            '''Anzahl der nichtverarbeiteten Nutzdatensätze.
            '''</Summary>
            <ApiMember(Description:="Anzahl der nichtverarbeiteten Nutzdatensätze.")>
            Public Overridable Property NichtverarbeiteteNds As Nullable(Of UInt32)

            '''<Summary>
            '''Der Datenteil des Protokolls.
            '''</Summary>
            <ApiMember(Description:="Der Datenteil des Protokolls.")>
            Public Overridable Property NdSFehler As List(Of NdSFehler06)
        End Class

        '''<Summary>
        '''Das Verarbeitungsprotokoll einer Datenabholungsprozesses.
        '''</Summary>
        <Api(Description:="Das Verarbeitungsprotokoll einer Datenabholungsprozesses.")>
        Public Partial Class Protokoll06
            '''<Summary>
            '''Version des Protokolls.
            '''</Summary>
            <ApiMember(Description:="Version des Protokolls.", Name:="Version")>
            Public Overridable Property Version As Nullable(Of Integer)

            '''<Summary>
            '''Der Zeitstempel der Protokoll-Aufbereitung. Es wird der Zeitstempel der serverseitigen Verarbeitung der Protokollanfrage zurück übermittelt. Das String-Format des ZeitStempels lautet: JJJJMMTThhmmss.
            '''</Summary>
            <ApiMember(Description:="Der Zeitstempel der Protokoll-Aufbereitung. Es wird der Zeitstempel der serverseitigen Verarbeitung der Protokollanfrage zurück übermittelt. Das String-Format des ZeitStempels lautet: JJJJMMTThhmmss.", Name:="ZeitStempel")>
            Public Overridable Property ZeitStempel As Nullable(Of Date)

            '''<Summary>
            '''Der Datenteil des Protokolls.
            '''</Summary>
            <ApiMember(Description:="Der Datenteil des Protokolls.", Name:="DatenTeil")>
            Public Overridable Property DatenTeil As DatenTeil06
        End Class

        '''<Summary>
        '''Represents the various tax types for the retrieval of data.
        '''</Summary>
        Public Enum Steuerart
            ESB
            GSB
            USB
            EPBescheid
            EPMitteilung
            Gewerbesteuerbescheid
            Gewerbesteuermitteilung
            GEWMB
            DIVAAnzeigeEinerLotterie
            DIVABescheid
            DivaBescheidESt
            DIVABuchmachersteuer
            DIVALotteriesteuerEinmal
            DIVALotteriesteuerMehr
            DIVASportwettensteuer
            DIVATotalisator
            OZGBescheid
            VerbindlicheAuskunft
            VerbindlicheZusage
            DivaSonstigerVA
            DivaBescheidErbSt
            DivaBescheidFEIN
            DivaBescheidGewSt
            DivaBescheidKSt
            DivaBescheidUSt
            DivaBescheidSchenkSt
            DIVATroncabgabe
            DIVAVirtuelleAutomatenStB
            DIVAOnlinePokerStB
            LStHVVMRM
            EinlagenrueckgewaehrVA
            FTTMeldungVA
            StatusInvStGVA
            UStVEUVA
            VERSVA
            AltZertVA
            KapEStEntlastungVA
            PostUDLVA
            StAb50aVA
            StAbEntlastungVA
            KassenangelegenheitenVA
            KStOptVA
            SteueroasenabwehrVA
            KDBVollmachtRM
            STBKE
            VDBKDBRueckmeldungLief
            AnhangRueckmeldung
            DivaEinwilligungRM
            GlueckspielF
            OZGMitteilung
            VerbindlicheAuskunftInfoF
            ELOProtokoll
        End Enum

        '''<Summary>
        '''Represents the transmission path.
        '''</Summary>
        Public Enum Uebertragungsweg
            direkt
            link
            sammellink
        End Enum
    End Namespace

    Namespace PwC.xEric.Core.Domain.Concretes.Models

        '''<Summary>
        '''Represents a portal certificate that is protected by a password.
        '''</Summary>
        <Api(Description:="Represents a portal certificate that is protected by a password.")>
        Public Partial Class PortalCertificate
            Inherits FileBase
            Implements ISecuredCertificate
            Implements IHasIndex
            Public Sub New()
                Tags = New List(Of String)
                Content = New Byte(){}
            End Sub

            '''<Summary>
            '''The unique identifier of the certificate.
            '''</Summary>
            <ApiMember(Description:="The unique identifier of the certificate.")>
            Public Overridable Property Id As Guid

            '''<Summary>
            '''The position of the certificate element in an indexed collection of certificates.
            '''</Summary>
            <ApiMember(Description:="The position of the certificate element in an indexed collection of certificates.")>
            Public Overridable Property Index As Integer

            '''<Summary>
            '''The password to protect the certificate from unauthorized access.
            '''</Summary>
            <StringLength(255)>
            <ApiMember(Description:="The password to protect the certificate from unauthorized access.")>
            Public Overridable Property Pin As String

            '''<Summary>
            '''The description of the certificate.
            '''</Summary>
            <StringLength(Integer.MaxValue)>
            <ApiMember(Description:="The description of the certificate.")>
            Public Overridable Property Description As String

            '''<Summary>
            '''Tags that can be used to label or identify the certificate.
            '''</Summary>
            <ApiMember(Description:="Tags that can be used to label or identify the certificate.")>
            Public Overridable Property Tags As List(Of String)

            '''<Summary>
            '''Gets or sets the file name of the certificate.
            '''</Summary>
            <ApiMember(Description:="Gets or sets the file name of the certificate.")>
            Public Overridable Property Name As String

            '''<Summary>
            '''The raw data content of the file.
            '''</Summary>
            <ApiMember(Description:="The raw data content of the file.", Name:="Content")>
            Public Overridable Property Content As Byte()
        End Class
    End Namespace

    Namespace PwC.xEric.Core.Services.Contracts.Datenabholungen.Requests.Protokolle

        '''<Summary>
        '''Represents the service request to retrieve logs about a specified tax assessement.
        '''</Summary>
        <Api(Description:="Represents the service request to retrieve logs about a specified tax assessement.")>
        Public Partial Class ProtokollRequest17
            Inherits ProtokollRequestBase17
            '''<Summary>
            '''The tax assessement, whose processing records shall be obtained.
            '''</Summary>
            <ApiMember(Description:="The tax assessement, whose processing records shall be obtained.", Name:="Bescheid")>
            Public Overridable Property Bescheid As Abholung17

            '''<Summary>
            '''The authentification certificate.
            '''</Summary>
            <ApiMember(Description:="The authentification certificate.", IsRequired:=true, Name:="Zertifikat")>
            Public Overridable Property Zertifikat As PortalCertificate
        End Class

        '''<Summary>
        '''Represents a base service request to retrieve processing records from a specified tax assessement.
        '''</Summary>
        <Api(Description:="Represents a base service request to retrieve processing records from a specified tax assessement.")>
        Public Partial Class ProtokollRequestBase
            Implements IPost
            '''<Summary>
            '''The authentification certificate.
            '''</Summary>
            <ApiMember(Description:="The authentification certificate.", IsRequired:=true, Name:="Zertifikat")>
            Public Overridable Property Zertifikat As PortalCertificate
        End Class

        '''<Summary>
        '''Represents a base service request to retrieve logs about a specified tax assessement.
        '''</Summary>
        <Api(Description:="Represents a base service request to retrieve logs about a specified tax assessement.")>
        Public Partial Class ProtokollRequestBase17
            Inherits ProtokollRequestBase
            '''<Summary>
            '''The tax assessement, whose processing records shall be obtained.
            '''</Summary>
            <ApiMember(Description:="The tax assessement, whose processing records shall be obtained.", Name:="Bescheid")>
            Public Overridable Property Bescheid As Abholung17

            '''<Summary>
            '''The authentification certificate.
            '''</Summary>
            <ApiMember(Description:="The authentification certificate.", IsRequired:=true, Name:="Zertifikat")>
            Public Overridable Property Zertifikat As PortalCertificate
        End Class
    End Namespace

    Namespace PwC.xEric.Core.Services.Contracts.Datenabholungen.Responses

        '''<Summary>
        '''Represents a type that encapulates the processing records of a tax statement.
        '''</Summary>
        <Api(Description:="Represents a type that encapulates the processing records of a tax statement.")>
        Public Partial Class ProtokollResponse
            Inherits ServiceReponseBase
            '''<Summary>
            '''The processing record of a tax statement.
            '''</Summary>
            <ApiMember(Description:="The processing record of a tax statement.", Name:="Protokoll")>
            Public Overridable Property Protokoll As Protokoll06

            '''<Summary>
            '''The unique identifier of the response.
            '''</Summary>
            <ApiMember(Description:="The unique identifier of the response.", Name:="Id")>
            Public Overridable Property Id As String

            '''<Summary>
            '''The position of the response element in an indexed collection.
            '''</Summary>
            <ApiMember(Description:="The position of the response element in an indexed collection.", Name:="Index")>
            Public Overridable Property Index As Integer

            '''<Summary>
            '''Metadata that contains structured error information on the service response.
            '''</Summary>
            <ApiMember(Description:="Metadata that contains structured error information on the service response.", Name:="ResponseStatus")>
            Public Overridable Property ResponseStatus As ResponseStatus
        End Class
    End Namespace

    Namespace PwC.xEric.Core.Services.Contracts.Responses

        '''<Summary>
        '''Specifies a service response from an ERiC service operation.
        '''</Summary>
        <Api(Description:="Specifies a service response from an ERiC service operation.")>
        Public Partial Class ServiceReponseBase
            Implements IHasIndex
            '''<Summary>
            '''The unique identifier of the response.
            '''</Summary>
            <ApiMember(Description:="The unique identifier of the response.", Name:="Id")>
            Public Overridable Property Id As String

            '''<Summary>
            '''The position of the response element in an indexed collection.
            '''</Summary>
            <ApiMember(Description:="The position of the response element in an indexed collection.", Name:="Index")>
            Public Overridable Property Index As Integer

            '''<Summary>
            '''Metadata that contains structured error information on the service response.
            '''</Summary>
            <ApiMember(Description:="Metadata that contains structured error information on the service response.", Name:="ResponseStatus")>
            Public Overridable Property ResponseStatus As ResponseStatus
        End Class
    End Namespace
End Namespace

VB.NET ProtokollRequest17 DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /datenabholungen/protokolle/17/verarbeitungsprotokoll HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	bescheid: 
	{
		steuerart: ESB,
		metaInformationen: 
		{
			meta: 
			[
				{
					name: String,
					coding: text,
					value: String
				}
			],
			metaInfoMaps: 
			[
				{
					typ: String,
					meta: 
					[
						{
							name: String,
							coding: text,
							value: String
						}
					]
				}
			]
		},
		bereitstellungsticket: String,
		anhaenge: 
		[
			{
				metadatenAnhang: 
				[
					{
						schluesselAnhang: 
						{
							dateibezeichnungID: String,
							dateibezeichnungKurz: String,
							value: String
						},
						wertAnhang: 
						{
							dateibezeichnungID: String,
							dateibezeichnungKurz: String,
							value: String
						}
					}
				],
				dateibezeichnung: String,
				dateityp: String,
				dateiinhalt: String
			}
		],
		id: String,
		idnr: String,
		veranlagungsjahr: 0,
		uebertragungsweg: direkt,
		encoding: String,
		mandantennummer: String,
		steuernummer: String,
		bescheiddatum: 0001-01-01,
		datenpaket: 
		{
			value: String
		},
		download: 
		{
			url: String,
			benutzer: String,
			passwort: String
		}
	},
	zertifikat: 
	{
		id: 00000000000000000000000000000000,
		index: 0,
		pin: String,
		description: String,
		tags: 
		[
			String
		],
		name: String,
		content: AA==
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	protokoll: 
	{
		version: 0,
		zeitStempel: 0001-01-01,
		datenTeil: 
		{
			transferTicket: String,
			code: 0,
			text: String,
			nutzdatenbloecke: 
			[
				{
					nutzdatenTicket: String,
					code: 0,
					text: String,
					verarbeiteteNds: 0,
					nichtverarbeiteteNds: 0,
					ndSFehler: 
					[
						{
							lfdNr: String,
							kmId: String,
							ordnungsMerkmal: String,
							fehlerNummer: 0,
							fehlerText: String
						}
					]
				}
			]
		}
	},
	id: String,
	index: 0,
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	}
}