Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Zielsetzung

Die Übertragung der ZUGFeRD Rechnung soll via Web-Service ermöglicht werden. Innerhalb des Web-Service sollen Methoden zum Abruf der Rechnung und zur Quittung des Empfangs der Rechnung enthalten sein. Der Web Service ist so gestaltet, dass in der Zukunft auch andere Dokumenttypen und Formate übertragen werden können, ohne die Grundstruktur ändern zu müssen.

...

Der Empfang eines Dokuments soll wie folgt bestätigt werden:

  • Erfolgreich: Übertragung erfolgreich, Daten syntaktisch korrekt

  • Fehlerhaft: Übertragung erfolgreich, Daten syntaktisch nicht korrekt.

Erfolgt eine erneute Anfrage, ohne dass der Empfang des zuletzt übertragenen Dokuments gesendet wurde, wird dies erneut übertragen.

...

In der Antwort werden folgende Fälle unterschieden:

  • Übertragung eines Dokuments

  • Es liegt kein Dokument vor

  • Fehler bei der Authentifizierung

  • Fehler beim angefragten Dokumenttyp

  • Fehler beim angefragten Format

  • Fehler bei der angefragten Formatversion

  • Allgemeine Fehler

Für die einzelnen Fälle wird der entsprechende Status bzw. die Fault Message übertragen.

...

In der Antwort werden folgende Fälle unterschieden:

  • Quittung angenommen

  • Kein Dokument mit den identifizierenden Daten vorhanden

  • Fehler bei der Authentifizierung

  • Fehler beim angefragten Dokumenttyp

  • Fehler beim angefragten Format

  • Fehler bei der angefragten Formatversion

  • Allgemeine Fehler

Für die einzelnen Fälle wird der entsprechende Status bzw. die Fault Message übertragen.

Anhang

element Authentification

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="Authentification">

<complexType>

<sequence>

<element name="CustomerNumber" type="normalizedString"/>

<element name="Login" type="normalizedString"/>

<element name="Password" type="normalizedString"/>

</sequence>

</complexType>

</element>

element Authentification/CustomerNumber

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

normalizedString

source

<element name="CustomerNumber" type="normalizedString"/>

element Authentification/Login

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

normalizedString

source

<element name="Login" type="normalizedString"/>

element Authentification/Password

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

normalizedString

source

<element name="Password" type="normalizedString"/>

element DocumentNumber

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

normalizedString

source

<element name="DocumentNumber" type="normalizedString"/>

element DocumentType

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

restriction of normalizedString

facets

minLength

1

maxLength

50

pattern

INVOIC|\w{1,50}

source

<element name="DocumentType">

<simpleType>

<restriction base="normalizedString">

<minLength value="1"/>

<maxLength value="50"/>

<pattern value="INVOIC|\w{1,50}"/>

</restriction>

</simpleType>

</element>

element Format

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

restriction of normalizedString

facets

minLength

1

maxLength

50

pattern

ZUGFeRD|\w{1,50}

source

<element name="Format">

<simpleType>

<restriction base="normalizedString">

<minLength value="1"/>

<maxLength value="50"/>

<pattern value="ZUGFeRD|\w{1,50}"/>

</restriction>

</simpleType>

</element>

element FormatVersion

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

restriction of normalizedString

facets

minLength

1

maxLength

50

pattern

1|\w{1,50}

source

<element name="FormatVersion">

<simpleType>

<restriction base="normalizedString">

<minLength value="1"/>

<maxLength value="50"/>

<pattern value="1|\w{1,50}"/>

</restriction>

</simpleType>

</element>

element getNextDocument

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="getNextDocument">

<complexType>

<sequence>

<element ref="tns:Format"/>

<element ref="tns:FormatVersion"/>

<element ref="tns:DocumentType"/>

<element ref="tns:Authentification"/>

</sequence>

</complexType>

</element>

element getNextDocumentResponse

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="getNextDocumentResponse">

<complexType>

<sequence>

<element name="NextDocumentStatus">

<complexType>

<sequence>

<element name="Code">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>

<element ref="tns:Message"/>

</sequence>

</complexType>

</element>

<element name="Document" minOccurs="0">

<complexType>

<sequence>

<element ref="tns:Format"/>

<element ref="tns:FormatVersion"/>

<element ref="tns:DocumentType"/>

<element ref="tns:DocumentNumber"/>

<element name="DocumentName" type="string"/>

<element name="DocumentContent" type="base64Binary"/>

</sequence>

</complexType>

</element>

</sequence>

</complexType>

</element>

element getNextDocumentResponse/NextDocumentStatus

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="NextDocumentStatus">

<complexType>

<sequence>

<element name="Code">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>

<element ref="tns:Message"/>

</sequence>

</complexType>

</element>

element getNextDocumentResponse/NextDocumentStatus/Code

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

restriction of string

facets

enumeration

0

enumeration

1

source

<element name="Code">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>

element getNextDocumentResponse/Document

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="Document" minOccurs="0">

<complexType>

<sequence>

<element ref="tns:Format"/>

<element ref="tns:FormatVersion"/>

<element ref="tns:DocumentType"/>

<element ref="tns:DocumentNumber"/>

<element name="DocumentName" type="string"/>

<element name="DocumentContent" type="base64Binary"/>

</sequence>

</complexType>

</element>

element getNextDocumentResponse/Document/DocumentName

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

string

source

<element name="DocumentName" type="string"/>

element getNextDocumentResponse/Document/DocumentContent

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

base64Binary

source

<element name="DocumentContent" type="base64Binary"/>

element Message

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

normalizedString

source

<element name="Message" type="normalizedString"/>

element sendDocumentAcknowledgement

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="sendDocumentAcknowledgement">

<complexType>

<sequence>

<element ref="tns:Format"/>

<element ref="tns:FormatVersion"/>

<element ref="tns:DocumentType"/>

<element ref="tns:Authentification"/>

<element name="DocumentReference">

<complexType>

<sequence>

<element ref="tns:DocumentNumber"/>

<element name="AcknowledgeState">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>

</sequence>

</complexType>

</element>

</sequence>

</complexType>

</element>

element sendDocumentAcknowledgement/DocumentReference

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="DocumentReference">

<complexType>

<sequence>

<element ref="tns:DocumentNumber"/>

<element name="AcknowledgeState">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>

</sequence>

</complexType>

</element>

element sendDocumentAcknowledgement/DocumentReference/AcknowledgeState

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

restriction of string

facets

enumeration

0

enumeration

1

source

<element name="AcknowledgeState">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>

element sendDocumentAcknowledgementResponse

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

source

<element name="sendDocumentAcknowledgementResponse">

<complexType>

<sequence>

<element name="Code">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>

<element ref="tns:Message"/>

</sequence>

</complexType>

</element>

element sendDocumentAcknowledgementResponse/Code

diagram

Image Removed
Image Added

namespace

http://service.itek-invoice.de/types2

type

restriction of string

facets

enumeration

0

enumeration

1


source

<element name="Code">

<simpleType>

<restriction base="string">

<enumeration value="0"/>

<enumeration value="1"/>

</restriction>

</simpleType>

</element>


WSDL

View file
nameWebservice.zip

...