Tax Filing Service
| POST | /CreateZm2020Xml | A synchronous service to create xml content that represents a recapitulative tax declaration for 2020. |
|---|
| 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. |
| 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. |
| 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. |
| 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 |
| UNGUELTIG | Währung ist ungültig. |
| EUR | Die Euro-Währung |
| Name | Value | |
|---|---|---|
| Nein | 10 | Nein: Erstmeldung |
| Ja | 11 | Ja: Berichtigte Anmeldung |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Quart | form | Quart | Yes | Quartal |
| Jahr | form | int | Yes | Die 4-stellige Jahreszahl, welche die Veranlagungszeitraum darstellt. |
| 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 |
| 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) |
| D | Dreiecksgeschäft |
| L | Innergemeinschaftliche Lieferung |
| S | Sonstige Leistung |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Wert | form | long | No | The intrinsic currency value. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Wert | form | long | No | The intrinsic currency value. |
| 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 .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /CreateZm2020Xml HTTP/1.1
Host: taxfiling.staging.pwc.de
Accept: application/json
Content-Type: application/json
Content-Length: length
{"knri":"String","anschrift":{"name":"String","adresszusatz":"String","strasse":"String","hausnr":"String","hausnrzusatz":"String","ort":"String","plz":"String","staat":"String","telefon":"String"},"zmZeilen":{"waehrung":"UNGUELTIG","meldeart":"Nein","anzeige":false,"widerruf":false,"mzr":{"quart":"Q1","jahr":0},"zeilen":[{"umsatzart":"D","knre":"String","betrag":{"wert":0}}]},"datenLieferant":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
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"}}}