Tax Filing Service

<back to all web services

BatchProtokollRequest17

SyncDatenabholungVerarbeitungsprotokolleBatch

Represents the service request to retrieve logs about tax statements.

Requires Authentication
The following routes are available for this service:
POST/datenabholungen/protokolle/17/verarbeitungsprotokoll/batch
"use strict";
export class FileBase {
    /** @param {{content?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description The raw data content of the file. */
    content;
}
export class PortalCertificate extends FileBase {
    /** @param {{id?:string,index?:number,pin?:string,description?:string,tags?:string[],name?:string,content?:string,content?:string}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /**
     * @type {string}
     * @description The unique identifier of the certificate. */
    id;
    /**
     * @type {number}
     * @description The position of the certificate element in an indexed collection of certificates. */
    index;
    /**
     * @type {?string}
     * @description The password to protect the certificate from unauthorized access. */
    pin;
    /**
     * @type {?string}
     * @description The description of the certificate. */
    description;
    /**
     * @type {string[]}
     * @description Tags that can be used to label or identify the certificate. */
    tags;
    /**
     * @type {?string}
     * @description Gets or sets the file name of the certificate. */
    name;
    /**
     * @type {string}
     * @description The raw data content of the file. */
    content;
}
export class BatchProtokollRequestBase {
    /** @param {{zertifikat?:PortalCertificate}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {PortalCertificate}
     * @description The authentification certificate. */
    zertifikat;
}
/** @typedef {'direkt'|'link'|'sammellink'} */
export var Uebertragungsweg;
(function (Uebertragungsweg) {
    Uebertragungsweg["direkt"] = "direkt"
    Uebertragungsweg["link"] = "link"
    Uebertragungsweg["sammellink"] = "sammellink"
})(Uebertragungsweg || (Uebertragungsweg = {}));
export class Datenpaket {
    /** @param {{value?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {?string}
     * @description Encoded (compressed and encrypted) requested data record */
    value;
}
export class Download {
    /** @param {{url?:string,benutzer?:string,passwort?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {?string}
     * @description The link to the data on the web server. */
    url;
    /**
     * @type {?string}
     * @description The user name for the web server. */
    benutzer;
    /**
     * @type {?string}
     * @description Password for the web server. */
    passwort;
}
export class Abholung {
    /** @param {{id?:string,idnr?:string,veranlagungsjahr?:number,uebertragungsweg?:Uebertragungsweg,encoding?:string,mandantennummer?:string,steuernummer?:string,bescheiddatum?:string,datenpaket?:Datenpaket,download?:Download}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {?string}
     * @description The identifier of the data record. */
    id;
    /**
     * @type {?string}
     * @description The ID number of the receipt owner. This attribute is only required for the tax type 'ElsterVaStDaten'. */
    idnr;
    /**
     * @type {?number}
     * @description The assessment year (YYYY) of the receipt. This attribute is only required for the tax type 'ElsterVaStDaten'. */
    veranlagungsjahr;
    /**
     * @type {?Uebertragungsweg}
     * @description The transmission path used. */
    uebertragungsweg;
    /**
     * @type {?string}
     * @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. */
    encoding;
    /**
     * @type {?string}
     * @description The client number; only applicable to the tax type 'ElsterDIVADaten'. */
    mandantennummer;
    /**
     * @type {?string}
     * @description The tax number; only applicable to the tax type 'ElsterDIVADaten'. */
    steuernummer;
    /**
     * @type {?string}
     * @description The asessment date; only applicable to the tax type 'ElsterDIVADaten'. */
    bescheiddatum;
    /**
     * @type {?Datenpaket}
     * @description Das Datenpaket angeforderter Datensaetze. Nur bei der Direktsendung ueber das ERiClet. */
    datenpaket;
    /**
     * @type {?Download}
     * @description Download requested data records.  Ensure the second payload data block  is empty for bulk retrieval operations. */
    download;
}
/** @typedef {'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'} */
export var Steuerart;
(function (Steuerart) {
    Steuerart["ESB"] = "ESB"
    Steuerart["GSB"] = "GSB"
    Steuerart["USB"] = "USB"
    Steuerart["EPBescheid"] = "EPBescheid"
    Steuerart["EPMitteilung"] = "EPMitteilung"
    Steuerart["Gewerbesteuerbescheid"] = "Gewerbesteuerbescheid"
    Steuerart["Gewerbesteuermitteilung"] = "Gewerbesteuermitteilung"
    Steuerart["GEWMB"] = "GEWMB"
    Steuerart["DIVAAnzeigeEinerLotterie"] = "DIVAAnzeigeEinerLotterie"
    Steuerart["DIVABescheid"] = "DIVABescheid"
    Steuerart["DivaBescheidESt"] = "DivaBescheidESt"
    Steuerart["DIVABuchmachersteuer"] = "DIVABuchmachersteuer"
    Steuerart["DIVALotteriesteuerEinmal"] = "DIVALotteriesteuerEinmal"
    Steuerart["DIVALotteriesteuerMehr"] = "DIVALotteriesteuerMehr"
    Steuerart["DIVASportwettensteuer"] = "DIVASportwettensteuer"
    Steuerart["DIVATotalisator"] = "DIVATotalisator"
    Steuerart["OZGBescheid"] = "OZGBescheid"
    Steuerart["VerbindlicheAuskunft"] = "VerbindlicheAuskunft"
    Steuerart["VerbindlicheZusage"] = "VerbindlicheZusage"
    Steuerart["DivaSonstigerVA"] = "DivaSonstigerVA"
    Steuerart["DivaBescheidErbSt"] = "DivaBescheidErbSt"
    Steuerart["DivaBescheidFEIN"] = "DivaBescheidFEIN"
    Steuerart["DivaBescheidGewSt"] = "DivaBescheidGewSt"
    Steuerart["DivaBescheidKSt"] = "DivaBescheidKSt"
    Steuerart["DivaBescheidUSt"] = "DivaBescheidUSt"
    Steuerart["DivaBescheidSchenkSt"] = "DivaBescheidSchenkSt"
    Steuerart["DIVATroncabgabe"] = "DIVATroncabgabe"
    Steuerart["DIVAVirtuelleAutomatenStB"] = "DIVAVirtuelleAutomatenStB"
    Steuerart["DIVAOnlinePokerStB"] = "DIVAOnlinePokerStB"
    Steuerart["LStHVVMRM"] = "LStHVVMRM"
    Steuerart["EinlagenrueckgewaehrVA"] = "EinlagenrueckgewaehrVA"
    Steuerart["FTTMeldungVA"] = "FTTMeldungVA"
    Steuerart["StatusInvStGVA"] = "StatusInvStGVA"
    Steuerart["UStVEUVA"] = "UStVEUVA"
    Steuerart["VERSVA"] = "VERSVA"
    Steuerart["AltZertVA"] = "AltZertVA"
    Steuerart["KapEStEntlastungVA"] = "KapEStEntlastungVA"
    Steuerart["PostUDLVA"] = "PostUDLVA"
    Steuerart["StAb50aVA"] = "StAb50aVA"
    Steuerart["StAbEntlastungVA"] = "StAbEntlastungVA"
    Steuerart["KassenangelegenheitenVA"] = "KassenangelegenheitenVA"
    Steuerart["KStOptVA"] = "KStOptVA"
    Steuerart["SteueroasenabwehrVA"] = "SteueroasenabwehrVA"
    Steuerart["KDBVollmachtRM"] = "KDBVollmachtRM"
    Steuerart["STBKE"] = "STBKE"
    Steuerart["VDBKDBRueckmeldungLief"] = "VDBKDBRueckmeldungLief"
    Steuerart["AnhangRueckmeldung"] = "AnhangRueckmeldung"
    Steuerart["DivaEinwilligungRM"] = "DivaEinwilligungRM"
    Steuerart["GlueckspielF"] = "GlueckspielF"
    Steuerart["OZGMitteilung"] = "OZGMitteilung"
    Steuerart["VerbindlicheAuskunftInfoF"] = "VerbindlicheAuskunftInfoF"
    Steuerart["ELOProtokoll"] = "ELOProtokoll"
})(Steuerart || (Steuerart = {}));
/** @typedef {'text'|'base64'} */
export var Coding;
(function (Coding) {
    Coding["text"] = "text"
    Coding["base64"] = "base64"
})(Coding || (Coding = {}));
export class Meta17 {
    /** @param {{name?:string,coding?:Coding,value?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {?string}
     * @description The type of metadata, e.g. datei [file] */
    name;
    /**
     * @type {?Coding}
     * @description The encoding of the metadata (text or base64) */
    coding;
    /**
     * @type {?string}
     * @description The content of the metadata */
    value;
}
export class MetaInfoMaps17 {
    constructor(init) { Object.assign(this, init) }
}
export class MetaInformationen17 {
    /** @param {{meta?:Meta17[],metaInfoMaps?:MetaInfoMaps17}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {Meta17[]}
     * @description List of metadata. */
    meta;
    /**
     * @type {?MetaInfoMaps17}
     * @description List of meta infomation maps. */
    metaInfoMaps;
}
export class Anhaenge17 {
    constructor(init) { Object.assign(this, init) }
}
export class Abholung17 extends Abholung {
    /** @param {{steuerart?:Steuerart,metaInformationen?:MetaInformationen17,bereitstellungsticket?:string,anhaenge?:Anhaenge17,id?:string,idnr?:string,veranlagungsjahr?:number,uebertragungsweg?:Uebertragungsweg,encoding?:string,mandantennummer?:string,steuernummer?:string,bescheiddatum?:string,datenpaket?:Datenpaket,download?:Download,id?:string,idnr?:string,veranlagungsjahr?:number,uebertragungsweg?:Uebertragungsweg,encoding?:string,mandantennummer?:string,steuernummer?:string,bescheiddatum?:string,datenpaket?:Datenpaket,download?:Download}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /**
     * @type {?Steuerart}
     * @description The tax type (e.g. ESB) of the data record. */
    steuerart;
    /**
     * @type {?MetaInformationen17}
     * @description The meta information of the identifier. */
    metaInformationen;
    /**
     * @type {?string}
     * @description Die Transfertickets der Datensaetze. Es duerfen max. 100 Bereitstellungstickets in einem Request angegeben werden. */
    bereitstellungsticket;
    /**
     * @type {?Anhaenge17}
     * @description The attachments of the data records. */
    anhaenge;
    /**
     * @type {?string}
     * @description The identifier of the data record. */
    id;
    /**
     * @type {?string}
     * @description The ID number of the receipt owner. This attribute is only required for the tax type 'ElsterVaStDaten'. */
    idnr;
    /**
     * @type {?number}
     * @description The assessment year (YYYY) of the receipt. This attribute is only required for the tax type 'ElsterVaStDaten'. */
    veranlagungsjahr;
    /**
     * @type {?Uebertragungsweg}
     * @description The transmission path used. */
    uebertragungsweg;
    /**
     * @type {?string}
     * @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. */
    encoding;
    /**
     * @type {?string}
     * @description The client number; only applicable to the tax type 'ElsterDIVADaten'. */
    mandantennummer;
    /**
     * @type {?string}
     * @description The tax number; only applicable to the tax type 'ElsterDIVADaten'. */
    steuernummer;
    /**
     * @type {?string}
     * @description The asessment date; only applicable to the tax type 'ElsterDIVADaten'. */
    bescheiddatum;
    /**
     * @type {?Datenpaket}
     * @description Das Datenpaket angeforderter Datensaetze. Nur bei der Direktsendung ueber das ERiClet. */
    datenpaket;
    /**
     * @type {?Download}
     * @description Download requested data records.  Ensure the second payload data block  is empty for bulk retrieval operations. */
    download;
}
export class BatchProtokollRequestBase17 extends BatchProtokollRequestBase {
    /** @param {{bescheide?:Abholung17[],zertifikat?:PortalCertificate,zertifikat?:PortalCertificate}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /**
     * @type {Abholung17[]}
     * @description The tax assessements, whose processing records shall be obtained. */
    bescheide;
    /**
     * @type {PortalCertificate}
     * @description The authentification certificate. */
    zertifikat;
}
export class BatchProtokollRequest17 extends BatchProtokollRequestBase17 {
    /** @param {{bescheide?:Abholung17[],zertifikat?:PortalCertificate,bescheide?:Abholung17[],zertifikat?:PortalCertificate,zertifikat?:PortalCertificate}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /**
     * @type {Abholung17[]}
     * @description The tax assessements, whose processing records shall be obtained. */
    bescheide;
    /**
     * @type {PortalCertificate}
     * @description The authentification certificate. */
    zertifikat;
}

JavaScript BatchProtokollRequest17 DTOs

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

HTTP + XML

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

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

<BatchProtokollRequest17 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Datenabholungen.Requests.Protokolle">
  <Zertifikat xmlns:d2p1="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Domain.Concretes.Models">
    <Content xmlns="http://schemas.datacontract.org/2004/07/PwC.DigitalHub.Utilities.IO.Core.Contracts.Models">AA==</Content>
    <d2p1:Description>String</d2p1:Description>
    <d2p1:Id>00000000-0000-0000-0000-000000000000</d2p1:Id>
    <d2p1:Index>0</d2p1:Index>
    <d2p1:Name>String</d2p1:Name>
    <d2p1:Pin>String</d2p1:Pin>
    <d2p1:Tags xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>String</d3p1:string>
    </d2p1:Tags>
  </Zertifikat>
  <Bescheide xmlns:d2p1="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Domain.Concretes.Datenabholungen.Models">
    <d2p1:Abholung17 id="String" idnr="String" veranlagungsjahr="0" uebertragungsweg="direkt" encoding="String" bereitstellungsticket="String">
      <MetaInformationen>
        <Meta art="String" coding="text">String</Meta>
        <MetaInfoMaps>
          <MetaInfoMap typ="String">
            <Meta art="String" coding="text">String</Meta>
          </MetaInfoMap>
        </MetaInfoMaps>
      </MetaInformationen>
      <Datenpaket>String</Datenpaket>
      <Download>
        <Url>String</Url>
        <Benutzer>String</Benutzer>
        <Passwort>String</Passwort>
      </Download>
      <Anhaenge version="0">
        <Anhang>
          <Dateibezeichnung>String</Dateibezeichnung>
          <Dateityp>String</Dateityp>
          <Dateiinhalt>String</Dateiinhalt>
          <MetadatumAnhang>
            <SchluesselAnhang DateibezeichnungID="String" DateibezeichnungKurz="String">String</SchluesselAnhang>
            <WertAnhang DateibezeichnungID="String" DateibezeichnungKurz="String">String</WertAnhang>
          </MetadatumAnhang>
        </Anhang>
      </Anhaenge>
    </d2p1:Abholung17>
  </Bescheide>
</BatchProtokollRequest17>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ArrayOfProtokollResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Datenabholungen.Responses">
  <ProtokollResponse>
    <Id xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Responses">String</Id>
    <Index xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Responses">0</Index>
    <ResponseStatus xmlns:d3p1="http://schemas.servicestack.net/types" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Responses">
      <d3p1:ErrorCode>String</d3p1:ErrorCode>
      <d3p1:Message>String</d3p1:Message>
      <d3p1:StackTrace>String</d3p1:StackTrace>
      <d3p1:Errors>
        <d3p1:ResponseError>
          <d3p1:ErrorCode>String</d3p1:ErrorCode>
          <d3p1:FieldName>String</d3p1:FieldName>
          <d3p1:Message>String</d3p1:Message>
          <d3p1:Meta xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:KeyValueOfstringstring>
              <d6p1:Key>String</d6p1:Key>
              <d6p1:Value>String</d6p1:Value>
            </d6p1:KeyValueOfstringstring>
          </d3p1:Meta>
        </d3p1:ResponseError>
      </d3p1:Errors>
      <d3p1:Meta xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>String</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </d3p1:Meta>
    </ResponseStatus>
    <Protokoll version="0" xmlns="http://www.elsterfachmethodik.de/protokollverfahren/version6/XMLSchema">
      <ZeitStempel>00010101000000</ZeitStempel>
      <DatenTeil transferTicket="String" code="0" text="String">
        <Nutzdatenblock nutzdatenTicket="String" code="0" text="String" verarbeiteteNdS="0" nichtverarbeiteteNdS="0">
          <NdSFehler lfdNr="String" kmId="String" ordnungsMerkmal="String" fehlerNummer="0" fehlerText="String" />
        </Nutzdatenblock>
      </DatenTeil>
    </Protokoll>
  </ProtokollResponse>
</ArrayOfProtokollResponse>
© 2021 - 2024 PwC. All rights reserved.
PwC refers to the PwC network and/or one or more of its member firms, each of which is a separate legal entity. Please see www.pwc.com/structure for further details. Any use of third party IP such as ELSTER is governed by the respective third party terms.