Root Element zum Abrufen von Veranlagungsverfügungen (VV) bzw. Quittungen.
Das Schema dient dem Beziehen von Veranlagungsverfügungen eines Zollkunden. Es gibt verschiedene Abfragemöglichkeiten:
- Bezug einer einzelnen Veranlagungsverfügung
- Abfrage einer Liste von Veranlagungsverfügungen
Die VV können nur von Zollkunden abgerufen werden, die als Zollanmelder, Kontoinhaber oder Versender (Exporteur) in der Original-Zollanmeldung angegeben sind.
Falls bei der Abfrage (einzelne Veranlagungsverfügung) keine Versionsangabe gemacht wird, wird immer die aktuelle Version der VV zurückgegeben. Für Export Dokumente kann immer nur die neueste Version bezogen werden. Für Import Dokumente können alle Versionen der Dokumente abgerufen werden.
Das Root Element enthält ein zwingendes Attribut schemaVersion, in dem angegeben wird, welcher edecReceipt Schema Version die XML Instanz entspricht.
Anhand des Attributs schemaVersion wird mitgeteilt, welche Version des edecReceipt Schemas zum Validieren benutzt werden soll.
Complex Type zum Abrufen von Veranlagungsverfügungen / Quittungen
Trader Identification Number (Spediteurnummer, TIN oder UID) des Bezügers (Stammdaten).
Ein Bezüger kann nur Veranlagungsverfügungen zu Zollanmeldungen abrufen, die von ihm deklariert wurden oder bei denen er als Beteiligter (Kontoinhaber oder Versender (Exporteur)) aufgeführt ist.
- Im ersten Fall muss die requestorTraderIdentificationNumber gleich declarant/traderIdentificationNumber in der Original-Zollanmeldung sein.
- Im zweiten Fall muss die requestorTraderIdentificationNumber gleich dem Kontoinhaber des ZAZ-Kontos (business/customsAccount bzw. business/VATAccount) in der Original-Zollanmeldung sein.
- Im dritten Fall muss die requestorTraderIdentificationNumber gleich der consignor/traderIdentificationNumber in der Original-Zollanmeldung sein.
Optionale Referenz um auch bei asynchronen (Mail) oder mandantenfähigen Systemen eine eindeutige Zuordnung zwischen Request und Response zu ermöglichen. Falls dieses Element gefüllt ist, so wird es auch in der Response enthalten sein.
Abruf einer Liste von Veranlagungsverfügungsnummern (entspricht der customsDeclarationNumber). Es muss die Rolle des Bezügers, ein Dokumenttyp oder eine Dokumenttyp Gruppe und eine Datumsspanne (von max. 10 Tagen) angegeben werden. Es können zusätzliche Einschränkungen abhängig von der Rolle gemacht werden. Es werden Deklarationsnummern vom Zoll zurückgegeben, bei denen der Zollanmelder der Original-Zollanmeldung der originalTraderDeclarationNumber entspricht oder die requestorTraderDeclarationNumber einem der Beteiligten (Kontoinhaber oder Versender) der Original-Zollanmeldung entspricht.
Rolle des Dokument Bezügers, Zollanmelder (0), Kontoinhaber (1), Versender (2), Kasse (3) (nur fuer internen Gebrauch) (Stammdaten: edecDomains.xml/domains/domain[@name="role"]/entry/@value)
ZAZ-Kontonummer des Kontoinhabers. Die Kontonummer muss angegeben werden, wenn in der Rolle des Kontoinhabers (role = 1) Dokumente bezogen werden möchten. Bei anderen Rollen darf die Kontonummer nicht angegeben werden.
Datumsspanne für Einschränkung der Abfrage der Liste der Veranlagungsverfügungen (max. 10 Tage). Das Datum bezieht sich auf das Erstellungsdatum der gesuchten Dokumente.
Datum ab wann gesucht werden soll
Datum bis und mit wann gesucht werden soll
Zollstellennummer (nur fuer internen Gebrauch) (Stammdaten: edecCustomsOffices.xml/customsOffices/customsOffice/@number)
Dokumenttypen und Dokumenttyp Gruppen, welche bei der Listenabfrage erlaubt sind. Mögliche Werte: Veranlagungsverfügung Zoll VVZ (taxationDecisionCustomsDuties), Veranlagungsverfügung Mehrwertsteuer VVM (taxationDecitionVAT), Veranlagungsverfügung Export eVV (taxationDecisionExport), Rückerstattung Zoll (refundCustomsDuties), Rückerstattung Mwst (refundVat), alle Import Dokumente (allImportTaxationDecisionsAndRefunds).
Nur für Export Dokumente: Trader Identification Number (Spediteurnummer, TIN oder UID) des Versenders / Exporteurs (consignor). Dieses Element schränkt die Suche ein auf Zollanmeldungen, bei denen das Element consignor/traderIdentificationNumer mit dem Suchwert übereinstimmt.
Abruf einer Veranlagungsverfügung mit Hilfe einer customsDeclarationNumber. Die Original-Zollanmeldung muss als Zollanmelder die originalTraderDeclarationNumber enthalten. Zudem muss in der Original-Zollanmeldung einer der Beteiligten (Kontoinhaber oder Versender) der requestorTraderDeclarationNumber entsprechen.
Zollanmeldungsnummer (früher Deklarationsnummer) Zoll
Zoll-Versionsnummer des Dokuments, das abgerufen werden soll.
Für Export Dokumente kann nur die neueste Version bezogen werden. Es ist nicht möglich, Vorversionen abzurufen (Regel v13). Fehlt die Versionsangabe, so wird die neueste Version zurückgegeben.
Für Import Dokumente können alle Versionen der Dokumente abgerufen werden. Fehlt die Versions-Angabe, so wird die neueste Version zurückgegeben.
Dokumenttyp; Art der Quittung; Mögliche Werte: Veranlagungsverfügung Zoll VVZ (taxationDecisionCustomsDuties), Veranlagungsverfügung Mehrwertsteuer VVM (taxationDecisionVAT), Veranlagungsverfügung Export eVV (taxationDecisionExport), Rückerstattung Zoll (refundCustomsDuties) und Rückerstattung Mwst (refundVAT).
Attribut zur Angabe der benutzten edecReceiptRequest Schema Version. Aktuelle Schema Version ist 2.0
Simple Type für Dokumenttyp für den Bezug einer einzelnen Veranlagungsverfügung.
Simple Type für Dokumenttyp und DokumentTyp Gruppen, welche bei der Abfrage einer Liste von Veranlagungsverfügungen verwendet werden können.
Simple Type mit Datum ohne Zeitzonenangabe (Format yyyy-mm-dd)
Simple Type für TraderIdentificationNumber (Spediteurnummer, TIN oder UID)
Versionsnummer der Zollanmeldung. Wird von e-dec vergeben.
Simple Type für Referenzen