Tax Filing Service

CreateZm2024XmlAsync

AsyncUmsatzsteuerZusammenfassende Meldung

An asynchronous service to create xml content that represents a recapitulative tax declaration for 2024.

The following routes are available for this service:
POST	/CreateZm2024XmlAsync	An asynchronous service to create xml content that represents a recapitulative tax declaration for 2024.

**CreateZm2024XmlAsync** Parameters:
Name	Parameter	Data Type	Required	Description
Knri	body	string	Yes	Inländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern.
Anschrift	body	Anschrift	Yes	Angaben zum Unternehmer
ZmZeilen	body	ZmZeilen	Yes	Allgemeine Daten
DatenLieferant	body	string	Yes	The details of the provider that submits the tax data.

**CreateZm2024XmlBase** Parameters:
Name	Parameter	Data Type	Required	Description
Knri	form	string	Yes	Inländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern.
Anschrift	form	Anschrift	Yes	Angaben zum Unternehmer
ZmZeilen	form	ZmZeilen	Yes	Allgemeine Daten
DatenLieferant	form	string	Yes	The details of the provider that submits the tax data.

**Anschrift** Parameters:
Name	Parameter	Data Type	Required	Description
Name	form	string	Yes	Der Name des Unternehmers.
Adresszusatz	form	string	No	Der Adresszusatz des Unternehmers.
Strasse	form	string	Yes	Der Straßenname des Unternehmers.
Hausnr	form	string	No	Die Hausnummer des Unternehmers.
Hausnrzusatz	form	string	No	Der Hausnummerzusatz des Unternehmers.
Ort	form	string	Yes	Der Ort des Unternehmers.
PLZ	form	string	No	Die Postleitzahl des Unternehmers.
Staat	form	string	Yes	Übermittlung des ISO-3166-Alpha-2-Codes des Staates von Unternehmer.
Telefon	form	string	No	Die Telefonummer des Unternehmers.

**ZmZeilen** Parameters:
Name	Parameter	Data Type	Required	Description
Waehrung	form	Waehrung	Yes	Währung
Meldeart	form	Meldeart	Yes	Berichtigte Meldung
Anzeige	form	bool	Yes	Die in § 18a Absatz 1 Satz 2 UStG enthaltene Regelung nehme ich nicht in Anspruch. Ich gebe die Zusammenfassende Meldung künftig monatlich ab. Diese Anzeige bindet mich bis zum Zeitpunkt des Widerrufs, mindestens aber für die Dauer von 12 Kalendermonaten.
Widerruf	form	bool	Yes	Widerruf meiner Anzeige nach § 18a Absatz 1 UStG
Mzr	form	Mzr	Yes	Meldungszeitraum
Zeilen	form	List<Zeile>	Yes	Meldungen der Warenlieferungen

**Waehrung** Enum:
UNGUELTIG	Währung ist ungültig.
EUR	Die Euro-Währung

**Meldeart** Enum:
Name	Value
Nein	10	Nein: Erstmeldung
Ja	11	Ja: Berichtigte Anmeldung

**Mzr** Parameters:
Name	Parameter	Data Type	Required	Description
Quart	form	Quart	Yes	Quartal
Jahr	form	int	Yes	Die 4-stellige Jahreszahl, welche die Veranlagungszeitraum darstellt.

**Quart** Enum:
Name	Value
Q1	1	Quartal 1
Q2	2	Quartal 2
Q3	3	Quartal 3
Q4	4	Quartal 4
JM	5	Jahresmeldung
M11	11	2-Monat-ZM Jan-Feb
M12	12	2-Monat-ZM April-Mai
M13	13	2-Monat-ZM Juli-Aug
M14	14	Die Art des Quartals
M21	21	Monats-ZM Januar
M22	22	Monats-ZM Februar
M23	23	Monats-ZM März
M24	24	Die Art des Quartals
M25	25	Monats-ZM Mai
M26	26	Monats-ZM Juni
M27	27	Monats-ZM Juli
M28	28	Monats-ZM August
M29	29	Monats-ZM September
M30	30	DMonats-ZM Oktober
M31	31	Monats-ZM November
M32	32	Monats-ZM Dezember

**Zeile** Parameters:
Name	Parameter	Data Type	Required	Description
Umsatzart	form	Umsatzart	Yes	Umsatzart
Knre	form	string	Yes	Umsatzsteuer-Identifikationsnummer des Erwerbers / Unternehmers in einem anderen Mitgliedstaat
Betrag	form	GeldBetragOhneCent11EN	Yes	Summe (Euro)

**Umsatzart** Enum:
D	Dreiecksgeschäft
L	Innergemeinschaftliche Lieferung
S	Sonstige Leistung

**GeldBetragOhneCent11EN** 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 .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 /CreateZm2024XmlAsync HTTP/1.1 
Host: taxfiling.staging.pwc.de 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreateZm2024XmlAsync xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Umsatzsteuer.Requests">
  <Anschrift>
    <name>String</name>
    <adresszusatz>String</adresszusatz>
    <strasse>String</strasse>
    <hausnr>String</hausnr>
    <plz>String</plz>
    <ort>String</ort>
    <staat>String</staat>
    <telefon>String</telefon>
  </Anschrift>
  <DatenLieferant>String</DatenLieferant>
  <Knri>String</Knri>
  <ZmZeilen waehrung="0" meldeart="10">
    <anzeige>false</anzeige>
    <widerruf>false</widerruf>
    <mzr>
      <quart>1</quart>
      <jahr>0</jahr>
    </mzr>
    <zeile umsatzart="D">
      <knre>String</knre>
      <betrag>0</betrag>
    </zeile>
  </ZmZeilen>
</CreateZm2024XmlAsync>

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>