Tax Filing Service

<back to all web services

CreateUmsatzsteuersondervorauszahlung2020Xml

SyncUmsatzsteuerSondervorauszahlung2020

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

Requires Authentication
The following routes are available for this service:
POST/CreateUmsatzsteuersondervorauszahlung2020XmlA synchronous service to create xml content that represents the filing of the special advance payment for VAT (Umsatzsteuer-sondervorauszahlung) for 2020
CreateUmsatzsteuersondervorauszahlung2020XmlBase Parameters:
NameParameterData TypeRequiredDescription
UmsatzsteuersondervorauszahlungformUmsatzsteuersondervorauszahlung2020YesThe filing of the special advance payment for VAT
CreateUmsatzsteueranmeldung2020XmlBase Parameters:
NameParameterData TypeRequiredDescription
DatenLieferantformDatenLieferantYesNatü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).
ErstellungsdatumformDateTime?YesDas Datum der Erstellung (Date of creation).
BeraterformBeraterNoDer Steuerberater, der den Steuerfall bearbeitet und abgibt (The tax adviser who processes and submits the tax case).
MandantformMandantNoDer Mandant, für den der Steuerfall bearbeitet wird (The client for which the tax case is being processed).
UnternehmerformUnternehmerNoDer natürliche oder jüritische Person, der den Steuerfall bearbeitet und abgibt (The natural or legal person who processes and submits the tax case).
BundesfinanzamtsnummerformstringYesDie vierstellige Bundesfinanzamtsnummer des empfangenden Finanzamtes (The four-digit federal tax office number of the receiving tax office).
StagingEnabledformbool?NoShould the processing of the tax data be staged? If true, tax data is not sent to the production ELSTER servers.
DatenLieferant Parameters:
NameParameterData TypeRequiredDescription
NameformstringYesDer Name des Datenlieferants.
StrasseformstringYesDer Straßenname des Datenlieferants.
PLZformstringYesDie Postleitzahl des Datenlieferants.
OrtformstringYesDer Ort des Datenlieferants.
TelefonformstringNoDie Telefonnummer (optional) des Datenlieferants.
EmailformstringNoDie Email-Adresse (optional) des Datenlieferant.
Berater Parameters:
NameParameterData TypeRequiredDescription
BezeichnungformstringNoDer Bezeichnung (optional) des Beraters (normalerweise der Name des Beraters Unternehmen).
NameformstringNoDer Name (optional) des Beraters.
VornameformstringNoDer Vorname (optional) des Beraters.
NamensvorsatzformstringNoDer Namenvorsatz (optional) des Beraters.
NamenszusatzformstringNoDer Namenzusatz (optional) des Beraters.
StrformstringNoDer Straßenname (optional) des Beraters.
HausnummerformstringNoDie Hausnummer (optional) des Beraters.
HNrZusatzformstringNoDer Hausnummernzusatz (optional) des Beraters.
AnschriftenZusatzformstringNoDer Anschriftenzusatz (optional) des Beraters.
OrtformstringNoDer Ort (optional) des Beraters.
PLZformstringNoDie Postleitzahl (optional) des Beraters.
AuslandsPLZformstringNoDie Auslandspostleitzahl (optional) des Beraters.
LandformstringNoDer Ländername (falls Anschrift im Ausland) des Beraters - optional. Der Ländername des Beraters kann mit 1-20 alphanumerischen Zeichen geliefert werden.
PostfachOrtformstringNoDer Ort des Postfaches (optional) des Beraters.
PostfachformstringNoDas Postfach (optional) des Beraters.
PostfachPLZformstringNoDie Postleitzahl (optional) des Beraters.
GKPLZformstringNoDie Großkundenpostleitzahl (optional) des Beraters.
TelefonformstringNoDie Telefonnummer (optional) des Beraters.
EmailformstringNoDie Emailadresse (optional) des Beraters.
Mandant Parameters:
NameParameterData TypeRequiredDescription
NameformstringNoDer Name (optional) des Mandanten.
VornameformstringNoDer Vorname (optional) des Mandanten.
MandantenNrformstringNoDie Mandantennummer (optional) des Mandanten.
BearbeiterkennzeichenformstringNoDas Bearbeiterkennzeichen (optional) des Mandanten.
Unternehmer Parameters:
NameParameterData TypeRequiredDescription
BezeichnungformstringNoDer Bezeichnung (optional) des Unternehmers (normalerweise der Name des Unternehmers Unternehmen).
NameformstringNoDer Name (optional) des Unternehmers.
VornameformstringNoDer Vorname (optional) des Unternehmers.
NamensvorsatzformstringNoDer Namenvorsatz (optional) des Unternehmers.
NamenszusatzformstringNoDer Namenzusatz (optional) des Unternehmers.
StrformstringNoDer Straßenname (optional) des Unternehmers.
HausnummerformstringNoDie Hausnummer (optional) des Unternehmers.
HNrZusatzformstringNoDer Hausnummernzusatz (optional) des Unternehmers.
AnschriftenZusatzformstringNoDer Anschriftenzusatz (optional) des Unternehmers.
OrtformstringNoDer Ort (optional) des Unternehmers.
PLZformstringNoDie Postleitzahl (optional) des Unternehmers.
AuslandsPLZformstringNoDie Auslandspostleitzahl (optional) des Unternehmers.
LandformstringNoDer Ländername (falls Anschrift im Ausland) des Unternehmers - optional. Der Ländername des Unternehmers kann mit 1-20 alphanumerischen Zeichen geliefert werden.
PostfachOrtformstringNoDer Ort des Postfaches (optional) des Unternehmers.
PostfachformstringNoDas Postfach (optional) des Unternehmers.
PostfachPLZformstringNoDie Postleitzahl (optional) des Unternehmers.
GKPLZformstringNoDie Großkundenpostleitzahl (optional) des Unternehmers.
TelefonformstringNoDie Telefonnummer (optional) des Unternehmers.
EmailformstringNoDie Emailadresse (optional) des Unternehmers.
Umsatzsteuersondervorauszahlung2020 Parameters:
NameParameterData TypeRequiredDescription
JahrformintYesDas Jahr der Veranlagung.
SteuernummerformstringYesSteuernummer.
Kz09formKz09YesPflichtkennzahl, welche die Angabe diverser Informationen ermöglicht.
Kz10formGanzenzahl1NoBerichtigte Anmeldung
Kz23formGanzenzahl1NoÜber die Angaben in der Steueranmeldung hinaus sind weitere oder abweichende Angaben oder Sachverhalte zu berücksichtigen.
Kz23_BegruendungformstringNoErgänzende Angaben zur Steueranmeldung
Kz26formGanzenzahl1NoDas 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.
Kz29formGanzenzahl1NoVerrechnung des Erstattungsbetrags erwünscht / Erstattungsbetrag ist abgetreten (falls ja, bitte eine 1 eintragen).
Kz38formPositiveGeldBetragOhneCent13YesSumme der verbleibenden Umsatzsteuer-Vorauszahlungen zuzüglich der zu berücksichtigenden Sondervorauszahlung für das Kalenderjahr $VZ-1$; davon 1/11 = Sondervorauszahlung $VZ$.
Kz09 Parameters:
NameParameterData TypeRequiredDescription
HerstellerIdformintYesDie Bezeichnung des Softwareherstellers (Pflicht), über dessen Software die Steuererklärung oder (Vor)anmeldung abgegeben wird. Die Bezeichnung muss 5-stellig sein.
BeraterNameformstringNoDer Name des Beraters, welcher die Steuererklärung oder (Vor)anmeldung abgegeben wird. Das Name des Beraters kann von 0- bis 85-stellig sein.
BerufsbezeichnungformstringNoDie Berufbezeichnung des Beraters. Die Berufbezeichnung des Beraterskann von 0- bis 85-stellig sein.
BeraterTelNrVorwahlformstringNoDie Telefonnummervorwahl des Beraters. Die Telefonnummervorwahl des Beraters kann von 0- bis 85-stellig sein.
BeraterTelNrAnschlussformstringNoDer Telefonnummeranschluss des Beraters. Der Telefonnummeranschluss des Beraters kann von 0- bis 85-stellig sein.
MandantNameformstringNoDer Name des Mandanten. Der Name des Mandanten kann von 0- bis 85-stellig sein.
Ganzenzahl1 Parameters:
NameParameterData TypeRequiredDescription
WertformintNoDer Wert der Ganzenzahl.
PositiveGeldBetragOhneCent13 Parameters:
NameParameterData TypeRequiredDescription
WertformlongNoDer Wert des vorzeichenlosen Geldbetrages.
XmlResponse Parameters:
NameParameterData TypeRequiredDescription
ContentformstringNoThe XML-based content of the response.
ResponseStatusformResponseStatusNoMetadata that contains structured error information on the XML response.

To override the Content-type in your clients, use the HTTP Accept Header, append the .x-msgpack suffix or ?format=x-msgpack

HTTP + X-MSGPACK

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

POST /CreateUmsatzsteuersondervorauszahlung2020Xml HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: application/x-msgpack
Content-Type: application/x-msgpack
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","stagingEnabled":false}
HTTP/1.1 200 OK
Content-Type: application/x-msgpack
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"}}}