1.1 ReferralWS – Referral

Version: 2.1.14297

The Web Service includes methods related to patient referrals.

The ReferralWS Web Service contains these methods:

• SaveReferral

The Web Service reference is: ReferralWS.asmx

For more detailed information as the web service WSDL, SOAP request and response see:

https://linkws.service.tieto.com/PasLinkWS/ReferralWS/ReferralWS.asmx

1.1.1 SaveReferral

Applicable systems for the method:

HIS90

Method can be used in the following versions of the Web Service:

HIS90

1.14

Description:

The method is used for creating a new referral period and saves referral in initial state. Referral is based on KITH 1.0 referral.

Syntax:

SaveReferralResponse = SaveReferral(SaveReferralRequest)

Parameter in	Type	Length Byte	Description – Data format – Valid data
SaveReferralRequest	SaveReferralRequest	N/A Dynamic	Referral message(object) according to XML schema SaveReferral.xsd

Returned parameter	Type	Length Byte	Description – Comments
SaveReferralResponse	SaveReferralResponse	N/A Dynamic	Referral class(object) according to XML schema SaveReferral.xsd.
Description for HIS90 implementation:			PasLinkWSWS_Referral_Save.xls

Schema for SaveReferralRequest and SaveReferralResponse: SaveReferral.xsd

Schema documentation for SaveReferral: SaveReferral.html

Sample xml file for SaveReferralRequest SaveReferralRequest.xml and SaveReferralResponse SaveReferralResponse.xml

KITH referral 1.0 can be found on KITH web.

Web Service Request and Response:

HTTP SOAP Request Envelope for SaveReferral and

HTTP SOAP Response Envelope for SaveReferral:

See your local installation, i.e.: http://<server>/<paslinkws>/ReferralWS/ReferralWS.asmx

Related methods or functions used:

GetUserLogin Used to verify a user, and to get a valid authentication Block in return.

Other references:

RequestHeader Information required calling a method, containing authentication information.

ResponseHeader Information and messages returned from the method, e.g. error codes/description,

system name or version.

Comments:

To use this method the RequestHeader must contain a valid Authentication Block and the system name is required. An error will be raised if one of these is missing.

Valid Authentication Block for RequestHeader the can be retrieved by using the method GetUserLogin in Authentication-Web Service.

In return from the method there will always be a ResponseHeader, which contains Error Information and System Information. Error Information block must always be checked to determine if any error has occurred while processing the methods.

HIS90 specific information:

The KITH Message, included in Referral.xsd, is designed using sets of common types. The type is only defined once and can not handle context. An attribute can not be optional in one context and mandatory in another.

See attached file for HIS90 specific usage information PasLinkWSWS_Referral_Save.xls.

HIS90 Server used for SaveReferral is CWRE01 and service code 50644.