Tax Filing Service

<back to all web services

CreateUmsatzsteuervoranmeldung2021XmlAsync

AsyncUmsatzsteuerVoranmeldung2021

An asynchronous service to create xml content that represents the preliminary VAT return (Umsatzsteuervoranmeldung) for 2021.

Requires Authentication
The following routes are available for this service:
POST/CreateUmsatzsteuervoranmeldung2021XmlAsyncAn asynchronous service to create xml content that represents the preliminary VAT return (Umsatzsteuervoranmeldung) for 2021
CreateUmsatzsteuervoranmeldung2021XmlBase Parameters:
NameParameterData TypeRequiredDescription
UmsatzsteuervoranmeldungformUmsatzsteuervoranmeldung2021YesDie Umsatzsteuervoranmeldung (The preliminary VAT declaration).
CreateUmsatzsteueranmeldung2021XmlBase 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).
EOPformEOP2021NoDie Anbindung zum ELSTER Online Portal (EOP).
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.
EOP2021 Parameters:
NameParameterData TypeRequiredDescription
TransferausgabeformstringNo
Umsatzsteuervoranmeldung2021 Parameters:
NameParameterData TypeRequiredDescription
JahrformintYesDas Jahr der Veranlagung.
ZeitraumformAnmeldungZeitraum?YesAnmeldungszeitraum.
SteuernummerformstringYesSteuernummer
Kz09formKz09YesPflichtkennzahl, welche die Angabe diverser Informationen ermöglicht.
Kz10formGanzenzahl1NoBerichtigte Anmeldung
Kz21formGeldBetragOhneCent13NoNicht steuerbare sonstige Leistungen gemäß § 18b Satz 1 Nummer 2 UStG
Kz22formGanzenzahl1NoBelege
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).
Kz35formGeldBetragOhneCent13Nozu anderen Steuersätzen (Bemessungsgrundlage)
Kz36formGeldBetragMitCent11ENNozu anderen Steuersätzen (Steuer)
Kz37formPositiveGeldBetragMitCent11ENNoMinderung der abziehbaren Vorsteuerbeträge (in der Zeile 55 aus Rechnungen von anderen Unternehmen (§ 15 Absatz 1 Satz 1 Nummer 1 UStG) sowie in den Zeilen 59 und 60 enthalten)
Kz39formPositiveGeldBetragMitCent13ENNoAbzug der festgesetzten Sondervorauszahlung für Dauerfristverlängerung (in der Regel nur in der letzten Voranmeldung des Besteuerungszeitraums auszufüllen)
Kz41formGeldBetragOhneCent13NoInnergemeinschaftliche Lieferungen (§ 4 Nummer 1 Buchstabe b UStG) an Abnehmer mit Umsatzsteuer-Identifikationsnummer
Kz42formGeldBetragOhneCent13NoLieferungen des ersten Abnehmers bei innergemeinschaftlichen Dreiecksgeschäften (§ 25b UStG)
Kz43formGeldBetragOhneCent13NoWeitere steuerfreie Umsätze mit Vorsteuerabzug (zum Beispiel Ausfuhrlieferungen, Umsätze nach § 4 Nummer 2 bis 7 UStG)
Kz44formGeldBetragOhneCent13NoInnergemeinschaftliche Lieferungen (§ 4 Nummer 1 Buchstabe b UStG) neuer Fahrzeuge an Abnehmer ohne Umsatzsteuer-Identifikationsnummer
Kz45formGeldBetragOhneCent13NoÜbrige nicht steuerbare Umsätze (Leistungsort nicht im Inland)
Kz46formGeldBetragOhneCent13NoSonstige Leistungen nach § 3a Absatz 2 UStG eines im übrigen Gemeinschaftsgebiet ansässigen Unternehmers (§ 13b Absatz 1 UStG) (Bemessungsgrundlage)
Kz47formGeldBetragMitCent11ENNoSonstige Leistungen nach § 3a Absatz 2 UStG eines im übrigen Gemeinschaftsgebiet ansässigen Unternehmers (§ 13b Absatz 1 UStG) (Steuer)
Kz48formGeldBetragOhneCent13NoSteuerfreie Umsätze ohne Vorsteuerabzug (zum Beispiel Umsätze nach § 4 Nummer 8 bis 29 UStG)
Kz49formGeldBetragOhneCent13NoInnergemeinschaftliche Lieferungen (§ 4 Nummer 1 Buchstabe b UStG) neuer Fahrzeuge außerhalb eines Unternehmens (§ 2a UStG)
Kz50formPositiveGeldBetragOhneCent13NoMinderung der Bemessungsgrundlage (in den Zeilen 20 bis 24 enthalten)
Kz59formGeldBetragMitCent11ENNoVorsteuerabzug für innergemeinschaftliche Lieferungen neuer Fahrzeuge außerhalb eines Unternehmens (§ 2a UStG) sowie von Kleinunternehmern im Sinne des § 19 Absatz 1 UStG (§ 15 Absatz 4a UStG)
Kz60formGeldBetragOhneCent13NoSteuerpflichtige Umsätze des leistenden Unternehmers, für die der Leistungsempfänger die Steuer nach § 13b Absatz 5 UStG schuldet
Kz61formGeldBetragMitCent11ENNoVorsteuerbeträge aus dem innergemeinschaftlichen Erwerb von Gegenständen (§ 15 Absatz 1 Satz 1 Nummer 3 UStG)
Kz62formGeldBetragMitCent11ENNoEntstandene Einfuhrumsatzsteuer (§ 15 Absatz 1 Satz 1 Nummer 2 UStG))
Kz63formGeldBetragMitCent11ENNoVorsteuerbeträge, die nach allgemeinen Durchschnittssätzen berechnet sind (§§ 23 und 23a UStG)
Kz64formGeldBetragMitCent11ENNoBerichtigung des Vorsteuerabzugs (§ 15a UStG)
Kz65formGeldBetragMitCent11ENNoSteuer infolge des Wechsels der Besteuerungsform sowie Nachsteuer auf versteuerte Anzahlungen und ähnlichem wegen Steuersatzänderung
Kz66formGeldBetragMitCent11ENNoVorsteuerbeträge aus Rechnungen von anderen Unternehmern (§ 15 Absatz 1 Satz 1 Nummer 1 UStG), aus Leistungen im Sinne des § 13a Absatz 1 Nummer 6 UStG (§ 15 Absatz 1 Satz 1 Nummer 5 UStG) und aus innergemeinschaftlichen Dreiecksgeschäften (§ 25b Absatz 5 UStG)
Kz67formGeldBetragMitCent11ENNoVorsteuerbeträge aus Leistungen im Sinne des § 13b UStG (§ 15 Absatz 1 Satz 1 Nummer 4 UStG)
Kz69formGeldBetragMitCent11ENNoIn Rechnungen unrichtig oder unberechtigt ausgewiesene Steuerbeträge (§ 14c UStG) sowie Steuerbeträge, die nach § 6a Absatz 4 Satz 2, § 17 Absatz 1 Satz 7, § 25b Absatz 2 UStG oder von einem Auslagerer oder Lagerhalter nach § 13a Absatz 1 Nummer 6 UStG geschuldet werden
Kz73formGeldBetragOhneCent13NoUmsätze, die unter das GrEStG fallen (§ 13b Absatz 2 Nummer 3 UStG) (Bemessungsgrundlage)
Kz74formGeldBetragMitCent11ENNoUmsätze, die unter das GrEStG fallen (§ 13b Absatz 2 Nummer 3 UStG) (Steuer)
Kz76formGeldBetragOhneCent13NoUmsätze, für die eine Steuer nach § 24 UStG zu entrichten ist (Sägewerkserzeugnisse, Getränke und alkoholische Flüssigkeiten, zum Beispiel Wein) (Bemessungsgrundlage)
Kz77formGeldBetragOhneCent13NoLieferungen land- und forstwirtschaftlicher Betriebe nach § 24 UStG an Abnehmer mit Umsatzsteuer-Identifikationsnummer
Kz80formGeldBetragMitCent11ENNoUmsätze, für die eine Steuer nach § 24 UStG zu entrichten ist (Sägewerkserzeugnisse, Getränke und alkoholische Flüssigkeiten, zum Beispiel Wein) (Steuer)
Kz81formGeldBetragOhneCent13Nozum Steuersatz von 19 Prozent
Kz83formGeldBetragMitCent11ENYesVerbleibende Umsatzsteuer-Vorauszahlung beziehungsweise verbleibender Überschuss
Kz84formGeldBetragOhneCent13NoAndere Leistungen (§ 13b Absatz 2 Nummer 1, 2, 4 bis 12 UStG) (Bemessungsgrundlage)
Kz85formGeldBetragMitCent11ENNoAndere Leistungen (§ 13b Absatz 2 Nummer 1, 2, 4 bis 12 UStG) (Steuer)
Kz86formGeldBetragOhneCent13Nozum Steuersatz von 7 Prozent
Kz89formGeldBetragOhneCent13Nozum Steuersatz von 19 Prozent
Kz91formGeldBetragOhneCent13NoSteuerfreie innergemeinschaftliche Erwerbe von bestimmten Gegenständen und Anlagegold (§§ 4b und 25c UStG)
Kz93formGeldBetragOhneCent13Nozum Steuersatz von 7 Prozent
Kz94formGeldBetragOhneCent13NoErwerbe nach §§ 4b und 25c UStG
Kz95formGeldBetragOhneCent13Nozu anderen Steuersätzen (Bemessungsgrundlage)
Kz96formGeldBetragMitCent11ENNoneuer Fahrzeuge (§ 1b Absatz 2 und 3 UStG) von Lieferern ohne Umsatzsteuer-Identifikationsnummer zum allgemeinen Steuersatz (Steuer)
Kz98formGeldBetragMitCent11ENNozu anderen Steuersätzen (Steuer)
AnmeldungZeitraum Enum:
NameValue
ZR011Erste monatliche Abgabe (Januar).
ZR022Zweite monatliche Abgabe (Februar).
ZR033Dritte monatliche Abgabe (März).
ZR044Vierte monatliche Abgabe (April).
ZR055Fünfte monatliche Abgabe (Mai).
ZR066Sechste monatliche Abgabe (Juni).
ZR077Siebte monatliche Abgabe (Juli).
ZR088Achte monatliche Abgabe (August).
ZR099Neunte monatliche Abgabe (September).
ZR1010 Zehnte monatliche Abgabe (Oktober).
ZR1111Elfte monatliche Abgabe (November).
ZR1212Zwölfte monatliche Abgabe (Dezember).
ZR4141Abgabe im ersten Quartal
ZR4242Abgabe im zweiten Quartal
ZR4343Abgabe im dritten Quartal
ZR4444Abgabe im vierten Quartal
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.
GeldBetragOhneCent13 Parameters:
NameParameterData TypeRequiredDescription
WertformlongNoDer Wert des Geldbetrages.
GeldBetragMitCent11EN Parameters:
NameParameterData TypeRequiredDescription
WertformdoubleNoDer Wert des Geldbetrages
PositiveGeldBetragMitCent11EN Parameters:
NameParameterData TypeRequiredDescription
WertformdoubleNoDer Wert des vorzeichenlosen Geldbetrages.
PositiveGeldBetragMitCent13EN Parameters:
NameParameterData TypeRequiredDescription
WertformdoubleNoDer Wert des vorzeichenlosen Geldbetrages.
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 /CreateUmsatzsteuervoranmeldung2021XmlAsync HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: application/x-msgpack
Content-Type: application/x-msgpack
Content-Length: length

{"umsatzsteuervoranmeldung":{"jahr":0,"zeitraum":"0","steuernummer":"String","kz09":{"herstellerId":0,"beraterName":"String","berufsbezeichnung":"String","beraterTelNrVorwahl":"String","beraterTelNrAnschluss":"String","mandantName":"String"},"kz10":{"wert":0},"kz21":{"wert":0},"kz22":{"wert":0},"kz23":{"wert":0},"kz23_Begruendung":"String","kz26":{"wert":0},"kz29":{"wert":0},"kz35":{"wert":0},"kz36":{"wert":0},"kz37":{"wert":0},"kz39":{"wert":0},"kz41":{"wert":0},"kz42":{"wert":0},"kz43":{"wert":0},"kz44":{"wert":0},"kz45":{"wert":0},"kz46":{"wert":0},"kz47":{"wert":0},"kz48":{"wert":0},"kz49":{"wert":0},"kz50":{"wert":0},"kz59":{"wert":0},"kz60":{"wert":0},"kz61":{"wert":0},"kz62":{"wert":0},"kz63":{"wert":0},"kz64":{"wert":0},"kz65":{"wert":0},"kz66":{"wert":0},"kz67":{"wert":0},"kz69":{"wert":0},"kz73":{"wert":0},"kz74":{"wert":0},"kz76":{"wert":0},"kz77":{"wert":0},"kz80":{"wert":0},"kz81":{"wert":0},"kz83":{"wert":0},"kz84":{"wert":0},"kz85":{"wert":0},"kz86":{"wert":0},"kz89":{"wert":0},"kz91":{"wert":0},"kz93":{"wert":0},"kz94":{"wert":0},"kz95":{"wert":0},"kz96":{"wert":0},"kz98":{"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"},"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"}}}