Tax Filing Service

<back to all web services

CheckElsterAsync

AsyncBearbeiteVorgangÜberprüfung

An asynchronous service to perform basic checks on a batch of tax data.

Requires Authentication
The following routes are available for this service:
POST/CheckElsterAsyncAn asynchronous service to perform basic checks on a batch of tax data.
using System;
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using PwC.xEric.Core.Services.Contracts.Requests;
using PwC.xEric.Core.Domain.Concretes.Models;
using PwC.xEric.Core.Services.Contracts.Responses;

namespace PwC.xEric.Core.Domain.Concretes.Models
{
    ///<summary>
    ///Represents a structure that encapsulates a tax declaration.
    ///</summary>
    [Api(Description="Represents a structure that encapsulates a tax declaration.")]
    public partial class TaxData
    {
        ///<summary>
        ///The unique identifier of the tax data.
        ///</summary>
        [ApiMember(Description="The unique identifier of the tax data.", IsRequired=true)]
        public virtual string Id { get; set; }

        ///<summary>
        ///The XML-based tax declaration.
        ///</summary>
        [ApiMember(Description="The XML-based tax declaration.", IsRequired=true)]
        public virtual string Content { get; set; }
    }

}

namespace PwC.xEric.Core.Services.Contracts.Requests
{
    ///<summary>
    ///An asynchronous service to perform basic checks on a batch of tax data.
    ///</summary>
    [Api(Description="An asynchronous service to perform basic checks on a batch of tax data.")]
    public partial class CheckElsterAsync
        : CheckElsterBase
    {
    }

    ///<summary>
    ///A base service to perform basic checks on a batch of tax data.
    ///</summary>
    [Api(Description="A base service to perform basic checks on a batch of tax data.")]
    public partial class CheckElsterBase
        : IPost
    {
        ///<summary>
        ///The ELSTER tax data to check.
        ///</summary>
        [ApiMember(Description="The ELSTER tax data to check.", Name="Data")]
        public virtual TaxData Data { get; set; }
    }

}

namespace PwC.xEric.Core.Services.Contracts.Responses
{
    ///<summary>
    ///Represents a type that encapulates the state of a provided ELSTER tax data.
    ///</summary>
    [Api(Description="Represents a type that encapulates the state of a provided ELSTER tax data.")]
    public partial class ElsterCheckResponse
        : ServiceReponseBase
    {
        ///<summary>
        ///Checks whether a portal certificate is required to sign the tax data.
        ///</summary>
        [ApiMember(Description="Checks whether a portal certificate is required to sign the tax data.")]
        public virtual bool ZertifikatErforderlich { get; set; }

        ///<summary>
        ///Checks whether a Manufacturer ID has been provided for the tax data.
        ///</summary>
        [ApiMember(Description="Checks whether a Manufacturer ID has been provided for the tax data.")]
        public virtual bool HatHerstellerId { get; set; }

        ///<summary>
        ///Checks whether a data provider has been provided for the tax data.
        ///</summary>
        [ApiMember(Description="Checks whether a data provider has been provided for the tax data.")]
        public virtual bool HatDatenlieferant { get; set; }

        ///<summary>
        ///Checks whether the PDF-based transfer protocol for the tax data can be printed out for the type of tax data.
        ///</summary>
        [ApiMember(Description="Checks whether the PDF-based transfer protocol for the tax data can be printed out for the type of tax data.")]
        public virtual bool TransferProtokollDruckbar { get; set; }
    }

    ///<summary>
    ///Specifies a service response from an ERiC service operation.
    ///</summary>
    [Api(Description="Specifies a service response from an ERiC service operation.")]
    public partial class ServiceReponseBase
        : IHasIndex
    {
        ///<summary>
        ///The unique identifier of the response.
        ///</summary>
        [ApiMember(Description="The unique identifier of the response.")]
        public virtual string Id { get; set; }

        ///<summary>
        ///The position of the response element in an indexed collection.
        ///</summary>
        [ApiMember(Description="The position of the response element in an indexed collection.")]
        public virtual int Index { get; set; }

        ///<summary>
        ///Metadata that contains structured error information on the service response.
        ///</summary>
        [ApiMember(Description="Metadata that contains structured error information on the service response.")]
        public virtual ResponseStatus ResponseStatus { get; set; }
    }

}

C# CheckElsterAsync DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .x-msgpack suffix or ?format=x-msgpack

HTTP + X-MSGPACK

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /CheckElsterAsync HTTP/1.1 
Host: taxfiling.staging.pwc.de 
Accept: application/x-msgpack
Content-Type: application/x-msgpack
Content-Length: length

{"data":{"id":"String","content":"String"}}
HTTP/1.1 200 OK
Content-Type: application/x-msgpack
Content-Length: length

{"zertifikatErforderlich":false,"hatHerstellerId":false,"hatDatenlieferant":false,"transferProtokollDruckbar":false,"id":"String","index":0,"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}