Sinn und Zweck

Diese Schnittstellenbeschreibung beinhaltet die fachlichen, technischen und organisatorischen Details der Schnittstelle von NEXUS/HEIM – IVF Hartmann.

Fachliche Angaben

Allgemeine Information

Mit IVF Hartmann können Sie medizinische Verbrauchsgüter - Medizinprodukte, Unfallschutz / Hygieneprodukte, Reinigungsmittel / Desinfektionsmittel, Körperpflege / Körperhygiene, Hauswirtschaft - im Web bestellen. Mit der Schnittstelle NEXUS / HEIM zu IVF Hartmann haben Sie die Möglichkeit, medizinische Verbrauchsgüter direkt auf einen Bewohner oder Unterbringung zu beschaffen. Dabei können Sie entscheiden, ob Sie die Verrechnung der Produkte in HARTMANNeasy machen wollen oder ob Sie die Abrechnung weiterhin einfach übers NEXUS / HEIM ausführen möchten.

Schnittstellenkommunikation

Die Schnittstelle ist bidirektional und übermittelt sowohl diverse Stammdaten als auch Bewegungsdaten vom NEXUS / HEIM zu IVF Hartmann und von IVF Hartmann zu NEXUS / HEIM. Die angewandte Technologie basiert auf einem Webservice-Aufruf (REST).

Der Export der Daten wird im Normalfall direkt bei einer Neuerfassung oder Mutation automatisch ausgeführt. Wenn Fehler vorhanden sind, werden diese grundsätzlich im Kommunikation-Log angezeigt. Fehler können beispielsweise eine fehlerhafte AHV-Nummer oder eine falsche Versichertenkartennummer sein.

Die Import-Abfrage ist im Normalfall für einen ganzen Monat eingestellt und in einer vordefinierten Regelmässigkeit (im Normalfall einmal am Tag). Der Tasks importiert diese vollautomatisch und die Leistungen erscheinen als «erfasst» in der Leistungserfassung und können bei Bedarf noch angepasst oder direkt abgerechnet werden. Werden Datensätze in einem anderen Format geschickt als definiert oder zu viele Datensätze, funktioniert der Import ins NEXUS / HEIM nicht mehr und es werden keine Daten mehr ins NEXUS / HEIM geschrieben. Der Export funktioniert weiterhin.

Command

Export Bewohnerdaten:

Befehl	Erklärung
C:\inetpub\wwwroot\HeimWS\bin\Heim.Communicator.Hartmann.exe	Ort wo sich der Communicator befindet
-u	Username für die Ausführung
-ep	Verschlüsseltes Passwort des Users
-c	Name der Konfiguration
-m	Mandant von Heim
-ae	Aktion Export

Import Leistungsdaten

Befehl	Erklärung
C:\inetpub\wwwroot\HeimWS\bin\Heim.Communicator.Hartmann.exe	Ort wo sich der Communicator befindet
-u	Username für die Ausführung
-ep	Verschlüsseltes Passwort des Users
-c	Name der Konfiguration
-m	Mandant von Heim
-ai	Aktion Export

Flussdiagramm

Technische Angaben

Datenfluss

Es werden sowohl Daten von NEXUS / HEIM an Hartmann übermittelt, als auch von Hartmann an NEXUS / HEIM. Folgend finden Sie die Daten, welche jeweils übergeben werden.

Datenfelder

NEXUS / HEIM - Hartmann

#	Feldname HARTMANNeasy	Pflichtfeld*	Feldbezeichnung NEXUS / HEIM	Datentyp
1	foreignIdentification	Ja	Bewohnernummer	varchar
2	dateOfBirth	Ja	Geburtsdatum	varchar
3	presenceState	Nein	Anwesenheitsstatus	varchar
4	firstName	Ja	Vorname	varchar
5	lastName	Ja	Nachname	varchar
6	gender	Ja	Geschlecht	varchar
7	station.foreignIdentification	Ja	Unterbringung / Stockwerk / Abteilung (Codewert)	varchar
8	station.displayName	Nein	Bezeichnung Unterbringung / Stockwerk / Abteilung	varchar
9	healthInsurance.foreignIdentification	Ja	Versicherung (GUID)	varchar
10	healtInsurance.name	Ja	Name Versicherung	varchar
11	healthInsurance.gln	Nein	GLN Versicherung	varchar
12	insurancePolicyNumber	Nein	Versichertennummer	varchar
13	insuranceCardNumber	Ja	VEKA-Nummer	varchar
14	ssn	Ja	AHV-Nummer	varchar
15	room	Nein	Zimmernummer	varchar
16	incontinenceDegree	Ja	Inkontinenz	varchar
17	docotor.foreignIdentification	Ja	Primärarzt (GUID)	varchar
18	doctor.name	Ja	Vor- und Nachname Primärarzt	varchar
19	doctor.zip	Ja	PLZ Primärarzt	varchar
20	doctor.city	Ja	Ort Primärarzt	varchar
21	doctor.zsrNumber	Ja	ZSR-Nummer Primärarzt	varchar
22	doctor.addition	Nein	Zusatz 1 Primärarzt	varchar
23	doctor.street	Nein	Strasse Primärarzt	varchar
24	doctor.eMail	Nein	E-Mail Primärarzt	varchar
25	doctor.phone	Nein	Privat 1 Primärarzt	varchar
26	doctor.gln	Nein	GLN Primärarzt	varchar
27	insuranceCardValidUntil	Nein	Gültigkeitsdatum bis Versicherungskarte	varchar
28	privateBillingAddress.firstname	Nein	Vorname Zustelladresse	varchar
29	privateBillingAddress.lastname	Nein	Nachname Zustelladresse	varchar
30	privateBillingAddress.addition	Nein	Zusatz 1 Zustelladresse	varchar
31	privateBillingAddress.street	Nein	Strasse Zustelladresse	varchar
32	privateBillingAddress.zip	Nein	PLZ Zustelladresse	varchar
33	privateBillingAddress.city	Nein	Ort Zustelladresse	varchar
34	privateBillingAddress.email	Nein	E-Mail Zustelladresse	varchar
35	privateBillingAddress.phone	Nein	Privat 1 Zustelladresse	varchar
36	clientAddress.addition	Nein	Zusatz 1 Bewohner	varchar
37	clientAdress.street	Nein	Strasse Bewohner	varchar
38	clientAdress.zip	Nein	PLZ Bewohner	varchar
39	clientAdress.city	Nein	Ort Bewohner	varchar
40	clientAdress.eMail	Nein	E-Mail Bewohner	varchar
41	clientAdress.phone	Nein	Privat 1 Bewohner	varchar

*Pflicht für die Abrechnung in HARTMANNeasy (ab NEXUS / HEIM Version 2023.1 möglich)

Hartmann - NEXUS / HEIM

Leistungskatalog

#	Feldname HARTMANNeasy	Feldbezeichnung HARTMANNeasy	Feldbezeichnung NEXUS / HEIM	Datentyp
1	priceIncludingTaxesPerUnit	Preis inkl. Steuern	Ansatz	varchar
2	quantityUnitContent	Inhalt	Einheit	varchar
3	articleText	Artikeltext	Bezeichnung	varchar
4	gtin	GTIN	GTIN	varchar
5	reimbursementCode	MiGeL	MiGeL	varchar
6	ReimbursementPriceCarePerUnit	MiGeL HVB Pflege	Ansatz 2	varchar
7	uniqueArticleIdentifier	UniqueArticleID	UID	varchar

Leistungserfassung

#	Feldname HARTMANNeasy	Feldbezeichnung HARTMANNeasy	Feldbezeichnung NEXUS / HEIM	Datentyp
1	priceIncludingTaxesPerReimbursementUnit	Preis pro Stück inkl. Steuer	Ansatz	varchar
2	reimbursementUnitQuantity	Bestellte Menge	Menge	varchar
3	priceIncludingTaxes	Summe Einkauf inkl. Steuern	Betrag	varchar

Organisatorische Angaben

Bei Fragen oder Anliegen, technischer oder fachlicher Natur, sind Fachexperten und Supporter sowohl von unserem Schnittstellenpartner IVF Hartmann als auch von uns da. Die IVF Hartmann berät Sie gerne bei Fragen rund um die Webapplikation, während wir verantwortlich sind für die NEXUS / HEIM-Applikation. Um Anpassungen erfolgreich implementieren zu können oder Probleme von Ihnen zeitnah zu lösen, stehen unser Schnittstellenpartner IVF Hartmann und die NEXUS Schweiz AG stets in Kontakt.