""" Options: Date: 2024-10-18 17:17:41 Version: 6.110 Tip: To override a DTO option, remove "#" prefix before updating BaseUrl: https://reportfiling.staging.pwc.de #GlobalNamespace: #AddServiceStackTypes: True #AddResponseStatus: False #AddImplicitVersion: #AddDescriptionAsComments: True IncludeTypes: BatchSubmitReports.* #ExcludeTypes: #DefaultImports: datetime,decimal,marshmallow.fields:*,servicestack:*,typing:*,dataclasses:dataclass/field,dataclasses_json:dataclass_json/LetterCase/Undefined/config,enum:Enum/IntEnum #DataClass: #DataClassJson: """ import datetime import decimal from marshmallow.fields import * from servicestack import * from typing import * from dataclasses import dataclass, field from dataclasses_json import dataclass_json, LetterCase, Undefined, config from enum import Enum, IntEnum # @Api(Description="Represents a PEM-encoded certificate.") @dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE) @dataclass class PemCertificate: """ Represents a PEM-encoded certificate. """ # @ApiMember(Description="The unique identifier (e.g. the file name) of the certificate.", IsRequired=true, Name="Id") id: Optional[str] = None """ The unique identifier (e.g. the file name) of the certificate. """ # @ApiMember(Description="The PEM-encoded content of the certificate.", IsRequired=true, Name="Content") content: Optional[str] = None """ The PEM-encoded content of the certificate. """ # @ApiMember(Description="The description of the certificate.", Name="Description") description: Optional[str] = None """ The description of the certificate. """ # @ApiMember(Description="Tags to label or identify the certificate.", Name="Tags") tags: Optional[List[str]] = None """ Tags to label or identify the certificate. """ # @Api(Description="Represents the credentials of a user to authenticate the access of an ELMA server.") @dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE) @dataclass class ElmaCredential(IElmaCredential): """ Represents the credentials of a user to authenticate the access of an ELMA server. """ # @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") id: Optional[str] = None """ The unique identifier of this instance. This identifer is only relevant in the context of data storage and retrieval. """ # @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) certificate: Optional[PemCertificate] = None """ 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 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) auth_steuernummer: Optional[str] = None """ 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 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) account_id: Optional[str] = None """ The account identifier of a BZSt-Online Portal (BOP) user. 10-character text field that may only contain numbers (0-9). """ # @ApiMember(Description="The password to protect the certificate from unauthorized access.", IsRequired=true, Name="Password") password: Optional[str] = None """ The password to protect the certificate from unauthorized access. """ class IAuthenticateRequest: credential: Optional[ElmaCredential] = None class IStageableRequest: staging_enabled: Optional[bool] = None # @Api(Description="Represents an ELMA report.") @dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE) @dataclass class Report: """ Represents an ELMA report. """ # @ApiMember(Description="The conventional ELMA file name of the report. The format of the ELMA formula is as follows: m5_<pb>_<BZSt-Nr>_<AccountID>_<DateiId>.xml where: m5 is a constant for all reporting types. pb is a constant that represents the ELMA product designation e.g. CC, DC, FC etc. BZSt-Nr is the 11-character BZSt (Bundeszentralamt für Steuern) - tax number of the ELMA user e.g. bz123456789 AccountID is the 10-digit account identifier of the BZSt-Online Portal (BOP) user e.g. 1234567890 DateiId is the 1 - 12 character internal short name for the data file.", IsRequired=true, Name="Id") id: Optional[str] = None """ The conventional ELMA file name of the report. The format of the ELMA formula is as follows: m5_<pb>_<BZSt-Nr>_<AccountID>_<DateiId>.xml where: m5 is a constant for all reporting types. pb is a constant that represents the ELMA product designation e.g. CC, DC, FC etc. BZSt-Nr is the 11-character BZSt (Bundeszentralamt für Steuern) - tax number of the ELMA user e.g. bz123456789 AccountID is the 10-digit account identifier of the BZSt-Online Portal (BOP) user e.g. 1234567890 DateiId is the 1 - 12 character internal short name for the data file. """ # @ApiMember(Description="The XML-content of the report.", IsRequired=true, Name="Data") data: Optional[str] = None """ The XML-content of the report. """ class IUploadRequest: validation_enabled: bool = False # @Api(Description="Specifies a request to submit reports to the ELMA server.") @dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE) @dataclass class BatchSubmitReportsBase(IReturn[List[SubmissionResponse]], IPost, IAuthenticateRequest, IBatchUploadRequest, IStageableRequest): """ Specifies a request to submit reports to the ELMA server. """ # @ApiMember(Description="The reports to submit to the ELMA server.", IsRequired=true, Name="Reports") reports: Optional[List[Report]] = None """ The reports to submit to the ELMA server. """ # @ApiMember(Description="The credential to gain access on the ELMA server.", IsRequired=true, Name="Credential") credential: Optional[ElmaCredential] = None """ The credential to gain access on the ELMA server. """ # @ApiMember(Description="Should the report data be validated before sending it to the ELMA server? true: report data is validated before submission to the ELMA server. false: report data sent without validation to the ELMA server.", Name="ValidationEnabled") validation_enabled: bool = False """ Should the report data be validated before sending it to the ELMA server? true: report data is validated before submission to the ELMA server. false: report data sent without validation to the 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") staging_enabled: Optional[bool] = None """ 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. """ @staticmethod def response_type(): return List[SubmissionResponse] class IBatchUploadRequest(IUploadRequest): reports: Optional[List[Report]] = None # @Api(Description="Represents a failure encountered during the validation of an ELMA report against its XML schema. ") @dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE) @dataclass class ValidationError: """ Represents a failure encountered during the validation of an ELMA report against its XML schema. """ # @ApiMember(Description="The unique identifier of the validation faílure.\n This is equivalent to the file name of the validated report.", Name="Id") id: Optional[str] = None """ The unique identifier of the validation faílure. This is equivalent to the file name of the validated report. """ # @ApiMember(Description="The message of the validation failure.", Name="Message") message: Optional[str] = None """ The message of the validation failure. """ # @ApiMember(Description="The severity of the validation faílure.", Name="Severity") severity: Optional[XmlSeverityType] = None """ The severity of the validation faílure. """ # @ApiMember(Description="The line number indicating where the error occurred.", Name="LineNumber") line_number: int = 0 """ The line number indicating where the error occurred. """ # @ApiMember(Description="The line position indicating where the error occurred.", Name="LinePosition") line_position: int = 0 """ The line position indicating where the error occurred. """ class IElmaCredential: certificate: Optional[PemCertificate] = None auth_steuernummer: Optional[str] = None account_id: Optional[str] = None password: Optional[str] = None # @Api(Description="Encapsulates the results of submitting a report") @dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE) @dataclass class SubmissionResponse: """ Encapsulates the results of submitting a report """ # @ApiMember(Description="The unique identifier of the report that was processed.", Name="Id") id: Optional[str] = None """ The unique identifier of the report that was processed. """ # @ApiMember(Description="The submitted XML-based report content.", Name="Xml") xml: Optional[str] = None """ The submitted XML-based report content. """ # @ApiMember(Description="The errors encountered during the validation phase of the report submission operation.", Name="ValidationErrors") validation_errors: Optional[List[ValidationError]] = None """ The errors encountered during the validation phase of the report submission operation. """ # @ApiMember(Description="The status of the report submission operation.", Name="ResponseStatus") response_status: Optional[ResponseStatus] = None """ The status of the report submission operation. """ # @Route("/sync/elma/reports/batch/submit", "POST") # @Api(Description="Represents a request to submit reports to the ELMA server.") @dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE) @dataclass class BatchSubmitReports(BatchSubmitReportsBase, IReturn[List[SubmissionResponse]]): """ Represents a request to submit reports to the ELMA server. """ pass