Tax Filing Service

<back to all web services

PostfachAnfrageEmpfangsBestaetigungRequestAsync

AsyncDatenabholungEmpfangsbestaetigungenPostfachAnfrage

Represents the service request to acknowledge the receipt of data records for the transmission of tax-related statements from organisations outside the tax administration (e.g. municipalities) to users (e.g. companies).

Requires Authentication
The following routes are available for this service:
POST/async/datenabholungen/bestaetigungen/17/PostfachAnfrage
using System;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using PwC.xEric.Core.Services.Contracts.Datenabholungen.Requests.EmpfangsBestaetigungen;
using PwC.xEric.Core.Services.Contracts.Datenabholungen.Requests;
using PwC.xEric.Core.Domain.Concretes.Models;
using PwC.DigitalHub.Utilities.IO.Core.Contracts.Models;
using PwC.xEric.Core.Services.Contracts.Datenabholungen.Responses;
using PwC.xEric.Core.Services.Contracts.Responses;
using PwC.xEric.Core.Domain.Contracts.Models;
using PwC.xEric.Core.Domain.Concretes.Datenabholungen.Models;

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 FileBase()
        {
            Content = new byte[]{};
        }

        ///<summary>
        ///The raw data content of the file.
        ///</summary>
        [ApiMember(Description="The raw data content of the file.", Name="Content")]
        public virtual byte[] Content { get; set; }
    }

}

namespace PwC.xEric.Core.Domain.Concretes.Datenabholungen.Models
{
    ///<summary>
    ///Represents the acknowledgement of receipt of requested tax assessment.
    ///</summary>
    [Api(Description="Represents the acknowledgement of receipt of requested tax assessment.")]
    public partial class Empfangsbestaetigung
    {
        ///<summary>
        ///Metadata (e.g. description data).
        ///</summary>
        [ApiMember(Description="Metadata (e.g. description data).")]
        public virtual string Id { get; set; }

        ///<summary>
        ///The ID number of the owner of the receipt data. This attribute is only required for the tax type 'ElsterVaStDaten'.
        ///</summary>
        [ApiMember(Description="The ID number of the owner of the receipt data. This attribute is only required for the tax type 'ElsterVaStDaten'.")]
        public virtual string Idnr { get; set; }

        ///<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 virtual int? Veranlagungsjahr { get; set; }
    }

}

namespace PwC.xEric.Core.Domain.Concretes.Models
{
    ///<summary>
    ///Represents information on the encryption of tax data.
    ///</summary>
    [Api(Description="Represents information on the encryption of tax data.")]
    public partial class Datei
    {
        ///<summary>
        ///The type of data encryption used.
        ///</summary>
        [ApiMember(Description="The type of data encryption used.")]
        public virtual Verschluesselungsart Verschluesselung { get; set; }

        ///<summary>
        ///The type of data compression used.
        ///</summary>
        [ApiMember(Description="The type of data compression used.")]
        public virtual Kompression Kompression { get; set; }

        ///<summary>
        ///The transport key used in the encryption.
        ///</summary>
        [ApiMember(Description="The transport key used in the encryption.")]
        public virtual string TransportSchluessel { get; set; }

        ///<summary>
        ///[Documentation unavailable]
        ///</summary>
        [ApiMember(Description="[Documentation unavailable]")]
        public virtual Erstellung Erstellung { get; set; }
    }

    ///<summary>
    ///Represents the data part of an ELSTER document.
    ///</summary>
    [Api(Description="Represents the data part of an ELSTER document.")]
    public partial class DatenTeil
    {
        public DatenTeil()
        {
            Nutzdatenbloecke = new List<Nutzdatenblock>{};
        }

        ///<summary>
        ///The blocks of tax data of the ELSTER document.
        ///</summary>
        [ApiMember(Description="The blocks of tax data of the ELSTER document.", IsRequired=true)]
        public virtual List<Nutzdatenblock> Nutzdatenbloecke { get; set; }
    }

    ///<summary>
    ///Represents an ELSTER document.
    ///</summary>
    [Api(Description="Represents an ELSTER document.")]
    public partial class Elster
    {
        ///<summary>
        ///The transfer header part of the ELSTER document.
        ///</summary>
        [ApiMember(Description="The transfer header part of the ELSTER document.", IsRequired=true)]
        public virtual TransferHeader TransferHeader { get; set; }

        ///<summary>
        ///The data (facts) part of the ELSTER document.
        ///</summary>
        [ApiMember(Description="The data (facts) part of the ELSTER document.")]
        public virtual DatenTeil DatenTeil { get; set; }
    }

    ///<summary>
    ///Represents a receiver of tax data.
    ///</summary>
    [Api(Description="Represents a receiver of tax data.")]
    public partial class Empfaenger
    {
        ///<summary>
        ///The identifier of the receiver.
        ///</summary>
        [ApiMember(Description="The identifier of the receiver.")]
        public virtual string Id { get; set; }

        ///<summary>
        ///The destination of the receiver.
        ///</summary>
        [ApiMember(Description="The destination of the receiver.")]
        public virtual Bundesland? Ziel { get; set; }
    }

    ///<summary>
    ///Represents a receriver ID
    ///</summary>
    public enum EmpfaengerID
    {
        L,
        F,
    }

    ///<summary>
    ///Represents information returned from a successful tax declaration process.
    ///</summary>
    [Api(Description="Represents information returned from a successful tax declaration process.")]
    public partial class Erfolg
    {
        public Erfolg()
        {
            Telenummer = new List<string>{};
            Ordnungsbegriffe = new List<string>{};
        }

        ///<summary>
        ///The generated tele-number for the successful tax declaration process.
        ///</summary>
        [ApiMember(Description="The generated tele-number for the successful tax declaration process.")]
        public virtual List<string> Telenummer { get; set; }

        ///<summary>
        ///The classification key for the successful tax declaration process.
        ///</summary>
        [ApiMember(Description="The classification key for the successful tax declaration process.")]
        public virtual List<string> Ordnungsbegriffe { get; set; }
    }

    ///<summary>
    ///Represents a structure that contains the first output of the ERiC tax data submission process.
    ///</summary>
    [Api(Description="Represents a structure that contains the first output of the ERiC tax data submission process.")]
    public partial class EricBearbeiteVorgang
    {
        public EricBearbeiteVorgang()
        {
            FehlerRegelpruefungen = new List<FehlerRegelpruefung>{};
            Hinweise = new List<Hinweis>{};
        }

        ///<summary>
        ///Information from the successful processing a tax declaration.
        ///</summary>
        [ApiMember(Description="Information from the successful processing a tax declaration.")]
        public virtual Erfolg Erfolg { get; set; }

        ///<summary>
        ///Gets or sets information on all data deliveries, including deliveries that have not been confirmed by the server.
        ///</summary>
        [ApiMember(Description="Gets or sets information on all data deliveries, including deliveries that have not been confirmed by the server.")]
        public virtual Transfers Transfers { get; set; }

        ///<summary>
        ///Error rules that result from the processing of a tax declaration.
        ///</summary>
        [ApiMember(Description="Error rules that result from the processing of a tax declaration.")]
        public virtual List<FehlerRegelpruefung> FehlerRegelpruefungen { get; set; }

        ///<summary>
        ///Hints that result the processing of a tax declaration.
        ///</summary>
        [ApiMember(Description="Hints that result the processing of a tax declaration.")]
        public virtual List<Hinweis> Hinweise { get; set; }
    }

    ///<summary>
    ///[Documentation unavailable]
    ///</summary>
    [Api(Description="[Documentation unavailable]")]
    public partial class EricTyp
    {
        ///<summary>
        ///The content of the data. Currently supported: Raw XML (text), XmlElement, XElement or IXmlSerializable
        ///</summary>
        [ApiMember(Description="The content of the data. Currently supported: Raw XML (text), XmlElement, XElement or IXmlSerializable")]
        public virtual Object Inhalt { get; set; }
    }

    ///<summary>
    ///[Documentation unavailable]
    ///</summary>
    [Api(Description="[Documentation unavailable]")]
    public partial class Erstellung
    {
        ///<summary>
        ///[Documentation unavailable]
        ///</summary>
        [ApiMember(Description="[Documentation unavailable]")]
        public virtual EricTyp Eric { get; set; }
    }

    ///<summary>
    ///Represents information on an ERiC reference.
    ///</summary>
    [Api(Description="Represents information on an ERiC reference.")]
    public partial class FehlerRegelpruefung
    {
        public FehlerRegelpruefung()
        {
            SemantischeIndexes = new List<SemantischerIndex>{};
        }

        ///<summary>
        ///The user data ticket of the reference.
        ///</summary>
        [ApiMember(Description="The user data ticket of the reference.")]
        public virtual string Nutzdatenticket { get; set; }

        ///<summary>
        ///The field identifier of the reference.
        ///</summary>
        [ApiMember(Description="The field identifier of the reference.")]
        public virtual string Feldidentifikator { get; set; }

        ///<summary>
        ///The multi-line index of the reference.
        ///</summary>
        [ApiMember(Description="The multi-line index of the reference.")]
        public virtual string Mehrfachzeilenindex { get; set; }

        ///<summary>
        ///The delivery number form of the reference.
        ///</summary>
        [ApiMember(Description="The delivery number form of the reference.")]
        public virtual string LfdNrVordruck { get; set; }

        ///<summary>
        ///Indicates the line number of the error field mentioned in the form.
        ///</summary>
        [ApiMember(Description="Indicates the line number of the error field mentioned in the form.")]
        public virtual string VordruckZeilennummer { get; set; }

        ///<summary>
        ///Specifies the value of one or more index fields that identify the context of error messages.
        ///</summary>
        [ApiMember(Description="Specifies the value of one or more index fields that identify the context of error messages.")]
        public virtual List<SemantischerIndex> SemantischeIndexes { get; set; }

        ///<summary>
        ///The sub-subject-area of the reference.
        ///</summary>
        [ApiMember(Description="The sub-subject-area of the reference.")]
        public virtual string Untersachbereich { get; set; }

        ///<summary>
        ///The private identification number of the reference.
        ///</summary>
        [ApiMember(Description="The private identification number of the reference.")]
        public virtual string PrivateKennnummer { get; set; }

        ///<summary>
        ///The name of the rule that applies to the reference.
        ///</summary>
        [ApiMember(Description="The name of the rule that applies to the reference.")]
        public virtual string RegelName { get; set; }

        ///<summary>
        ///The technical error identifier of the reference.
        ///</summary>
        [ApiMember(Description="The technical error identifier of the reference.")]
        public virtual string FachlicheFehlerId { get; set; }

        ///<summary>
        ///The textual details of the reference.
        ///</summary>
        [ApiMember(Description="The textual details of the reference.")]
        public virtual string Text { get; set; }
    }

    ///<summary>
    ///Represents a manufacturer/vendor of tax software.
    ///</summary>
    [Api(Description="Represents a manufacturer/vendor of tax software.")]
    public partial class Hersteller
    {
        ///<summary>
        ///The product name of the tax software produced by the manufacturer.
        ///</summary>
        [ApiMember(Description="The product name of the tax software produced by the manufacturer.")]
        public virtual string ProduktName { get; set; }

        ///<summary>
        ///The product version of the tax software produced by the manufacturer.
        ///</summary>
        [ApiMember(Description="The product version of the tax software produced by the manufacturer.")]
        public virtual string ProduktVersion { get; set; }
    }

    public partial class Hinweis
    {
        public Hinweis()
        {
            SemantischeIndexes = new List<SemantischerIndex>{};
        }

        ///<summary>
        ///The user data ticket of the reference.
        ///</summary>
        [ApiMember(Description="The user data ticket of the reference.")]
        public virtual string Nutzdatenticket { get; set; }

        ///<summary>
        ///The field identifier of the reference.
        ///</summary>
        [ApiMember(Description="The field identifier of the reference.")]
        public virtual string Feldidentifikator { get; set; }

        ///<summary>
        ///The multi-line index of the reference.
        ///</summary>
        [ApiMember(Description="The multi-line index of the reference.")]
        public virtual string Mehrfachzeilenindex { get; set; }

        ///<summary>
        ///The delivery number form of the reference.
        ///</summary>
        [ApiMember(Description="The delivery number form of the reference.")]
        public virtual string LfdNrVordruck { get; set; }

        ///<summary>
        ///Indicates the line number of the error field mentioned in the form.
        ///</summary>
        [ApiMember(Description="Indicates the line number of the error field mentioned in the form.")]
        public virtual string VordruckZeilennummer { get; set; }

        ///<summary>
        ///Specifies the value of one or more index fields that identify the context of error messages.
        ///</summary>
        [ApiMember(Description="Specifies the value of one or more index fields that identify the context of error messages.")]
        public virtual List<SemantischerIndex> SemantischeIndexes { get; set; }

        ///<summary>
        ///The sub-subject-area of the reference.
        ///</summary>
        [ApiMember(Description="The sub-subject-area of the reference.")]
        public virtual string Untersachbereich { get; set; }

        ///<summary>
        ///The private identification number of the reference.
        ///</summary>
        [ApiMember(Description="The private identification number of the reference.")]
        public virtual string PrivateKennnummer { get; set; }

        ///<summary>
        ///The name of the rule that applies to the reference.
        ///</summary>
        [ApiMember(Description="The name of the rule that applies to the reference.")]
        public virtual string RegelName { get; set; }

        ///<summary>
        ///The technical note identifier of the reference.
        ///</summary>
        [ApiMember(Description="The technical note identifier of the reference.")]
        public virtual string FachlicheHinweisId { get; set; }

        ///<summary>
        ///The textual details of the reference.
        ///</summary>
        [ApiMember(Description="The textual details of the reference.")]
        public virtual string Text { get; set; }
    }

    ///<summary>
    ///Represents a receiver of tax data.
    ///</summary>
    [Api(Description="Represents a receiver of tax data.")]
    public partial class NDHEmpfaenger
    {
        ///<summary>
        ///The identifier of the receiver.
        ///</summary>
        [ApiMember(Description="The identifier of the receiver.")]
        public virtual EmpfaengerID Id { get; set; }

        ///<summary>
        ///The value of the receiver.
        ///</summary>
        [ApiMember(Description="The value of the receiver.")]
        public virtual string Value { get; set; }
    }

    ///<summary>
    ///Represents an encapsulation of tax data content.
    ///</summary>
    [Api(Description="Represents an encapsulation of tax data content.")]
    public partial class Nutzdaten
    {
        ///<summary>
        ///The content of the tax data. This varies by tax declaration. Currently supported formats: Raw XML (text), XElement, and IXmlSerializable
        ///</summary>
        [ApiMember(Description="The content of the tax data. This varies by tax declaration. Currently supported formats: Raw XML (text), XElement, and IXmlSerializable", IsRequired=true)]
        public virtual Object Inhalt { get; set; }
    }

    ///<summary>
    ///Represents a block of tax data.
    ///</summary>
    [Api(Description="Represents a block of tax data.")]
    public partial class Nutzdatenblock
    {
        ///<summary>
        ///The header part of the block.
        ///</summary>
        [ApiMember(Description="The header part of the block.", IsRequired=true)]
        public virtual NutzdatenHeader NutzdatenHeader { get; set; }

        ///<summary>
        ///The data part of the block.
        ///</summary>
        [ApiMember(Description="The data part of the block.", IsRequired=true)]
        public virtual Nutzdaten Nutzdaten { get; set; }
    }

    ///<summary>
    ///Represents the header of a tax data.
    ///</summary>
    [Api(Description="Represents the header of a tax data.")]
    public partial class NutzdatenHeader
    {
        ///<summary>
        ///The version of the header.
        ///</summary>
        [ApiMember(Description="The version of the header.", IsRequired=true)]
        public virtual string Version { get; set; }

        ///<summary>
        ///The ticket identifier of the header.
        ///</summary>
        [ApiMember(Description="The ticket identifier of the header.", IsRequired=true)]
        public virtual string NutzdatenTicket { get; set; }

        ///<summary>
        ///The receiver of the header.
        ///</summary>
        [ApiMember(Description="The receiver of the header.", IsRequired=true)]
        public virtual NDHEmpfaenger Empfaenger { get; set; }

        ///<summary>
        ///The software manufacturer, through whose software the tax declaration or filing is submitted.
        ///</summary>
        [ApiMember(Description="The software manufacturer, through whose software the tax declaration or filing is submitted.", IsRequired=true)]
        public virtual Hersteller Hersteller { get; set; }

        ///<summary>
        ///The details of the data provider (e.g. taxpayer, tax consulant or firm), who produced the tax data and it must not necessarily be the same person declared in the TransferHeader section.
        ///</summary>
        [ApiMember(Description="The details of the data provider (e.g. taxpayer, tax consulant or firm), who produced the tax data and it must not necessarily be the same person declared in the TransferHeader section.")]
        public virtual string DatenLieferant { get; set; }

        ///<summary>
        ///The return code of the header.
        ///</summary>
        [ApiMember(Description="The return code of the header.")]
        public virtual RC RC { get; set; }

        ///<summary>
        ///The data extensions of the header.
        ///</summary>
        [ApiMember(Description="The data extensions of the header.")]
        public virtual Zusatz Zusatz { get; set; }
    }

    ///<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
        : FileBase, ISecuredCertificate, IHasIndex
    {
        public PortalCertificate()
        {
            Tags = new List<string>{};
            Content = new byte[]{};
        }

        ///<summary>
        ///The unique identifier of the certificate.
        ///</summary>
        [ApiMember(Description="The unique identifier of the certificate.")]
        public virtual Guid Id { get; set; }

        ///<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 virtual int Index { get; set; }

        ///<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 virtual string Pin { get; set; }

        ///<summary>
        ///The description of the certificate.
        ///</summary>
        [StringLength(int.MaxValue)]
        [ApiMember(Description="The description of the certificate.")]
        public virtual string Description { get; set; }

        ///<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 virtual List<string> Tags { get; set; }

        ///<summary>
        ///Gets or sets the file name of the certificate.
        ///</summary>
        [ApiMember(Description="Gets or sets the file name of the certificate.")]
        public virtual string Name { get; set; }

        ///<summary>
        ///The raw data content of the file.
        ///</summary>
        [ApiMember(Description="The raw data content of the file.", Name="Content")]
        public virtual byte[] Content { get; set; }
    }

    ///<summary>
    ///Represents an ERiC return code.
    ///</summary>
    [Api(Description="Represents an ERiC return code.")]
    public partial class RC
    {
        ///<summary>
        ///The return value of the return code.
        ///</summary>
        [ApiMember(Description="The return value of the return code.")]
        public virtual Rueckgabe Rueckgabe { get; set; }

        ///<summary>
        ///The internal value of the return code.
        ///</summary>
        [ApiMember(Description="The internal value of the return code.")]
        public virtual Stack Stack { get; set; }
    }

    ///<summary>
    ///Represents an external error stack.
    ///</summary>
    [Api(Description="Represents an external error stack.")]
    public partial class Rueckgabe
    {
        ///<summary>
        ///The external error code. Either a zero (0) if no external errors occurred; otherwise an error number.
        ///</summary>
        [ApiMember(Description="The external error code. Either a zero (0) if no external errors occurred; otherwise an error number.")]
        public virtual string Code { get; set; }

        ///<summary>
        ///The external error message.
        ///</summary>
        [ApiMember(Description="The external error message.")]
        public virtual string Text { get; set; }
    }

    ///<summary>
    ///Represents value of an index field, which identfies the context about an error message.
    ///</summary>
    [Api(Description="Represents value of an index field, which identfies the context about an error message.")]
    public partial class SemantischerIndex
    {
        ///<summary>
        ///The name of the index field.
        ///</summary>
        [ApiMember(Description="The name of the index field.")]
        public virtual string Name { get; set; }

        ///<summary>
        ///The value of the index field.
        ///</summary>
        [ApiMember(Description="The value of the index field.")]
        public virtual string Value { get; set; }
    }

    ///<summary>
    ///Represents the signature and associated information of the compressed, encrypted, base64-encoded content of the data part of the tax declaration/statement.
    ///</summary>
    [Api(Description="Represents the signature and associated information of the compressed, encrypted, base64-encoded content of the data part of the tax declaration/statement.")]
    public partial class SigUser
    {
        ///<summary>
        ///The content of the data. Currently supported: Raw XML (text), XElement or IXmlSerializable
        ///</summary>
        [ApiMember(Description="The content of the data. Currently supported: Raw XML (text), XElement or IXmlSerializable")]
        public virtual Object Inhalt { get; set; }
    }

    ///<summary>
    ///Represents an internal error stack.
    ///</summary>
    [Api(Description="Represents an internal error stack.")]
    public partial class Stack
    {
        ///<summary>
        ///The internal error code. Either a zero (0) if no internal errors occurred; otherwise an error number.
        ///</summary>
        [ApiMember(Description="The internal error code. Either a zero (0) if no internal errors occurred; otherwise an error number.")]
        public virtual string Code { get; set; }

        ///<summary>
        ///The external error message.
        ///</summary>
        [ApiMember(Description="The external error message.")]
        public virtual string Text { get; set; }
    }

    ///<summary>
    ///Represents information on the delivery.
    ///</summary>
    [Api(Description="Represents information on the delivery.")]
    public partial class Transfer
    {
        ///<summary>
        ///The ticket of the transfer.
        ///</summary>
        [ApiMember(Description="The ticket of the transfer.")]
        public virtual string TransferTicket { get; set; }
    }

    ///<summary>
    ///Represents the transfer header part of an ELSTER document.
    ///</summary>
    [Api(Description="Represents the transfer header part of an ELSTER document.")]
    public partial class TransferHeader
    {
        ///<summary>
        ///The version of the transfer header.
        ///</summary>
        [ApiMember(Description="The version of the transfer header.", IsRequired=true)]
        public virtual string Version { get; set; }

        ///<summary>
        ///The tax operation used in the ELSTER process.
        ///</summary>
        [ApiMember(Description="The tax operation used in the ELSTER process.", IsRequired=true)]
        public virtual Verfahren Verfahren { get; set; }

        ///<summary>
        ///The tax data type of the ELSTER process.
        ///</summary>
        [ApiMember(Description="The tax data type of the ELSTER process.", IsRequired=true)]
        public virtual Datenart DatenArt { get; set; }

        ///<summary>
        ///The authentification procedure of the ELSTER process.
        ///</summary>
        [ApiMember(Description="The authentification procedure of the ELSTER process.", IsRequired=true)]
        public virtual Vorgang Vorgang { get; set; }

        ///<summary>
        ///The ticket identifier after a successful ELSTER process.
        ///</summary>
        [ApiMember(Description="The ticket identifier after a successful ELSTER process.")]
        public virtual string TransferTicket { get; set; }

        ///<summary>
        ///The flag that indicates whether the tax declaration or filing is a test case. For production purposes, this value should not be set.
        ///</summary>
        [ApiMember(Description="The flag that indicates whether the tax declaration or filing is a test case. For production purposes, this value should not be set.")]
        public virtual Testmerker? Testmerker { get; set; }

        ///<summary>
        ///The signature and associated information on the compressed, encrypted, base64-encoded content of the the data part of a tax declaration / statement.
        ///</summary>
        [ApiMember(Description="The signature and associated information on the compressed, encrypted, base64-encoded content of the the data part of a tax declaration / statement.")]
        public virtual SigUser SigUser { get; set; }

        ///<summary>
        ///The receiving ELSTER server.
        ///</summary>
        [ApiMember(Description="The receiving ELSTER server.")]
        public virtual Empfaenger Empfaenger { get; set; }

        ///<summary>
        ///The identifier of the software manufacturer, through whose software the tax declaration is filed.
        ///</summary>
        [ApiMember(Description="The identifier of the software manufacturer, through whose software the tax declaration is filed.", IsRequired=true)]
        public virtual string HerstellerID { get; set; }

        ///<summary>
        ///The details of the provider that submits tax data.
        ///</summary>
        [ApiMember(Description="The details of the provider that submits tax data.", IsRequired=true)]
        public virtual string DatenLieferant { get; set; }

        ///<summary>
        ///The date of receipt of the tax data.
        ///</summary>
        [ApiMember(Description="The date of receipt of the tax data.")]
        public virtual DateTime? EingangsDatum { get; set; }

        ///<summary>
        ///The encryption data required for authenticated transmission of tax data.
        ///</summary>
        [ApiMember(Description="The encryption data required for authenticated transmission of tax data.")]
        public virtual Datei Datei { get; set; }

        ///<summary>
        ///The return code of the transfer header and is included in the response XML of the ELSTER server. The value should never be set by the data provider.
        ///</summary>
        [ApiMember(Description="The return code of the transfer header and is included in the response XML of the ELSTER server. The value should never be set by the data provider.")]
        public virtual RC RC { get; set; }

        ///<summary>
        ///The details of the software that submits the tax data.
        ///</summary>
        [ApiMember(Description="The details of the software that submits the tax data.")]
        public virtual string VersionClient { get; set; }

        ///<summary>
        ///Data extensions to the transfer header.
        ///</summary>
        [ApiMember(Description="Data extensions to the transfer header.")]
        public virtual Zusatz Zusatz { get; set; }
    }

    ///<summary>
    ///Represents information on all data deliveries, including deliveries that have not been confirmed by the server. For more information, see the ERiC developer manual in the 'TransferTicket' section.
    ///</summary>
    [Api(Description="Represents information on all data deliveries, including deliveries that have not been confirmed by the server. For more information, see the ERiC developer manual in the 'TransferTicket' section.")]
    public partial class Transfers
    {
        public Transfers()
        {
            TransferList = new List<Transfer>{};
        }

        ///<summary>
        ///Contains information on all data deliveries, including deliveries that have not been confirmed by the server.
        ///</summary>
        [ApiMember(Description="Contains information on all data deliveries, including deliveries that have not been confirmed by the server.")]
        public virtual List<Transfer> TransferList { get; set; }
    }

    ///<summary>
    ///Represents an ERiC extension.
    ///</summary>
    [Api(Description="Represents an ERiC extension.")]
    public partial class Zusatz
    {
        public Zusatz()
        {
            Infos = new List<string>{};
            ElsterInfos = new List<string>{};
        }

        ///<summary>
        ///The user-customizable items for the extension. Data providers can use these items for their own extensions/information.
        ///</summary>
        [ApiMember(Description="The user-customizable items for the extension. Data providers can use these items for their own extensions/information.")]
        public virtual List<string> Infos { get; set; }

        ///<summary>
        ///The ELSTER items for the extension. They can be included in the response XML from the ELSTER server, if special information must be returned to the user after data submission. For example, for authenticated submission, information about impending certificate expiration etc. It must not be supplied by the data provider (even when empty).
        ///</summary>
        [ApiMember(Description="The ELSTER items for the extension. They can be included in the response XML from the ELSTER server, if special information must be returned to the user after data submission. For example, for authenticated submission, information about impending certificate expiration etc. It must not be supplied by the data provider (even when empty).")]
        public virtual List<string> ElsterInfos { get; set; }
    }

}

namespace PwC.xEric.Core.Domain.Contracts.Models
{
    ///<summary>
    ///Einheitliche Abkürzungen fuer die Bundesländer bzw. alternative Empfänger
    ///</summary>
    public enum Bundesland
    {
        BW,
        BY,
        BE,
        BB,
        HB,
        HH,
        HE,
        MV,
        NI,
        NW,
        RP,
        SL,
        SN,
        ST,
        SH,
        TH,
        EC,
        BF,
        CS,
        CD,
        CM,
        CN,
        DS,
        OP,
        TK,
        ZF,
    }

    ///<summary>
    ///Auflistung aller gültigen Datenarten.
    ///</summary>
    public enum Datenart
    {
        Anlage34a,
        AnpassungVorauszahlung,
        AntragUStVerguetung4a,
        AbrufcodeAntrag,
        AenderungAdresse,
        AbrufcodeStorno,
        AbrufvollmachtAnlage,
        AbrufvollmachtUpdate,
        AenderungBankverbindung,
        AntraegeRechteLoeschen,
        AntraegeUndRechte,
        Aufzeichnung146a,
        BetPG,
        Bilanz,
        Belegnachreichung,
        BSBMitteilung,
        BZSt2,
        C19Mitteilung,
        DUeAbmelden,
        DUeAnmelden,
        DUeUmmelden,
        Einspruch,
        EinspruchNachtrag,
        EinspruchRuecknahme,
        ELeVAntragELStAM,
        ELeVErmaessigung,
        ELeVGetrenntlebend,
        ELeVSteuerklassenwechsel,
        ELeVWiederaufnahmeEhe,
        EPAntwort,
        EPBescheid,
        EPMitteilung,
        EPKurzmitteilung,
        ElsterErklaerungDaten,
        ElsterKMVDaten,
        ElsterLohn2Daten,
        ElsterLohnDaten,
        ElsterVaStDaten,
        ElsterDIVADaten,
        ElsterDIVDaten,
        ElsterEPBescheidDaten,
        ElsterEPMitteilungDaten,
        EPStBescheidAbholung,
        EPStMitteilungAbholung,
        Erbschaftsteuer,
        ESt,
        EStbeschraenkt,
        EUER,
        EUn,
        FEIN,
        ForschungZulAntrag,
        KStAntragOptionPersG,
        FLHMitteilung,
        FreistellungKapitalertraegeBV,
        Fristverlaengerung,
        FsEVerein,
        Gewerbemeldung,
        GDBMitteilung,
        Gewinnermittlung13aEStG,
        GewSt,
        GewStZ,
        GrundsteuerBW,
        GrundsteuerBY,
        GrundsteuerHE,
        GrundsteuerHH,
        GrundsteuerNI,
        Grundsteuerwert,
        InvStG56Abs5,
        InvStG51Feststellung,
        KapEStA,
        KapEStInvStG,
        KapG,
        KapGAus,
        KKVMitteilung,
        Kontoabfrage,
        Kontoinformation,
        KSt,
        KStZ,
        KTTAnmeldungHH,
        KTTAnzeigeHH,
        Lohnersatzleistung,
        LohnersatzMitteilung,
        LStA,
        LStB,
        LStHVVMAnlage,
        LStHVVMUpdate,
        OGHMitteilung,
        VermoegenswirksameLeistung,
        VMWiderruf,
        VollmachtDetails,
        VNoVMVRegistrierung,
        VNoVMVUpdate,
        VNoVMVLoeschung,
        VollfAAnlage,
        VollfAUpdate,
        VMoVMVStBAnlage,
        VMoVMVStBUpdate,
        VMoVMVFreischaltung,
        VAGMitteilung,
        DIVADatenBZSt,
        DivaEinwilligungAnlageBRM,
        DivaEinwilligungFreisch,
        DivaEinwilligungUpdateBRM,
        DivaWiderrufBRM,
        DivaErgebnisliste,
        LStHVDivaAdresseBRM,
        VMErgebnisListeVNSicht,
        PersG,
        PostfachAnfrage,
        PostfachStatus,
        ProtokollAnforderung,
        Registrierung,
        Schenkungsteuer,
        SonstigeNachrichten,
        SpezRechtAntrag,
        SpezRechtFreischaltung,
        SpezRechtListe,
        SpezRechtStorno,
        SpezRechtTeilnahme,
        StAb50a,
        Statusabfrage,
        UnentgeltlicheDepotuebertragung,
        UENSTAnmeldungBE,
        UENSTAnzeigeBE,
        USt,
        UStVA,
        UStDV,
        UStSV,
        VGNAnmeldungHB,
        VGNAnmeldungBE,
        VGNAnmeldungHH,
        VGNAnzeigeHH,
        WTBAnmeldungHB,
        ZMDO,
        ElsterVollmachtDaten,
        MitteilungAbholung,
    }

    ///<summary>
    ///Enumeration of ERiC API error codes.
    ///</summary>
    public enum EricFehlerCode
    {
        ERIC_OK = 0,
        ERIC_GLOBAL_UNKNOWN = 610001001,
        ERIC_GLOBAL_PRUEF_FEHLER = 610001002,
        ERIC_GLOBAL_HINWEISE = 610001003,
        ERIC_GLOBAL_FEHLERMELDUNG_NICHT_VORHANDEN = 610001007,
        ERIC_GLOBAL_KEINE_DATEN_VORHANDEN = 610001008,
        ERIC_GLOBAL_NICHT_GENUEGEND_ARBEITSSPEICHER = 610001013,
        ERIC_GLOBAL_DATEI_NICHT_GEFUNDEN = 610001014,
        ERIC_GLOBAL_HERSTELLER_ID_NICHT_ERLAUBT = 610001016,
        ERIC_GLOBAL_ILLEGAL_STATE = 610001017,
        ERIC_GLOBAL_FUNKTION_NICHT_ERLAUBT = 610001018,
        ERIC_GLOBAL_ECHTFALL_NICHT_ERLAUBT = 610001019,
        ERIC_GLOBAL_NO_VERSAND_IN_BETA_VERSION = 610001020,
        ERIC_GLOBAL_TESTMERKER_UNGUELTIG = 610001025,
        ERIC_GLOBAL_DATENSATZ_ZU_GROSS = 610001026,
        ERIC_GLOBAL_VERSCHLUESSELUNGS_PARAMETER_NICHT_ERLAUBT = 610001027,
        ERIC_GLOBAL_NUR_PORTALZERTIFIKAT_ERLAUBT = 610001028,
        ERIC_GLOBAL_ABRUFCODE_NICHT_ERLAUBT = 610001029,
        ERIC_GLOBAL_ERROR_XML_CREATE = 610001030,
        ERIC_GLOBAL_TEXTPUFFERGROESSE_FIX = 610001031,
        ERIC_GLOBAL_INTERNER_FEHLER = 610001032,
        ERIC_GLOBAL_ARITHMETIKFEHLER = 610001033,
        ERIC_GLOBAL_STEUERNUMMER_UNGUELTIG = 610001034,
        ERIC_GLOBAL_STEUERNUMMER_FALSCHE_LAENGE = 610001035,
        ERIC_GLOBAL_STEUERNUMMER_NICHT_NUMERISCH = 610001036,
        ERIC_GLOBAL_LANDESNUMMER_UNBEKANNT = 610001037,
        ERIC_GLOBAL_BUFANR_UNBEKANNT = 610001038,
        ERIC_GLOBAL_LANDESNUMMER_BUFANR = 610001039,
        ERIC_GLOBAL_PUFFER_ZUGRIFFSKONFLIKT = 610001040,
        ERIC_GLOBAL_PUFFER_UEBERLAUF = 610001041,
        ERIC_GLOBAL_DATENARTVERSION_UNBEKANNT = 610001042,
        ERIC_GLOBAL_DATENARTVERSION_XML_INKONSISTENT = 610001044,
        ERIC_GLOBAL_COMMONDATA_NICHT_VERFUEGBAR = 610001045,
        ERIC_GLOBAL_LOG_EXCEPTION = 610001046,
        ERIC_GLOBAL_TRANSPORTSCHLUESSEL_NICHT_ERLAUBT = 610001047,
        ERIC_GLOBAL_OEFFENTLICHER_SCHLUESSEL_UNGUELTIG = 610001048,
        ERIC_GLOBAL_TRANSPORTSCHLUESSEL_TYP_FALSCH = 610001049,
        ERIC_GLOBAL_PUFFER_UNGLEICHER_INSTANZ = 610001050,
        ERIC_GLOBAL_VORSATZ_UNGUELTIG = 610001051,
        ERIC_GLOBAL_DATEIZUGRIFF_VERWEIGERT = 610001053,
        ERIC_GLOBAL_UNGUELTIGE_INSTANZ = 610001080,
        ERIC_GLOBAL_NICHT_INITIALISIERT = 610001081,
        ERIC_GLOBAL_MEHRFACHE_INITIALISIERUNG = 610001082,
        ERIC_GLOBAL_FEHLER_INITIALISIERUNG = 610001083,
        ERIC_GLOBAL_UNKNOWN_PARAMETER_ERROR = 610001102,
        ERIC_GLOBAL_CHECK_CORRUPTED_NDS = 610001108,
        ERIC_GLOBAL_VERSCHLUESSELUNGS_PARAMETER_NICHT_ANGEGEBEN = 610001206,
        ERIC_GLOBAL_SEND_FLAG_MEHR_ALS_EINES = 610001209,
        ERIC_GLOBAL_UNGUELTIGE_FLAG_KOMBINATION = 610001218,
        ERIC_GLOBAL_ERSTE_SEITE_DRUCK_NICHT_UNTERSTUETZT = 610001220,
        ERIC_GLOBAL_UNGUELTIGER_PARAMETER = 610001222,
        ERIC_GLOBAL_DRUCK_FUER_VERFAHREN_NICHT_ERLAUBT = 610001224,
        ERIC_GLOBAL_VERSAND_ART_NICHT_UNTERSTUETZT = 610001225,
        ERIC_GLOBAL_UNGUELTIGE_PARAMETER_VERSION = 610001226,
        ERIC_GLOBAL_TRANSFERHANDLE = 610001227,
        ERIC_GLOBAL_PLUGININITIALISIERUNG = 610001228,
        ERIC_GLOBAL_INKOMPATIBLE_VERSIONEN = 610001229,
        ERIC_GLOBAL_VERSCHLUESSELUNGSVERFAHREN_NICHT_UNTERSTUETZT = 610001230,
        ERIC_GLOBAL_MEHRFACHAUFRUFE_NICHT_UNTERSTUETZT = 610001231,
        ERIC_GLOBAL_UTI_COUNTRY_NOT_SUPPORTED = 610001404,
        ERIC_GLOBAL_IBAN_FORMALER_FEHLER = 610001501,
        ERIC_GLOBAL_IBAN_LAENDERCODE_FEHLER = 610001502,
        ERIC_GLOBAL_IBAN_LANDESFORMAT_FEHLER = 610001503,
        ERIC_GLOBAL_IBAN_PRUEFZIFFER_FEHLER = 610001504,
        ERIC_GLOBAL_BIC_FORMALER_FEHLER = 610001510,
        ERIC_GLOBAL_BIC_LAENDERCODE_FEHLER = 610001511,
        ERIC_GLOBAL_ZULASSUNGSNUMMER_ZU_LANG = 610001519,
        ERIC_GLOBAL_IDNUMMER_UNGUELTIG = 610001525,
        ERIC_GLOBAL_NULL_PARAMETER = 610001526,
        ERIC_GLOBAL_EWAZ_UNGUELTIG = 610001527,
        ERIC_GLOBAL_EWAZ_LANDESKUERZEL_UNBEKANNT = 610001528,
        ERIC_GLOBAL_UPDATE_NECESSARY = 610001851,
        ERIC_GLOBAL_EINSTELLUNG_NAME_UNGUELTIG = 610001860,
        ERIC_GLOBAL_EINSTELLUNG_WERT_UNGUELTIG = 610001861,
        ERIC_GLOBAL_ERR_DEKODIEREN = 610001862,
        ERIC_GLOBAL_FUNKTION_NICHT_UNTERSTUETZT = 610001863,
        ERIC_GLOBAL_NUTZDATENTICKETS_NICHT_EINDEUTIG = 610001865,
        ERIC_GLOBAL_NUTZDATENHEADERVERSIONEN_UNEINHEITLICH = 610001866,
        ERIC_GLOBAL_BUNDESLAENDER_UNEINHEITLICH = 610001867,
        ERIC_GLOBAL_ZEITRAEUME_UNEINHEITLICH = 610001868,
        ERIC_GLOBAL_NUTZDATENHEADER_EMPFAENGER_NICHT_KORREKT = 610001869,
        ERIC_TRANSFER_COM_ERROR = 610101200,
        ERIC_TRANSFER_VORGANG_NICHT_UNTERSTUETZT = 610101201,
        ERIC_TRANSFER_ERR_XML_THEADER = 610101210,
        ERIC_TRANSFER_ERR_PARAM = 610101251,
        ERIC_TRANSFER_ERR_DATENTEILENDNOTFOUND = 610101253,
        ERIC_TRANSFER_ERR_BEGINDATENLIEFERANT = 610101255,
        ERIC_TRANSFER_ERR_ENDDATENLIEFERANT = 610101256,
        ERIC_TRANSFER_ERR_BEGINTRANSPORTSCHLUESSEL = 610101257,
        ERIC_TRANSFER_ERR_ENDTRANSPORTSCHLUESSEL = 610101258,
        ERIC_TRANSFER_ERR_BEGINDATENGROESSE = 610101259,
        ERIC_TRANSFER_ERR_ENDDATENGROESSE = 610101260,
        ERIC_TRANSFER_ERR_SEND = 610101271,
        ERIC_TRANSFER_ERR_NOTENCRYPTED = 610101274,
        ERIC_TRANSFER_ERR_PROXYCONNECT = 610101276,
        ERIC_TRANSFER_ERR_CONNECTSERVER = 610101278,
        ERIC_TRANSFER_ERR_NORESPONSE = 610101279,
        ERIC_TRANSFER_ERR_PROXYAUTH = 610101280,
        ERIC_TRANSFER_ERR_SEND_INIT = 610101282,
        ERIC_TRANSFER_ERR_TIMEOUT = 610101283,
        ERIC_TRANSFER_ERR_PROXYPORT_INVALID = 610101284,
        ERIC_TRANSFER_ERR_OTHER = 610101291,
        ERIC_TRANSFER_ERR_XML_NHEADER = 610101292,
        ERIC_TRANSFER_ERR_XML_ENCODING = 610101293,
        ERIC_TRANSFER_ERR_ENDSIGUSER = 610101294,
        ERIC_TRANSFER_ERR_XMLTAG_NICHT_GEFUNDEN = 610101295,
        ERIC_TRANSFER_ERR_DATENTEILFEHLER = 610101297,
        ERIC_TRANSFER_EID_ZERTIFIKATFEHLER = 610101500,
        ERIC_TRANSFER_EID_KEINKONTO = 610101510,
        ERIC_TRANSFER_EID_IDNRNICHTEINDEUTIG = 610101511,
        ERIC_TRANSFER_EID_SERVERFEHLER = 610101512,
        ERIC_TRANSFER_EID_KEINCLIENT = 610101520,
        ERIC_TRANSFER_EID_CLIENTFEHLER = 610101521,
        ERIC_TRANSFER_EID_FEHLENDEFELDER = 610101522,
        ERIC_TRANSFER_EID_IDENTIFIKATIONABGEBROCHEN = 610101523,
        ERIC_TRANSFER_EID_NPABLOCKIERT = 610101524,
        ERIC_CRYPT_ERROR_CREATE_KEY = 610201016,
        ERIC_CRYPT_E_INVALID_HANDLE = 610201101,
        ERIC_CRYPT_E_MAX_SESSION = 610201102,
        ERIC_CRYPT_E_BUSY = 610201103,
        ERIC_CRYPT_E_OUT_OF_MEM = 610201104,
        ERIC_CRYPT_E_PSE_PATH = 610201105,
        ERIC_CRYPT_E_PIN_WRONG = 610201106,
        ERIC_CRYPT_E_PIN_LOCKED = 610201107,
        ERIC_CRYPT_E_P7_READ = 610201108,
        ERIC_CRYPT_E_P7_DECODE = 610201109,
        ERIC_CRYPT_E_P7_RECIPIENT = 610201110,
        ERIC_CRYPT_E_P12_READ = 610201111,
        ERIC_CRYPT_E_P12_DECODE = 610201112,
        ERIC_CRYPT_E_P12_SIG_KEY = 610201113,
        ERIC_CRYPT_E_P12_ENC_KEY = 610201114,
        ERIC_CRYPT_E_P11_SIG_KEY = 610201115,
        ERIC_CRYPT_E_P11_ENC_KEY = 610201116,
        ERIC_CRYPT_E_XML_PARSE = 610201117,
        ERIC_CRYPT_E_XML_SIG_ADD = 610201118,
        ERIC_CRYPT_E_XML_SIG_TAG = 610201119,
        ERIC_CRYPT_E_XML_SIG_SIGN = 610201120,
        ERIC_CRYPT_E_ENCODE_UNKNOWN = 610201121,
        ERIC_CRYPT_E_ENCODE_ERROR = 610201122,
        ERIC_CRYPT_E_XML_INIT = 610201123,
        ERIC_CRYPT_E_ENCRYPT = 610201124,
        ERIC_CRYPT_E_DECRYPT = 610201125,
        ERIC_CRYPT_E_P11_SLOT_EMPTY = 610201126,
        ERIC_CRYPT_E_NO_SIG_ENC_KEY = 610201127,
        ERIC_CRYPT_E_LOAD_DLL = 610201128,
        ERIC_CRYPT_E_NO_SERVICE = 610201129,
        ERIC_CRYPT_E_ESICL_EXCEPTION = 610201130,
        ERIC_CRYPT_E_TOKEN_TYPE_MISMATCH = 610201144,
        ERIC_CRYPT_E_P12_CREATE = 610201146,
        ERIC_CRYPT_E_VERIFY_CERT_CHAIN = 610201147,
        ERIC_CRYPT_E_P11_ENGINE_LOADED = 610201148,
        ERIC_CRYPT_E_USER_CANCEL = 610201149,
        ERIC_CRYPT_ZERTIFIKAT = 610201200,
        ERIC_CRYPT_SIGNATUR = 610201201,
        ERIC_CRYPT_NICHT_UNTERSTUETZTES_PSE_FORMAT = 610201203,
        ERIC_CRYPT_PIN_BENOETIGT = 610201205,
        ERIC_CRYPT_PIN_STAERKE_NICHT_AUSREICHEND = 610201206,
        ERIC_CRYPT_E_INTERN = 610201208,
        ERIC_CRYPT_ZERTIFIKATSPFAD_KEIN_VERZEICHNIS = 610201209,
        ERIC_CRYPT_ZERTIFIKATSDATEI_EXISTIERT_BEREITS = 610201210,
        ERIC_CRYPT_PIN_ENTHAELT_UNGUELTIGE_ZEICHEN = 610201211,
        ERIC_CRYPT_E_INVALID_PARAM_ABC = 610201212,
        ERIC_CRYPT_CORRUPTED = 610201213,
        ERIC_CRYPT_EIDKARTE_NICHT_UNTERSTUETZT = 610201214,
        ERIC_CRYPT_E_SC_SLOT_EMPTY = 610201215,
        ERIC_CRYPT_E_SC_NO_APPLET = 610201216,
        ERIC_CRYPT_E_SC_SESSION = 610201217,
        ERIC_CRYPT_E_P11_NO_SIG_CERT = 610201218,
        ERIC_CRYPT_E_P11_INIT_FAILED = 610201219,
        ERIC_CRYPT_E_P11_NO_ENC_CERT = 610201220,
        ERIC_CRYPT_E_P12_NO_SIG_CERT = 610201221,
        ERIC_CRYPT_E_P12_NO_ENC_CERT = 610201222,
        ERIC_CRYPT_E_SC_ENC_KEY = 610201223,
        ERIC_CRYPT_E_SC_NO_SIG_CERT = 610201224,
        ERIC_CRYPT_E_SC_NO_ENC_CERT = 610201225,
        ERIC_CRYPT_E_SC_INIT_FAILED = 610201226,
        ERIC_CRYPT_E_SC_SIG_KEY = 610201227,
        ERIC_IO_FEHLER = 610301001,
        ERIC_IO_DATEI_INKORREKT = 610301005,
        ERIC_IO_PARSE_FEHLER = 610301006,
        ERIC_IO_NDS_GENERIERUNG_FEHLGESCHLAGEN = 610301007,
        ERIC_IO_MASTERDATENSERVICE_NICHT_VERFUEGBAR = 610301010,
        ERIC_IO_STEUERZEICHEN_IM_NDS = 610301014,
        ERIC_IO_VERSIONSINFORMATIONEN_NICHT_GEFUNDEN = 610301031,
        ERIC_IO_FALSCHES_VERFAHREN = 610301104,
        ERIC_IO_READER_MEHRFACHE_STEUERFAELLE = 610301105,
        ERIC_IO_READER_UNERWARTETE_ELEMENTE = 610301106,
        ERIC_IO_READER_FORMALE_FEHLER = 610301107,
        ERIC_IO_READER_FALSCHES_ENCODING = 610301108,
        ERIC_IO_READER_MEHRFACHE_NUTZDATEN_ELEMENTE = 610301109,
        ERIC_IO_READER_MEHRFACHE_NUTZDATENBLOCK_ELEMENTE = 610301110,
        ERIC_IO_UNBEKANNTE_DATENART = 610301111,
        ERIC_IO_READER_UNTERSACHBEREICH_UNGUELTIG = 610301114,
        ERIC_IO_READER_ZU_VIELE_NUTZDATENBLOCK_ELEMENTE = 610301115,
        ERIC_IO_READER_STEUERZEICHEN_IM_TRANSFERHEADER = 610301150,
        ERIC_IO_READER_STEUERZEICHEN_IM_NUTZDATENHEADER = 610301151,
        ERIC_IO_READER_STEUERZEICHEN_IN_DEN_NUTZDATEN = 610301152,
        ERIC_IO_READER_ZU_VIELE_ANHAENGE = 610301190,
        ERIC_IO_READER_ANHANG_ZU_GROSS = 610301191,
        ERIC_IO_READER_ANHAENGE_ZU_GROSS = 610301192,
        ERIC_IO_READER_SCHEMA_VALIDIERUNGSFEHLER = 610301200,
        ERIC_IO_READER_UNBEKANNTE_XML_ENTITY = 610301201,
        ERIC_IO_DATENTEILNOTFOUND = 610301252,
        ERIC_IO_DATENTEILENDNOTFOUND = 610301253,
        ERIC_IO_UEBERGABEPARAMETER_FEHLERHAFT = 610301300,
        ERIC_IO_UNGUELTIGE_UTF8_SEQUENZ = 610301400,
        ERIC_IO_UNGUELTIGE_ZEICHEN_IN_PARAMETER = 610301401,
        ERIC_PRINT_INTERNER_FEHLER = 610501001,
        ERIC_PRINT_DRUCKVORLAGE_NICHT_GEFUNDEN = 610501002,
        ERIC_PRINT_UNGUELTIGER_DATEI_PFAD = 610501004,
        ERIC_PRINT_INITIALISIERUNG_FEHLERHAFT = 610501007,
        ERIC_PRINT_AUSGABEZIEL_UNBEKANNT = 610501008,
        ERIC_PRINT_ABBRUCH_DRUCKVORBEREITUNG = 610501009,
        ERIC_PRINT_ABBRUCH_GENERIERUNG = 610501010,
        ERIC_PRINT_STEUERFALL_NICHT_UNTERSTUETZT = 610501011,
        ERIC_PRINT_FUSSTEXT_ZU_LANG = 610501012,
    }

    ///<summary>
    ///Mit welcher Kompression wurden die Inhalte von den Elementen DatenLieferant und ggf. SigUser im TransferHeader und dem Element DatenTeil komprimiert.
    ///</summary>
    public enum Kompression
    {
        GZIP,
        NO_BASE64,
    }

    ///<summary>
    ///Kennzeichnung der Datenlieferung ob es sich um einen Testfall handelt, gilt fuer die gesamte Datenlieferung. Ein Echtfall enthält dieses Element nicht. Ein Testfall muss mit einem Testmerker versehen werden, damit er nicht wie ein Echtfall verarbeitet wird. Handelt es sich um Daten, die nur zum Testen des Frontends versendet wurden, müssen sie nicht mehr weiter verarbeitet werden.
    ///</summary>
    public enum Testmerker
    {
        TM010000001 = 10000001,
        TM080000001 = 80000001,
        TM160000001 = 160000001,
        TM160000002 = 160000002,
        TM220000000 = 220000000,
        TM220002000 = 220002000,
        TM230000001 = 230000001,
        TM240000000 = 240000000,
        TM370000001 = 370000001,
        TM520000000 = 520000000,
        TM700000001 = 700000001,
        TM700000004 = 700000004,
    }

    ///<summary>
    ///Auflistung der gültigen Verfahren
    ///</summary>
    public enum Verfahren
    {
        ElsterAnmeldung,
        ElsterBereitstellung,
        ElsterBilanz,
        ElsterBRM,
        ElsterBRMOrg,
        ElsterDatenabholung,
        ElsterErklaerung,
        ElsterExtern,
        ElsterFSE,
        ElsterKapESt,
        ElsterKMV,
        ElsterKontoabfrage,
        ElsterLavendel,
        ElsterLohn,
        ElsterLohn2,
        ElsterNachricht,
        ElsterSignatur,
        ElsterVollmachtDB,
    }

    ///<summary>
    ///Protokoll der Verschluesselung. Es kann vorkommen, dass verschieden Verschluesselungsarten eingesetzt werden, eine Unterscheidung ist hier nötig, um das richtige Entschluesselungstool anzusteuern. Mit welcher Verschluesselungsart wurden die Inhalte von den Elementen 'DatenLieferant' und ggf. 'SigUser' im TransferHeader und dem Element 'DatenTeil' verschluesselt
    ///</summary>
    public enum Verschluesselungsart
    {
        PKCS_7v1_5,
        PKCS_7v1_5enveloped,
        NO_BASE64,
        CMSEncryptedData,
        CMSEnvelopedData,
        EnvelopedData__RSA_OAEP__AES_128__GZip__B64,
    }

    ///<summary>
    ///Hauptinformation ob die Daten authentifiziert wurden (send-Auth) oder nicht (send-NoSig)
    ///</summary>
    public enum Vorgang
    {
        Send_Auth,
        Send_Auth_Part,
        Send_NoSig,
        Send_NoSig_Part,
    }

}

namespace PwC.xEric.Core.Services.Contracts.Datenabholungen.Requests
{
    ///<summary>
    ///Specifies the base service request to submit data a retrieval request.
    ///</summary>
    [Api(Description="Specifies the base service request to submit data a retrieval request.")]
    public partial class PhaseRequestBase
        : ISendeRequest, IVeschlueselungsRequest
    {
        ///<summary>
        ///The authentification certificate.
        ///</summary>
        [ApiMember(Description="The authentification certificate.", IsRequired=true, Name="Zertifikat")]
        public virtual PortalCertificate Zertifikat { get; set; }

        ///<summary>
        ///The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.
        ///</summary>
        [ApiMember(Description="The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.", Name="AbrufCode")]
        public virtual string AbrufCode { get; set; }

        ///<summary>
        ///The details of the provider that submits the tax data.
        ///</summary>
        [ApiMember(Description="The details of the provider that submits the tax data.", IsRequired=true, Name="DatenLieferant")]
        public virtual string DatenLieferant { get; set; }
    }

}

namespace PwC.xEric.Core.Services.Contracts.Datenabholungen.Requests.EmpfangsBestaetigungen
{
    ///<summary>
    ///Specifies the request to confirm the receipt of retrieved tax statements.
    ///</summary>
    [Api(Description="Specifies the request to confirm the receipt of retrieved tax statements.")]
    public partial class EmpfangsBestaetigungRequestBase
        : PhaseRequestBase, IPost
    {
        ///<summary>
        ///The authentification certificate.
        ///</summary>
        [ApiMember(Description="The authentification certificate.", IsRequired=true, Name="Zertifikat")]
        public virtual PortalCertificate Zertifikat { get; set; }

        ///<summary>
        ///The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.
        ///</summary>
        [ApiMember(Description="The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.", Name="AbrufCode")]
        public virtual string AbrufCode { get; set; }

        ///<summary>
        ///The details of the provider that submits the tax data.
        ///</summary>
        [ApiMember(Description="The details of the provider that submits the tax data.", IsRequired=true, Name="DatenLieferant")]
        public virtual string DatenLieferant { get; set; }
    }

    ///<summary>
    ///Represents the base request criteria to search for data record IDs that require receipt confirmation.
    ///</summary>
    [Api(Description="Represents the base request criteria to search for data record IDs that require receipt confirmation.")]
    public partial class EmpfangsBestaetigungSuchkriterien
    {
        ///<summary>
        ///The ID that represents a data record.
        ///</summary>
        [ApiMember(Description="The ID that represents a data record.", Name="Id")]
        public virtual string Id { get; set; }
    }

    ///<summary>
    ///Represents the service request to acknowledge the receipt of data records for the transmission of tax-related statements from organisations outside the tax administration (e.g. municipalities) to users (e.g. companies).
    ///</summary>
    [Api(Description="Represents the service request to acknowledge the receipt of data records for the transmission of tax-related statements from organisations outside the tax administration (e.g. municipalities) to users (e.g. companies).")]
    public partial class PostfachAnfrageEmpfangsBestaetigungRequestAsync
        : PostfachAnfrageEmpfangsBestaetigungRequestBase
    {
        public PostfachAnfrageEmpfangsBestaetigungRequestAsync()
        {
            Suchkriterien = new List<EmpfangsBestaetigungSuchkriterien>{};
        }

        ///<summary>
        ///The search criteria of the service request.
        ///</summary>
        [ApiMember(Description="The search criteria of the service request.", Name="Suchkriterien")]
        public virtual List<EmpfangsBestaetigungSuchkriterien> Suchkriterien { get; set; }

        ///<summary>
        ///The authentification certificate.
        ///</summary>
        [ApiMember(Description="The authentification certificate.", IsRequired=true, Name="Zertifikat")]
        public virtual PortalCertificate Zertifikat { get; set; }

        ///<summary>
        ///The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.
        ///</summary>
        [ApiMember(Description="The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.", Name="AbrufCode")]
        public virtual string AbrufCode { get; set; }

        ///<summary>
        ///The details of the provider that submits the tax data.
        ///</summary>
        [ApiMember(Description="The details of the provider that submits the tax data.", IsRequired=true, Name="DatenLieferant")]
        public virtual string DatenLieferant { get; set; }
    }

    ///<summary>
    ///Specifies the request to acknowledge the number of hits per data group and per tax type for an account or fingerprint.
    ///</summary>
    [Api(Description="Specifies the request to acknowledge the number of hits per data group and per tax type for an account or fingerprint.")]
    public partial class PostfachAnfrageEmpfangsBestaetigungRequestBase
        : EmpfangsBestaetigungRequestBase
    {
        public PostfachAnfrageEmpfangsBestaetigungRequestBase()
        {
            Suchkriterien = new List<EmpfangsBestaetigungSuchkriterien>{};
        }

        ///<summary>
        ///The search criteria of the service request.
        ///</summary>
        [ApiMember(Description="The search criteria of the service request.", Name="Suchkriterien")]
        public virtual List<EmpfangsBestaetigungSuchkriterien> Suchkriterien { get; set; }

        ///<summary>
        ///The authentification certificate.
        ///</summary>
        [ApiMember(Description="The authentification certificate.", IsRequired=true, Name="Zertifikat")]
        public virtual PortalCertificate Zertifikat { get; set; }

        ///<summary>
        ///The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.
        ///</summary>
        [ApiMember(Description="The retrieval code. This value MUST be given for the tax operation ElsterDatenabholung and tax tax type ElsterVaStDaten, for which a SoftPSE certificate is used to sign.In other cases a null value should be given. It consists of 2 x 5 characters, which are joined by  '-'. Example: 'K6FG5 - RS32P'.", Name="AbrufCode")]
        public virtual string AbrufCode { get; set; }

        ///<summary>
        ///The details of the provider that submits the tax data.
        ///</summary>
        [ApiMember(Description="The details of the provider that submits the tax data.", IsRequired=true, Name="DatenLieferant")]
        public virtual string DatenLieferant { get; set; }
    }

}

namespace PwC.xEric.Core.Services.Contracts.Datenabholungen.Responses
{
    ///<summary>
    ///Represents a server response type that encapsulates acknowledgments of data receipt during the fifth phase of the data retrieval process.
    ///</summary>
    [Api(Description="Represents a server response type that encapsulates acknowledgments of data receipt during the fifth phase of the data retrieval process.")]
    public partial class EmpfangsBestaetigungResponse
        : EricFehlerCodeResponse
    {
        public EmpfangsBestaetigungResponse()
        {
            Empfangsbestaetigungen = new List<Empfangsbestaetigung>{};
        }

        ///<summary>
        ///The list of receipt acknowledgements.
        ///</summary>
        [ApiMember(Description="The list of receipt acknowledgements.", Name="Empfangsbestaetigungen")]
        public virtual List<Empfangsbestaetigung> Empfangsbestaetigungen { get; set; }

        ///<summary>
        ///The return value of the process.
        ///</summary>
        [ApiMember(Description="The return value of the process.", Name="Rueckgabe")]
        public virtual EricBearbeiteVorgang Rueckgabe { get; set; }

        ///<summary>
        ///The server response of the process.
        ///</summary>
        [ApiMember(Description="The server response of the process.", Name="Serverantwort")]
        public virtual Elster Serverantwort { get; set; }

        ///<summary>
        ///The status code that the ERiC API function returns.
        ///</summary>
        [ApiMember(Description="The status code that the ERiC API function returns.", Name="StatusCode")]
        public virtual EricFehlerCode StatusCode { get; set; }

        ///<summary>
        ///The status message that the ERiC API function returns.
        ///</summary>
        [ApiMember(Description="The status message that the ERiC API function returns.", Name="StatusText")]
        public virtual string StatusText { get; set; }

        ///<summary>
        ///The unique identifier of the response.
        ///</summary>
        [ApiMember(Description="The unique identifier of the response.", Name="Id")]
        public virtual string Id { get; set; }

        ///<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 virtual int Index { get; set; }

        ///<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 virtual ResponseStatus ResponseStatus { get; set; }
    }

}

namespace PwC.xEric.Core.Services.Contracts.Responses
{
    ///<summary>
    ///Represent a base response that encapsulate any ERiC API function return value.
    ///</summary>
    [Api(Description="Represent a base response that encapsulate any ERiC API function return value.")]
    public partial class EricFehlerCodeResponse
        : ServiceReponseBase
    {
        ///<summary>
        ///The status code that the ERiC API function returns.
        ///</summary>
        [ApiMember(Description="The status code that the ERiC API function returns.", Name="StatusCode")]
        public virtual EricFehlerCode StatusCode { get; set; }

        ///<summary>
        ///The status message that the ERiC API function returns.
        ///</summary>
        [ApiMember(Description="The status message that the ERiC API function returns.", Name="StatusText")]
        public virtual string StatusText { get; set; }

        ///<summary>
        ///The unique identifier of the response.
        ///</summary>
        [ApiMember(Description="The unique identifier of the response.", Name="Id")]
        public virtual string Id { get; set; }

        ///<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 virtual int Index { get; set; }

        ///<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 virtual ResponseStatus ResponseStatus { get; set; }
    }

    ///<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
        : IHasIndex
    {
        ///<summary>
        ///The unique identifier of the response.
        ///</summary>
        [ApiMember(Description="The unique identifier of the response.", Name="Id")]
        public virtual string Id { get; set; }

        ///<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 virtual int Index { get; set; }

        ///<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 virtual ResponseStatus ResponseStatus { get; set; }
    }

}

C# PostfachAnfrageEmpfangsBestaetigungRequestAsync 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 /async/datenabholungen/bestaetigungen/17/PostfachAnfrage HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	suchkriterien: 
	[
		{
			id: String
		}
	],
	zertifikat: 
	{
		id: 00000000000000000000000000000000,
		index: 0,
		pin: String,
		description: String,
		tags: 
		[
			String
		],
		name: String,
		content: AA==
	},
	abrufCode: String,
	datenLieferant: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	empfangsbestaetigungen: 
	[
		{
			id: String,
			idnr: String,
			veranlagungsjahr: 0
		}
	],
	rueckgabe: 
	{
		erfolg: 
		{
			telenummer: 
			[
				String
			],
			ordnungsbegriffe: 
			[
				String
			]
		},
		transfers: 
		{
			transferList: 
			[
				{
					transferTicket: String
				}
			]
		},
		fehlerRegelpruefungen: 
		[
			{
				nutzdatenticket: String,
				feldidentifikator: String,
				mehrfachzeilenindex: String,
				lfdNrVordruck: String,
				vordruckZeilennummer: String,
				semantischeIndexes: 
				[
					{
						name: String,
						value: String
					}
				],
				untersachbereich: String,
				privateKennnummer: String,
				regelName: String,
				fachlicheFehlerId: String,
				text: String
			}
		],
		hinweise: 
		[
			{
				nutzdatenticket: String,
				feldidentifikator: String,
				mehrfachzeilenindex: String,
				lfdNrVordruck: String,
				vordruckZeilennummer: String,
				semantischeIndexes: 
				[
					{
						name: String,
						value: String
					}
				],
				untersachbereich: String,
				privateKennnummer: String,
				regelName: String,
				fachlicheHinweisId: String,
				text: String
			}
		]
	},
	serverantwort: 
	{
		transferHeader: 
		{
			version: String,
			verfahren: ElsterAnmeldung,
			datenArt: 34a,
			vorgang: send-Auth,
			transferTicket: String,
			testmerker: 0,
			sigUser: 
			{
				inhalt: {}
			},
			empfaenger: 
			{
				id: String,
				ziel: BW
			},
			herstellerID: String,
			datenLieferant: String,
			eingangsDatum: 0001-01-01,
			datei: 
			{
				verschluesselung: PKCS#7v1.5,
				kompression: GZIP,
				transportSchluessel: String,
				erstellung: 
				{
					eric: 
					{
						inhalt: {}
					}
				}
			},
			rc: 
			{
				rueckgabe: 
				{
					code: String,
					text: String
				},
				stack: 
				{
					code: String,
					text: String
				}
			},
			versionClient: String,
			zusatz: 
			{
				infos: 
				[
					String
				],
				elsterInfos: 
				[
					String
				]
			}
		},
		datenTeil: 
		{
			nutzdatenbloecke: 
			[
				{
					nutzdatenHeader: 
					{
						version: String,
						nutzdatenTicket: String,
						empfaenger: 
						{
							id: L,
							value: String
						},
						hersteller: 
						{
							produktName: String,
							produktVersion: String
						},
						datenLieferant: String,
						rc: 
						{
							rueckgabe: 
							{
								code: String,
								text: String
							},
							stack: 
							{
								code: String,
								text: String
							}
						},
						zusatz: 
						{
							infos: 
							[
								String
							],
							elsterInfos: 
							[
								String
							]
						}
					},
					nutzdaten: 
					{
						inhalt: {}
					}
				}
			]
		}
	},
	statusCode: ERIC_OK,
	statusText: 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
		}
	}
}