Tax Filing Service

<back to all web services

CreateZm2020Xml

SyncUmsatzsteuerZusammenfassende Meldung

A synchronous service to create XML content that represents a recapitulative tax declaration for 2020.

Requires Authentication
The following routes are available for this service:
POST/CreateZm2020XmlA synchronous service to create xml content that represents a recapitulative tax declaration for 2020.
CreateZm2020Xml Parameters:
NameParameterData TypeRequiredDescription
KnribodystringYesInländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern.
AnschriftbodyAnschriftYesAngaben zum Unternehmer
ZmZeilenbodyZmZeilenYesAllgemeine Daten
DatenLieferantbodystringYesThe details of the provider that submits the tax data.
CreateZm2020XmlBase Parameters:
NameParameterData TypeRequiredDescription
KnriformstringYesInländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern.
AnschriftformAnschriftYesAngaben zum Unternehmer
ZmZeilenformZmZeilenYesAllgemeine Daten
DatenLieferantformstringYesThe details of the provider that submits the tax data.
Anschrift Parameters:
NameParameterData TypeRequiredDescription
NameformstringYesDer Name des Unternehmers.
AdresszusatzformstringNoDer Adresszusatz des Unternehmers.
StrasseformstringYesDer Straßenname des Unternehmers.
HausnrformstringNoDie Hausnummer des Unternehmers.
HausnrzusatzformstringNoDer Hausnummerzusatz des Unternehmers.
OrtformstringYesDer Ort des Unternehmers.
PLZformstringNoDie Postleitzahl des Unternehmers.
StaatformstringYesÜbermittlung des ISO-3166-Alpha-2-Codes des Staates von Unternehmer.
TelefonformstringNoDie Telefonummer des Unternehmers.
ZmZeilen Parameters:
NameParameterData TypeRequiredDescription
WaehrungformWaehrungYesWährung
MeldeartformMeldeartYesBerichtigte Meldung
AnzeigeformboolYesDie 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.
WiderrufformboolYesWiderruf meiner Anzeige nach § 18a Absatz 1 UStG
MzrformMzrYesMeldungszeitraum
ZeilenformList<Zeile>YesMeldungen der Warenlieferungen
Waehrung Enum:
UNGUELTIGWährung ist ungültig.
EURDie Euro-Währung
Meldeart Enum:
NameValue
Nein10Nein: Erstmeldung
Ja11Ja: Berichtigte Anmeldung
Mzr Parameters:
NameParameterData TypeRequiredDescription
QuartformQuartYesQuartal
JahrformintYesDie 4-stellige Jahreszahl, welche die Veranlagungszeitraum darstellt.
Quart Enum:
NameValue
Q11Quartal 1
Q22Quartal 2
Q33Quartal 3
Q44Quartal 4
JM5Jahresmeldung
M11112-Monat-ZM Jan-Feb
M12122-Monat-ZM April-Mai
M13132-Monat-ZM Juli-Aug
M1414Die Art des Quartals
M2121Monats-ZM Januar
M2222Monats-ZM Februar
M2323Monats-ZM März
M2424Die Art des Quartals
M2525Monats-ZM Mai
M2626Monats-ZM Juni
M2727Monats-ZM Juli
M2828Monats-ZM August
M2929Monats-ZM September
M3030DMonats-ZM Oktober
M3131Monats-ZM November
M3232Monats-ZM Dezember
Zeile Parameters:
NameParameterData TypeRequiredDescription
UmsatzartformUmsatzartYesUmsatzart
KnreformstringYesUmsatzsteuer-Identifikationsnummer des Erwerbers / Unternehmers in einem anderen Mitgliedstaat
BetragformGeldBetragOhneCent11ENYesSumme (Euro)
Umsatzart Enum:
DDreiecksgeschäft
LInnergemeinschaftliche Lieferung
SSonstige Leistung
GeldBetragOhneCent11EN 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 .jsv suffix or ?format=jsv

HTTP + JSV

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.pwc.de 
Accept: text/jsv
Content-Type: text/jsv
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: text/jsv
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
		}
	}
}