POST | /CreateUstSvXmlFromDefinition | A synchronous 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. |
---|
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. |
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. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Jahr | form | int | Yes | The year of the assessment |
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. |
form | string | No | Die Email-Adresse (optional) des Datenlieferant. |
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. |
form | string | No | Die Emailadresse (optional) des Beraters. |
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. |
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. |
form | string | No | Die Emailadresse (optional) des Unternehmers. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Transferausgabe | form | string | No |
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 .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /CreateUstSvXmlFromDefinition HTTP/1.1
Host: taxfiling.pwc.de
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<CreateUstSvXmlFromDefinition xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Umsatzsteuer.ReturnBuilder.Requests">
<Jahr>0</Jahr>
<Properties xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:KeyValueOfstringstring>
<d2p1:Key>String</d2p1:Key>
<d2p1:Value>String</d2p1:Value>
</d2p1:KeyValueOfstringstring>
</Properties>
<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>
</CreateUstSvXmlFromDefinition>
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.Umsatzsteuer.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>