Orientierungshilfe zur WSDL-Datei Schnittstelle für landwirtschaftliche Bündler (Tierwohl Datenbank Stammdaten)

Transkript

1 Orientierungshilfe zur WSDL-Datei Die neue WSDL (zum Testen) folgt in Kürze. Die Authentifizierung geschieht über Web Service Security wie hier spezifiziert: pdf Benutzt wird der Passwort Typ "PasswordText" also das Passwort im Klartext. Das können wir bei Bedarf noch auf verschlüsselte Passwörter umstellen (PasswordDigest). Aber da SSL benutzt werden soll, ist das nicht unbedingt notwendig. In den QS Services wird das Passwort auch im Klartext übertragen (HTTP Basic Auth) BSP: <soap:header> <wsse:security xmlns:wsse=" wss-wssecurity-secext-1.0.xsd" soap:mustunderstand="1"> <wsse:usernametoken xmlns:wsse=" wss-wssecurity-secext-1.0.xsd" xmlns:wsu=" wss-wssecurity-utility-1.0.xsd" wsu:id="usernametoken "> <wsse:username xmlns:wsse=" open.org/wss/2004/01/oasis wss-wssecurity-secext- 1.0.xsd">USERNAME</wsse:Username> <wsse:password xmlns:wsse=" Type=" wss-username-token-profile-1.0#PasswordText">PASSWORD</wsse:Password> </wsse:usernametoken> </wsse:security> </soap:header> IT Dienstleister erhalten die Zugangsdaten über die Bündler, für die sie entwickeln. Bei Fragen rufen Sie uns gerne an, auch unter der support-nummer: +49 (0) In der Schnittstelle sind die Nachrichten mit ihren englischen Begriffen beschrieben. Seite 1 von 11

2 Zum Ablauf: Neue Standorte: Mit der Nachricht UpdateLocation (Kapitel 3) müssen Sie zuerst den gewünschten Standort anlegen (registrieren). Nur für Schweine haltende Standorte: Mit der Nachricht Checklists (Kapitel 2) müssen Sie dann die aktuell gültigen Checklisten abfragen. Je eine Checkliste pro Produktionsart. Nur für Schweine haltende Standorte: Mit der Nachricht UpdateLocationRequirements (Kapitel 4) importieren Sie die standortspezifische Checkliste in die Tierwohl-Datenbank. Sie muss sowohl die Pflicht als auch die Wahlpflicht-Checkpunkte enthalten und alle Bedingungen erfüllen. Mit der Nachricht ActivateLocation (Kapitel 6) können Sie den Standort anmelden. Erst dann ist der Standort ein Teilnehmer. Für alle Nachrichten, die der Bündler abfragen kann, muss er sich in der Anfrage mit seinem Benutzernamen und Passwort identifizieren. Als Antwort erhält er die gewünschten Daten. Bestehende Standorte: Standorte, die bereits am jetzigen Programm Initiative Tierwohl teilnehmen, bestätigen mit der Nachricht 9 Nachricht Teilnahme am Programm die weitere Teilnahme am Programm. 1 Nachricht Standortdaten abfragen, Liste oder In der Anfrage kann der Bündler neben den Login-Daten auch eine Standortnummer und Produktionsart senden. Dadurch wird das Ergebnis auf einen Standort eingeschränkt. Als Antwort wird eine Liste mit Standorten ausgegeben. Jeder Datensatz enthält folgende Felder: Standortname String, 100 Produktionsart String, 5 P2001, P2004, P2008; P3001, P3004 Standortnummer String, 30 QS-ID String, 13 Straße String, 200 Postadresse (wie in Teilnahmeerklärung hinterlegt) PLZ String, 10 Postadresse (wie in Teilnahmeerklärung hinterlegt) Ort String, 100 Postadresse (wie in Teilnahmeerklärung hinterlegt) Postfach PLZ String, 30 Postadresse (wie in Teilnahmeerklärung hinterlegt) Postfach String, 30 Postadresse (wie in Teilnahmeerklärung hinterlegt) Land String, 3 Eindeutiges Länderkürzel Bundesland String, 3 Pflichtfeld wenn Land Deutschland. Als eindeutiges Kürzel. URL String, 200 Adresse des Stalls String, 5000 Zertifizierungssystem String Zahlungsberechtigt bis () Vorbelegt mit dem Text Stalladresse entspricht Standortadresse (Postadresse) QS Gesperrt Boolean Gibt an, ob der Standort gesperrt ist. Gesperrt von Gesperrt bis Abmeldung Attribut Schwein Tieranzahl gemeldet Integer, 6 Seite 2 von 11

3 Tieranzahl Gemeldet Integer, 6 Die Tieranzahl für das Programm EU-Öko- Verordnung Konventionell, öko Attribut Geflügel kg LG/Jahr Masthähnchen männlich weiblich kg LG/Jahr Masthähnchen männlich weiblich Inklusive Putenaufzucht boolean Die QS-ID des aktuellen Vermarkters. Wenn sich ein Betrieb QS-ID Vermarkter String, 13 für die Teilnahme am Programm angemeldet hat ist eine Vermarkterzuordnung für eine Zahlungsberechtigung zwingend notwendig. Mehr Platz gemäß tierschutzrechtlicher Vorschriften QS-ID Zertifizierungsstelle Umsetzungszeitpunkt Umsetzungszeitpunkt String, 13 Anforderungen der EU-Öko-Verordnung oder ökologischer Anbauverbände, die einen höheren Qualitätsstandard garantieren. andere tierschutzrechtliche Vorschriften, die zur Umsetzung eines höheren Platzangebots verpflichten Schwein: frühestmögliches ; max. 5 Monate in der Zukunft Geflügel: frühestmögliches in der Anmeldephase bis Produktionsart 3001: Produktionsart 3004: danach: max. 5 Monate in der Zukunft Schwein: Für neue, und wieder angemeldete Standorte: frühestmögliches ; Max Für Standorte, die zum Zeitpunkt der Anmeldung für das neue Programm angemeldet und zugelassen sind (auch mit Sperre): frühestmögliches 2 Monate vor Ende der aktuellen Zulassung; Max. 5 Monate nach dem frühestmöglichen. Geflügel: frühestmögliches ab dem Tag der Bestätigung der Teilnahme. Oder bei einer erneuten Änderung des s, nicht in der Vergangenheit. Enddatum in der Anmeldephase: Seite 3 von 11

4 Für jeden Standortdatensatz wird eine Liste mit Ansprechpartner des jeweiligen Standortes ausgegeben. danach: max. 5 Monate in der Zukunft Steuersatz Dezimal 2,1 Umsatzsteuer-ID String, 20 Auditzyklus Auditzyklus Anfragezyklus Anmeldestatus gesetzl. Vertreter Ansprechpartnertyp Ansprechpartner Krisenmanager String Stellvertr. Ansprechpartner Anrede String Herr, Frau Titel String, 20 Vorname String, 100 Nachname String, 100 Telefonnr. String, 200 Mobilnr. String, 200 Pflichtfeld nur bei Krisenmanagern Faxnr. String, 200 String, 200 Sprache String ISO3 DEU, ENG Für jeden Standortdatensatz wird die aktuelle, individuelle Checkliste ausgegeben. Nummer String, 25 Anforderung String, 350 Grundanforderung Boolean Seite 4 von 11

5 Für jeden Standortdatensatz wird der letzte, freigegebene Auditbericht ausgegeben. Audit Auditanfang Zeitstempel Auditende Zeitstempel Auditdauer Integer Dauer in Minuten Auditart String Programmaudit Bestätigungsaudit Sonderaudit Stichprobenaudit Parallelaudit Bestandscheck Freigabedatum Freigebender String Audit-Status String Bestanden Nicht bestanden Pruefliste Version des Standortes zur eindeutigen Identifizierung der Prüfliste Dient zusammen mit der Auditart und der Produktionsart String, 15 Bemerkung String, 5000 GeneralKO Boolean Bemerkung GeneralKO String, 5000 Auskunftsperson String, 200 Für den Auditdatensatz wird eine Liste mit Checkpunkten inkl. der Ergebnisse ausgegeben. Nummer String, 25 Anforderung String, 350 Grundanforderung Boolean Vollständig erfüllt Ergebnis String K.O. Nicht anwendbar 2 Nur für Schweine haltende Standorte: Nachricht Abfrage Der Bündler kann für eine bestimmte Produktionsart und Gültigkeitszeitraum die Prüflisten abfragen. Als Antwort erhält er eine Liste mit Prüflistendatensätzen. Name String, 200 Produktionsart Integer, 4 P2001, P2004, P2008 Version String, 15 Gültig von Seite 5 von 11

6 Gültig bis Jeder Prüflistendatensatz enthält eine Liste mit allen Checkpunkten. Nummer String, 25 Anforderung String, 350 Grundanforderung Boolean Betrag Dezimal 6,2 BetragBIO Dezimal 6,2 Der Betrag, der ausgezahlt wird, wenn der Betrieb den EU- Öko-Verordnung oder einen höherwertigen Standard erfüllt. Überschrift Boolean Info, ob der Checkpunkt eine Überschrift darstellt. 3 Nachricht Import Name="ImportLocation") Der Bündler kann über diese Schnittstelle Standorte mit allen relevanten Daten anlegen und aktualisieren. Die Aktualisierung von Daten führt zu einem Änderungsantrag. Es können ein oder mehrere Standortdatensätze gleichzeitig gesendet werden. Standortname String, 100 Produktionsart String, 5 P2001, P2004, P2008; P3001, P3004 QS-ID String, 13 Standortnummer String, 30 Straße String, 200 PLZ String, 10 Ort String, 100 Postfach PLZ String, 30 Postfach String, 30 Land String, 3 Eindeutiges Länderkürzel ISO3 DEU Bundesland String, 3 Pflichtfeld wenn Land Deutschland. Als eindeutiges Kürzel. URL String, 200 Adresse des Stalls String, 5000 () Vorbelegt mit dem Text Stalladresse entspricht Standortadresse (Postadresse) Zertifizierungssystem String QS Attribut Schwein Tieranzahl gemeldet nicht angemeldet Die Änderung ist nur möglich, wenn der Standort noch Integer, 6 ist. EU-Öko- Verordnung kg LG/Jahr Masthähnchen Konventionell, öko Attribut Geflügel Die Änderung ist nur möglich, wenn der Standort noch nicht angemeldet ist. Das gilt für alle Kg Angaben. Seite 6 von 11

7 männlich weiblich Inklusive Putenaufzucht boolean Mehr Platz gemäß tierschutzrechtlicher Vorschriften QS-ID Zertifizierungsstelle Umsetzungszeitpunkt String, 13 Anforderungen der EU-Öko-Verordnung oder ökologischer Anbauverbände, die einen höheren Qualitätsstandard garantieren. andere tierschutzrechtliche Vorschriften, die zur Umsetzung eines höheren Platzangebots verpflichten Schwein: Für neue, und wieder angemeldete Standorte: frühestmögliches ; Max Für Standorte, die zum Zeitpunkt der Anmeldung für das neue Programm angemeldet und zugelassen sind (ggf. auch mit temporärer Sperre): frühestmögliches 2 Monate vor Ende der aktuellen Zulassung; Max. 5 Monate nach dem frühestmöglichen. Geflügel: frühestmögliches ab dem Tag/ dem Ende Registrierungsphase ( ). Oder bei einer erneuten Änderung des s, nicht in der Vergangenheit. Enddatum in der Anmeldephase: danach: max. 5 Monate in der Zukunft Die Änderung ist nur möglich, wenn der Standort noch nicht angemeldet ist. Steuersatz Dezimal 2,1 Steuersatz in % Umsatzsteuer-ID String, 20 IBAN String, 34 () BIC String, 11 () Kontoinhaber String, 100 () Für jeden Standortdatensatz wird eine Liste mit Ansprechpartner des jeweiligen Standortes gesendet. gesetzl. Vertreter Ansprechpartnertyp Ansprechpartner Krisenmanager String Stellvertr. Ansprechpartner Anrede String Herr, Frau Titel String, 20 Vorname String, 100 Nachname String, 100 Telefonnr. String, 200 Mobilnr. String, 200 Pflichtfeld nur bei Krisenmanagern Faxnr. String, 200 Seite 7 von 11

8 String, 200 Sprache String, 3 ISO3 DEU, ENG Für jeden Standortdatensatz kann eine individuelle Checkliste gesendet werden. Es wird geprüft, ob die Änderung möglich ist und ob die Checkpunkte zu der aktuellen Prüfliste passen, falls ja werden die bisherigen Checkpunkte überschrieben. 4 Nur für Schweine haltende Standorte: Nachricht individuelle Checkliste Der Bündler kann für einen Standort die individuelle Checkliste importieren. Dabei wird geprüft, ob die Checkpunkte zu der aktuellen Prüfliste passen. Produktionsart Long, 10 Standortnummer String, 30 Es wird eine Liste mit Checkpunkten der Prüfliste gesendet, die dann für den gesendeten Standort gilt. 5 Nachricht Der Bündler bündelt den gesendeten Standort. Die Voraussetzungen dafür müssen erfüllt sein. Produktionsart Long, 10 P2001, P2004, P2008, P3001, P3004 Standortnummer String, 30 Seite 8 von 11

9 6 Nachricht Name="ActivateLocation") Der Standort wird auf den Status Angemeldet gesetzt, sofern alle Bedingungen erfüllt sind. Produktionsart Long, 10 P2001, P2004, P2008, P3001, P3004 Standortnummer String, 30 7 Nachricht Name="DeactivateLocation") Der Standort wird auf den Status Abgemeldet gesetzt. Inkl. Zwei Jahres-Sperre und Entzug der Zahlungsberechtigung. Produktionsart Long, 10 P2001, P2004, P2008, P3001, P3004 Standortnummer String, 30 8 Nachricht Ein abgemeldeter Standort kann für das neue Programm wieder angemeldet werden. Je nach Produktionsart müssen andere Daten übertragen werden. Produktionsart Long, 10 P2001, P2004, P2008, P3001, P3004 Standortnummer String, 30 Umsetzungszeitpunkt Attribut Schwein Tieranzahl gemeldet Integer, 6 kg LG/Jahr Masthähnchen männlich weiblich QS-ID Vermarkter String, 13 Attribut Geflügel QS-ID des Vermarkters. Für die Zahlungsberechtigung ist die Angabe des Vermarkters zwingend notwendig Wenn es sich um einen Standort mit der Produktionsart 2001 bis 2008 handelt, muss zusätzlich eine Liste mit standortspezifischen Checkpunkten übertragen werden. Vorher muss natürlich die aktuelle Prüfliste abgerufen werden. Seite 9 von 11

10 Es wird eine Liste mit Checkpunkten der Prüfliste gesendet, die dann für den gesendeten Standort gilt. 9 Nachricht Teilnahme am Der Standort kann sich zur Teilnahme am Programm anmelden. Je nach Produktionsart müssen andere Daten übertragen werden Produktionsart Long, 10 P2001, P2004, P2008, P3001, P3004 Standortnummer String, 30 Umsetzungszeitpunkt Attribut Schwein Tieranzahl gemeldet Integer, 6 kg LG/Jahr Masthähnchen männlich weiblich QS-ID Vermarkter String, 13 Attribut Geflügel QS-ID des Vermarkters. Für die Zahlungsberechtigung ist die Angabe des Vermarkters zwingend notwendig Wenn es sich um einen Standort mit der Produktionsart 2001 bis 2008 handelt, muss zusätzlich eine Liste mit standortspezifischen Checkpunkten übertragen werden. Vorher muss natürlich die aktuelle Prüfliste abgerufen werden. Es wird eine Liste mit Checkpunkten der Prüfliste gesendet, die dann für den gesendeten Standort gilt. Seite 10 von 11

11 10 Nachricht Name="ChangeMarketer") Der Standort kann die Vermarkterzuordnung wechseln oder beenden. Die Änderung wird jeweils zum angegebenen gültig. Produktionsart Long, 10 P2001, P2004, P2008, P3001, P3004 Standortnummer String, 30 Wechseldatum QS-ID neuer Vermarkter String, 13 QS-ID des neuen Vermarkters. Die bestehende Vermarkterzuordnung wird automatisch zugunsten des neuen Vermarkters aufgelöst. Falls nicht angegeben, wird die bestehende Vermarkterzuordnung beendet ohne eine neue zu erstellen. Hierbei verliert der Standort die Zahlungsberechtigung. 11 Nachricht Abfrage Name="MarketerList") Liefert eine Liste mit allen, im System angelegten, Vermarktern, die ein gültiges Vertragsdatum in der Vergangenheit haben und deren Kündigungsdatum (falls vorhanden) noch nicht erreicht ist. Vermarktername String, 100 QS-ID String, 13 Straße String, 200 PLZ String, 10 Ort String, 100 Postfach PLZ String, 30 Postfach String, 30 Land String, 3 Eindeutiges Länderkürzel ISO3 DEU Bundesland String, 3 Pflichtfeld wenn Land Deutschland. Als eindeutiges Kürzel. URL String, 200 Gesellschaft zur Förderung des Tierwohls in der Nutztierhaltung mbh GF: Dr. Alexander Hinrichs Schedestraße Bonn Tel +49 (0) info@initiative-tierwohl.de Seite 11 von 11