Tax Filing Service

<back to all web services

BatchValidiereSendeUndDruckeAsync

AsyncBearbeiteVorgangValidiereSendeDruckeBatch

An asynchronous service to validate tax data and print its transfer protocol.

Requires Authentication
The following routes are available for this service:
POST/BatchValidiereSendeUndDruckeAsync
BatchValidiereSendeUndDruckeAsync Parameters:
NameParameterData TypeRequiredDescription
DuplexDruckbodybool?NoShould the PDF file be prepared for a double-sided printout with a margin for punching?. True: The straight sides are indented to the left for a stitching margin for punching. False: There is no indentation of the straight sides. The created PDF is only intended for printing pages page by page.
ProtocolPrefixbodystringNoName prefix of the generated transfer protocol file.
FussTextbodystringNoFooter text to be used on the printout (optional).
DatenLieferantbodystringNoThe details of the provider that submits tax data.
StagingEnabledbodybool?NoShould the processing of the tax data be staged? If true, tax data is not sent to the production ELSTER servers.
DatabodyList<TaxData>YesThe batch of tax data to process.
BatchValidiereSendeUndDruckeBase Parameters:
NameParameterData TypeRequiredDescription
DuplexDruckformbool?NoShould the PDF file be prepared for a double-sided printout with a margin for punching?. True: The straight sides are indented to the left for a stitching margin for punching. False: There is no indentation of the straight sides. The created PDF is only intended for printing pages page by page.
ProtocolPrefixformstringNoName prefix of the generated transfer protocol file.
FussTextformstringNoFooter text to be used on the printout (optional).
DatenLieferantformstringNoThe details of the provider that submits tax data.
StagingEnabledformbool?NoShould the processing of the tax data be staged? If true, tax data is not sent to the production ELSTER servers.
DataformList<TaxData>YesThe batch of tax data to process.
BatchBearbeiteVorgangBase Parameters:
NameParameterData TypeRequiredDescription
DataformList<TaxData>YesThe batch of tax data to process.
TaxData Parameters:
NameParameterData TypeRequiredDescription
IdformstringYesThe unique identifier of the tax data.
ContentformstringYesThe XML-based tax declaration.

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

HTTP + OTHER

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

POST /BatchValidiereSendeUndDruckeAsync HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"duplexDruck":false,"protocolPrefix":"String","fussText":"String","datenLieferant":"String","stagingEnabled":false,"data":[{"id":"String","content":"String"}]}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

[{"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":"\/Date(-62135596800000-0000)\/","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":{}}}]}},"transferProtocols":[{"metadata":{"name":"String","fullName":"String","lastAccessTime":"\/Date(-62135596800000-0000)\/","lastAccessTimeUtc":"\/Date(-62135596800000-0000)\/","lastWriteTime":"\/Date(-62135596800000-0000)\/","lastWriteTimeUtc":"\/Date(-62135596800000-0000)\/","length":0,"userId":0,"groupId":0,"othersCanRead":false,"groupCanExecute":false,"groupCanWrite":false,"groupCanRead":false,"ownerCanExecute":false,"ownerCanWrite":false,"ownerCanRead":false,"othersCanExecute":false,"othersCanWrite":false,"extensions":{"String":"String"}},"name":"String","content":"AA=="}],"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"}}}]