Zur Homepage www.HI-Tier.de TAM/Antibiotika V.1
Zurück Home Nach oben Weiter
Öffentlicher Bereich für Entwickler

 

Inhaltsverzeichnis, Stand 25.07.2014

  1. Mitteilungspflichten
    1. Rechtliche und organisatorische Grundlagen, FAQ
    2. Pflichtmeldungen nach AMG und optionale Erweiterungen
    3. Meldewege
    4. Benennung Dritter durch Erklärung, Vollmachten
  2. Melden an HI-Tier per Programmschnittstelle
    1. HIT-Architektur - Grundlagen, Schnittstellen-Techniken und Protokoll
    2. HIT-Data-Dictionary - ein Katalog aller Meldungen, Datenelemente, Kompetenzen und Plausibilitätsprüfungen
    3. Fachliche Definition, Hilfe und Beschreibung
    4. HIT-Protokoll - Wichtige Detailaspekte
  3. HIT-Testsystem und Testzugang
    1. Allgemeine Hinweise zum Testsystem
    2. Testkennungen speziell für TAM-Belange
    3. Wichtige Hilfestellung bei der Nutzung des HIT-Protokolls und der Auswahl der richtigen Funktionen und Meldungen
  4. Fallbeispiele zu den einzelnen Meldungsarten - "use cases"
    1. Nutzungsart (nach AMG § 58a Absatz 1 und 2) - TAM_HALT...
    2. Erklärung des Halters bezüglich Dritter (nach § 58 AMG - TAM_ERKL)
    3. Tierbestandserfassung (nach § 58b AMG - TAM_BEST)
    4. Tierbestandsveränderung (nach § 58b AMG - TAM_BVER)
    5. Arzneimittel Abgabe und Anwendung (TAM_XABAW)

horizontal rule

Mitteilungspflichten nach Arzneimittelgesetz AMG § 58a,b - Antibiotika-Datenbank (TAM) in HI-Tier - Version 1 (V.1)

Rechtliche und organisatorische Grundlagen, FAQ

Die folgernden Hinweise sind rein technischer Natur. Es wird keine Gewähr für fachliche und juristische Korrektheit übernommen. Im Zweifelsfall rechtlich verbindlich sind nur Aussagen der zuständigen Veterinärbehörden der Länder.

Mit Inkrafttreten der Änderungen im Arzneimittelgesetz (AMG) sind in Deutschland Halter von Masttieren (Rinder, Schweine, Hühner, Puten) die nach der Tierarzneimittel-Mitteilungendurchführungsverordnung (TAMMitDurchV) festgelegte Bestandsuntergrenzen überschreiten, verpflichtet folgendes an die zentrale Datenbank HI–Tier zu melden:

bulletab dem 01.04.2014 die Nutzungsart (nach AMG § 58a Absatz 1 und 2) und
bulletab dem 01.07.2014 Bestand, Bestandversänderungen (nach AMG § 58b (1) 5) und Verwendung von "Antibiotika"-Arzneimitteln (nach AMG § 58b (1) 1.-4.)

Fachlich und rechtlich zuständig sind die Veterinärverwaltungen der Länder bzw. der Kreise. Einige Länder planen für die Durchführung der Aufgaben und der Mitteilungen zusätzlich Regionalstellen einzurichten, Adressen siehe www.hi-tier.de/rs-adress.html

Allgemeine Hinweise und Antworten auf häufige Fragen (FAQ) finden Sie hier bei "Info Tierarzneimittel (TAM) - Datenbank".

Pflichtmeldungen nach AMG und optionale Erweiterungen

Im Rahmen der Mitteilungspflicht nach AMG (§ 58b (1) 1.-4.) sind bestimmte Pflichtmitteilungen und dabei erforderliche Dateninhalte definiert. Darüber hinausgehend wird im Hinblick auf mögliche zukünftige Entwicklungen zur elektronischen Speicherung von Anwendungs- und Abgabebelegen (AuA) und Bestandsbuchdaten (BB) für Tierhalter und Tierärzte die Möglichkeit geschaffen, zusätzlich freiwillig Daten zu speichern, auf welche die Behörde im Rahmen der Überwachung der Antibiotika-Verwendung keinen Zugriff hat.

Diese Speichermöglichkeiten können dem elektronischen Datenaustausch zwischen Halter und Tierarzt oder sonstigen Dritten dienen und so insbesondere eine Brücke zwischen Betriebsmanagementsystemen, Praxissoftware und Management-Datenbanken u.a. von QS-Systemen bilden.

Meldewege

Zur Mitteilung stehen verschiedene Meldewege offen

bulletSchriftlich direkt bei der zuständigen Veterinärbehörde oder einer beauftragten Regionalstelle des Landes.
Ggf. einzuhaltende Formvorschriften (Meldekarten, Formulare etc.) und Kosten oder Gebühren regeln die Länder.
bulletOnline über Web-Formulare im unserem Meldeprogramm unter www.hi-tier.de
bulletPer Software-Schnittstelle an unsere zentrale Datenbank HI-Tier.

Benennung Dritter durch Erklärung, Vollmachten

Im AMG ist festgelegt, dass der Halter zur Erfüllung seiner Mitteilungspflichten Dritte beauftragen kann (Benennung eines Dritten für Mitteilungen gem. §58a und §58b AMG). Die Beauftragung ("Tierhalter-Erklärung") muss er unter Nennung des Dritten gegenüber der zuständigen Behörde anzeigen (§58a Abs. 4 AMG). Da die Schriftform nicht zwingend vorgeschrieben ist, kann das auch online erfolgen. Der Anzeigepflicht kommt er nach, wenn er die Tierhalter-Erklärung über ein elektronisches Meldeformular (im TAM-HIT-Meldeprogramm) erfasst.

ACHTUNG: Die in HI-Tier bekannten Mechanismen der HIT-Melde- bzw. Abfragevollmachten oder Hoftierarztvollmachten finden im Bereich der "Antibiotia"-Mitteilungen keine Anwendung.

Bei der Erstellung der Software ist zunächst die Grundentscheidung zu treffen wer Zielgruppe ist, d.h. aus wessen Sicht Mitteilungen abgesetzt werden sollen. Ablauf, Voraussetzung und Vorgehensweise sind geringfügig aber entscheidend unterschiedlich. Im Folgenden werden grundsätzliche Szenarien unterschieden:

  1. Tierhalter meldet für sich selbst
  2. Dritter meldet für Tierhalter
  3. Regionalstelle oder Verwaltung meldet für Tierhalter

horizontal rule

Melden an HI-Tier per Programmschnittstelle

HIT-Architektur - Grundlagen, Schnittstellen-Techniken und Protokoll

Die HI-Tier Architektur als 3 Schichtenmodell

bullet1.Schicht: Datenhaltung im zentralen Datenbanksystem
bullet2.Schicht: Applikationslogik in zentralen, redundanten Applikationsservern
bullet3.Schicht: Präsentation und Endbenutzerschnittstelle in verschiedensten Ausprägungen

Mögliche Clients in Schicht 3

bulletInteraktives GUI in Form des HIT-Meldeprogramms mit HTML-Formularen und der Möglichkeit Massenmeldungen per Datei als händischen "File-Upload". Zur Bearbeitung von einzelnen Datensätzen und beschränkten Mengen (wenige hundert) im Upload.
bulletHIT-Batch-Client, zur Stapelverarbeitung von Daten in Form von CSV- und ADIS-Format Dateien. Geeignet zur Massenverarbeitung in optimaler Geschwindigkeit, hoher Stabilität und Verfügbarkeit und fast unbegrenzter Datenmenge. Diese Programm kann auch frei in andere Softwaresysteme integriert werden. Dokumentation, Konfiguration und Download siehe .../Programme/HitBatch
bulletClients von anderen Herstellern und Stellen, die das HIT-Protokoll selbst implementieren oder die REST-Schnittstelle nutzen.

Die stabilste Übertragung mit der besten Performance ist auf jeden Fall die mittels HIT-Socketprotokoll und dabei am einfachsten per kostenlosem HIT-Batch-Client.
Für geringe bis mittlere Datenmengen (< 1.000 Datensätze pro Session) steht auch eine vereinfachte REST-Schnittstelle über HTTPS zur Verfügung, Details siehe hier unter REST-Service.

Tipp: Weitere Details zu möglichen Clients und FAQ für Software-Hersteller finden Sie unter: .../Programme/Default.htm

Das HIT-Protokoll als universale Schnittstelle zur Client-Server Kommunikation

Zur Kommunikation zwischen den Endanwendungen in Schicht 3 und der zentralen Serverlogik in Schicht 2 existiert ein eigenes IP-Socketbasiertes Kommunikationsprotokoll HITP. Diese Protokoll stellt Datenmanipulationsmöglichkeiten ähnlich dem "CRUD"-Modell bereit, Details und Protokoll-Spezifikation siehe .../Entwicklung/konzept/hitp/default.htm.

bulletCreate (Datensatz anlegen) - in HIT Nomenklatur "I:Insert" und "X:eXecute",
bulletRead oder Retrieve (Datensatz lesen) - in HIT "R:Retrieve",
bulletUpdate (Datensatz aktualisieren)  - in HIT "X:eXecute" und ggf. "U:Update"
bulletDelete oder Destroy (Datensatz löschen) - in HIT "S:Strono".

HIT-Data-Dictionary - ein Katalog aller Meldungen, Datenelemente, Kompetenzen und Plausibilitätsprüfungen

Innerhalb des HIT-Protokolls werden alle Daten in Form von Meldungen (intern "ENTITY") generisch behandelt. Die technische Beschreibung aller dieser Datenstrukturen findet sich im HIT-Data-Dictionary (siehe ../HIT-DD/). Dort befinden sich auch Kataloge alle Datenelemente mit zugehörigen Schlüssellisten,  ein Verzeichnis der Kompetenzen und alle Plausibilitätsprüfungen.

Die zentralen Meldungsarten für die TAM-Datenbank sind:

  1. Mitteilung der Nutzungsart (nach § 58a AMG - TAM_HALT)
  2. Erklärung des Halters bezüglich Dritter (nach § 58 AMG - TAM_ERKL)
  3. Tierbestandserfassung (nach § 58b AMG - TAM_BEST)
  4. Tierbestandsveränderung (nach § 58b AMG - TAM_BVER)
  5. Arzneimittel Abgabe und Anwendung (TAM_XABAW)

Beim Melden und Abrufen von Daten durch Dritte sind teilweise geringfügig modifizierte Meldearten (i. d. R. unter einem anderen Entitäten-Namen) zu benutzen. Näheres siehe unten bei den konkreten Beispielen. Eine Liste aller Meldearten ist im Data-Dictionary hier unter Meldungen mit Entity "TAM" erhältlich.

Fachliche Definition, Hilfe und Beschreibung

Fachliche Definitionen und Beschreibungen findet sich nicht im Data-Dictionary. Sofern Meldepflichten in gesetzlichen Vorschriften wie Vieh-Verkehrs-Verordnung oder Tierarzneimittelgesetzt begründet sind, ergeben sich die Grundlagen aus diesen Vorschriften.

Hilfe - Allgemein Endkunden gerechte Beschreibungen, ausführliche Hilfe und Erläuterungen zu Meldungen und Dateninhalten erhalten Sie online im Web-Meldeprogramm, unter dem Menüpunkt "Auswahlmenü Tierarzneimittel / Antibiotika (TAM)", auf den jeweiligen Eingabeseiten. Über die gelben Fragezeichen gelangen Sie direkt zum jeweiligen Hilfetest.. Das Testsystem www.hi-tier.de/hittest ist dazu völlig ausreichend, Zugangsdaten siehe unten bei HIT-Testsystem.

HIT-Protokoll - Wichtige Detailaspekte

Wahl der Vorgehensweise HIT-Protokoll oder HIT-Batch-Client

Bei der Entwicklung ist zu entscheiden ob das HIT-Protokoll selbst implementiert wird (sehr flexibel und sehr kompliziert) oder der HIT-Batch-Client (viel einfacher, aber Umweg über Dateien) Verwendung findet. In den Fallbeispielen unten wird immer das HIT-Protokoll angegeben. Eine Übertragung in die Syntax und Strukturen des HIT-Batch-Clients ist aber sehr einfach und wird hier am Beispiel demonstriert.

In den folgenden Beispielen wird immer HIT-Protokoll "lesbar" angegeben. Bei der tatsächlichen Übertragung müssen die unbedingt Daten verschlüsselt werden, beim HitBatch-Client einfach über INI-Parameter, beim HIT-Protokoll ist das mit zu implementieren - Details siehe Verschlüsselung im HIT-Protokoll

HIT-Protokoll

Bei der Kommunikation mit dem HIT-Protokoll werden die Befehle zeilenweise über eine bidirektionale IP-Socketverbindung vom Client zum HIT-Server gesendet. Der Server sendet ein oder mehrere Antwortzeilen zurück. Die Synchronisation erfolgt über Zeilenkennzeichen. Die genaue Protokoll-Spezifikation siehe .../Entwicklung/konzept/hitp/default.htm.

Beispiel: Ausführen der Anmeldung (XS:LOGON) und einfügen einer Nutzungsmeldung (IS:TAM_HALTH):

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
=... Antworten des Servers
*2:IS:TAM_HALTH/BNR15;TAMH_VON;TAMH_FORM:276091280700000;01.04.2014;PM1
=... Antworten des Servers

Die Hintergrundfarben sollen zeigen, an welcher Stelle die Bestandteile eines HIT-Protokoll-Befehls in den Steuer- und Inputdateien des HIT-Batch-Clients (siehe unten) zu finden sind.

HIT-Batch-Client

Bei der Nutzung des HIT-Batch-Clients wird im Hinterrund ebenfalls HIT-Protokoll verwendet. Der Benutzer schreibt aber Befehle (COMMAND=IS) und betroffene Meldungsarten (MELDUNG=TAM_HALTH) in eine Steuerdatei - die sogenannte INI-Datei (i.d.R. HITBATCH.INI). Die Feldnamen stehen in der ersten Zeile (BNR15;...) und die Daten (276091280700000;...) in der zweiten und ggf. nachfolgenden Zeilen der sogenannten INPUT-Datei, Details zu. Dokumentation, Konfiguration und Download siehe .../Programme/HitBatch

INI-Datei: z.B. HitBatch.INI

[SET-1]
COMMAND=IS
MELDUNG=TAM_HALTH
INFILE
=Set1.IN

INPUT-Datei: z.B. Set1.IN

BNR15;TAMH_VON;TAMH_FORM
276091280700000;01.04.2014;PM1

Tipp: Eine Zusammenstellung mit Programm ("jar"), Startdatei ("cmd"), Konfiguration ("ini"),  und Beispielen finden Sie hier unter: Dateibereich/TAM-Datenbank Test.zip

Darstellung, Schreibweise, Normierung von Datenwerten (Feldinhalte)

Der HIT-Server ist tolerant bezüglich angelieferter Wertformate und Formen. Es werden verschiedene Darstellungen und Schreibweisen akzeptiert. Hier einige Beispiele:

bulletBetriebsnummer (BNR15) kann 276091280700000 oder 091280700000 oder 09 128 070 0000 oder ...
bulletOhrmarken (LOM) als 2760009012345678 oder DE 09 123 45678
bulletDatum als 01.07.2014 oder 1.7.14
bulletSchlüssel numerisch als 123 oder Kurzcode laut Schlüsselliste PM1

Weitere Details siehe HIT Normierungen.

Der Zeitbezug in den TAM-Mitteilungen

Halbjahresbezug

Die meisten Meldearten im TAM-Bereich haben ein Datum und beziehen sich auf ein Kalenderhalbjahr, weil die Mitteilungspflicht immer halbjahresweise vorgeschrieben ist.

Meldung Entity Datum Element
Tierbestand TAM_BEST Stichtag der Bestandsmeldung TAMB_DAT
Bestandsveränderung TAM_BVER Datum der Bestandsveränderung TAMV_DAT
Arzneimittelverwendung TAM_XABAW Datum der Anwendung TAMX_AWDAT

Das korrespondierende Datenelement "Kalenderhalbjahr" (TAM_PERIOD) kann gefüllt werden oder es wird vom System ergänzt. Es darf nicht im Widerspruch zum Datum stehen.

Zeitraumbezug

Einige Meldearten im TAM-Bereich sind nicht direkt auf Halbjahre bezogen, sondern sondern haben einen Beginnzeitpunkt und ggf. einen Endzeitpunkt. Es handelt sich hierbei eine Zeitraum bezogene Angaben mit einen sogenannten fachlichen Gültigkeit.

Meldung Entity Zeitraum Von-Element Von-Element
Nutzungsart TAM_HALT Beginn - Ende der Haltung einer Nutzungsart TAMH_VON TAMH_BIS
Erklärung eine Dritten TAM_ERKL Beginn - Ende des Vorliegens von Rechten für den benannten Dritten TAME_VON TAME_BIS

Dabei sind folgende Feinheiten zu beachten:

bulletWird das VON-Feld (also der Beginn des Zeitraumes) beim Senden nicht, leer oder als NULL übertragen wird ein Default gesetzt, hier das aktuelle Datum (mit Uhrzeit 00:00:00.000000)
bulletWird das BIS-Feld (also das Ende) nicht, leer oder als NULL übertragen wird der 31.12.2100 (mit Uhrzeit 00:00:00.000000) als Default gesetzt und das bedeutet OFFEN / UNBEGRENZT
bulletVON und BIS sind technisch als Timestamp definiert und werden inklusive Uhrzeit (bis Mikrosekunden [µs], d.h. 10-6 Sekunden [s]) gespeichert. Aber momentan dürfen nur "ganze Datumswerte" benutzt werden, d.h. Uhrzeit weglassen oder nur 00.00..... verwenden.
bulletAchtung: Im BIS-Feld steht die erste Mikrosekunde wann die Aussage nicht mehr gilt
Beispiel: Wenn ein Halter nur ein ganzes Jahr, also umgangssprachlich vom 1.Januar bis einschließlich 31.Dezember 2014 (den ganzen Tag) Masthühnchenhalter war, ist technisch im Bis-Feld die Mikrosekunde zu nennen, ab wann er nicht mehr Masthühnchen hält, also den 01.01.2015.00.00.00.000000 !
*2:IS:TAM_HALTH/BNR15;TAMH_VON;TAMH_BIS;TAMH_FORM:276091280700000;01.01.2014.00.00.00.000000;01.01.2015.00.00.00.000000;HM1
alternativ ist folgende Schreibweise beim Anliefern erlaubt (um das Ende des Tages an zu deuten) - die Speicherung erfolgt aber als 1.1.2015
*2:IS:TAM_HALTH/BNR15;TAMH_VON;TAMH_BIS;TAMH_FORM:276091280700000;01.01.2014.00.00.00.000000;31.12.2014/24.00;HM1

Mandatory vs. optional vs. System

Bei der Beschreibung der Zuordnung von Meldungen und Elementen ("HIT Meld-Elemente") im HIT-Data-Dictiornary existiert einen Spalte "Required" mit folgendem Inhalt:

Abkürzung Bedeutung Erforderlich Hinweis
PK-x Primary Key, fortlaufende Nummer x=1..n JA Felder, die technisch zum Speichern erforderlich sind (Erforderlich=JA), können beim Anliefern teilweise leer gelassen werden, falls in der Beschreibung ein DEFAULT angegeben ist.
MAN Mandatory, Pflichtfeld JA
OPT Optional, freiwillige Angaben NEIN Felder, die technisch zum Speichern nicht erforderlich sind (Erforderlich=NEIN), können aus fachlogischen Gründen manchmal doch Pflichtfelder sein und müssen dann i.d.R. beim Senden angegeben werden.
SYS Systemfeld, wird i.d.R. durch ZDB gefüllt NEIN
GUID Globally Unique Identifier, Systemschlüssel JA Kann vom sendenden System generiert werden, wird andernfalls von HIT gefüllt, Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (lower case)

In der Spalte "Erforderlich" ist erkennbar, was Pflichtfelder und was freiwillige Angaben in technischen Hinsicht sind. In den Hinweise wird verdeutlicht, dass aus fachlicher Sicht teilweise davon abgewichen werden kann. 

Plausibilitätsprüfungen

Im HIT-Server werden für den angelieferte Satz eine Vielzahl von Prüfungen ("a priori") durchgeführt. Je nach maximaler Fehlerschwere wird der Satz mit Erfolgsmeldung oder mit Hinweisen verarbeitet, in Zweifelsfällen eine Nachfrage generiert oder im Fehlerfall die weitere Verarbeitung abgelehnt. Alle gespeicherten Sätze werden später noch mal untereinander auf Vollständigkeit und Widerspruchsfreiheit getestet ("a posteriori"). Allgemeines zu Plausibilitätsprüfungen und Fehlerhandling siehe "Plausi allgemein", eine Liste der Plausibilitätsprüfungen und möglichen daraus resultierenden Fehlercodes und Fehlermeldungen siehe Data-Dictionary unter HIT-Plausi-Prüfungen zur jeweiligen Entität.

Primärschlüssel - Die Bedeutung des primary key (PK) und die Konsequenzen

Standard in HI-Tier

Wenn die Plausibilitätsprüfungen fehlerfrei absolviert wurden, wird der Satz anhand seines Primärschlüssels in der Datenbank gesucht. Welche Spalten allein oder zusammen genommen den PK bilden ist im Data-Dictionary ebenfalls in der Spalte "Required"  unter "HIT Meld-Elemente" ersichtlich.

Command PK gefunden Daten identisch Konsequenz Schwere/Plausi : Text
I - INSERT Nein  --- Neuer Satz wird gespeichert 0/130:Die Meldung wurde abgespeichert.
Ja Nein Speichern wird abgelehnt mit Fehler 3/132:Es liegen bereits andere Daten für diese Meldung vor, Speichern wurde abgelehnt.
Ja Ja Speichern nicht notwendig mit Hinweis 1/133:Diese Meldung liegt bereits identisch vor und wurde deshalb ignoriert.
X - EXECUTE Nein  --- Neuer Satz wird gespeichert 0/138:Die Meldung wurde ausgeführt und neu abgespeichert.
Ja Nein Satz wird geändert 0/139:Die Meldung wurde ausgeführt und als Änderung abgespeichert.
Ja Ja Speichern nicht notwendig mit Hinweis 1/133:Diese Meldung liegt bereits identisch vor und wurde deshalb ignoriert.
U - UPDATE Nein  --- Kein Update, mit Hinweis 1/187:Die angegebene Meldung wurde nicht gefunden, Update nicht ausgeführt.
Ja Nein Update wird durchgeführt 0/188:Die Meldung wurde ausgeführt und als Änderung abgespeichert.
Ja Ja Update nicht notwendig mit Hinweis 1/133:Diese Meldung liegt bereits identisch vor und wurde deshalb ignoriert.
S - STORNO Nein  --- Kein Storno, mit Hinweis 1/141:Die angegebene Meldung wurde nicht gefunden, Storno nicht ausgeführt.
Ja Nein Kein Storno, mit Fehler 3/148:Die angegebenen Daten stimmen nicht mit der Meldung in der Datenbank überein, Storno abgelehnt.
Ja Ja Storno wird durchgeführt 0/140:Die Meldung wurde storniert.

Globally Unique Identifier (GUID)

Da bei komplexen, mehrteiligen Schlüsseln die Handhabung teilweise recht kompliziert ist, insbesondere wenn - wie bei Arzneimittelanwendung noch ggf. automatisch hochzählbare laufende Nummern enthalten sind, wird für ausgewählte Entitäten zusätzlich eine Identifikationsspalte mit einem Globally Unique Identifier (GUID) eingeführt. Diese kann vom Anwender beim Senden generiert werden oder falls nicht geliefert wird sie vom System gebildet und gefüllt. Die GUID kann dann nachfolgend anstelle des Primärschlüssels zur Identifikation verwendet werden, technische Hintergrundinformation dazu unter Systemschlüssel GUID.

horizontal rule

HIT-Testsystem und Testzugang

Allgemeine Hinweise zum Testsystem

Die komplette Funktionalität des System von HI-Tier steht in einem Testsystem öffentlich zur Verfügung. In diesem System sollten aus Gründen des Datenschutzes auf keinen Fall reale Daten mit Personen oder Betriebsbezug verarbeitet werden! Das System ist explizit nicht für Massentest oder Geschwindigkeitstest ausgelegt. Wir behalten uns vor, jederzeit ohne Rücksprache mit den Urhebern (die ja i. d. R. gar nicht ermittelbar sind) Daten aus dem Testsystem zu löschen.

Dieses Testsystem ist online erreichbar über die Testversion des Meldeprogramms unter www.hi-tier.de/hittest, oder per HIT-Protokoll über der Socket-Port 2223 (weitere Hinweise zu verfügbaren Serveradressen und Ports siehe www.hi-tier.de/Entwicklung/technik/techinfo.htm)

Testkennungen speziell für TAM-Belange

 Betriebsnummer    PIN      Betr.Typ   Beschreibung
 09 128 070 0000  900000 1  Rinderhalter 0
 09 128 070 0001  900000 1  Rinderhalter 1
 09 128 070 0002  900000 1  Rinderhalter 2
 09 128 070 0003  900000 1  Rinderhalter 3
 09 128 070 0004  900000 1  Rinderhalter 4
 09 128 070 0005  900000 1  Rinderhalter 5
 09 128 070 0006  900000 1  Rinderhalter 6
 09 128 070 0007  900000 1  Rinderhalter 7
 09 128 070 0008  900000 1  Rinderhalter 8
 09 128 070 0019  900000 1  Rinderhalter 9
 09 128 070 0010  900000 4  Schlachtbetrieb
 09 128 070 0011  900000 1  Rinderhalter               
 09 128 070 0012  900000 31  Schweinehalter             
 09 128 070 0013  900000 125  Geflügelhalter             
 09 128 070 0014  900000 1,31  Rind/Schweinehalter        
 09 128 070 0015  900000 1,125  Rind/Geflügelhalter        
 09 128 070 0016  900000  1,31,125  Rind/Schwein/Geflügelhalter
 09 128 070 0085  900000 85  Tierarzt
 09 128 070 0090  900000  8,95,93    TAM-Verwaltung (alles)
 09 128 070 0091  900000 91  TAM-Verwaltung - Land
 09 128 070 0092  900000 92  TAM-Verwaltung - Reg.Bez.
 09 128 070 0093  900000 93  TAM-Verwaltung - Kreis
 09 128 070 0094  900000 94  TAM-Verwaltung - Bund
 09 128 070 0095  900000 95  TAM-Regionalstelle (RS)
 09 128 070 0710  900000 710  TAM-Regionalstelle nur meldpfl. TAM-Daten (landesweit)                
 09 128 070 0711  900000 711  TAM-Regionalstelle pfl/nicht meldepfl. TAM-Daten (für LKR)    
 09 128 070 0712  900000 712  TAM-Regionalstelle nur meldpfl. TAM-Daten (für den LKR)         
 09 128 070 0713  900000 713  Benannter Dritter (TAM) gem. Tierhalter-Erklärung

Diese Testbenutzer können online im Web, im HIT-Batch-Client oder auch direkt im HIT-Protokoll verwendet werden um mit dem HIT-Testsystem zu arbeiten. Ein Anmelden im "echten" Produktionssystem ist damit nicht möglich. Von "Tests" im Produktionssystem wird dringend abgeraten.

Wichtige Hilfestellung bei der Nutzung des HIT-Protokolls und der Auswahl der richtigen Funktionen und Meldungen

Hinter der Web-Oberfläche wird auch immer das HIT-Protokoll benutzt um mit der zentralen Applikationslogik zu kommunizieren.

Sie können sich diese Befehle anzeigen lassen indem Sie

bulleteine gewünschte Funktion zuerst ausführen (egal ob "Einfügen", "Ändern", "Stornieren" "oder "Abfragen")
bulletund dann über "Hauptmenü" / "weitere Abfragen und Funktionen" / "Anzeige der zuletzt ausgeführten internen Befehle (HITP)" die Befehle anzeigen lassen.

Diese HITP-Befehle können praktisch 1:1 analog im HIT-Batch-Client oder eigenen Programmen verwendet werden.

Damit lässt sich auch die Frage beantworten, welche "Rückantworten" kommen. Sie müssen dazu bei der "Anzeige HitProtokoll-Befehle" mittels Schaltfläche "Fehlertexte merken" die erweiterte Protokollierung aktivieren und dann die Funktion nochmals ausführen.

horizontal rule

Fallbeispiele zu den einzelnen Meldungsarten - "use cases"

Nutzungsart (nach AMG § 58a Absatz 1 und 2) - TAM_HALT...

Erläuterungen, Voraussetzungen, Hintergründe

Der Halter muss seit dem 1.4.2014 seine Nutzungsart entsprechend der Kategorien des AMG angeben. Angaben zu Produktionsrichtung oder Betriebstyp aus den HIT-Stammdaten sind nicht kompatibel. Diese Angabe ist nicht für jedes Kalenderhalbjahr vorzunehmen, sondern wird in Form einer Zeitraumsangabe gehandhabt - mit Beginn einer fachlichen Gültigkeit (Von) und einem fixierten oder offenen Ende (Bis). Weitere Details zu Von-Bis-Zeiträumen siehe oben bei Zeitraumbezug.

Es ist zu beachten, dass bei der Nutzungsart der Codeset TAMH_FORM zum Einsatz kommt. Dort sind auch nicht mitteilungspflichtige Nutzungsarten aufgeführt. Durch Speichern einer mitteilungspflichtige Nutzungsart kann der Halter Daten zum Tierbestand, Bestandsveränderung und Arzneimittelverwendung in HI-Tier erfassen, ohne dass die Arzneimittel-Überwachungsbehörde darauf Zugriff hat. Sollte sich am Ende des Halbjahres ergeben, dass die Bestandsuntergrenze überschritten ist (es ist geplant einen entsprechenden Hinweis für den Halter online an zu zeigen) und der Halter damit doch mitteilungspflichtig ist, kann er die Nutzungsart einfach von "nicht mitteilungspflichtig" auf "mitteilungspflichtig" ändern. Damit gibt er dann die Daten für die Behörde frei und braucht sie nicht erneut einzugeben.

Weitere Erläuterungen dazu finden Sie auf der Hilfeseiten zu Eingabe Nutzungsart im Onlineprogramm.

Create: Einfügen / Speichern - I:INSERT

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:IS:TAM_HALTH/BNR15;TAMH_VON;TAMH_FORM:276091280700000;01.04.2014;PM1

Der Halter meldet sich mit seiner Betriebsnummer und PIN an, Beschreibungen zu den weiteren Feldern der LOGON-Entity siehe Data-Dictionary unter LOGON.

Anschließend sendet er den INSERT-Befehl zum Einfügen einer Nutzungsart. Im Bereich "Nutzungsart" gibt es verschiedene Entitäten mit geringfügig unterschiedlichen Rechten und Einsatzgebieten, zur Meldung des Halter ist immer TAM_HALTH zu verwenden.

Read: Lesen - R:RETRIEVE

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:RS:TAM_HALTH/*:BNR15;=;276091280700000;ORDER;TAMH_FORM;TAMH_VON

Zur Kontrolle kann der Halter alle seine Nutzungsarten abrufen.

Update: Ändern - X:EXECUTE

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:XS:TAM_HALTH/BNR15;TAMH_VON;TAMH_BIS;TAMH_FORM:276091280700000;01.04.2014;31.12.2014.24.00;PM1

Der Halter kann die Nutzung ändern. Hier z.B. beendet er die Nutzung durch Ändern des Endedatum, weil er diese Nutzung zum Ende des Jahres aufgibt. Die Aussage, dass er mal die Nutzungsart betrieben hat ist weiterhin gültig. Es handelt sich hie um eine fachliche Änderung.

Delete: Löschen - S:STORNO

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:SS:TAM_HALTH/BNR15;TAMH_FORM:276091280700000;PM1

Das Stornieren ist vom obigen Beenden zu unterscheiden und bedeutet die Aussage war nicht korrekt so und muss entfernt werden. Ein richtiges Löschen durch den Benutzer ist nicht vorgesehen und erfolgt technisch in der Datenbank erst am Ende der vorgeschriebenen Aufbewahrungspflichten. Es handelt sich hier um eine Korrektur.

Unterschiede wenn ein beauftragter Dritter Nutzungsarten meldet

Damit der Dritte melden kann muss eine entsprechende Erklärung des Halters bei der Behörde vorliegen, fachliche Grundlagen siehe oben bei Benennung Dritter durch Erklärung. Bei der Meldung selbst gibt es praktisch keine Unterschiede zum Vorgehen des Halters. Halter und Dritter können die Daten zur Nutzungsart des Halters wechselseitig einfügen, ändern oder stornieren. Eine exakte Absprache zwischen den Parteien ist notwendig. Es ist ersichtlich wer die jeweilige Änderung vorgenommen hat.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:IS:TAM_HALTH/BNR15;TAMH_VON;TAMH_FORM:276091280700019;01.04.2014;PM1

Der Dritte meldet sich mit seiner Betriebsnummer und PIN an und sendet den INSERT-Befehl zum Einfügen einer Nutzungsart.

Zum Ändern, insbesondere Beenden/Abschließen kann analog der XS-Befehl verwendet werden.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:XS:TAM_HALTH/BNR15;TAMH_VON;TAMH_BIS;TAMH_FORM:276091280700019;01.04.2014;31.12.2014.24.00;PM1

Zum Stornieren, also entfernen ("löschen") einer Nutzung kann analog der SS-Befehl verwendet werden.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:SS:TAM_HALTH/BNR15;TAMH_FORM:276091280700019;PM1

Zur Kontrolle der von ihm eingegebenen Daten kann der Dritte sie über die Meldeentität abrufen.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:RS:TAM_HALTH/*:BNR15;=;276091280700019;AND;MELD_BNR;=;09 128 070 0713;ORDER;TAMH_FORM;TAMH_VON
Erfolgsmeldung: Anzahl Datenzeilen - 1

Achtung: Im Gegensatz zum Halter muss er aber zusätzlich in der Abrufbedingung spezifizieren, dass er sich auf die eigen gemeldeten Daten beschränken möchte (andernfalls erhält er eine Fehlermeldung).

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:RS:TAM_HALTH/*:BNR15;=;276091280700019;ORDER;TAMH_FORM;TAMH_VON
Fehler in Bedingung. - Der angegebene Wert liegt nicht im Kompetenzbereich - 276091280700019

Falls der Dritte in der Erklärung Abrufrecht auf Nutzungsartdaten (unabhängig ob er sie selbst gemeldet hat) eingeräumt bekommt, kann er alle Nutzungen des Betriebs über die Sicht ("view") TAM_HALTD abrufen.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:RS:TAM_HALTD/*:BNR15;=;276091280700019;ORDER;TAMH_FORM;TAMH_VON
Erfolgsmeldung: Anzahl Datenzeilen - 2

horizontal rule

Erklärung des Halters bezüglich Dritter (nach § 58 AMG) - TAM_ERKL

Erläuterungen, Voraussetzungen, Hintergründe

Der Halter kann zur Erfüllung seiner Mitteilungspflichten Dritte beauftragen (siehe oben). Diese Beauftragung ("Tierhalter-Erklärung") kann er auch über Schnittstelle senden. Die Erklärung ist analog der Nutzungsangabe oben Zeitraum bezogen.

Es ist zu beachten, dass hier in TAM_ERKL bei der Nutzungsart der Codeset TAME_FORM zum Einsatz kommt. Es gibt momentan nur "mitteilungspflichtig" und zusätzlich "Sämtliche ..." für alle gemeinsam undifferenziert.

Die Erklärungen haben differenzierte Wahlmöglichkeiten bezüglich der Erteilung von Zugriffsmöglichkeiten für den Dritten, differenziert nach Senden / Abrufen und nach Meldungsart Bestand / Nutzung / Arzneimittelverwendung. Weitere Erläuterungen dazu finden Sie auf der Hilfeseiten zu Eingabe Tierhalter-Erklärung bezgl. Dritter im Onlineprogramm.

Create: Einfügen / Speichern - I:INSERT

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:IS:TAM_HALTH/BNR15;TAMH_VON;TAMH_FORM:276091280700000;01.04.2014;PM1

Read, Update, Delete ...

analog oben...

Unterschiede wenn ein beauftragter Dritter meldet

Es ist explizit nicht möglich, dass der Dritte die Erklärung per Schnittstelle sendet. Es ist mit der zuständigen Stellen der Länder abzusprechen ob es akzeptiert wird, dass der Dritte ausgefüllte und unterschriebene, Maschinen lesbare Formulare von seinen Kunden einsammelt und bei der Behörde einreicht. Wir bei HI-Tier nehmen keine schriftliche Formulare entgegen!

horizontal rule

Tierbestandserfassung (nach § 58b AMG) - TAM_BEST

Erläuterungen, Voraussetzungen, Hintergründe

Der Halter muss den Tierbestand für jede mitteilungspflichtige Nutzungsart und und jedes Kalenderhalbjahr melden. Der Stichtag ist jeweils der 1.Januar bzw. 1.Juli 00:00 Uhr. Bestandsveränderungen zum diesem Stichtag sollten bereits separat als Veränderungen (in TAM_BVER siehe unten) gemeldet werden. Spätester Termin für die Abgabe dieser Meldung ist 14 Tage nach Ende des Kalenderhalbjahres. Es kann aber jederzeit ab dem Stichtag gemeldet werden. Eine Korrektur ist bis zum Fristende jederzeit möglich.

Es ist zu beachten, dass hier in TAM_BEST bei der Nutzungsart der Codeset TAMB_FORM zum Einsatz kommt. Ein Unterscheidung zwischen "nicht mitteilungspflichtig" auf "mitteilungspflichtig" findet nicht statt. Die Steuerung der Relevanz für die behördliche Mitteilungspflicht erfolgt allein aufgrund der aktuellen Angaben in der Meldung "Nutzungsart" (siehe oben).

Weitere Erläuterungen dazu finden Sie auf der Hilfeseiten zu Eingabe Tierbestand/Bestandsveränderungen im Onlineprogramm.

Create: Einfügen / Speichern - I:INSERT

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:IS:TAM_BEST/BNR15;TAMB_DAT;TAMB_FORM;TAMB_ANZ;TAM_PERIOD:276091280700000;01.07.2014;11;100;142

Read, Update, Delete ...

analog oben...

Unterschiede wenn ein beauftragter Dritter Tierbestandsdaten meldet

Bei der Meldung gibt es praktisch keine Unterschiede zum Vorgehen des Halters. Ausführlicher beschrieben ist es auch oben bei Unterschiede wenn ein beauftragter Dritter Nutzungsarten meldet.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:IS:TAM_BEST/BNR15;TAMB_DAT;TAMB_FORM;TAMB_ANZ;TAM_PERIOD:276091280700019;01.07.2014;PM1;100;142
*3:XS:TAM_BEST/BNR15;TAMB_DAT;TAMB_FORM;TAMB_ANZ;TAM_PERIOD:276091280700019;01.07.2014;PM1;101;142
*4:SS:TAM_BEST/BNR15;TAMB_DAT;TAMB_FORM;TAM_PERIOD:276091280700019;01.07.2014;PM1;142
*5:XS:TAM_BEST/BNR15;TAMB_DAT;TAMB_FORM;TAMB_ANZ;TAM_PERIOD:276091280700019;01.07.2014;PM1;102;142
*6:RS:TAM_BEST/*:BNR15;=;276091280700019;ORDER;TAMB_DAT
Fehler in Bedingung. - Der angegebene Wert liegt nicht im Kompetenzbereich - 276091280700019
*7:RS:TAM_BEST/*:BNR15;=;276091280700019;AND;MELD_BNR;=;09 128 070 0713;ORDER;TAMB_DAT
Anzahl Datenzeilen - 1
*8:RS:TAM_BESTD/*:BNR15;=;276091280700019;ORDER;TAMB_DAT
Anzahl Datenzeilen - 2

horizontal rule

Tierbestandsveränderung (nach § 58b AMG) - TAM_BVER

Erläuterungen, Voraussetzungen, Hintergründe

Bestandsveränderungsmeldungen sind für jede mitteilungspflichtige Nutzungsart und und jedes Datum mit Änderungen am Bestand im Kalenderhalbjahr separat zu melden. Es gibt unterschiedliche Rechtsauffassungen ob Tod/Verendung meldepflichtig sind. Wir gehen nach aktuellen Vorgaben der Länder momentan davon aus, dass die mitteilungspflichtig ist. Diesbezügliche Fragen stellen Sie bitte an die zuständigen Verwaltungsstellen der Länder. Die Anmerkungen von oben bei Tierbestandserfassung treffen hier analog zu.

Weitere Erläuterungen dazu finden Sie auf der Hilfeseiten zu Eingabe Tierbestand/Bestandsveränderungen im Onlineprogramm.

Create: Einfügen / Speichern - I:INSERT

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:IS:TAM_BVER/BNR15;TAMV_DAT;TAMB_FORM;TAMV_ART;TAMV_ANZ;TAM_PERIOD:276091280700000;30.08.2014;11;BZU;100;142

Read, Update, Delete ...

analog oben...

Unterschiede wenn ein beauftragter Dritter Tierbestandsveränderungen meldet

Bei der Meldung gibt es praktisch keine Unterschiede zum Vorgehen des Halters. Ausführlicher beschrieben ist es auch oben bei Unterschiede wenn ein beauftragter Dritter Nutzungsarten meldet.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:IS:TAM_BVER/BNR15;TAMV_DAT;TAMB_FORM;TAMV_ART;TAMV_ANZ;TAM_PERIOD:276091280700019;02.07.2014;PM1;BZU;100;142
*3:XS:TAM_BVER/BNR15;TAMV_DAT;TAMB_FORM;TAMV_ART;TAMV_ANZ;TAM_PERIOD:276091280700019;02.07.2014;PM1;BZU;101;142
*4:SS:TAM_BVER/BNR15;TAMV_DAT;TAMB_FORM;TAMV_ART;TAM_PERIOD:276091280700019;02.07.2014;PM1;BZU;142
*5:XS:TAM_BVER/BNR15;TAMV_DAT;TAMB_FORM;TAMV_ART;TAMV_ANZ;TAM_PERIOD:276091280700019;02.07.2014;PM1;BZU;102;142
*6:RS:TAM_BVER/*:BNR15;=;276091280700019;ORDER;TAMV_DAT;TAMV_ART
Fehler in Bedingung. - Der angegebene Wert liegt nicht im Kompetenzbereich - 276091280700019
*7:RS:TAM_BVER/*:BNR15;=;276091280700019;AND;MELD_BNR;=;09 128 070 0713;ORDER;TAMV_DAT;TAMV_ART
Anzahl Datenzeilen - 1
*8:RS:TAM_BVERD/*:BNR15;=;276091280700019;ORDER;TAMV_DAT;TAMV_ART
Anzahl Datenzeilen - 2

horizontal rule

Arzneimittel Abgabe und Anwendung - TAM_XABAW

Erläuterungen, Voraussetzungen, Hintergründe

Die Verwendung antibakteriell wirksamer Substanzen ist für jede mitteilungspflichtige Nutzungsart und und jede Anwendung im Kalenderhalbjahr separat zu melden. Spätester Termin für die Abgabe dieser Meldung ist 14 Tage nach Ende des Kalenderhalbjahres.

Die Datenstruktur beinhaltet Elemente für freiwillige elektronischen Speicherung von Anwendungs- und Abgabebelegen (AuA) und Bestandsbuchdaten (BB) für Tierhalter und Tierärzte über die Mitteilungspflicht nach AMG hinaus. Auf diese Daten hat die Überwachungsbehörde keinen Zugriff.

Da die Inhalte der verschiedenen Datenelemente einigen besonderen, technischen Anforderungen genügen müssen werden die Felder aus technischer Warte näher erläutert. Die fachliche und inhaltliche Beschreibung entnehmen sie bitte hier der Hilfe im Online-Meldeprogramm.

Pflichtangaben nach AMG-Mitteilungspflicht

bulletHalter (BNR15_HA)
bulletDatum der Anwendung oder Abgabe - unspezifisch, Details siehe unten bei "technisch erforderlich"
bulletNutzungsart, analog zu Bestand nicht differenziert (TAMB_FORM)
bulletAnzahl Tiere (TAMX_TIANZ)
bulletName des verwendeten Arzneimittels, Details siehe unten
bulletAnwendungsmenge (TAMX_AWMEN) und Maßeinheit (TAMX_AW_ME), kann ggf. vom System errechnet werden als: Dosis * Behandlungstage * Tierzahl
bulletDauer der Anwendung ("Behandlungstage") (TAMX_BEHAT)
bulletWirkungstage (TAMX_WIRKT) - wenn nicht geliefert, kann Wert vom System aus den Behandlungstagen und dem Arzneimittel automatisch errechnet werden., fachliche Erklärung siehe Online-Hilfe.

Zusätzlich technisch erforderlich für die Datenübertragung

bulletBetriebsnummer des Urhebers der Daten, also der Halter oder der Dritte (BNR15)
bulletDatum der Anwendung (TAMX_AWDAT),
falls eine Abgabe mit Datum der Abgabe (TAMX_ABDAT) gemeldet wird, wird ggf. das Anwendungsdatum mit Abgabedatum gefüllt
bulletZulassungsnummer des verwendeten Arzneimittels (TAMA_ZNR) oder eindeutiger Arzneimittelname (TAMA_NAME). Falls nur eines von beiden geliefert wird das andere vom System gefüllt. Bei Änderungen des Namens zu einer Zulassungsnummer kann es ggf. zu Unschärfen kommen.
Leider ist es uns momentan nicht gestattet Ihnen den Katalog mit den Arzneimittelnamen und den Zulassungsnummern zur Verfügung zu stellen.
Es ist Ihnen auch nicht gestattet die entsprechenden Arzneimitteldaten von unserer Website herunter zu laden und in Ihre Programm zu importieren.
© - Copyright: Rechteinhaber für diese Daten ist das Bundesinstitut für Arzneimittel und Medizinprodukte (BfArM); Details hierzu www.dimdi.de/static/de/db/dbinfo/copyrights/bfarm.htm.
bulletArt der Verwendung: Anwendung oder Abgabe (TAMX_ABAW)
bulletlaufende Nummer pro Tierart/Nutzungsart wenn mehr als ein Eintrag für den primary key (TAMX_LFNR), vom System wird für den ersten Eintrag problemlos eine 1 vorbesetzt. Weitere Einträge werden nur nach Nachfrage hoch gezählt. Das kann modifiziert werden mittels Dummywert "+" (Plus: immer hoch zählen) oder "-" (Minus: Stopp, nicht hoch zählen).
Bei Datenänderungen sollte immer die betreffende laufende Nummer angegeben werden.
bulletSystemschlüssel oder Globally Unique Identifier (GUID) - zur Vereinfachung der Identifikation eines Datensatzes und zur Vermeidung von Problemen mit der laufenden Nummer, siehe oben GUID
bulletKennzeichen für Korrekturbeleg (TAMX_KORR), in der Regel 0 "Originaldatensatz, es existiert kein Korrekturdatensatz"
bulletwenn eine Korrektur dokumentiert werden soll, kann der alte Beleg auf 2 "hinfälliger Originaldatensatz, nicht mehr für Berechnungen heran ziehen" gesetzt werden
bulletund einer neuer Datensatz mit 1 "Korrekturdatensatz, der einen Originaldatensatz ersetzt" gespeichert werden. Für die Berechnung werden Datensätze  mit Kennzeichen 0 und 1 verwendet.

Zusätzlich erforderlich für Speicherung - wird aber i.d.R. automatisch vom System ergänzt werden

bulletKalenderhalbjahr, wird aus Anwendungs- oder Abgabedatum ermittelt, kann aber zur Qualitätssicherung mitgeliefert werden (TAM_PERIOD)
bulletArzneimittelmeldung für die Behörde zugänglich (TAMX_ABDB), für Mitteilungen nach AMG immer 1:"Ja"
bulletBelegart (TAMX_BEART), wenn leer wird vom System Default 4:"AMG-Meldung" ergänzt
bulletKennzeichen ob Daten bei Meldung für AMG beabsichtigt sind (TAMX_AMG). Insbesondere wenn Erklärungen bezüglich Dritter vorliegen oder beabsichtigt sind kann diese Angabe zur Qualitätssicherung dienen. Wenn keine Angaben geliefert werden, setzt das System den Wert automatisch entsprechend ob eine Erklärung bezüglich Dritter vorliegt.
bulletBeispiel 1: Halter meldet, keine Erklärung bezüglich Dritter liegt vor: BNR15 = BNR15_HA = Halter, TAMX_AMG = 1
bulletBeispiel 2: Dritter meldet, eine Erklärung bezüglich Dritter liegt vor: BNR15 = Dritter, BNR15_HA = Halter, TAMX_AMG = 1
bulletBeispiel 3: Dritter meldet, die Erklärung wurde per Papier geschickt und noch nicht eingetragen: BNR15 = Dritter, BNR15_HA = Halter, ....
bulletDritter möchte AMG relevante Meldung machen, lässt aber TAMX_AMG leer, System füllt eine 0:"nicht für AMG" (weil Erkl. noch nicht da) - schlecht
bullet -- " --, Dritter setzt TAMX_AMG = 1 "für AMG gedacht" - jetzt kommt wenigstens Fehler der auf den Widerspruch hinweist - besser
bulletTierart als freie Eingabe, insbesondere für sonstige Tiere die nicht der AMG-Meldepflicht unterliegen für freiwillige (TAMX_TIART), mandatory mit Default LEER
bulletIdentität (TAMX_IDENT), freiwillige Angabe für Bestandsbuch, zwar mandatory (MAN), wird ggf. automatisch vom System auf Default LEER gesetzt
bulletStandort (TAMX_STORT), freiwillige Angabe für Bestandsbuch, analog zu Identität

Speziellen Hinweise zu weitere Elementen

bulletVerantwortlicher Tierarzt (BNR15_TA), speziell für AuA-Beleg und BB, bei AMG kann das benutzt werden um zu prüfen ob ggf. notwendige Versicherungen des Halter vorliegen, dass er bei Abgabemeldungen nicht von den Anweisungen des Tierarztes abgewichen ist
bulletDosierung des Arzneimittels pro Tier und Tag (TAMX_DOSIS) und zugehörige Maßeinheit (TAMX_DO_ME), kann alternativ zu Anwendungsmenge gegeben werden
bulletAbgabemenge (TAMX_ABMEN) und zugehörige Maßeinheit (TAMX_AB_ME), speziell für AuA-Beleg und BB
bullet... - die weiteren Felder sind für AuA-Beleg und BB. Es existieren dazu momentan keine speziellen Ausfüllvorschriften in der Datenbank

Weitere Erläuterungen dazu finden Sie auf der Hilfeseiten zu Eingabe Verwendung antibakteriell wirksamer Substanzen im Onlineprogramm.

Create: Einfügen / Speichern - I:INSERT

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0000;900000;3;1200
*2:XS:TAM_XABAW/BNR15;BNR15_HA;TAMX_BEART;TAMX_AWDAT;TAMX_ABAW;TAMA_ZNR;TAMB_FORM;TAMX_LFNR;TAMX_TIANZ;TAMX_AWMEN;TAMX_BEHAT;TAMX_WIRKT;TAMX_AMG:
                276091280700000;276091280700000;4;02.07.2014;2;ZNR-091280700001;11;;10;123;3;3;1

*3:XS:TAM_XABAW/BNR15;BNR15_HA;TAMX_BEART;TAMX_AWDAT;TAMX_ABAW;TAMA_ZNR;TAMB_FORM;TAMX_LFNR;TAMX_TIANZ;TAMX_AWMEN;TAMX_BEHAT;TAMX_WIRKT;TAMX_AMG:
                276091280700000;276091280700000;4;02.07.2014;2;ZNR-091280700001;11;;10;123;3;6;1            (
siehe unten *1) Hinweis)

*1) Hinweis: Zeilenumbruch nur zur besseren Lesbarkeit, im HIT-Protokoll ist der Befehl in einer Zeile zu schreiben

Read, Update, Delete ...

analog oben...

Unterschiede wenn ein beauftragter Dritter meldet

Damit der Dritte melden kann muss eine entsprechende Erklärung des Halters bei der Behörde vorliegen, fachliche Grundlagen siehe oben bei Benennung Dritter durch Erklärung. Bei der Meldung von Arzneimittel-Verwendungen gibt es bei der Erklärung detaillierte Abstufungen, die Auswirkung auf die Meldemöglichkeit des Dritte, die "AMG Relevanz"  und den Zugriff der Behörden der Daten haben. Zu beachten ist dabei insbesondere auch mögliche Doppelmeldung von Halter und Drittem, siehe oben Pflichtmeldungen nach AMG und optionale Erweiterungen.

Weitere Erläuterungen dazu finden Sie auf der Hilfeseiten zu Eingabe Erklärung im Onlineprogramm.

Halter und Dritter können die Daten zur Arzneimittel-Verwendung des Halters getrennt voneinander einfügen, ändern oder stornieren. Eine exakte Absprache zwischen den Parteien ist notwendig, aber eine Änderung der Daten des anderen ist NICHT möglich, d.h. der Halter kann die Arzneimitteleingaben des Dritten (ihn betreffend) sehen aber nicht ändern. Ob der Dritte Arzneimitteleingaben des Halters oder anderer Dritter für den Halter sehen kann hängt von den Abfrageoptionen in der Erklärung ab. Die Daten, die der Dritte selbst eingegeben hat, kann er immer sehen (auch nach einer eventuellen Beendigung des Erklärung). Änderungen an den Daten kann er nur vornehmen solange die Erklärung aktiv ist.

Bei der Meldung selbst gibt es einige Unterschiede im Detail zum Vorgehen des Halters. Der wichtigste Unterschied ist die Unterscheidung zwischen

bulletBNR15 - der Betriebsnummer des "Urhebers" des Satzes, hier ist jetzt die Nummer des Dritten anzugeben
bulletBNR15_HA - der Betriebsnummer des Tierhalters an den das Arzneimittel abgegeben oder bei dem es angewendet wurde.

Der Dritte meldet sich mit seiner Betriebsnummer und PIN an und sendet den INSERT-Befehl zum Einfügen einer Arzneimittelverwendung.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*2:IS:TAM_XABAW/BNR15;BNR15_HA;TAMX_BEART;TAMX_AWDAT;TAMX_ABAW;TAMA_ZNR;TAMB_FORM;TAMX_LFNR;TAMX_TIANZ;TAMX_AWMEN;TAMX_BEHAT;TAMX_WIRKT;TAMX_AMG:
                276091280700713;276091280700019;4;02.07.2014;2;ZNR-091280700001;PM1;1;10;123;2;2;1            (
siehe unten *2) Hinweis)

Zum Ändern, insbesondere Beenden/Abschließen kann analog der XS-Befehl verwendet werden.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*3:XS:TAM_XABAW/BNR15;BNR15_HA;TAMX_BEART;TAMX_AWDAT;TAMX_ABAW;TAMA_ZNR;TAMB_FORM;TAMX_LFNR;TAMX_TIANZ;TAMX_AWMEN;TAMX_BEHAT;TAMX_WIRKT;TAMX_AMG:
                276091280700713;276091280700019;4;02.07.2014;2;ZNR-091280700001;PM1;1;10;123;3;3;1            (
siehe unten *2) Hinweis)

*2) Hinweis: Zeilenumbruch nur zur besseren Lesbarkeit, im HIT-Protokoll ist der Befehl in einer Zeile zu schreiben

Zum Stornieren, also entfernen ("löschen") einer Verwendung kann analog der SS-Befehl verwendet werden.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*4:SS:TAM_XABAW/BNR15;BNR15_HA;TAMX_BEART;TAMX_AWDAT;TAMX_ABAW;TAMA_ZNR;TAMB_FORM;TAMX_LFNR:276091280700713;276091280700019;4;02.07.2014;2;ZNR-091280700001;PM1;1

Zur Kontrolle der von ihm eingegebenen Daten kann der Dritte sie über die Meldeentität abrufen.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*6:RS:TAM_XABAW/*:BNR15_HA;=;276091280700019;ORDER;BNR15_HA;BNR15;TAMX_AWDAT;TAMA_ZNR;TAMB_FORM;TAMX_LFNR
Erfolgsmeldung: Anzahl Datenzeilen - 1

Hinweis: Im Gegensatz zu den anderen TAM-Meldungen, gehört dieser Satz dem Dritten unmittelbar - im Feld BNR15 steht die Nummer des Dritten als "Urheber". Der Umweg über die Angabe der Bedingung MELD_BNR ist nicht nötig.

Falls der Dritte in der Erklärung Abrufrecht auf Arzneimittelverwendungen (unabhängig ob er sie selbst gemeldet hat) eingeräumt bekommt, kann er alle Verwendungen des Betriebs über die Sicht ("view") TAM_XABAD1 bzw. TAM_XABAD2 abrufen.

*1:XS:LOGON/BNR15;PIN;MELD_WG;TIMEOUT:09 128 070 0713;900000;3;1200
*8:RS:TAM_XABAD1/*:BNR15_HA;=;276091280700019;ORDER;BNR15_HA;BNR15;TAMX_AWDAT;TAMA_ZNR;TAMB_FORM;TAMX_LFNR

horizontal rule

Zurück zum Anfang