Tax Filing Service

<back to all web services

CreateZm2018Xml

SyncUmsatzsteuerZusammenfassende Meldung

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

Requires Authentication
The following routes are available for this service:
POST/CreateZm2018XmlA synchronous service to create xml content that represents a recapitulative tax declaration for 2018.

/** @description Angaben zum Unternehmen */
// @Api(Description="Angaben zum Unternehmen")
export class Anschrift
{
    /** @description Der Name des Unternehmers. */
    // @ApiMember(Description="Der Name des Unternehmers.", IsRequired=true, Name="Name")
    public name: string;

    /** @description Der Adresszusatz des Unternehmers. */
    // @ApiMember(Description="Der Adresszusatz des Unternehmers.", Name="Adresszusatz")
    public adresszusatz?: string;

    /** @description Der Straßenname des Unternehmers. */
    // @ApiMember(Description="Der Straßenname des Unternehmers.", IsRequired=true, Name="Strasse")
    public strasse: string;

    /** @description Die Hausnummer des Unternehmers. */
    // @ApiMember(Description="Die Hausnummer des Unternehmers.", Name="Hausnr")
    public hausnr?: string;

    /** @description Der Hausnummerzusatz des Unternehmers. */
    // @ApiMember(Description="Der Hausnummerzusatz des Unternehmers.", Name="Hausnrzusatz")
    public hausnrzusatz?: string;

    /** @description Der Ort des Unternehmers. */
    // @ApiMember(Description="Der Ort des Unternehmers.", IsRequired=true, Name="Ort")
    public ort: string;

    /** @description Die Postleitzahl des Unternehmers. */
    // @ApiMember(Description="Die Postleitzahl des Unternehmers.", Name="PLZ")
    public plz?: string;

    /** @description Übermittlung des ISO-3166-Alpha-2-Codes des Staates von Unternehmer. */
    // @ApiMember(Description="Übermittlung des ISO-3166-Alpha-2-Codes des Staates von Unternehmer.", IsRequired=true, Name="Staat")
    public staat: string;

    /** @description Die Telefonummer des Unternehmers. */
    // @ApiMember(Description="Die Telefonummer des Unternehmers.", Name="Telefon")
    public telefon?: string;

    public constructor(init?: Partial<Anschrift>) { (Object as any).assign(this, init); }
}

/** @description Die Art der Währung */
export enum Waehrung
{
    UNGUELTIG = 'UNGUELTIG',
    EUR = 'EUR',
}

/** @description Art der Meldung */
export enum Meldeart
{
    Nein = 10,
    Ja = 11,
}

/** @description Die Art des Quartals */
export enum Quart
{
    Q1 = 1,
    Q2 = 2,
    Q3 = 3,
    Q4 = 4,
    JM = 5,
    M11 = 11,
    M12 = 12,
    M13 = 13,
    M14 = 14,
    M21 = 21,
    M22 = 22,
    M23 = 23,
    M24 = 24,
    M25 = 25,
    M26 = 26,
    M27 = 27,
    M28 = 28,
    M29 = 29,
    M30 = 30,
    M31 = 31,
    M32 = 32,
}

/** @description Meldungszeitraum */
// @Api(Description="Meldungszeitraum")
export class Mzr
{
    /** @description Quartal */
    // @ApiMember(Description="Quartal", IsRequired=true, Name="Quart")
    public quart: Quart;

    /** @description Die 4-stellige Jahreszahl, welche die Veranlagungszeitraum darstellt. */
    // @ApiMember(Description="Die 4-stellige Jahreszahl, welche die Veranlagungszeitraum darstellt.", IsRequired=true, Name="Jahr")
    public jahr: number;

    public constructor(init?: Partial<Mzr>) { (Object as any).assign(this, init); }
}

/** @description Die Art des Umsatzes. */
export enum Umsatzart
{
    D = 'D',
    L = 'L',
    S = 'S',
}

/** @description Specifies an amount of money without cents with limits and a specialized string representation */
// @Api(Description="Specifies an amount of money without cents with limits and a specialized string representation")
export class GrossGeldBetragOhneCent
{
    /** @description The intrinsic currency value. */
    // @ApiMember(Description="The intrinsic currency value.")
    public wert: number;

    public constructor(init?: Partial<GrossGeldBetragOhneCent>) { (Object as any).assign(this, init); }
}

/** @description Represents an amount of money without cents whose value has a maximum length of 11 digits. That is, 1 to 11 digits. Minus sign allowed. */
// @Api(Description="Represents an amount of money without cents whose value has a maximum length of 11 digits. That is, 1 to 11 digits. Minus sign allowed.")
export class GeldBetragOhneCent11EN extends GrossGeldBetragOhneCent
{
    /** @description The intrinsic currency value. */
    // @ApiMember(Description="The intrinsic currency value.")
    public wert: number;

    public constructor(init?: Partial<GeldBetragOhneCent11EN>) { super(init); (Object as any).assign(this, init); }
}

/** @description Meldung der Warenlieferungen */
// @Api(Description="Meldung der Warenlieferungen")
export class Zeile
{
    /** @description Umsatzart */
    // @ApiMember(Description="Umsatzart", IsRequired=true, Name="Umsatzart")
    public umsatzart: Umsatzart;

    /** @description Umsatzsteuer-Identifikationsnummer des Erwerbers / Unternehmers in einem anderen Mitgliedstaat */
    // @ApiMember(Description="Umsatzsteuer-Identifikationsnummer des Erwerbers / Unternehmers in einem anderen Mitgliedstaat", IsRequired=true, Name="Knre")
    public knre: string;

    /** @description Summe (Euro) */
    // @ApiMember(Description="Summe (Euro)", IsRequired=true, Name="Betrag")
    public betrag: GeldBetragOhneCent11EN;

    public constructor(init?: Partial<Zeile>) { (Object as any).assign(this, init); }
}

/** @description Allgemeine Daten */
// @Api(Description="Allgemeine Daten")
export class ZmZeilen
{
    /** @description Währung */
    // @ApiMember(Description="Währung", IsRequired=true, Name="Waehrung")
    public waehrung: Waehrung;

    /** @description Berichtigte Meldung */
    // @ApiMember(Description="Berichtigte Meldung", IsRequired=true, Name="Meldeart")
    public meldeart: Meldeart;

    /** @description 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. */
    // @ApiMember(Description="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.", IsRequired=true, Name="Meldeart")
    public anzeige: boolean;

    /** @description Widerruf meiner Anzeige nach § 18a Absatz 1 UStG */
    // @ApiMember(Description="Widerruf meiner Anzeige nach § 18a Absatz 1 UStG", IsRequired=true, Name="Widerruf")
    public widerruf: boolean;

    /** @description Meldungszeitraum */
    // @ApiMember(Description="Meldungszeitraum", IsRequired=true, Name="Mzr")
    public mzr: Mzr;

    /** @description Meldungen der Warenlieferungen */
    // @ApiMember(Description="Meldungen der Warenlieferungen", IsRequired=true, Name="Zeilen")
    public zeilen: Zeile[];

    public constructor(init?: Partial<ZmZeilen>) { (Object as any).assign(this, init); }
}

/** @description Create XML content that represents a recapitulative tax declaration for 2018. */
// @Api(Description="Create XML content that represents a recapitulative tax declaration for 2018.")
export class CreateZm2018XmlBase implements IPost
{
    /** @description Inländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern. */
    // @ApiMember(Description="Inländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern.", IsRequired=true)
    public knri: string;

    /** @description Angaben zum Unternehmer */
    // @ApiMember(Description="Angaben zum Unternehmer", IsRequired=true)
    public anschrift: Anschrift;

    /** @description Allgemeine Daten */
    // @ApiMember(Description="Allgemeine Daten", IsRequired=true)
    public zmZeilen: ZmZeilen;

    /** @description The details of the provider that submits the tax data. */
    // @ApiMember(Description="The details of the provider that submits the tax data.", IsRequired=true)
    public datenLieferant: string;

    public constructor(init?: Partial<CreateZm2018XmlBase>) { (Object as any).assign(this, init); }
}

/** @description Represents the response from a service that generates XML content. */
// @Api(Description="Represents the response from a service that generates XML content.")
export class XmlResponse
{
    /** @description The XML-based content of the response. */
    // @ApiMember(Description="The XML-based content of the response.")
    public content?: string;

    /** @description Metadata that contains structured error information on the XML response. */
    // @ApiMember(Description="Metadata that contains structured error information on the XML response.")
    public responseStatus?: ResponseStatus;

    public constructor(init?: Partial<XmlResponse>) { (Object as any).assign(this, init); }
}

/** @description A synchronous service to create XML content that represents a recapitulative tax declaration for 2018. */
// @Api(Description="A synchronous service to create XML content that represents a recapitulative tax declaration for 2018.")
export class CreateZm2018Xml extends CreateZm2018XmlBase
{
    /** @description Inländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern. */
    // @ApiMember(Description="Inländische Umsatzsteuer-Identifikationsnummer des Meldenden bestehend aus dem Länderkürzel 'DE' gefolgt von exakt 9 Ziffern.", IsRequired=true)
    public knri: string;

    /** @description Angaben zum Unternehmer */
    // @ApiMember(Description="Angaben zum Unternehmer", IsRequired=true)
    public anschrift: Anschrift;

    /** @description Allgemeine Daten */
    // @ApiMember(Description="Allgemeine Daten", IsRequired=true)
    public zmZeilen: ZmZeilen;

    /** @description The details of the provider that submits the tax data. */
    // @ApiMember(Description="The details of the provider that submits the tax data.", IsRequired=true)
    public datenLieferant: string;

    public constructor(init?: Partial<CreateZm2018Xml>) { super(init); (Object as any).assign(this, init); }
}

TypeScript CreateZm2018Xml DTOs

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

<CreateZm2018Xml 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>
</CreateZm2018Xml>

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>
© 2021 - 2024 PwC. All rights reserved.
PwC refers to the PwC network and/or one or more of its member firms, each of which is a separate legal entity. Please see www.pwc.com/structure for further details. Any use of third party IP such as ELSTER is governed by the respective third party terms.