Tax Filing Service

<back to all web services

CreateZm2022XmlAsync

AsyncUmsatzsteuerZusammenfassende Meldung

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

Requires Authentication
The following routes are available for this service:
POST/CreateZm2022XmlAsyncAn asynchronous service to create xml content that represents a recapitulative tax declaration for 2022.
CreateZm2022XmlBase Parameters:
NameParameterData TypeRequiredDescription
UnternehmerformList<ZmUnternehmer>YesAngaben zum Unternehmen (Company details).
DatenLieferantformstringYesThe details of the provider that submits the tax data.
StagingEnabledformbool?NoShould the processing of the tax data be staged? If true, tax data is not sent to the production ELSTER servers.
ZmUnternehmer Parameters:
NameParameterData TypeRequiredDescription
KnriformstringYesInländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern.
ZulassNrformZulassNrYesTeilnehmernummer für die elektronische Abgabe der Zusammenfassenden Meldung
AnschriftformAnschriftYesAngaben zum Unternehmer
ZmZeilenformList<ZmZeile>YesAllgemeine Daten
ZulassNr Parameters:
NameParameterData TypeRequiredDescription
Zulnr1formZulassNr1YesTeilnehmernummer gemäß § 6 StDüV (Paginierbuchstabe)
Zulnr2formZulassNr2YesTeilnehmernummer gemäß § 6 StDüV
ZulassNr1 Enum:
SDie Zusammenfassende Meldung wurde im ElsterOnline-Portal erfasst und abgesendet.
PÜbermittlung aus dem BZStOnline-Portal.
NERiC-Übermittlungen.
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.
ZmZeile 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
BetragformGeldBetragOhneCent11YesSumme (Euro)
Umsatzart Enum:
DDreiecksgeschäft
LInnergemeinschaftliche Lieferung
SSonstige Leistung
GeldBetragOhneCent11 Parameters:
NameParameterData TypeRequiredDescription
WertformlongNoDer Wert des Geldbetrages.
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 /CreateZm2022XmlAsync HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	unternehmer: 
	[
		{
			knri: String,
			zulassNr: 
			{
				zulnr1: S,
				zulnr2: 00000000
			},
			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,
	stagingEnabled: False
}
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
		}
	}
}