Tax Filing Service

CreateUstSvXmlFromDefinitionAsync

AsyncUmsatzsteuerSondervorauszahlungReturnBuilderDefinition

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.

The following routes are available for this 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

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

**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

**DatenLieferant** Parameters:
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.
Email	form	string	No	Die Email-Adresse (optional) des Datenlieferant.

**Berater** Parameters:
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.
Email	form	string	No	Die Emailadresse (optional) des Beraters.

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

**Unternehmer** Parameters:
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.
Email	form	string	No	Die Emailadresse (optional) des Unternehmers.

**EOP2022** Parameters:
Name	Parameter	Data Type	Required	Description
Transferausgabe	form	string	No

**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 /CreateUstSvXmlFromDefinitionAsync HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	bundesfinanzamtsnummer: String,
	datenLieferant: 
	{
		name: String,
		strasse: String,
		plz: String,
		ort: String,
		telefon: String,
		email: String
	},
	erstellungsdatum: 0001-01-01,
	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/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
		}
	}
}