Tax Filing Service

CreateUmsatzsteuersondervorauszahlung2023Xml

SyncUmsatzsteuerSondervorauszahlung2023

A synchronous service to create XML content that represents the filing of the special advance payment for VAT (Umsatzsteuer-sondervorauszahlung) for 2023.

The following routes are available for this service:
POST	/CreateUmsatzsteuersondervorauszahlung2023Xml	A synchronous service to create xml content that represents the filing of the special advance payment for VAT (Umsatzsteuer-sondervorauszahlung) for 2023

**CreateUmsatzsteuersondervorauszahlung2023Xml** Parameters:
Name	Parameter	Data Type	Required	Description
Umsatzsteuersondervorauszahlung	body	Umsatzsteuersondervorauszahlung2023	Yes	The filing of the special advance payment for VAT
DatenLieferant	body	DatenLieferant	Yes	Natürliche Person, welche die Software bedient, bzw. in deren Namen die Software bedient wird, um die Daten zu übersenden (Natural person who operates the software or under whose name the software is operated in order to transmit the data).
Erstellungsdatum	body	DateTime?	Yes	Das Datum der Erstellung (Date of creation).
Berater	body	Berater	No	Der Steuerberater, der den Steuerfall bearbeitet und abgibt (The tax adviser who processes and submits the tax case).
Mandant	body	Mandant	No	Der Mandant, für den der Steuerfall bearbeitet wird (The client for which the tax case is being processed).
Unternehmer	body	Unternehmer	No	Der natürliche oder jüritische Person, der den Steuerfall bearbeitet und abgibt (The natural or legal person who processes and submits the tax case).
Bundesfinanzamtsnummer	body	string	Yes	Die vierstellige Bundesfinanzamtsnummer des empfangenden Finanzamtes (The four-digit federal tax office number of the receiving tax office).
EOP	body	EOP	No	Die Anbindung zum ELSTER Online Portal (EOP).

**CreateUmsatzsteuersondervorauszahlung2023XmlBase** Parameters:
Name	Parameter	Data Type	Required	Description
Umsatzsteuersondervorauszahlung	form	Umsatzsteuersondervorauszahlung2023	Yes	The filing of the special advance payment for VAT
DatenLieferant	form	DatenLieferant	Yes	Natürliche Person, welche die Software bedient, bzw. in deren Namen die Software bedient wird, um die Daten zu übersenden (Natural person who operates the software or under whose name the software is operated in order to transmit the data).
Erstellungsdatum	form	DateTime?	Yes	Das Datum der Erstellung (Date of creation).
Berater	form	Berater	No	Der Steuerberater, der den Steuerfall bearbeitet und abgibt (The tax adviser who processes and submits the tax case).
Mandant	form	Mandant	No	Der Mandant, für den der Steuerfall bearbeitet wird (The client for which the tax case is being processed).
Unternehmer	form	Unternehmer	No	Der natürliche oder jüritische Person, der den Steuerfall bearbeitet und abgibt (The natural or legal person who processes and submits the tax case).
Bundesfinanzamtsnummer	form	string	Yes	Die vierstellige Bundesfinanzamtsnummer des empfangenden Finanzamtes (The four-digit federal tax office number of the receiving tax office).
EOP	form	EOP	No	Die Anbindung zum ELSTER Online Portal (EOP).

**CreateUmsatzsteueranmeldung2023XmlBase** Parameters:
Name	Parameter	Data Type	Required	Description
DatenLieferant	form	DatenLieferant	Yes	Natürliche Person, welche die Software bedient, bzw. in deren Namen die Software bedient wird, um die Daten zu übersenden (Natural person who operates the software or under whose name the software is operated in order to transmit the data).
Erstellungsdatum	form	DateTime?	Yes	Das Datum der Erstellung (Date of creation).
Berater	form	Berater	No	Der Steuerberater, der den Steuerfall bearbeitet und abgibt (The tax adviser who processes and submits the tax case).
Mandant	form	Mandant	No	Der Mandant, für den der Steuerfall bearbeitet wird (The client for which the tax case is being processed).
Unternehmer	form	Unternehmer	No	Der natürliche oder jüritische Person, der den Steuerfall bearbeitet und abgibt (The natural or legal person who processes and submits the tax case).
Bundesfinanzamtsnummer	form	string	Yes	Die vierstellige Bundesfinanzamtsnummer des empfangenden Finanzamtes (The four-digit federal tax office number of the receiving tax office).
EOP	form	EOP	No	Die Anbindung zum ELSTER Online Portal (EOP).

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

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

**Umsatzsteuersondervorauszahlung2023** Parameters:
Name	Parameter	Data Type	Required	Description
Jahr	form	int	Yes	Das Jahr der Veranlagung.
Steuernummer	form	string	Yes	Steuernummer.
Kz09	form	Kz09	Yes	Fünfstellige HerstellerID (Pflichtangabe wenn der zugehörige Kontext angegeben wird).
Kz10	form	Ganzzahl1EN	No	Berichtigte Anmeldung
Kz23	form	Ganzzahl1EN	No	Über die Angaben in der Steueranmeldung hinaus sind weitere oder abweichende Angaben oder Sachverhalte zu berücksichtigen.
Kz23_Begruendung	form	string	No	Ergänzende Angaben zur Steueranmeldung
Kz26	form	Ganzzahl1EN	No	Das SEPA-Lastschriftmandat wird ausnahmsweise (zum Beispiel wegen Verrechnungswünschen) für diesen Voranmeldungszeitraum widerrufen (falls ja, bitte eine 1 eintragen). Ein gegebenenfalls verbleibender Restbetrag ist gesondert zu entrichten.
Kz29	form	Ganzzahl1EN	No	Verrechnung des Erstattungsbetrags erwünscht / Erstattungsbetrag ist abgetreten (Teilen Sie bitte die Verrechnungswünsche dem Finanzamt gesondert mit).
Kz38	form	PositiverGeldBetragOhneCent13EN	Yes	Summe der verbleibenden Umsatzsteuer-Vorauszahlungen zuzüglich der zu berücksichtigenden Sondervorauszahlung für das Kalenderjahr 2022; davon 1/11 = Sondervorauszahlung 2023.

**Kz09** Parameters:
Name	Parameter	Data Type	Required	Description
HerstellerId	form	int	Yes	Die Bezeichnung des Softwareherstellers (Pflicht), über dessen Software die Steuererklärung oder (Vor)anmeldung abgegeben wird. Die Bezeichnung muss 5-stellig sein.
BeraterName	form	string	No	Der Name des Beraters, welcher die Steuererklärung oder (Vor)anmeldung abgegeben wird. Das Name des Beraters kann von 0- bis 85-stellig sein.
Berufsbezeichnung	form	string	No	Die Berufbezeichnung des Beraters. Die Berufbezeichnung des Beraterskann von 0- bis 85-stellig sein.
BeraterTelNrVorwahl	form	string	No	Die Telefonnummervorwahl des Beraters. Die Telefonnummervorwahl des Beraters kann von 0- bis 85-stellig sein.
BeraterTelNrAnschluss	form	string	No	Der Telefonnummeranschluss des Beraters. Der Telefonnummeranschluss des Beraters kann von 0- bis 85-stellig sein.
MandantName	form	string	No	Der Name des Mandanten. Der Name des Mandanten kann von 0- bis 85-stellig sein.

**Ganzzahl1EN** Parameters:
Name	Parameter	Data Type	Required	Description
Wert	form	int	No	The intrinsic integer value.

**Ganzzahl** Parameters:
Name	Parameter	Data Type	Required	Description
Wert	form	int	No	The intrinsic integer value.

**PositiverGeldBetragOhneCent13EN** Parameters:
Name	Parameter	Data Type	Required	Description
Wert	form	long	No	The intrinsic currency value.

**GrossGeldBetragOhneCent** Parameters:
Name	Parameter	Data Type	Required	Description
Wert	form	long	No	The intrinsic currency value.

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

{"umsatzsteuersondervorauszahlung":{"jahr":0,"steuernummer":"String","kz09":{"herstellerId":0,"beraterName":"String","berufsbezeichnung":"String","beraterTelNrVorwahl":"String","beraterTelNrAnschluss":"String","mandantName":"String"},"kz10":{"wert":0},"kz23":{"wert":0},"kz23_Begruendung":"String","kz26":{"wert":0},"kz29":{"wert":0},"kz38":{"wert":0}},"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"},"bundesfinanzamtsnummer":"String","eop":{"transferausgabe":"String"}}

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"}}}