Tax Filing Service

<back to all web services

CheckElster

SyncÜberprüfung

A synchronous service to perform basic checks on a batch of tax data.

Requires Authentication
The following routes are available for this service:
POST/CheckElsterA synchronous service to perform basic checks on a batch of tax data.
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
Object = TypeVar('Object')


# @Api(Description="Represents a structure that encapsulates a tax declaration.")
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TaxData:
    """
    Represents a structure that encapsulates a tax declaration.
    """

    # @ApiMember(Description="The unique identifier of the tax data.", IsRequired=true)
    id: Optional[str] = None
    """
    The unique identifier of the tax data.
    """


    # @ApiMember(Description="The XML-based tax declaration.", IsRequired=true)
    content: Optional[str] = None
    """
    The XML-based tax declaration.
    """


# @Api(Description="A base service to perform basic checks on a batch of tax data.")
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class CheckElsterBase(IReturn[ElsterCheckResponse], IPost):
    """
    A base service to perform basic checks on a batch of tax data.
    """

    # @ApiMember(Description="The ELSTER tax data to check.", Name="Data")
    data: Optional[TaxData] = None
    """
    The ELSTER tax data to check.
    """
    @staticmethod
    def response_type(): return ElsterCheckResponse


# @Api(Description="Specifies a service response from an ERiC service operation.")
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ServiceReponseBase(IHasIndex):
    """
    Specifies a service response from an ERiC service operation.
    """

    # @ApiMember(Description="The unique identifier of the response.")
    id: Optional[str] = None
    """
    The unique identifier of the response.
    """


    # @ApiMember(Description="The position of the response element in an indexed collection.")
    index: int = 0
    """
    The position of the response element in an indexed collection.
    """


    # @ApiMember(Description="Metadata that contains structured error information on the service response.")
    response_status: Optional[ResponseStatus] = None
    """
    Metadata that contains structured error information on the service response.
    """


# @Api(Description="Represents a type that encapulates the state of a provided ELSTER tax data.")
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ElsterCheckResponse(ServiceReponseBase):
    """
    Represents a type that encapulates the state of a provided ELSTER tax data.
    """

    # @ApiMember(Description="Checks whether a portal certificate is required to sign the tax data.")
    zertifikat_erforderlich: bool = False
    """
    Checks whether a portal certificate is required to sign the tax data.
    """


    # @ApiMember(Description="Checks whether a Manufacturer ID has been provided for the tax data.")
    hat_hersteller_id: bool = False
    """
    Checks whether a Manufacturer ID has been provided for the tax data.
    """


    # @ApiMember(Description="Checks whether a data provider has been provided for the tax data.")
    hat_datenlieferant: bool = False
    """
    Checks whether a data provider has been provided for the tax data.
    """


    # @ApiMember(Description="Checks whether the PDF-based transfer protocol for the tax data can be printed out for the type of tax data.")
    transfer_protokoll_druckbar: bool = False
    """
    Checks whether the PDF-based transfer protocol for the tax data can be printed out for the type of tax data.
    """


# @Api(Description="A synchronous service to perform basic checks on a batch of tax data.")
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class CheckElster(CheckElsterBase):
    """
    A synchronous service to perform basic checks on a batch of tax data.
    """

    pass

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

<CheckElster xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Requests">
  <Data xmlns:d2p1="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Domain.Concretes.Models">
    <d2p1:Content>String</d2p1:Content>
    <d2p1:Id>String</d2p1:Id>
  </Data>
</CheckElster>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ElsterCheckResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.xEric.Core.Services.Contracts.Responses">
  <Id>String</Id>
  <Index>0</Index>
  <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>
  <HatDatenlieferant>false</HatDatenlieferant>
  <HatHerstellerId>false</HatHerstellerId>
  <TransferProtokollDruckbar>false</TransferProtokollDruckbar>
  <ZertifikatErforderlich>false</ZertifikatErforderlich>
</ElsterCheckResponse>