Tax Filing Service

CreateLegacyUstXmlFromDefinition

SyncUmsatzsteuerJahressteuererklärungLegacyReturnBuilderDefinition

A synchronous service to create XML content that represents an annual VAT return (Umsatzsteuerjahreserklärung) from the specified dictionary (hash map) of key/value definitions.

The following routes are available for this service:
POST	/CreateLegacyUstXmlFromDefinition	A synchronous service to create xml content that represents an annual VAT return (Umsatzsteuerjahreserklärung) from the specified dictionary (hash map) of key/value definitions.

**CreateLegacyUstXmlFromDefinitionBase** Parameters:
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.

**CreateXmlFromDefinitionBase** Parameters:
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.

**CreateXmlFromDefinitionAbstract** Parameters:
Name	Parameter	Data Type	Required	Description
Jahr	form	int	Yes	The year of the assessment

**Vorsatz** Parameters:
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.

**Unterfallart** Enum:
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

**OrdNrArt** Enum:
S	Steuernummer.
O	Maschinell.

**VeranlagungVorgang** Enum:
Name	Value
NurVeranlagung	1	'01': Bei Nur-Veranlagung.
VeranlagungMitVorauszahlung	4	'04': Bei Veranlagung mit Vorauszahlung zu füllen

**Rueckuebermittlung** Parameters:
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.

**XmlResponse** Parameters:
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 .jsv suffix or ?format=jsv

HTTP + JSV

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

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

{
	vorsatz: 
	{
		unterfallart: UFA10,
		ordNrArt: S,
		vorgang: NurVeranlagung,
		stNr: String,
		id: String,
		idEhefrau: String,
		zeitraum: 0,
		erstelldatum: 0001-01-01,
		erstellzeit: 0001-01-01,
		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: text/jsv
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
		}
	}
}