Samenlieferschein

Im Rahmen eines Partnerprojektes mit der Besamung Hohenzell GmbH wurde, für den Import von Lieferdaten, eine normierte Importschnittstelle entwickelt. Grundsätzlich ist dies eine offene Schnittstelle, welche zukünftig beliebig ausbaubar und auch für andere Besamungsstationen verwendbar ist. Als Datenstandard wurde eine XML-Struktur erstellt, damit ist auch eine entsprechende Flexibilität für Weiterentwicklungen sichergestellt.

Aktivierung Samenlieferschein bei der Besamungsstation

Um Samenlieferscheine importieren zu können, müssen Sie die folgenden Schritte durchführen:

• Fordern Sie von der Besamungsstation (derzeit Hohenzell und Gleisdorf) die Konfigurationsdaten für den elektronischen Samenlieferschein an.
• Geben Sie diese Daten wie im nächsten Kapitel beschrieben, im ANIMALoffice in die Stammdaten der Besamungsstation ein.
• Ab der folgenden Samenlieferung können Sie dann, wie beschrieben den Lieferschein downloaden und importieren.
  

Ansprechpartner Besamungsstationen

• HOHENZELL - Hr. Wolfgang GRUBER
• GLEISDORF - Hr. Thomas KAHR
• WIESELBURG - Hr. Ing. Herbert STADLER

Betriebsnummern

Wenn Sie für bestimmte Betriebe Samen übernehmen und in Ihrem Samencontainer deponieren, ist es unbedingt erforderlich dass Sie die LFBIS-Nr. dieser Betriebe bei der Besamungsstation bekanntgeben. Nur dann ist es möglich, dass auch diese Lieferungen als Kundenreservierungen in die ANIMALoffice Chargenverwaltung übernommen werden können. Für ANIMALoffice sind diese Betriebe nur über die LFBIS-Nr. erkennbar. Dies ist mit der jeweiligen Besamungsstation abzuklären.

Einstellungen

Die Grundeinstellungen für den Import von Samenlieferscheinen erfolgen in der Tabelle BESAMUNGSSTATIONEN.

Alle Definitionen und Zugangsdaten werden nach Anfrage von der jeweiligen Besamungsstation für jeden Tierarzt gesondert ausgestellt. Bitte kontaktieren Sie Ihre zuständige Besamungsstation.

Zugangsdaten FTP-Server Besamungsstation (SAMENLIEFERSCHEINE)

Feldname	Inhalt	Beispiel
Host	FTP-Serveradresse Besamungsstation	ftp.data.besamungsstation.at
Username	Benutzername	BES_12345
Passwort	Kennwort	Hugo1234
PIN	Kontroll-Code	z.Zt. nicht erforderlich

Zugangsdaten FTP-Server Besamungsstation (STATIONSINFO)

Die Besamungsstationen können für die Tierärzte zusätzliche Stationsinformationen wie z.B. Samen-Preislisten bereitstellen. Diese Informationen werden für ALLE Tierärzte zur Verfügung gestellt, damit alle Tierärzte auf dieses Verzeichnis zugreifen können, sind dafür eigene Zugangsdaten erforderlich

GENOSTAR GLEISDORF | BESAMUNG HOHENZELL

Feldname	Inhalt	Beispiel
Host	FTP-Serveradresse Besamungsstation	Webadresse erhalten Sie von der Besamungsstation
Username	Benutzername - fix für alle STMK, OOE	Stationsinfo
Passwort	Kennwort - fix für alle STMK, OOE	Stationsinfo4711

GENOSTAR WIESELBURG

Feldname	Inhalt	Beispiel
Host	FTP-Serveradresse Besamungsstation	Webadresse erhalten Sie von der Besamungsstation
Username	Benutzername - fix für alle NOE	web57f32
Passwort	Kennwort - fix für alle NOE	T3C0LBvW

Besamungsimport / Vorgaben in ANIMALoffice

Für die automatische Anlage der Artikel- und Chargendaten müssen/können Sie die folgenden Grundeinstellungen setzen. Beachten Sie bitte, dass diese Daten für die Anlage im Artikelstamm sehr wichtig sind da es sonst zu Problemen bei der Kalkulation bzw. bei der weiteren Verarbeitung kommt.

Feldname	Inhalt	Beispiel	Anmerkung
Samen Artikelart	Artikelart für Samen	S	lt. Artikelstamm
Steuersatz	Steuerschlüssel für Samen	10	i.d.R.
Maßeinheit	Maßeinheit Samen	Port	lt. Ihren Definitionen im Artikelstamm
Präfix Artikelname	Ihr indiv. Präfix (falls verwendet)	S_ od. Samen_	wenn Name mit bestimmten Zeichen beginnen soll
Cont. Kundenres.	ID_Container - Kundenreservierungen	Container_K	Wenn reservierte Kundensamen in eig. Container
Lieferant Nr.	Lieferantennummer der Besamungsstation	16	Wenn Station im Lieferantenstamm aktiviert
Lade/Teiler automatisch finden	Lade/Teiler werden bei Import automatisch zugeordnet	X	wenn gewünscht

Samen Artikelart

Definieren Sie in diesem Feld die Artikelart über welche die Samen im ANIMALoffice Praxis Management System verwaltet werden. Diese Artikelart wird bei der Neuanlage eines Samenartikels eingesetzt.

Steuerschlüssel

Definieren Sie in diesem Feld den Steuerschlüssel mit dem die Samen im ANIMALoffice Praxis Management System verrechnet werden. Dieser Steuerschlüssel wird bei der Neuanlage eines Samenartikels eingesetzt.

Präfix Artikelname

Wenn Sie für die Suchfunktionen vor den Namen des Samens ein Identifikationsmerkmal setzen möchten, geben Sie in dieses Feld die entsprechenden Zeichen ein. Die Hier definierten Zeichen werden bei der Neuanlage eines Samenartikels automatisch vor den Namen gesetzt.

Container Kundenres.

Wird für Kundenreservierungen ein eigener Samencontainer verwendet, kann die entsprechende ID (lt. ANIMALoffice) in diesem Feld definiert. In der Folge wird bei der Neuanlage der Samencharge diese ID als „Lagerort“ eingesetzt.

• HOHENZELL - Nicht möglich/erforderlich, da Kundenreservierungen über <Referenz> als getrennte Lieferscheine importiert werden.
• GENOSTAR - Diese ID wird bei Splitting einer Position auf mehrere Kunden automatisch angewendet und dem definierten Lagerort zugewiesen.

Lieferant Nr.

In dieses Feld können Sie die Lieferantennummer der Besamungsstation (Stammdaten > Lieferanten) eingeben. Da beim Import eines Samenlieferscheins die Positionen auch automatisch in die Warenzugangs-Statistik mit einfließen, ist ein Lieferanten-Stammsatz für die Besamungsstation anzulegen. Wird dies nicht durchgeführt, schreibt ANIMALoffice die Informationen mit der Lieferantennummer "-99" die die Tabelle. Bei der Statistik kann allerdings kein Lieferantenname angezeigt werden. Wenn Sie diese Definition später nachholen, korrigiert ANIMALoffice auch für die bereits erfassten Einträge die Lieferantennummer auf den neuen Wert.

Lade/Teiler automatisch finden

Wird dieser Schalter aktiviert, fügt ANIMALoffice jedem zu importierenden Samen automatisch der ersten gefundenen Lade/Teiler-Kombination (P1,P2) zu. D.h. wurde ein Samen einmal einer bestimmten Lade/Teiler zugewiesen, werden zukünftige Samen immer wieder derselben Position zugeordnet.

Bereitstellung der Daten

• Besamung Hohenzell GMBH

Die Lieferscheine werden sofort bei der Samenausgabe auf den Server der Besamungsstation gestellt. Diese Daten stehen sofort nach dem Upload für den Tierarzt zur Verfügung.

• GENOSTAR Gleisdorf

Die Lieferscheine werden im Rahmen der Auftragsbearbeitung nach der Bestellung durch die Tierarztpraxis/Landwirt auf den Server gestellt.

• GENOSTAR Wieselburg

Die Lieferscheine werden sofort bei der Samenausgabe auf den Server der Besamungsstation gestellt. Diese Daten stehen sofort nach dem Upload für den Tierarzt zur Verfügung.

Download Lieferdaten

Um die Daten von der Besamungsstation zu laden, führen Sie die folgenden Schritte durch:

• Rufen Sie über die Menüleiste EXTRAS den Menüpunkt für das Import Samenlieferscheine auf
• Im Importlayout wählen Sie zuerst die gewünschte Besamungsstation aus
• Klicken Sie auf den Button neue Daten holen

Es werden nun unter "Historie" alle Lieferscheine und deren Status angezeigt. Liefert die Besamungsstation in einem Lieferschein unter "Referenz" eine Nummer oder Bezeichnung, wird diese nach der Lieferschein-Nummer und einem "/" angezeigt.

• Klicken Sie auf den gewünschten Lieferschein um diesen auszuwählen

Die Positionen werden anschließend in der Detailanzeige angezeigt

• Wählen Sie die gewünschten Positionen aus (Shift+Klick, CMD+Klick für mehrere) und klicken Sie auf den Button Auswahl importieren oder

klicken Sie auf den Button Alle importieren um alle Positionen des Lieferscheines zu importieren

Import und Buchungen

Artikelstamm generell (Import+Preisliste)

ANIMALoffice erstellt bzw. aktualisiert einen Artikel-Stammsatz für einen Samen immer aus der Kombination der folgenden Importfelder:

• ISO_Lebensnummer
• Samentyp
• Gesext

Dies ist erforderlich, da die Kombination der 3 Felder i.d.R. einen eigenen Preis ergibt. Somit kann die Besamungsstation eine individuelle Preisgestaltung durchführen ohne die Verarbeitung in ANIMALoffice zu beeinflussen.

Beim Import Samenlieferschein bzw. bei der Aktualisierung lt. Preisliste wird der Text in der Artikelbezeichnung wie folgt erweitert: Es wird zusätzlich, in [eckigen Klammern] eingeschlossen, die Kombination Typ und gesext gestellt. Dadurch kann der Tierarzt die Samen eindeutig am Namen erkennen.

Beispiel:
HUGO [S|W] = Samen Hugo, SpermVital, weiblich gesext

Im Rahmen des Imports der Lieferdaten führt ANIMALoffice die folgenden Buchungen durch

Artikel für die Position existiert bereits im ANIMALoffice :

• Preise (EK/VK) werden aktualisiert
• Lagerbestand wird entsprechend erhöht

Artikel existiert im ANIMALoffice noch nicht

• Stammsatz für den Samen wird angelegt

ACHTUNG: Beachten Sie bitte dass die Voreinstellungen (Besamungsstation) korrekt vorgegeben sind

• Lagerbestand wird aktiviert

Chargennummer befindet sich in der Lieferscheinposition

In der ANIMALoffice Chargentabelle wird ein Eintrag mit der übermittelten Chargennummer erstellt (ohne Zuordnung von Köcher, Fach, etc.)

Chargennummer befindet sich NICHT in der Lieferscheinposition

In der ANIMALoffice Chargentabelle wird ein Eintrag erstellt (ohne Zuordnung von Köcher, Fach, etc.), wobei Als Chargennumer die Lebensnummer des Stieres (AT000123456789) eingetragen wird.

Kunden- Lieferscheine (Landwirte)

• Samenportionen welche fix für Kunden(Landwirte) reserviert wurden - eigene Lieferscheine - werden automatisch gebucht und als Kundenreservierungen im ANIMALoffice Samencontainer geführt.

Preisaktualisierung weitere Samen im ANIMALoffice Artikelstamm

Beim Import der Samenlieferscheine können selbstverständlich nur die Preise der am Lieferschein angeführten Stiersamen aktualisiert werden. Für die Überprüfung und Aktualisierung aller mit der Zuchtwertschätzung verknüpften Artikel steht nun die folgende Möglichkeit zur Verfügung:

Die Besamungsstationen können eine Preisliste zusätzlich auf den Downloadserver stellen. Ist dies der Fall, erkennt dies ANIMALoffice beim Lieferschein-Download und führt die folgenden Tätigkeiten automatisch durch:

• ANIMALoffice downloadet die Preisliste
• ANIMALoffice überprüft alle Artikel welche mit der Zuchtwertschätzung verknüpft sind und korrigiert bei Bedarf vollautomatisch die Artikelkalkulationen nach den Vorgaben.

ANIMALoffice merkt sich das Datum und führt die Aktualisierung erst wieder durch wenn seitens der Besamungsstation wieder eine neue Preisliste bereitgestellt wurde. Dies bedeutet, dass die Tierärzte nicht mehr in diesen Ablauf eingreifen müssen.