Tax Filing Service

<back to all web services

BatchValidiereUndSendeAsync

AsyncBearbeiteVorgangValidiereSendeBatch

An asynchronous service to validate and send batch of tax data.

Requires Authentication
The following routes are available for this service:
POST/BatchValidiereUndSendeAsyncAn asynchronous service to validate and send batch of tax data.
BatchValidiereUndSendeAsync Parameters:
NameParameterData TypeRequiredDescription
ProtocolPrefixbodystringNoName prefix of the generated transfer protocol file.
FussTextbodystringNoFooter text to be used on the printout (optional).
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.
DatenLieferantbodystringNoThe details of the provider that submits batch of tax data.
StagingEnabledbodybool?NoShould the processing of the batch of tax data be staged? If true, batch of tax data is not sent to the production ELSTER servers.
DatabodyList<TaxData>YesThe batch of tax data to process.
BatchValidiereUndSendeBase Parameters:
NameParameterData TypeRequiredDescription
ProtocolPrefixformstringNoName prefix of the generated transfer protocol file.
FussTextformstringNoFooter text to be used on the printout (optional).
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.
DatenLieferantformstringNoThe details of the provider that submits batch of tax data.
StagingEnabledformbool?NoShould the processing of the batch of tax data be staged? If true, batch of 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 .csv suffix or ?format=csv

HTTP + CSV

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

POST /BatchValidiereUndSendeAsync HTTP/1.1 
Host: taxfiling.staging.pwc.de 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"protocolPrefix":"String","fussText":"String","duplexDruck":false,"datenLieferant":"String","stagingEnabled":false,"data":[{"id":"String","content":"String"}]}
HTTP/1.1 200 OK
Content-Type: text/csv
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"}}}]