Tax Filing Service

<back to all web services

CreateUmsatzsteuersondervorauszahlung2021XmlAsync

AsyncUmsatzsteuerSondervorauszahlung2021

An asynchronous service to create xml content that represents the filing of the special advance payment for VAT (Umsatzsteuer-sondervorauszahlung) for 2021.

Requires Authentication
The following routes are available for this service:
POST/CreateUmsatzsteuersondervorauszahlung2021XmlAsyncAn asynchronous service to create xml content that represents the filing of the special advance payment for VAT (Umsatzsteuer-sondervorauszahlung) for 2021
CreateUmsatzsteuersondervorauszahlung2021XmlAsync Parameters:
NameParameterData TypeRequiredDescription
UmsatzsteuersondervorauszahlungbodyUmsatzsteuersondervorauszahlung2021YesThe filing of the special advance payment for VAT
DatenLieferantbodyDatenLieferantYesNatü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).
ErstellungsdatumbodyDateTime?YesDas Datum der Erstellung (Date of creation).
BeraterbodyBeraterNoDer Steuerberater, der den Steuerfall bearbeitet und abgibt (The tax adviser who processes and submits the tax case).
MandantbodyMandantNoDer Mandant, für den der Steuerfall bearbeitet wird (The client for which the tax case is being processed).
UnternehmerbodyUnternehmerNoDer natürliche oder jüritische Person, der den Steuerfall bearbeitet und abgibt (The natural or legal person who processes and submits the tax case).
BundesfinanzamtsnummerbodystringYesDie vierstellige Bundesfinanzamtsnummer des empfangenden Finanzamtes (The four-digit federal tax office number of the receiving tax office).
EOPbodyEOPNoDie Anbindung zum ELSTER Online Portal (EOP).
CreateUmsatzsteuersondervorauszahlung2021XmlBase Parameters:
NameParameterData TypeRequiredDescription
UmsatzsteuersondervorauszahlungformUmsatzsteuersondervorauszahlung2021YesThe filing of the special advance payment for VAT
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).
EOPformEOPNoDie Anbindung zum ELSTER Online Portal (EOP).
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).
EOPformEOPNoDie Anbindung zum ELSTER Online Portal (EOP).
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.
EOP Parameters:
NameParameterData TypeRequiredDescription
TransferausgabeformstringNo
Umsatzsteuersondervorauszahlung2021 Parameters:
NameParameterData TypeRequiredDescription
JahrformintYesDas Jahr der Veranlagung.
SteuernummerformstringYesSteuernummer.
Kz09formKz09YesPflichtkennzahl, welche die Angabe diverser Informationen ermöglicht.
Kz10formGanzzahl1ENNoBerichtigte Anmeldung
Kz23formGanzzahl1ENNoÜber die Angaben in der Steueranmeldung hinaus sind weitere oder abweichende Angaben oder Sachverhalte zu berücksichtigen.
Kz23_BegruendungformstringNoErgänzende Angaben zur Steueranmeldung
Kz26formGanzzahl1ENNoDas 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.
Kz29formGanzzahl1ENNoVerrechnung des Erstattungsbetrags erwünscht / Erstattungsbetrag ist abgetreten (falls ja, bitte eine 1 eintragen).
Kz38formPositiverGeldBetragOhneCent13ENYesSumme der verbleibenden Umsatzsteuer-Vorauszahlungen zuzüglich der zu berücksichtigenden Sondervorauszahlung für das Kalenderjahr 2020; davon 1/11 = Sondervorauszahlung 2021.
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.
Ganzzahl1EN Parameters:
NameParameterData TypeRequiredDescription
WertformintNoThe intrinsic integer value.
Ganzzahl Parameters:
NameParameterData TypeRequiredDescription
WertformintNoThe intrinsic integer value.
PositiverGeldBetragOhneCent13EN Parameters:
NameParameterData TypeRequiredDescription
WertformlongNoThe intrinsic currency value.
GrossGeldBetragOhneCent Parameters:
NameParameterData TypeRequiredDescription
WertformlongNoThe intrinsic currency value.
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 .xml suffix or ?format=xml

HTTP + XML

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

POST /CreateUmsatzsteuersondervorauszahlung2021XmlAsync HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreateUmsatzsteuersondervorauszahlung2021XmlAsync xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Umsatzsteuer.Requests">
  <Berater>
    <Bezeichnung>String</Bezeichnung>
    <Name>String</Name>
    <Namensvorsatz>String</Namensvorsatz>
    <Namenszusatz>String</Namenszusatz>
    <Str>String</Str>
    <Hausnummer>String</Hausnummer>
    <HNrZusatz>String</HNrZusatz>
    <AnschriftenZusatz>String</AnschriftenZusatz>
    <Ort>String</Ort>
    <PLZ>String</PLZ>
    <AuslandsPLZ>String</AuslandsPLZ>
    <Land>String</Land>
    <PostfachOrt>String</PostfachOrt>
    <Postfach>String</Postfach>
    <PostfachPLZ>String</PostfachPLZ>
    <GKPLZ>String</GKPLZ>
    <Telefon>String</Telefon>
    <Email>String</Email>
  </Berater>
  <Bundesfinanzamtsnummer>String</Bundesfinanzamtsnummer>
  <DatenLieferant>
    <Name>String</Name>
    <Strasse>String</Strasse>
    <PLZ>String</PLZ>
    <Ort>String</Ort>
    <Telefon>String</Telefon>
    <Email>String</Email>
  </DatenLieferant>
  <EOP>
    <Transferausgabe>String</Transferausgabe>
  </EOP>
  <Erstellungsdatum>0001-01-01T00:00:00</Erstellungsdatum>
  <Mandant>
    <Name>String</Name>
    <Vorname>String</Vorname>
    <MandantenNr>String</MandantenNr>
    <Bearbeiterkennzeichen>String</Bearbeiterkennzeichen>
  </Mandant>
  <Unternehmer>
    <Bezeichnung>String</Bezeichnung>
    <Name>String</Name>
    <Namensvorsatz>String</Namensvorsatz>
    <Namenszusatz>String</Namenszusatz>
    <Str>String</Str>
    <Hausnummer>String</Hausnummer>
    <HNrZusatz>String</HNrZusatz>
    <AnschriftenZusatz>String</AnschriftenZusatz>
    <Ort>String</Ort>
    <PLZ>String</PLZ>
    <AuslandsPLZ>String</AuslandsPLZ>
    <Land>String</Land>
    <PostfachOrt>String</PostfachOrt>
    <Postfach>String</Postfach>
    <PostfachPLZ>String</PostfachPLZ>
    <GKPLZ>String</GKPLZ>
    <Telefon>String</Telefon>
    <Email>String</Email>
  </Unternehmer>
  <Umsatzsteuersondervorauszahlung>
    <Jahr>0</Jahr>
    <Steuernummer>String</Steuernummer>
    <Kz09>00000*String*String*String*String*String</Kz09>
    <Kz10>0</Kz10>
    <Kz23>0</Kz23>
    <Kz23_Begruendung>String</Kz23_Begruendung>
    <Kz26>0</Kz26>
    <Kz29>0</Kz29>
    <Kz38>0</Kz38>
  </Umsatzsteuersondervorauszahlung>
</CreateUmsatzsteuersondervorauszahlung2021XmlAsync>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<XmlResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Responses">
  <Content>String</Content>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
</XmlResponse>