Report Filing Service

<back to all web services

BatchRetrieveProtocolsAsync

RetrieveProtocolsBatchAsync

Represents a request to retrieve protocols using multiple search criteria in an asynchronous operation.

Requires Authentication
The following routes are available for this service:
POST/async/elma/protocols/batch/retrieve
import java.math.*;
import java.util.*;
import net.servicestack.client.*;

public class dtos
{

    /**
    * Represents a request to retrieve protocols using multiple search criteria in an asynchronous operation.
    */
    @Api(Description="Represents a request to retrieve protocols using multiple search criteria in an asynchronous operation.")
    public static class BatchRetrieveProtocolsAsync extends BatchRetrieveProtocolsBase
    {
        
    }

    /**
    * Specifies a request to retrieve protocols using multiple search criteria.
    */
    @Api(Description="Specifies a request to retrieve protocols using multiple search criteria.")
    public static class BatchRetrieveProtocolsBase implements IPost, IAuthenticateRequest, IStageableRequest, IBatchSearchRequest
    {
        /**
        * The parameters to search or filter the found protocols.
        */
        @ApiMember(Description="The parameters to search or filter the found protocols.", IsRequired=true, Name="SearchCriteria")
        public ArrayList<SearchCriteria> searchCriteria = null;

        /**
        * The credential to gain access on the ELMA server.
        */
        @ApiMember(Description="The credential to gain access on the ELMA server.", IsRequired=true, Name="Credential")
        public ElmaCredential credential = null;

        /**
        * Should operations be staged on the ELMA server? true: operations are executed on the Test ELMA server. false: operations are executed on the Live (Production) ELMA server.
        */
        @ApiMember(Description="Should operations be staged on the ELMA server? true: operations are executed on the Test ELMA server. false: operations are executed on the Live (Production) ELMA server.", Name="StagingEnabled")
        public Boolean stagingEnabled = null;
        
        public ArrayList<SearchCriteria> getSearchCriteria() { return searchCriteria; }
        public BatchRetrieveProtocolsBase setSearchCriteria(ArrayList<SearchCriteria> value) { this.searchCriteria = value; return this; }
        public ElmaCredential getCredential() { return credential; }
        public BatchRetrieveProtocolsBase setCredential(ElmaCredential value) { this.credential = value; return this; }
        public Boolean isStagingEnabled() { return stagingEnabled; }
        public BatchRetrieveProtocolsBase setStagingEnabled(Boolean value) { this.stagingEnabled = value; return this; }
    }

    /**
    * Represent parameters to search or filter on submissions. 
    */
    @Api(Description="Represent parameters to search or filter on submissions. ")
    public static class SearchCriteria
    {
        /**
        * Full or partial name of the item (report or protocol) to search.
        */
        @ApiMember(Description="Full or partial name of the item (report or protocol) to search.", Name="Name")
        public String name = null;

        /**
        * TThe ELMA product designation.
        */
        @ApiMember(Description="TThe ELMA product designation.", Name="Designation")
        public Verfahren designation = null;
        
        public String getName() { return name; }
        public SearchCriteria setName(String value) { this.name = value; return this; }
        public Verfahren getDesignation() { return designation; }
        public SearchCriteria setDesignation(Verfahren value) { this.designation = value; return this; }
    }

    public static enum Verfahren
    {
        Cc,
        Cs,
        Dc,
        Fc,
        Fs,
        Fa,
        Km;
    }

    /**
    * Represents the credentials of a user to authenticate the access of an ELMA server.
    */
    @Api(Description="Represents the credentials of a user to authenticate the access of an ELMA server.")
    public static class ElmaCredential implements IElmaCredential
    {
        /**
        * The unique identifier of this instance.  This identifer is only relevant in the context of data storage and retrieval.
        */
        @ApiMember(Description="The unique identifier of this instance.  This identifer is only relevant in the context of data storage and retrieval.", IsRequired=true, Name="Id")
        public String id = null;

        /**
        * The security certificate to authenticate the user and grant access to the ELMA server.  This certificate is generated from the BZSt-issued *.pfx BOP certificate. More details on BOP (BZSt-Online Portal - https://www.elster.de/bportal/start)
        */
        @ApiMember(Description="The security certificate to authenticate the user and grant access to the ELMA server.  This certificate is generated from the BZSt-issued *.pfx BOP certificate. More details on BOP (BZSt-Online Portal - https://www.elster.de/bportal/start)", IsRequired=true, Name="Certificate")
        @Required()
        @StringLength(2147483647)
        public PemCertificate certificate = null;

        /**
        * The BZSt (Bundeszentralamt für Steuern) - tax number of the user. 11-character text field that may only consist of two capital letters and 9 digits (0-9).  The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start).  The number is available in the private area of the BOP user account under "My BOP" under the "Registration Information"
        */
        @ApiMember(Description="The BZSt (Bundeszentralamt für Steuern) - tax number of the user. 11-character text field that may only consist of two capital letters and 9 digits (0-9).  The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start).  The number is available in the private area of the BOP user account under \"My BOP\" under the \"Registration Information\"", IsRequired=true, Name="AuthSteuernummer")
        @Required()
        @StringLength(11)
        public String authSteuernummer = null;

        /**
        * The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).
        */
        @ApiMember(Description="The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).", IsRequired=true, Name="AccountId")
        @Required()
        @StringLength(10)
        public String accountId = null;

        /**
        * The password to protect the certificate from unauthorized access.
        */
        @ApiMember(Description="The password to protect the certificate from unauthorized access.", IsRequired=true, Name="Password")
        public String password = null;
        
        public String getId() { return id; }
        public ElmaCredential setId(String value) { this.id = value; return this; }
        public PemCertificate getCertificate() { return certificate; }
        public ElmaCredential setCertificate(PemCertificate value) { this.certificate = value; return this; }
        public String getAuthSteuernummer() { return authSteuernummer; }
        public ElmaCredential setAuthSteuernummer(String value) { this.authSteuernummer = value; return this; }
        public String getAccountId() { return accountId; }
        public ElmaCredential setAccountId(String value) { this.accountId = value; return this; }
        public String getPassword() { return password; }
        public ElmaCredential setPassword(String value) { this.password = value; return this; }
    }

    /**
    * Represents a PEM-encoded certificate.
    */
    @Api(Description="Represents a PEM-encoded certificate.")
    public static class PemCertificate
    {
        /**
        * The unique identifier (e.g. the file name) of the certificate.
        */
        @ApiMember(Description="The unique identifier (e.g. the file name) of the certificate.", IsRequired=true, Name="Id")
        public String id = null;

        /**
        * The PEM-encoded content of the certificate.
        */
        @ApiMember(Description="The PEM-encoded content of the certificate.", IsRequired=true, Name="Content")
        public String content = null;

        /**
        * The description of the certificate.
        */
        @ApiMember(Description="The description of the certificate.", Name="Description")
        public String description = null;

        /**
        * Tags to label or identify the certificate.
        */
        @ApiMember(Description="Tags to label or identify the certificate.", Name="Tags")
        public ArrayList<String> tags = null;
        
        public String getId() { return id; }
        public PemCertificate setId(String value) { this.id = value; return this; }
        public String getContent() { return content; }
        public PemCertificate setContent(String value) { this.content = value; return this; }
        public String getDescription() { return description; }
        public PemCertificate setDescription(String value) { this.description = value; return this; }
        public ArrayList<String> getTags() { return tags; }
        public PemCertificate setTags(ArrayList<String> value) { this.tags = value; return this; }
    }

    /**
    * Encapsulates the results of a protocol retrieval operation.
    */
    @Api(Description="Encapsulates the results of a protocol retrieval operation.")
    public static class RetrievalResponse
    {
        /**
        * Processing logs that indicate the status of submitted reports.
        */
        @ApiMember(Description="Processing logs that indicate the status of submitted reports.", Name="Protocols")
        public ArrayList<Elma> protocols = null;

        /**
        * Other artefacts including the auxillary files from the BZSt.
        */
        @ApiMember(Description="Other artefacts including the auxillary files from the BZSt.", Name="Files")
        public ArrayList<BinaryFile> files = null;

        /**
        * The status of the response.
        */
        @ApiMember(Description="The status of the response.", Name="ResponseStatus")
        public ResponseStatus responseStatus = null;
        
        public ArrayList<Elma> getProtocols() { return protocols; }
        public RetrievalResponse setProtocols(ArrayList<Elma> value) { this.protocols = value; return this; }
        public ArrayList<BinaryFile> getFiles() { return files; }
        public RetrievalResponse setFiles(ArrayList<BinaryFile> value) { this.files = value; return this; }
        public ResponseStatus getResponseStatus() { return responseStatus; }
        public RetrievalResponse setResponseStatus(ResponseStatus value) { this.responseStatus = value; return this; }
    }

    /**
    * Represents an ELMA report document.
    */
    @Api(Description="Represents an ELMA report document.")
    public static class Elma
    {
        /**
        * The unique identifier of this instance. This identifer is only relevant in the context of data storage and retrieval.
        */
        @ApiMember(Description="The unique identifier of this instance. This identifer is only relevant in the context of data storage and retrieval.", IsRequired=true, Name="Id")
        public String id = null;

        /**
        * The location of the XML Schema to use for the root namespace.
        */
        @ApiMember(Description="The location of the XML Schema to use for the root namespace.", Name="SchemaLocation")
        public String schemaLocation = null;

        /**
        * The type of reporting process.
        */
        @ApiMember(Description="The type of reporting process.", IsRequired=true, Name="Verfahren")
        public Verfahren verfahren = null;

        /**
        * The communication section of the ELMA report document.
        */
        @ApiMember(Description="The communication section of the ELMA report document.", IsRequired=true, Name="ElmaKom")
        public ElmaKom elmaKom = null;

        /**
        * The communication section of the ELMA report document.
        */
        @ApiMember(Description="The communication section of the ELMA report document.", Name="ElmaProtokoll")
        public ElmaProtokoll elmaProtokoll = null;

        /**
        * The communication section of the ELMA report document.
        */
        @ApiMember(Description="The communication section of the ELMA report document.", Name="ElmaFehler")
        public ElmaFehler elmaFehler = null;
        
        public String getId() { return id; }
        public Elma setId(String value) { this.id = value; return this; }
        public String getSchemaLocation() { return schemaLocation; }
        public Elma setSchemaLocation(String value) { this.schemaLocation = value; return this; }
        public Verfahren getVerfahren() { return verfahren; }
        public Elma setVerfahren(Verfahren value) { this.verfahren = value; return this; }
        public ElmaKom getElmaKom() { return elmaKom; }
        public Elma setElmaKom(ElmaKom value) { this.elmaKom = value; return this; }
        public ElmaProtokoll getElmaProtokoll() { return elmaProtokoll; }
        public Elma setElmaProtokoll(ElmaProtokoll value) { this.elmaProtokoll = value; return this; }
        public ElmaFehler getElmaFehler() { return elmaFehler; }
        public Elma setElmaFehler(ElmaFehler value) { this.elmaFehler = value; return this; }
    }

    /**
    * Represents the communication section of an ELMA report document.
    */
    @Api(Description="Represents the communication section of an ELMA report document.")
    public static class ElmaKom
    {
        /**
        * The version number of the ELMAKOM definition.
        */
        @ApiMember(Description="The version number of the ELMAKOM definition.", IsRequired=true, Name="ElmakomVersion")
        public String elmakomVersion = null;

        /**
        * The header part of the ELMAKOM definition.
        */
        @ApiMember(Description="The header part of the ELMAKOM definition.", IsRequired=true, Name="ElmaHeader")
        public ElmaHeader elmaHeader = null;

        /**
        * The process part of the ELMAKOM definition.
        */
        @ApiMember(Description="The process part of the ELMAKOM definition.", IsRequired=true, Name="ElmaVerfahren")
        public ElmaVerfahren elmaVerfahren = null;
        
        public String getElmakomVersion() { return elmakomVersion; }
        public ElmaKom setElmakomVersion(String value) { this.elmakomVersion = value; return this; }
        public ElmaHeader getElmaHeader() { return elmaHeader; }
        public ElmaKom setElmaHeader(ElmaHeader value) { this.elmaHeader = value; return this; }
        public ElmaVerfahren getElmaVerfahren() { return elmaVerfahren; }
        public ElmaKom setElmaVerfahren(ElmaVerfahren value) { this.elmaVerfahren = value; return this; }
    }

    /**
    * Represents the header of an ELMA communication section.
    */
    @Api(Description="Represents the header of an ELMA communication section.")
    public static class ElmaHeader
    {
        /**
        * The process-specific report type of an ELMA document.It distinguishes by the type of input.
        */
        @ApiMember(Description="The process-specific report type of an ELMA document.It distinguishes by the type of input.", IsRequired=true, Name="DatenArt")
        public DatenArt datenArt = null;

        /**
        * The BZSt (Bundeszentralamt für Steuern) - tax number of the user. 11-character text field that may only consist of two capital letters and 9 digits (0-9). The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start). The number is available in the private area of the BOP user account under "My BOP" under the "Registration Information"
        */
        @ApiMember(Description="The BZSt (Bundeszentralamt für Steuern) - tax number of the user. 11-character text field that may only consist of two capital letters and 9 digits (0-9). The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start). The number is available in the private area of the BOP user account under \"My BOP\" under the \"Registration Information\"", IsRequired=true, Name="AuthSteuernummer")
        public String authSteuernummer = null;

        /**
        * The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).
        */
        @ApiMember(Description="The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).", IsRequired=true, Name="AccountId")
        public String accountId = null;

        /**
        * The time of creation.Corresponds to the time, at which the user created a file.
        */
        @ApiMember(Description="The time of creation.Corresponds to the time, at which the user created a file.", Name="ErstellungsDatum")
        public Date erstellungsDatum = null;

        /**
        * User custom ID.This field can be filled with internal reference information of the user.
        */
        @ApiMember(Description="User custom ID.This field can be filled with internal reference information of the user.", Name="KundeneigeneId")
        public String kundeneigeneId = null;

        /**
        * Data transfer identifier.Hexadecimal formatted number. Example: 550e8400-e29b-11d4-a716-446655440000
        */
        @ApiMember(Description="Data transfer identifier.Hexadecimal formatted number. Example: 550e8400-e29b-11d4-a716-446655440000", Name="UUID")
        public UUID uuid = null;

        /**
        * Distinguishes between test and live data transfer.
        */
        @ApiMember(Description="Distinguishes between test and live data transfer.", Name="Verarbeitungslauf")
        public Verarbeitungslauf verarbeitungslauf = null;
        
        public DatenArt getDatenArt() { return datenArt; }
        public ElmaHeader setDatenArt(DatenArt value) { this.datenArt = value; return this; }
        public String getAuthSteuernummer() { return authSteuernummer; }
        public ElmaHeader setAuthSteuernummer(String value) { this.authSteuernummer = value; return this; }
        public String getAccountId() { return accountId; }
        public ElmaHeader setAccountId(String value) { this.accountId = value; return this; }
        public Date getErstellungsDatum() { return erstellungsDatum; }
        public ElmaHeader setErstellungsDatum(Date value) { this.erstellungsDatum = value; return this; }
        public String getKundeneigeneId() { return kundeneigeneId; }
        public ElmaHeader setKundeneigeneId(String value) { this.kundeneigeneId = value; return this; }
        public UUID getUuid() { return uuid; }
        public ElmaHeader setUuid(UUID value) { this.uuid = value; return this; }
        public Verarbeitungslauf getVerarbeitungslauf() { return verarbeitungslauf; }
        public ElmaHeader setVerarbeitungslauf(Verarbeitungslauf value) { this.verarbeitungslauf = value; return this; }
    }

    public static enum DatenArt
    {
        ElmaCc,
        ElmaCcrm,
        ElmaCrs,
        ElmaCrsrm,
        ElmaDc,
        ElmaDcrm,
        ElmaFc,
        ElmaFcrm;
    }

    public static enum Verarbeitungslauf
    {
        Produktionslauf,
        Testlauf;
    }

    public static class ElmaVerfahren
    {
        /**
        * The content of process-specific definition.
        */
        @ApiMember(Description="The content of process-specific definition.", Name="Inhalt")
        public Object inhalt = null;
        
        public Object getInhalt() { return inhalt; }
        public ElmaVerfahren setInhalt(Object value) { this.inhalt = value; return this; }
    }

    /**
    * Represents an ELMA protocol report, which the ELMA servers return after a formal verification of a submitted ELMA report.
    */
    @Api(Description="Represents an ELMA protocol report, which the ELMA servers return after a formal verification of a submitted ELMA report.")
    public static class ElmaProtokoll
    {
        /**
        * File name of the processed input ELMA report.
        */
        @ApiMember(Description="File name of the processed input ELMA report.", Name="Dateiname")
        public String dateiname = null;

        /**
        * The BZSt (Bundeszentralamt für Steuern) - tax number of the user. 11-character text field that may only consist of two capital letters and 9 digits (0-9). The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start). The number is available in the private area of the BOP user account under "My BOP" under the "Registration Information"
        */
        @ApiMember(Description="The BZSt (Bundeszentralamt für Steuern) - tax number of the user. 11-character text field that may only consist of two capital letters and 9 digits (0-9). The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start). The number is available in the private area of the BOP user account under \"My BOP\" under the \"Registration Information\"", IsRequired=true, Name="AuthSteuernummer")
        public String authSteuernummer = null;

        /**
        * The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).
        */
        @ApiMember(Description="The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).", IsRequired=true, Name="AccountId")
        public String accountId = null;

        /**
        * Date on which the request was processed by ELAN (ELMA receiving server at BZSt).
        */
        @ApiMember(Description="Date on which the request was processed by ELAN (ELMA receiving server at BZSt).", Name="VerarbeitungsDatum")
        public Date verarbeitungsDatum = null;

        /**
        * Time of processing by ELAN (ELMA receiving server at BZSt).
        */
        @ApiMember(Description="Time of processing by ELAN (ELMA receiving server at BZSt).", Name="VerarbeitungsZeit")
        public Date verarbeitungsZeit = null;

        /**
        * The status code of the ELMA process.
        */
        @ApiMember(Description="The status code of the ELMA process.", Name="Status")
        public Status status = null;

        /**
        * A brief description of the status.
        */
        @ApiMember(Description="A brief description of the status.", Name="StatusText")
        public String statusText = null;

        /**
        * A detailed information on the status.
        */
        @ApiMember(Description="A detailed information on the status.", Name="StatusDetail")
        public String statusDetail = null;

        /**
        * User custom ID.This field can be filled with internal reference information of the user.
        */
        @ApiMember(Description="User custom ID.This field can be filled with internal reference information of the user.", Name="KundeneigeneId")
        public String kundeneigeneId = null;

        /**
        * Data transfer identifier.Hexadecimal formatted number. Example: 550e8400-e29b-11d4-a716-446655440000
        */
        @ApiMember(Description="Data transfer identifier.Hexadecimal formatted number. Example: 550e8400-e29b-11d4-a716-446655440000", Name="UUID")
        public UUID uuid = null;
        
        public String getDateiname() { return dateiname; }
        public ElmaProtokoll setDateiname(String value) { this.dateiname = value; return this; }
        public String getAuthSteuernummer() { return authSteuernummer; }
        public ElmaProtokoll setAuthSteuernummer(String value) { this.authSteuernummer = value; return this; }
        public String getAccountId() { return accountId; }
        public ElmaProtokoll setAccountId(String value) { this.accountId = value; return this; }
        public Date getVerarbeitungsDatum() { return verarbeitungsDatum; }
        public ElmaProtokoll setVerarbeitungsDatum(Date value) { this.verarbeitungsDatum = value; return this; }
        public Date getVerarbeitungsZeit() { return verarbeitungsZeit; }
        public ElmaProtokoll setVerarbeitungsZeit(Date value) { this.verarbeitungsZeit = value; return this; }
        public Status getStatus() { return status; }
        public ElmaProtokoll setStatus(Status value) { this.status = value; return this; }
        public String getStatusText() { return statusText; }
        public ElmaProtokoll setStatusText(String value) { this.statusText = value; return this; }
        public String getStatusDetail() { return statusDetail; }
        public ElmaProtokoll setStatusDetail(String value) { this.statusDetail = value; return this; }
        public String getKundeneigeneId() { return kundeneigeneId; }
        public ElmaProtokoll setKundeneigeneId(String value) { this.kundeneigeneId = value; return this; }
        public UUID getUuid() { return uuid; }
        public ElmaProtokoll setUuid(UUID value) { this.uuid = value; return this; }
    }

    public static enum Status
    {
        ElmaGlobalUnbekannt(0),
        ElmaOk(8000),
        ElmaParserFehler(8001),
        ElmaUngueltigeKodierung(8002),
        ElmaUngueltigeDateiname(8003),
        ElmaFalscheBzstnrOderAccountid(8004),
        ElmaSignaturDateiFehlt(8005),
        ElmaSignaturPruefungFehlerhaft(8006),
        ElmaNotwendigeFachlicheBerechtigungenFehlen(8007),
        ElmaFreischaltungFehlt(8008),
        ElmaSperreVorhanden(8009),
        ElmaDateinameBereitsVerwendet(8010),
        ElmaDateiinhaltIdentisch(8011),
        ElmaBzstnrOderAccountidStimmtNichtUberein(8012),
        ElmaTestdaten(8013);

        private final int value;
        Status(final int intValue) { value = intValue; }
        public int getValue() { return value; }
    }

    /**
    * Represents an ELMA protocol report, which the ELMA servers return after a formal verification of a submitted ELMA report.
    */
    @Api(Description="Represents an ELMA protocol report, which the ELMA servers return after a formal verification of a submitted ELMA report.")
    public static class ElmaFehler
    {
        /**
        * File name of the processed input ELMA report.
        */
        @ApiMember(Description="File name of the processed input ELMA report.", Name="Dateiname")
        public String dateiname = null;

        /**
        * The BZSt (Bundeszentralamt für Steuern) - tax number of the user.  11-character text field that may only consist of two capital letters and 9 digits (0-9). The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start). The number is available in the private area of the BOP user account under "My BOP" under the "Registration Information"
        */
        @ApiMember(Description="The BZSt (Bundeszentralamt für Steuern) - tax number of the user.  11-character text field that may only consist of two capital letters and 9 digits (0-9). The fiscal authority BZSt provides this number during registration at the BOP (BZSt-Online Portal - https://www.elster.de/bportal/start). The number is available in the private area of the BOP user account under \"My BOP\" under the \"Registration Information\"", IsRequired=true, Name="AuthSteuernummer")
        public String authSteuernummer = null;

        /**
        * The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).
        */
        @ApiMember(Description="The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9).", IsRequired=true, Name="AccountId")
        public String accountId = null;

        /**
        * Date on which the request was processed by ELAN (ELMA receiving server at BZSt).
        */
        @ApiMember(Description="Date on which the request was processed by ELAN (ELMA receiving server at BZSt).", Name="VerarbeitungsDatum")
        public Date verarbeitungsDatum = null;

        /**
        * Time of processing by ELAN (ELMA receiving server at BZSt).
        */
        @ApiMember(Description="Time of processing by ELAN (ELMA receiving server at BZSt).", Name="VerarbeitungsZeit")
        public Date verarbeitungsZeit = null;

        /**
        * The status code of the ELMA process.
        */
        @ApiMember(Description="The status code of the ELMA process.", Name="FehlerID")
        public Status fehlerID = null;

        /**
        * A brief description of the error status.
        */
        @ApiMember(Description="A brief description of the error status.", Name="FehlerText")
        public String fehlerText = null;

        /**
        * A detailed information on the status.
        */
        @ApiMember(Description="A detailed information on the status.", Name="FehlerProzess")
        public String fehlerProzess = null;

        /**
        * User custom ID.This field can be filled with internal reference information of the user.
        */
        @ApiMember(Description="User custom ID.This field can be filled with internal reference information of the user.", Name="KundeneigeneId")
        public String kundeneigeneId = null;

        /**
        * Data transfer identifier.Hexadecimal formatted number. Example: 550e8400-e29b-11d4-a716-446655440000
        */
        @ApiMember(Description="Data transfer identifier.Hexadecimal formatted number. Example: 550e8400-e29b-11d4-a716-446655440000", Name="UUID")
        public UUID uuid = null;
        
        public String getDateiname() { return dateiname; }
        public ElmaFehler setDateiname(String value) { this.dateiname = value; return this; }
        public String getAuthSteuernummer() { return authSteuernummer; }
        public ElmaFehler setAuthSteuernummer(String value) { this.authSteuernummer = value; return this; }
        public String getAccountId() { return accountId; }
        public ElmaFehler setAccountId(String value) { this.accountId = value; return this; }
        public Date getVerarbeitungsDatum() { return verarbeitungsDatum; }
        public ElmaFehler setVerarbeitungsDatum(Date value) { this.verarbeitungsDatum = value; return this; }
        public Date getVerarbeitungsZeit() { return verarbeitungsZeit; }
        public ElmaFehler setVerarbeitungsZeit(Date value) { this.verarbeitungsZeit = value; return this; }
        public Status getFehlerID() { return fehlerID; }
        public ElmaFehler setFehlerID(Status value) { this.fehlerID = value; return this; }
        public String getFehlerText() { return fehlerText; }
        public ElmaFehler setFehlerText(String value) { this.fehlerText = value; return this; }
        public String getFehlerProzess() { return fehlerProzess; }
        public ElmaFehler setFehlerProzess(String value) { this.fehlerProzess = value; return this; }
        public String getKundeneigeneId() { return kundeneigeneId; }
        public ElmaFehler setKundeneigeneId(String value) { this.kundeneigeneId = value; return this; }
        public UUID getUuid() { return uuid; }
        public ElmaFehler setUuid(UUID value) { this.uuid = value; return this; }
    }

    /**
    * Represents a file that contains raw data content in bytes
    */
    @Api(Description="Represents a file that contains raw data content in bytes")
    public static class BinaryFile extends FileBase
    {
        /**
        * The attributes of the file.
        */
        @ApiMember(Description="The attributes of the file.", Name="Metadata")
        public FileMetadata metadata = null;

        /**
        * The name of the file without information on its directory path.
        */
        @ApiMember(Description="The name of the file without information on its directory path.", Name="Name")
        public String name = null;
        
        public FileMetadata getMetadata() { return metadata; }
        public BinaryFile setMetadata(FileMetadata value) { this.metadata = value; return this; }
        public String getName() { return name; }
        public BinaryFile setName(String value) { this.name = value; return this; }
    }

    /**
    * Represents a base class for a file with raw data.
    */
    @Api(Description="Represents a base class for a file with raw data.")
    public static class FileBase
    {
        /**
        * The raw data content of the file.
        */
        @ApiMember(Description="The raw data content of the file.", Name="Content")
        public byte[] content = null;
        
        public byte[] getContent() { return content; }
        public FileBase setContent(byte[] value) { this.content = value; return this; }
    }

    /**
    * Represents information about a file or directory.
    */
    @Api(Description="Represents information about a file or directory.")
    public static class FileMetadata implements IFileMetadata
    {
        /**
        * The name of the file.For files, gets the name of the file.For directories, gets the name of the last directory in the hierarchy if a hierarchy exists; otherwise, the name of the directory.
        */
        @ApiMember(Description="The name of the file.\nFor files, gets the name of the file.\nFor directories, gets the name of the last directory in the hierarchy if a hierarchy exists; otherwise, the name of the directory.", Name="Name")
        public String name = null;

        /**
        * The full path of the directory or file.
        */
        @ApiMember(Description="The full path of the directory or file.", Name="FullName")
        public String fullName = null;

        /**
        * The time the current file or directory was last accessed.
        */
        @ApiMember(Description="The time the current file or directory was last accessed.", Name="LastAccessTime")
        public Date lastAccessTime = null;

        /**
        * The name of the file.
        */
        @ApiMember(Description="The name of the file.", Name="LastAccessTimeUtc")
        public Date lastAccessTimeUtc = null;

        /**
        * The time when the current file or directory was last written to.
        */
        @ApiMember(Description="The time when the current file or directory was last written to.", Name="LastAccessTime")
        public Date lastWriteTime = null;

        /**
        * The time, in coordinated universal time (UTC), when the current file or directory was last written to.
        */
        @ApiMember(Description="The time, in coordinated universal time (UTC), when the current file or directory was last written to.", Name="LastWriteTimeUtc")
        public Date lastWriteTimeUtc = null;

        /**
        * The size, in bytes, of the current file.
        */
        @ApiMember(Description="The size, in bytes, of the current file.", Name="Length")
        public Long length = null;

        /**
        * The size, in bytes, of the current file.
        */
        @ApiMember(Description="The size, in bytes, of the current file.", Name="UserId")
        public Integer userId = null;

        /**
        * The file group id.
        */
        @ApiMember(Description="The file group id.", Name="GroupId")
        public Integer groupId = null;

        /**
        * A value that indicates whether the others can read from this file.
        */
        @ApiMember(Description="A value that indicates whether the others can read from this file.", Name="OthersCanRead")
        public Boolean othersCanRead = null;

        /**
        * A value that indicates whether the group members can execute this file.
        */
        @ApiMember(Description="A value that indicates whether the group members can execute this file.", Name="GroupCanExecute")
        public Boolean groupCanExecute = null;

        /**
        * A value that indicates whether the group members can write into this file.
        */
        @ApiMember(Description="A value that indicates whether the group members can write into this file.", Name="GroupCanWrite")
        public Boolean groupCanWrite = null;

        /**
        * A value that indicates whether the group members can read from this file.
        */
        @ApiMember(Description="A value that indicates whether the group members can read from this file.", Name="GroupCanRead")
        public Boolean groupCanRead = null;

        /**
        * A value that indicates whether the owner can execute this file.
        */
        @ApiMember(Description="A value that indicates whether the owner can execute this file.", Name="OwnerCanExecute")
        public Boolean ownerCanExecute = null;

        /**
        * A value that indicates whether the owner can write into this file.
        */
        @ApiMember(Description="A value that indicates whether the owner can write into this file.", Name="OwnerCanWrite")
        public Boolean ownerCanWrite = null;

        /**
        * A value that indicates whether the owner can read from this file.
        */
        @ApiMember(Description="A value that indicates whether the owner can read from this file.", Name="OthersCanRead")
        public Boolean ownerCanRead = null;

        /**
        * A value that indicates whether others can read from this file.
        */
        @ApiMember(Description="A value that indicates whether others can read from this file.", Name="OthersCanExecute")
        public Boolean othersCanExecute = null;

        /**
        * A value that indicates whether others can write into this file.
        */
        @ApiMember(Description="A value that indicates whether others can write into this file.", Name="OthersCanWrite")
        public Boolean othersCanWrite = null;

        /**
        * Extensions to the file attributes.
        */
        @ApiMember(Description="Extensions to the file attributes.", Name="Extensions")
        public HashMap<String,String> extensions = null;
        
        public String getName() { return name; }
        public FileMetadata setName(String value) { this.name = value; return this; }
        public String getFullName() { return fullName; }
        public FileMetadata setFullName(String value) { this.fullName = value; return this; }
        public Date getLastAccessTime() { return lastAccessTime; }
        public FileMetadata setLastAccessTime(Date value) { this.lastAccessTime = value; return this; }
        public Date getLastAccessTimeUtc() { return lastAccessTimeUtc; }
        public FileMetadata setLastAccessTimeUtc(Date value) { this.lastAccessTimeUtc = value; return this; }
        public Date getLastWriteTime() { return lastWriteTime; }
        public FileMetadata setLastWriteTime(Date value) { this.lastWriteTime = value; return this; }
        public Date getLastWriteTimeUtc() { return lastWriteTimeUtc; }
        public FileMetadata setLastWriteTimeUtc(Date value) { this.lastWriteTimeUtc = value; return this; }
        public Long getLength() { return length; }
        public FileMetadata setLength(Long value) { this.length = value; return this; }
        public Integer getUserId() { return userId; }
        public FileMetadata setUserId(Integer value) { this.userId = value; return this; }
        public Integer getGroupId() { return groupId; }
        public FileMetadata setGroupId(Integer value) { this.groupId = value; return this; }
        public Boolean isOthersCanRead() { return othersCanRead; }
        public FileMetadata setOthersCanRead(Boolean value) { this.othersCanRead = value; return this; }
        public Boolean isGroupCanExecute() { return groupCanExecute; }
        public FileMetadata setGroupCanExecute(Boolean value) { this.groupCanExecute = value; return this; }
        public Boolean isGroupCanWrite() { return groupCanWrite; }
        public FileMetadata setGroupCanWrite(Boolean value) { this.groupCanWrite = value; return this; }
        public Boolean isGroupCanRead() { return groupCanRead; }
        public FileMetadata setGroupCanRead(Boolean value) { this.groupCanRead = value; return this; }
        public Boolean isOwnerCanExecute() { return ownerCanExecute; }
        public FileMetadata setOwnerCanExecute(Boolean value) { this.ownerCanExecute = value; return this; }
        public Boolean isOwnerCanWrite() { return ownerCanWrite; }
        public FileMetadata setOwnerCanWrite(Boolean value) { this.ownerCanWrite = value; return this; }
        public Boolean isOwnerCanRead() { return ownerCanRead; }
        public FileMetadata setOwnerCanRead(Boolean value) { this.ownerCanRead = value; return this; }
        public Boolean isOthersCanExecute() { return othersCanExecute; }
        public FileMetadata setOthersCanExecute(Boolean value) { this.othersCanExecute = value; return this; }
        public Boolean isOthersCanWrite() { return othersCanWrite; }
        public FileMetadata setOthersCanWrite(Boolean value) { this.othersCanWrite = value; return this; }
        public HashMap<String,String> getExtensions() { return extensions; }
        public FileMetadata setExtensions(HashMap<String,String> value) { this.extensions = value; return this; }
    }

}

Java BatchRetrieveProtocolsAsync 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 /async/elma/protocols/batch/retrieve HTTP/1.1 
Host: reportfiling.pwc.de 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<BatchRetrieveProtocolsAsync xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.Elmaas.Core.Services.Contracts.Requests">
  <Credential xmlns:d2p1="http://schemas.datacontract.org/2004/07/PwC.Elmaas.Core.Domain.Concretes.Models">
    <d2p1:AccountId>String</d2p1:AccountId>
    <d2p1:AuthSteuernummer>String</d2p1:AuthSteuernummer>
    <d2p1:Certificate xmlns:d3p1="http://schemas.datacontract.org/2004/07/PwC.Elmaas.Core.Domain.Contracts.Models">
      <d3p1:Content>String</d3p1:Content>
      <d3p1:Description>String</d3p1:Description>
      <d3p1:Id>String</d3p1:Id>
      <d3p1:Tags xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>String</d4p1:string>
      </d3p1:Tags>
    </d2p1:Certificate>
    <d2p1:Password>String</d2p1:Password>
  </Credential>
  <SearchCriteria>
    <SearchCriteria>
      <Designation>CC</Designation>
      <Name>String</Name>
    </SearchCriteria>
  </SearchCriteria>
  <StagingEnabled>false</StagingEnabled>
</BatchRetrieveProtocolsAsync>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<RetrievalResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.Elmaas.Core.Services.Contracts.Responses">
  <Files xmlns:d2p1="http://schemas.datacontract.org/2004/07/PwC.DigitalHub.Utilities.IO.Concretes.Models">
    <d2p1:BinaryFile>
      <Content xmlns="http://schemas.datacontract.org/2004/07/PwC.DigitalHub.Utilities.IO.Core.Contracts.Models">AA==</Content>
      <d2p1:Metadata xmlns:d4p1="http://schemas.datacontract.org/2004/07/PwC.DigitalHub.Utilities.IO.Core.Concretes.Models">
        <d4p1:Extensions xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d4p1:Extensions>
        <d4p1:FullName>String</d4p1:FullName>
        <d4p1:GroupCanExecute>false</d4p1:GroupCanExecute>
        <d4p1:GroupCanRead>false</d4p1:GroupCanRead>
        <d4p1:GroupCanWrite>false</d4p1:GroupCanWrite>
        <d4p1:GroupId>0</d4p1:GroupId>
        <d4p1:LastAccessTime>0001-01-01T00:00:00</d4p1:LastAccessTime>
        <d4p1:LastAccessTimeUtc>0001-01-01T00:00:00</d4p1:LastAccessTimeUtc>
        <d4p1:LastWriteTime>0001-01-01T00:00:00</d4p1:LastWriteTime>
        <d4p1:LastWriteTimeUtc>0001-01-01T00:00:00</d4p1:LastWriteTimeUtc>
        <d4p1:Length>0</d4p1:Length>
        <d4p1:Name>String</d4p1:Name>
        <d4p1:OthersCanExecute>false</d4p1:OthersCanExecute>
        <d4p1:OthersCanRead>false</d4p1:OthersCanRead>
        <d4p1:OthersCanWrite>false</d4p1:OthersCanWrite>
        <d4p1:OwnerCanExecute>false</d4p1:OwnerCanExecute>
        <d4p1:OwnerCanRead>false</d4p1:OwnerCanRead>
        <d4p1:OwnerCanWrite>false</d4p1:OwnerCanWrite>
        <d4p1:UserId>0</d4p1:UserId>
      </d2p1:Metadata>
      <d2p1:Name>String</d2p1:Name>
    </d2p1:BinaryFile>
  </Files>
  <Protocols xmlns:d2p1="http://schemas.datacontract.org/2004/07/PwC.Elmaas.Core.Domain.Concretes.Models">
    <d2p1:Elma xmlns:n1="http://www.itzbund.de/ELAN/01">
      <n1:ELMAKOM ELMAKOMVersion="String">
        <n1:ELMAHeader>
          <n1:DatenArt>ELMA_CC</n1:DatenArt>
          <n1:AuthSteuernummer>String</n1:AuthSteuernummer>
          <n1:AccountID>String</n1:AccountID>
          <n1:ErstellungsDatum>0001-01-01T00:00:00.000</n1:ErstellungsDatum>
          <n1:KundeneigeneID>String</n1:KundeneigeneID>
          <n1:UUID>00000000-0000-0000-0000-000000000000</n1:UUID>
          <n1:Verarbeitungslauf>PRODUKTIONSLAUF</n1:Verarbeitungslauf>
        </n1:ELMAHeader>
        <n1:ELMAVerfahren />
      </n1:ELMAKOM>
      <n1:ELMAProtokoll>
        <n1:Dateiname>String</n1:Dateiname>
        <n1:AuthSteuernummer>String</n1:AuthSteuernummer>
        <n1:AccountID>String</n1:AccountID>
        <n1:VerarbeitungsDatum>0001-01-01</n1:VerarbeitungsDatum>
        <n1:VerarbeitungsZeit>0001-01-01</n1:VerarbeitungsZeit>
        <n1:Status>ELMA_GLOBAL_UNBEKANNT</n1:Status>
        <n1:StatusText>String</n1:StatusText>
        <n1:StatusDetail>String</n1:StatusDetail>
        <n1:KundeneigeneID>String</n1:KundeneigeneID>
        <n1:UUID>00000000-0000-0000-0000-000000000000</n1:UUID>
      </n1:ELMAProtokoll>
      <n1:ELMAFEHLER>
        <n1:Dateiname>String</n1:Dateiname>
        <n1:AuthSteuernummer>String</n1:AuthSteuernummer>
        <n1:AccountID>String</n1:AccountID>
        <n1:VerarbeitungsDatum>0001-01-01</n1:VerarbeitungsDatum>
        <n1:VerarbeitungsZeit>00:00:00.000</n1:VerarbeitungsZeit>
        <n1:FehlerID>ELMA_GLOBAL_UNBEKANNT</n1:FehlerID>
        <n1:FehlerText>String</n1:FehlerText>
        <n1:FehlerProzess>String</n1:FehlerProzess>
        <n1:KundeneigeneID>String</n1:KundeneigeneID>
        <n1:UUID>00000000-0000-0000-0000-000000000000</n1:UUID>
      </n1:ELMAFEHLER>
    </d2p1:Elma>
  </Protocols>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
</RetrievalResponse>