POST | /CreateLegacyUstXmlFromDefinitionAsync | An asynchronous service to create xml content that represents an annual VAT return (Umsatzsteuerjahreserklärung) from the specified dictionary (hash map) of key/value definitions. |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Vorsatz | form | Vorsatz | Yes | Der Vorsatz der Jahressteuererklaerung. |
Bundesfinanzamtsnummer | form | string | No | The four-digit federal tax office number of the receiving tax office. |
DatenLieferant | form | string | Yes | The details of the provider that submits the tax data. |
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 |
---|---|---|---|---|
Unterfallart | form | Unterfallart | Yes | Unterfalllarten für die verschiedenen Verfahren. |
OrdNrArt | form | OrdNrArt | Yes | Die Art des ermittelten Ordnungsbegriffs zu füllen. |
Vorgang | form | VeranlagungVorgang | Yes | Der Vorgang bei einer Veranlagung. |
StNr | form | string | No | |
ID | form | string | No | |
IDEhefrau | form | string | No | |
Zeitraum | form | int | Yes | Das Jahr, für das die Erklärung gilt, im Format JJJJ. |
Erstelldatum | form | DateTime? | No | Das Erstellungsdatum des Steuerfalls, im Format JJJJMMDD. |
Erstellzeit | form | DateTime? | No | Die Erstellungszeit des Steuerfalls, im Format hhmmss. |
AbsName | form | string | Yes | Name, alphanumerisch, max. 45-stellig. |
AbsStr | form | string | Yes | Straße und Hausnummer, alphanumerisch, max. 30-stellig. |
AbsPlz | form | string | No | Postleitzahl, numerisch, 5-stellig. |
AbsOrt | form | string | Yes | Ort, alphanumerisch, max. 29-stellig. |
Copyright | form | string | No | Copyrightmeldung des SW-Herstellers, alphanumerisch, max.50-stellig |
Rueckuebermittlung | form | Rueckuebermittlung | No | Die zur Abholung notwendigen Informationen werden hier angegeben. |
Name | Value | |
---|---|---|
UFA10 | 10 | Gilt nur für die Datenart 'ESt'. |
UFA12 | 12 | Gilt nur für die Datenart 'EStbeschraenkt'. |
UFA13 | 13 | Gilt nur für die Datenart 'Anlage34a'. |
UFA20 | 20 | Gilt nur für die Datenart 'GewSt'. |
UFA21 | 21 | Gilt nur für die Datenart 'GewStZ'. |
UFA30 | 30 | Gilt nur für die Datenart 'KSt'. |
UFA31 | 31 | Gilt nur für die Datenart 'KSt'. |
UFA32 | 32 | Gilt nur für die Datenart 'KSt'. |
UFA33 | 33 | Gilt nur für die Datenart 'KSt'. |
UFA39 | 39 | Gilt nur für die Datenart 'KStZ'. |
UFA50 | 50 | Gilt nur für die Datenart 'USt'. |
UFA57 | 57 | Gilt nur für die Datenart 'USt'. |
UFA58 | 58 | Gilt nur für die Datenart 'USt'. |
UFA64 | 64 | Gilt nur für die Datenart 'USt'. |
UFA76 | 76 | Gilt nur für die Datenart 'EUER'. |
UFA77 | 77 | Gilt nur für die Datenart 'EUER'. |
UFA88 | 88 | Gilt nur für die Datenart 'EUER'. |
UFA90 | 90 | Gilt nur für die Datenart 'FEIN'. |
UFA95 | 95 | Gilt nur für die Datenart 'FEIN'. |
UFA97 | 97 | Gilt nur für die Datenart 'InvStG56Abs5'. |
Keine | 98 | Keine Unterfallart |
S | Steuernummer. |
O | Maschinell. |
Name | Value | |
---|---|---|
NurVeranlagung | 1 | '01': Bei Nur-Veranlagung. |
VeranlagungMitVorauszahlung | 4 | '04': Bei Veranlagung mit Vorauszahlung zu füllen |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Bescheid | form | bool | No | Dieses Attribut beschreibt, ob eine Datenabholung gewünscht ist. |
ArtRueckuebermittlung | form | string | No | Art der Adresse der Bescheidbereitstellung: INTERNET bei Rückübermittlung über Internet. |
SchluesselRueckuebermittlung | form | string | No | Öffentlicher Schlüssel mit variabler Länge. |
AdresseRueckuebermittlung | form | string | No | Erforderliche Adresselemente bei Benachrichtigung für Bescheidbereitstellung: E-Mail-Adresse. |
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 .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /CreateLegacyUstXmlFromDefinitionAsync HTTP/1.1
Host: taxfiling.pwc.de
Accept: application/json
Content-Type: application/json
Content-Length: length
{"vorsatz":{"unterfallart":"UFA10","ordNrArt":"S","vorgang":"NurVeranlagung","stNr":"String","id":"String","idEhefrau":"String","zeitraum":0,"erstelldatum":"\/Date(-62135596800000-0000)\/","erstellzeit":"\/Date(-62135596800000-0000)\/","absName":"String","absStr":"String","absPlz":"String","absOrt":"String","copyright":"String","rueckuebermittlung":{"bescheid":false,"artRueckuebermittlung":"String","schluesselRueckuebermittlung":"String","adresseRueckuebermittlung":"String"}},"bundesfinanzamtsnummer":"String","datenLieferant":"String","properties":{"String":"String"},"jahr":0}
HTTP/1.1 200 OK Content-Type: application/json 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"}}}