Report Filing Service

<back to all web services

ValidateReportAsync

ValidateReportAsync

Represents a request to validate a report in an asynchronous operation.

Requires Authentication
The following routes are available for this service:
POST/async/elma/reports/validate
ValidateReportBase Parameters:
NameParameterData TypeRequiredDescription
ReportformReportYesThe report to validate.
Report Parameters:
NameParameterData TypeRequiredDescription
IdformstringYesThe 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.
DataformstringYesThe XML-content of the report.
ValidationResponse Parameters:
NameParameterData TypeRequiredDescription
IdformstringNoThe unique identifier of the report that was processed. The identifier is usually the filename.
ValidationErrorsformList<ValidationError>NoThe errors encountered during the report validation operation.
ResponseStatusformResponseStatusNoThe status of the validation operation.
ValidationError Parameters:
NameParameterData TypeRequiredDescription
IdformstringNoThe unique identifier of the validation faílure. This is equivalent to the file name of the validated report.
MessageformstringNoThe message of the validation failure.
SeverityformXmlSeverityTypeNoThe severity of the validation faílure.
LineNumberformintNoThe line number indicating where the error occurred.
LinePositionformintNoThe line position indicating where the error occurred.

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

HTTP + X-MSGPACK

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

POST /async/elma/reports/validate HTTP/1.1 
Host: reportfiling.pwc.de 
Accept: application/x-msgpack
Content-Type: application/x-msgpack
Content-Length: length

{"report":{"id":"String","data":"String"}}
HTTP/1.1 200 OK
Content-Type: application/x-msgpack
Content-Length: length

{"id":"String","validationErrors":[{"id":"String","message":"String","severity":"Error","lineNumber":0,"linePosition":0}],"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}