Tax Filing Service
| POST | /CreateUstSvXmlFromDefinitionAsync | An asynchronous service to create xml content that represents a filing of the special advance payment for VAT (Umsatzsteuersondervorauszahlung) from the specified dictionary (hash map) of key/value definitions |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Bundesfinanzamtsnummer | form | string | Yes | The four-digit federal tax office number of the receiving tax office. |
| DatenLieferant | form | DatenLieferant | Yes | Natural person who operates the software or on whose behalf the software is operated in order to transfer the tax data. |
| Erstellungsdatum | form | DateTime? | Yes | Date of creation. |
| Berater | form | Berater | No | The tax adviser who processes and submits the tax case. |
| Mandant | form | Mandant | No | The client for which the tax case is being processed. |
| Unternehmer | form | Unternehmer | No | The natural or legal person who processes and submits the tax case. |
| EOP | form | EOP2022 | No | The association to the ELSTER Online Portal (EOP). This is only applicable for years of assessment starting from 2022. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Properties | form | Dictionary<string, string> | No | Dictionary of key-value pairs that represent the intrinsic properties of the VAT declaration. Each key represents a name of the VAT property. Each value of the pair represents the VAT property value. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Jahr | form | int | Yes | The year of the assessment |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | Yes | Der Name des Datenlieferants. |
| Strasse | form | string | Yes | Der Straßenname des Datenlieferants. |
| PLZ | form | string | Yes | Die Postleitzahl des Datenlieferants. |
| Ort | form | string | Yes | Der Ort des Datenlieferants. |
| Telefon | form | string | No | Die Telefonnummer (optional) des Datenlieferants. |
| form | string | No | Die Email-Adresse (optional) des Datenlieferant. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Bezeichnung | form | string | No | Der Bezeichnung (optional) des Beraters (normalerweise der Name des Beraters Unternehmen). |
| Name | form | string | No | Der Name (optional) des Beraters. |
| Vorname | form | string | No | Der Vorname (optional) des Beraters. |
| Namensvorsatz | form | string | No | Der Namenvorsatz (optional) des Beraters. |
| Namenszusatz | form | string | No | Der Namenzusatz (optional) des Beraters. |
| Str | form | string | No | Der Straßenname (optional) des Beraters. |
| Hausnummer | form | string | No | Die Hausnummer (optional) des Beraters. |
| HNrZusatz | form | string | No | Der Hausnummernzusatz (optional) des Beraters. |
| AnschriftenZusatz | form | string | No | Der Anschriftenzusatz (optional) des Beraters. |
| Ort | form | string | No | Der Ort (optional) des Beraters. |
| PLZ | form | string | No | Die Postleitzahl (optional) des Beraters. |
| AuslandsPLZ | form | string | No | Die Auslandspostleitzahl (optional) des Beraters. |
| Land | form | string | No | Der Ländername (falls Anschrift im Ausland) des Beraters - optional. Der Ländername des Beraters kann mit 1-20 alphanumerischen Zeichen geliefert werden. |
| PostfachOrt | form | string | No | Der Ort des Postfaches (optional) des Beraters. |
| Postfach | form | string | No | Das Postfach (optional) des Beraters. |
| PostfachPLZ | form | string | No | Die Postleitzahl (optional) des Beraters. |
| GKPLZ | form | string | No | Die Großkundenpostleitzahl (optional) des Beraters. |
| Telefon | form | string | No | Die Telefonnummer (optional) des Beraters. |
| form | string | No | Die Emailadresse (optional) des Beraters. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | No | Der Name (optional) des Mandanten. |
| Vorname | form | string | No | Der Vorname (optional) des Mandanten. |
| MandantenNr | form | string | No | Die Mandantennummer (optional) des Mandanten. |
| Bearbeiterkennzeichen | form | string | No | Das Bearbeiterkennzeichen (optional) des Mandanten. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Bezeichnung | form | string | No | Der Bezeichnung (optional) des Unternehmers (normalerweise der Name des Unternehmers Unternehmen). |
| Name | form | string | No | Der Name (optional) des Unternehmers. |
| Vorname | form | string | No | Der Vorname (optional) des Unternehmers. |
| Namensvorsatz | form | string | No | Der Namenvorsatz (optional) des Unternehmers. |
| Namenszusatz | form | string | No | Der Namenzusatz (optional) des Unternehmers. |
| Str | form | string | No | Der Straßenname (optional) des Unternehmers. |
| Hausnummer | form | string | No | Die Hausnummer (optional) des Unternehmers. |
| HNrZusatz | form | string | No | Der Hausnummernzusatz (optional) des Unternehmers. |
| AnschriftenZusatz | form | string | No | Der Anschriftenzusatz (optional) des Unternehmers. |
| Ort | form | string | No | Der Ort (optional) des Unternehmers. |
| PLZ | form | string | No | Die Postleitzahl (optional) des Unternehmers. |
| AuslandsPLZ | form | string | No | Die Auslandspostleitzahl (optional) des Unternehmers. |
| Land | form | string | No | Der Ländername (falls Anschrift im Ausland) des Unternehmers - optional. Der Ländername des Unternehmers kann mit 1-20 alphanumerischen Zeichen geliefert werden. |
| PostfachOrt | form | string | No | Der Ort des Postfaches (optional) des Unternehmers. |
| Postfach | form | string | No | Das Postfach (optional) des Unternehmers. |
| PostfachPLZ | form | string | No | Die Postleitzahl (optional) des Unternehmers. |
| GKPLZ | form | string | No | Die Großkundenpostleitzahl (optional) des Unternehmers. |
| Telefon | form | string | No | Die Telefonnummer (optional) des Unternehmers. |
| form | string | No | Die Emailadresse (optional) des Unternehmers. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Transferausgabe | form | string | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Content | form | string | No | The XML-based content of the response. |
| ResponseStatus | form | ResponseStatus | No | Metadata that contains structured error information on the XML response. |
To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /CreateUstSvXmlFromDefinitionAsync HTTP/1.1
Host: taxfiling.pwc.de
Accept: text/csv
Content-Type: text/csv
Content-Length: length
{"bundesfinanzamtsnummer":"String","datenLieferant":{"name":"String","strasse":"String","plz":"String","ort":"String","telefon":"String","email":"String"},"erstellungsdatum":"\/Date(-62135596800000-0000)\/","berater":{"bezeichnung":"String","name":"String","vorname":"String","namensvorsatz":"String","namenszusatz":"String","str":"String","hausnummer":"String","hNrZusatz":"String","anschriftenZusatz":"String","ort":"String","plz":"String","auslandsPLZ":"String","land":"String","postfachOrt":"String","postfach":"String","postfachPLZ":"String","gkplz":"String","telefon":"String","email":"String"},"mandant":{"name":"String","vorname":"String","mandantenNr":"String","bearbeiterkennzeichen":"String"},"unternehmer":{"bezeichnung":"String","name":"String","vorname":"String","namensvorsatz":"String","namenszusatz":"String","str":"String","hausnummer":"String","hNrZusatz":"String","anschriftenZusatz":"String","ort":"String","plz":"String","auslandsPLZ":"String","land":"String","postfachOrt":"String","postfach":"String","postfachPLZ":"String","gkplz":"String","telefon":"String","email":"String"},"eop":{"transferausgabe":"String"},"properties":{"String":"String"},"jahr":0}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length
{"content":"String","responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}