ZEDAL-SOAP-Webservice: Übersichtsabfragen über ListTransportDocuments() / ListFileAreaDocuments() / ListInboxDocuments()¶
<ListTransportDocuments>
<sessionid>...</sessionid>
<qpar>
<fieldmask>
<!-- Zero or more repetitions: -->
<item>...</item>
</fieldmask>
<!-- Zero or more repetitions: -->
<filter>
<path>...</path>
<op>
<!-- Choice from: -->
equal
not_equal
null
not_null
contains
begins_with
ends_with
less
greater
less_or_equal
greater_or_equal
between
in_list
</op>
<!-- Zero or more repetitions: -->
<operands>
<!-- Choice from: -->
<s>...</s>
<i>...</i>
<n>...</n>
<d>...</d>
<utc>...</utc>
<dt>...</dt>
</operands>
</filter>
<!-- Zero or more repetitions: -->
<sort>
<path>...</path>
<direction>
<!-- Choice from: -->
asc
desc
</direction>
</sort>
<!-- Optional: -->
<page_start>...</page_start>
<!-- Optional: -->
<page_size>...</page_size>
</qpar>
<!-- Optional: -->
<speedup-preselection>...</speedup-preselection>
</ListTransportDocuments>
<ListFileAreaDocuments>
<sessionid>...</sessionid>
<qpar>
<fieldmask>
<!-- Zero or more repetitions: -->
<item>...</item>
</fieldmask>
<!-- Zero or more repetitions: -->
<filter>
<path>...</path>
<op>
<!-- Choice from: -->
equal
not_equal
null
not_null
contains
begins_with
ends_with
less
greater
less_or_equal
greater_or_equal
between
in_list
</op>
<!-- Zero or more repetitions: -->
<operands>
<!-- Choice from: -->
<s>...</s>
<i>...</i>
<n>...</n>
<d>...</d>
<utc>...</utc>
<dt>...</dt>
</operands>
</filter>
<!-- Zero or more repetitions: -->
<sort>
<path>...</path>
<direction>
<!-- Choice from: -->
asc
desc
</direction>
</sort>
<!-- Optional: -->
<page_start>...</page_start>
<!-- Optional: -->
<page_size>...</page_size>
</qpar>
<!-- Optional: -->
<speedup-preselection>...</speedup-preselection>
</ListFileAreaDocuments>
<ListInboxDocuments>
<sessionid>...</sessionid>
<qpar>
<fieldmask>
<!-- Zero or more repetitions: -->
<item>...</item>
</fieldmask>
<!-- Zero or more repetitions: -->
<filter>
<path>...</path>
<op>
<!-- Choice from: -->
equal
not_equal
null
not_null
contains
begins_with
ends_with
less
greater
less_or_equal
greater_or_equal
between
in_list
</op>
<!-- Zero or more repetitions: -->
<operands>
<!-- Choice from: -->
<s>...</s>
<i>...</i>
<n>...</n>
<d>...</d>
<utc>...</utc>
<dt>...</dt>
</operands>
</filter>
<!-- Zero or more repetitions: -->
<sort>
<path>...</path>
<direction>
<!-- Choice from: -->
asc
desc
</direction>
</sort>
<!-- Optional: -->
<page_start>...</page_start>
<!-- Optional: -->
<page_size>...</page_size>
</qpar>
<!-- Optional: -->
<speedup-preselection>...</speedup-preselection>
</ListInboxDocuments>
Beschreibung¶
Die Aufrufe liefern Übersichtsdaten zu Dokumenten im ZEDAL-Dokumentenbestand. Für jeden Hauptbereich (Transportdokumente / Nachweis-Bereich / Inbox) gibt es eine Funktion. Mit dem optionalen Parameter speedup-preselection lässt sich die Menge der Dokumente auf einen Zeitraum begrenzen; die Abfrage wird dadurch schneller.
Verfügbare Felder (<fieldmask> / <path>):¶
- doc.document_id
- doc.last_changed
- doc.cancelled
- doc.document_type
- doc.current_layer
- doc.sequence_number
- doc.notification_id
- doc.transport_weight
- doc.transport_volume
- doc.waste_type_code
- doc.notes
- doc.handover_date
- doc.internal_name
- doc.waste_producer_number
- doc.waste_producer_name1
- doc.waste_producer_name2
- doc.waste_producer_city1
- doc.waste_producer_street1
- doc.waste_producer_internal_name
- doc.waste_producer_site_number
- doc.waste_producer_code
- doc.waste_producer_sig1_name
- doc.waste_producer_sig1_time
- doc.waste_producer_sig1_cstat
- doc.waste_producer_sig2_name
- doc.waste_producer_sig2_time
- doc.waste_producer_sig2_cstat
- doc.takeover_date
- doc.carrier1_number
- doc.carrier1_name1
- doc.carrier1_name2
- doc.carrier1_city1
- doc.carrier1_street1
- doc.carrier1_truck
- doc.carrier1_trailer
- doc.carrier1_internal_name
- doc.carrier1_code
- doc.carrier1_site_number
- doc.carrier1_sig1_name
- doc.carrier1_sig1_time
- doc.carrier1_sig1_cstat
- doc.carrier1_sig2_name
- doc.carrier1_sig2_time
- doc.carrier1_sig2_cstat
- doc.acceptance_date
- doc.recovery_disposal_facility_number
- doc.recovery_disposal_facility_name1
- doc.recovery_disposal_facility_name2
- doc.recovery_disposal_facility_city1
- doc.recovery_disposal_facility_street1
- doc.recovery_disposal_facility_acceptance_refused
- doc.recovery_disposal_facility_internal_name
- doc.recovery_disposal_facility_site_number
- doc.recovery_disposal_facility_code
- doc.recovery_disposal_facility_sig1_name
- doc.recovery_disposal_facility_sig1_time
- doc.recovery_disposal_facility_sig1_cstat
- doc.recovery_disposal_facility_sig2_name
- doc.recovery_disposal_facility_sig2_time
- doc.recovery_disposal_facility_sig2_cstat
- doc.carrier2_number
- doc.carrier2_name1
- doc.carrier2_name2
- doc.carrier2_city1
- doc.carrier2_street1
- doc.carrier2_truck
- doc.carrier2_trailer
- doc.carrier2_site_number
- doc.carrier2_sig1_name
- doc.carrier2_sig1_time
- doc.carrier2_sig1_cstat
- doc.carrier2_sig2_name
- doc.carrier2_sig2_time
- doc.carrier2_sig2_cstat
- doc.carrier3_number
- doc.carrier3_name1
- doc.carrier3_name2
- doc.carrier3_city1
- doc.carrier3_street1
- doc.carrier3_truck
- doc.carrier3_trailer
- doc.carrier3_site_number
- doc.carrier3_sig1_name
- doc.carrier3_sig1_time
- doc.carrier3_sig1_cstat
- doc.carrier3_sig2_name
- doc.carrier3_sig2_time
- doc.carrier3_sig2_cstat
- doc.temporary_storage_number
- doc.temporary_storage_name1
- doc.temporary_storage_name2
- doc.temporary_storage_city1
- doc.temporary_storage_street1
- doc.temporary_storage_site_number
- doc.temporary_storage_sig1_name
- doc.temporary_storage_sig1_time
- doc.temporary_storage_sig1_cstat
- doc.temporary_storage_sig2_name
- doc.temporary_storage_sig2_time
- doc.temporary_storage_sig2_cstat
doc.document_id enthält die ZEDAL-interne und netzweit eindeutige Dokumentnummer („docID“, z. B. „12345-6“), doc.sequence_number die amtliche BMU-Nummer des Transportdokuments.
Der Dokumenttyp im Feld doc.document_type entspricht dem BMU-Dokumenttyp („BGS“, „UNS“ usw.).
Der aktuelle Layer in doc.current_layer entspricht den amtlichen BMU-Layer-Namen (z. B. „BGSERZLayer“).
Stornierte Dokumente tragen im Feld doc.cancelled den Wert „true“.
Das Feld doc.notes kann mehrzeilige Inhalte haben.
Die Felder zum Signaturstatus (..._cstat) tragen folgende Codes:
- 2 -> gültig
- 5 -> fraglich, z. B. OCSP „unknown“ oder ohne Antwort
- 8 -> ungültig
Datumsfelder haben das Format YYYY-MM-DD (z. B. „2022-08-31“).
Zeitstempelfelder haben das Format YYYY-MM-DDTHH24:Mi:SSZ, z. B. „2022-08-31T16:48:23Z“. Alle Zeiten sind in UTC angegeben.
Optional: Filter (<filter>):¶
- path -> Feldname (siehe oben)
- op -> Operator („
equal“ / „not_equal“ / „null“ / „not_null“ / „contains“ / „begins_with“ / „ends_with“ / „less“ / „greater“ / „less_or_equal“ / „greater_or_equal“ / „between“ / „in_list“) - operands -> Operand(en)
Mehrere Filter werden immer mit UND verknüpft (alle Bedingungen müssen zutreffen). Andere logische Verknüpfungen lassen sich abbilden, indem du Abfragen nacheinander ausführst und die Ergebnisse entsprechend zusammenführst.
Datentypen (in <operands>):¶
- s -> string, z. B. „
Berlin“ - i -> int, z. B. „
12“ - n -> double, z. B. „
1.23“ - d -> date, YYYY-MM-DD, z. B. „
2022-08-31“ - utc -> dateTime (in UTC), YYYY-MM-DD HH24:Mi:SS, z. B. „
2022-08-31 16:48:23“ - (nicht verwendet: dt -> dateTime, YYYY-MM-DD HH24:Mi:SS, z. B. „
2022-08-31 16:48:23“)
Wie viele Operanden nötig sind (durch Wiederholen des Elements <operands>), hängt vom Operator ab:
- null / not_null: kein Operand
- equal / not_equal / contains / begins_with / ends_with / less / greater / less_or_equal / greater_or_equal: genau ein Operand
- between: genau zwei Operanden
- in_list: ein oder mehrere Operanden
Optional: Sortierung (<sort>):¶
Ohne Angabe kommen die Datensätze in keiner bestimmten Reihenfolge zurück.
- path -> Feldname (siehe oben)
- direction -> Richtung („
asc“ / „desc“)
Optional: Seitenweise Abfrage:¶
Ohne Angabe kommen höchstens die ersten 20 Datensätze zurück.
- page_start -> erster zurückzugebender Datensatz (>= 1)
- page_size -> Anzahl der zurückzugebenden Datensätze
Optional: Vorauswahl zur Beschleunigung (<speedup-preselection>):¶
Erwartet ein date (Format YYYY-MM-DD, z. B. „2022-08-31“). Die Grundmenge der Dokumente wird vorab auf die bis zu diesem Datum relevanten begrenzt; die Abfrage wird dadurch schneller. Ohne Angabe werden alle verfügbaren Daten berücksichtigt.