1.1   BookingWS – Booking

Version: 2.1.17180

 

The Web Service includes methods related to booking.

 

The BookingWS Web Service contains these methods:

 

 

The Web Service reference is: BookingWS.asmx

 

For more detailed information on the web service's WSDL, SOAP request and response see:

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

 

BookingWS uses two expressions when booking time for visit/treatment; “appointment” and “schedule slot”. These are the same but are used in different contexts.

Appointment is used for the patient context.

Schedule slot is used in context with a resource or organization unit.

 

1.1.1   ListResourcesAppointments

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

Lists appointments according to search criteria.

 

Syntax:

 

AppointmentCollection = ListAppointments(ResourceId, FromDate, ToDate)

 

Parameter in

Type

Length byte

Description – Data format – Valid data

ResourceId

Numeric

4

The resource id.

FromDate

DateTime

N/A

Dynamic

Used to search within a date interval.

ToDate

 

DateTime

N/A

Dynamic

Used to search within a date interval.

 

Returned parameter

Type

Length Byte

Description – Comments

AppointmentCollection

 

N/A

Dynamic

Appointment collection class according to XML schema Appointment.xsd.

 

Schema for AppointmentCollection: Appointment.xsd

Schema documentation for Appointment: Appointment.html

Sample xml file for Appointment: Appointment.xml

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=ListResourceAppointments

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

 

1.1.2   ListBookedResources

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

Gets data about one patient. A search can be made using either the internal patient id or the official id.

 

Syntax:

 

Resources = ListBookedResources(UnitId, FromDate, ToDate)

 

Parameter in

Type

Length byte

Description – Data format – Valid data

UnitId

Number

4

Internal unique unit id.

FromDate

DateTime

N/A

Dynamic

Used to search within a date interval.

ToDate

 

DateTime

N/A

Dynamic

Used to search within a date interval.

 

Returned parameter

Type

Length Byte

Description – Comments

Resource Collection

 

N/A

Dynamic

Resource collection class according to XML schema Resources.xsd.

 

Schema for Resources: Resources.xsd

Schema documentation for Resources: Resources.html

Sample xml file for Resources: Resources.xml

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=ListBookedResources

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

 

1.1.3   ListPatientAppointments

 

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

The method is used for listing pasient appointments. The search can be filtered on department, unit, section and/or period. If not filtered then patient appointments are listed across organization units.

 

For HIS90 actual appointments booked, active waiting list (without booking/visit time) and suspended waiting lists are listed in ListPatientAppointments.

 

 

Syntax:

 

ListPatientAppointmentsResponse = ListPatientAppointments(ListPatientAppointmentsRequest)

 

 

Parameter in

Type

Length byte

Description – Data format – Valid data

ListPatientAppointmentsRequest

 

N/A

Dynamic

Request class according to XML schema in Booking.xsd.

Description:

 

 

 

PatientId

 

 

Patient’s id. Mandatory field.

Patient id’s can be found by using PatientWS.ListPatients or PatientWS.GetPatient.

From

 

 

Search period from date and time. The period starts on given date and time.

Defaulted to current date/time if not provided.

To

 

 

Search period to date and time. The period ends on given to date and time.

Defaulted to current date/time if not provided.

Organization.MedicalUnit.Id

 

 

Restrict search/list to patient appointments in a selected medical unit/department.

MedicalUnit.Id’s can be found by using OrganizationWS.ListOrganizations or OrganizationWS.GetOrganization2G.

Organization.CareUnit.Id

 

 

Restrict search/list to patient appointments in a selected care unit. When selecting a care unit a department must also be selected.

CareUnit.Id’s can be found by using OrganizationWS.ListOrganizations or OrganizationWS.GetOrganization2G.

Organization.Section.Code

 

 

Restrict search/list to patient appointments in a selected section. When selecting a section a department must also be selected.

Section codes can be found by using OrganizationWS.ListOrganizations or OrganizationWS.GetOrganization2G.

 

Returned parameter

Type

Length Byte

Description – Comments

ListPatientAppointmentsResponse

 

N/A

Dynamic

Response class according to XML schema in Booking.xsd.

Description:

 

 

 

Id.OfficialId.Value

 

 

Official id.

 

Id.OfficialId.TypeOfId

 

 

Type of id above. Legal values F or N. See PatientWS for details about TypeOfId.

Id.OfficialId.FormattedId

 

 

Official id formatted for viewing.

Id.PatientId

 

 

Internal patient id.

Name.FormattedName

 

 

Formatted patient name: last name, first name middle name.

Appointment.Id

 

 

Internal id of the appointment/booking.

 

HIS90:

Combined id BookingId, based on the patient id and the serial number assigned by the system to identify the appointment.

Format: PatientId|BookingNo

Appointment.ContactId

 

 

Used only if the appointments are related to a contact.

 

HIS90:

Combined id: ContactId

Appointment.CarePeriodId

 

 

Internal id of the care period the appointment/booking belongs to.

An id used to identify associated appointments, waiting lists or referrals.

Appointment.From

 

 

Planned start date/time of a booking by patient responsible.

Note - If the appointment is suspended/postponed (see Status.Code) the From and To date will contain the original start date/time of the appointment (not the new date/time).

Appointment.To

 

 

If an appointment is scheduled then this gives end time for booking by patient responsible.

Note - If the appointment is suspended/postponed (see Status.Code) the From and To date will contain the original end date/time for the appointment (not the new date/time).

Appointment.Type

 

 

Type of booking.

 

HIS90:

Valid types are T1-T5 and OB.

Appointment.Status.Code

 

 

Status code of an appointment (booking).

 

HIS90:

Valid status codes: 1, 3 and 4

Appointment.Status.Text

 

 

Status text for an appointment (booking).

 

HIS90:

Valid status texts are:

-       (1) Active on waiting list

-       (3) Active on waiting list with appointment time (visit time) in place

-       (4) Postponed appointment

Appoinment.TypeOfCare.Code

 

 

Type of care code.

Valid codes are:

I, P or D

Appoinment.TypeOfCare.Text

 

 

Description of type of care.

 

HIS90:

TypeOfCare:

I = Inpatient (Inneliggende)

P = OutPatient (Poliklinikk)

D = In hospital only at daytime (Dagbehandling)

Appointment.Organization.MedicalUnit.Id

 

 

Internal id/number of the department responsible for the appointment.

Appointment.Organization.MedicalUnit.ShortName

 

 

Short name/code of the department responsible for the appointment.

Appointment.Organization.MedicalUnit.Name

 

 

The name of the department responsible for the appointment.

Appointment.Organization.CareUnit.Id

 

 

Internal id/number of the care unit that is responsible for the appointment.

Appointment.Organization.CareUnit.ShortName

 

 

Short name/code of the care unit responsible for the appointment.

Appointment.Organization.CareUnit.Name

 

 

The name/description of the care unit that is responsible for the appointment.

Appointment.Organization.Section.Code

 

 

Code for department section.

Appointment.Organization.Section.Text

 

 

Description of the department section code.

 

HIS90: N/A

Appointment.Resources.Resource.ResourceId

 

 

Internal unique id identifying physicians or other resources reserved for the appointment.

 

HIS90:

Combined id for unique identification of a resource.

Appointment.Resources.Resource.Id

 

 

Internal id identifying physicians or other resources reserved for the appointment.

 

HIS90: N/A

Appointment.Resources.Resource.From

 

 

Planned start date/time of an appointment/booking on the resource.

Appointment.Resources.Resource.To

 

 

If an appointment is scheduled then this gives end time of the appointment/booking on the resource.

Appointment.Resources.Resource.Code

 

 

Code identifying physicians or other resources reserved for the appointment.

Appointment.Resources.Resource.Name

 

 

Physician name or description of other resource reserved for the appointment.

Appointment.Resources.Resource.Type

 

 

Type/category of resources reserved for the appointment.

 

HIS90:

Valid codes in PAQRECA.

Appointment.Resources.Resource.MedicalUnit.Id

 

 

Internal id/number of the department that owns resources reserved for the appointment.

Appointment.Resources.Resource.MedicalUnit.ShortName

 

 

Short name/code of the department that owns resources reserved for the appointment.

Appointment.Resources.Resource.MedicalUnit.Name

 

 

The name of the department that owns resources reserved for the appointment.

Appointment.Resources.Resource.CareUnit.Id

 

 

Internal id/number of the unit that owns resources reserved for the appointment.

Appointment.Resources.Resource.CareUnit.ShortName

 

 

Short name/code of the unit that owns resources reserved for the appointment.

Appointment.Resources.Resource.CareUnit.Name

 

 

The name of the unit that owns resources reserved for the appointment.

Appointment.Resources.EvaluatedBy.Id

 

 

Internal id identifying responsible physician or other resource responsible for the medical care or evaluation (review of the requisition/referral).

 

HIS90: N/A

Appointment.Resources.EvaluatedBy.Code

 

 

Code identifying responsible physician or other resource responsible for the medical care or evaluation (review of the requisition/referral).

Appointment.Resources.EvaluatedBy.Name

 

 

Name identifying responsible physician or other resource responsible for the medical care or evaluation (review of the requisition/referral).

Appointment.Resources.EvaluatedBy.Type

 

 

Type/category of resource.

 

HIS90:

Valid codes in PAQRECA.

Appointment.Requesters.Requester.Id

 

 

Internal id of the requester.

 

HIS90: N/A

Appointment.Requesters.Requester.Code

 

 

Code of who requested this service/booking.

This can either be an organization or a physican.

-       1 (external or internal requester organization)

-       2 (requesting physician)

Appointment.Requesters.Requester.Name

 

 

Name of who requested this service/booking.

-       [1] Name of requesting organization

-       [2] Name of requesting physician

Appointment.Requesters.Requester.Type

 

 

Type of requester.

 

HIS90:

Valid values, description:

1: External institution (Ekstern institusjon)

2: Health station, medical centre (Helsestasjon, legesenter)

3: External physician (Ekstern lege)

4: Internal ward (Intern sengepost)

5: Internal polyclinic (Intern poliklinikk)

6: Internal physician (Intern lege)

7: Nursing home (Aldershjem)

 

Schema for ListPatientAppointments: Booking.xsd

Schema documentation for ListPatientAppointments: Booking.html

Sample xml file for ListPatientAppointments: ListPatientAppointmentsRequest.xml and ListPatientAppointmentsResponse.xml

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=ListPatientAppointments

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

HIS90 spesific information:

Server used for the method is CWBP01 and service code 54422.

 

Server is only to list appointments that user is allowed to access according to organization status and placement.

 

 

1.1.4   GetAppointment

 

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

The method is used for getting information about one selected appointment.

 

ListPatientAppointments can be used to find valid appointments for a patient.

 

Syntax:

 

GetAppointmentResponse = GetAppointment(GetAppointmentRequest)

 

 

Parameter in

Type

Length byte

Description – Data format – Valid data

GetAppointmentRequest

 

N/A

Dynamic

Request class according to XML schema in Booking.xsd.

Description:

 

 

 

Id

 

 

Internal id of the appointment/booking.

 

HIS90:

Combined id BookingId. Based on the patient id and the serial number assigned by the system to identify the appointment.

Format: PatientId|BookingNo

 

 

Returned parameter

Type

Length Byte

Description – Comments

GetAppointmentResponse

 

N/A

Dynamic

Response class according to XML schema in Booking.xsd.

Description:

 

 

 

Patient.Id

 

 

Internal patient id.

Appointment.Id

 

 

Internal id of the appointment/booking.

 

HIS90:

Combined id BookingId. Based on the patient id and the serial number assigned by the system to identify the appointment.

Format: PatientId|BookingNo

Appointment.CarePeriodId

 

 

Internal id of the care period the appointment/booking belongs to.

An id used to identify associated appointments, waiting lists or referrals.

Appointment.Type

 

 

Type of booking.

 

HIS90:

Valid types are T1-T5 and OB.

Appointment.Status.Code

 

 

Status code of an appointment (booking).

Valid status codes:

1-9

Appointment.Status.Text

 

 

Status text of an appointment (booking).

Valid status codes and text:

1 - Aktivt på venteliste (Actively on waiting list)

2 - Slettet fra venteliste (Deleted from waiting list)

3 - Utsatt på venteliste (Suspended from waiting list)

4 - Time er satt/bestilt (Active on waiting list with appointment time (visit time) in place)

5 - Slettet fra timebestilling (Deleted from waiting list deleted from status 4))

6 - Ikke møtt (Did not meet)

7 - Ankommet poliklinikk (Arrived at policlinic)

8 - Ankommet sengepost (Arrived at inpatient clinic)

9 - Sperrekode prioritet 55 (Suspension, code 55)

Appointment.VisitType.Code

 

 

Type of consultation.

 

HIS90: Patient_Type

Use CommonCodesWS.ListAdmitCodes to list valid values.

Appointment.VisitType.Text

 

 

Description of VisitType.Code.

Appoinment.TypeOfCare.Code

 

 

Type of care code.

Valid codes are:

I, P or D

Appoinment.TypeOfCare.Text

 

 

Description of type of care.

 

HIS90:

TypeOfCare:

I = Inpatient (Inneliggende)

P = OutPatient (Poliklinikk)

D = In hospital only at daytime (Dagbehandling)

Appointment.From

 

 

Planned start date/time of a booking by patient responsible.

Note - If the appointment is suspended/postponed (see Status.Code) the From and To date will contain the original start date/time of the appointment (not the new date/time).

Appointment.To

 

 

If an appointment is scheduled then this gives end time of booking by patient responsible.

Note - If the appointment is suspended/postponed (see Status.Code) the From and To date will contain the original end date/time of the appointment (not the new date/time).

Appointment.PreviousVisits.PreviousVisit

 

 

Previous visit date/time.

 

HIS90:

In case of  cancelled or suspended visit for out-patient this date is the planned appointment. Same as in PaqBook.Visit_date, PaqBook.Visit_time

Appointment.Group.Code

 

 

Group code.

 

HIS90:

Valid codes are found in PAS table PAQGRUP.

Appointment.FreeHospitalChoice

 

 

If treatment (booking) is due to Free Hospital Choice (Norway only).

 

True = Free choice

False = Not free choice

Tag missing/null = Not decided/patient has not made a choice (not asked)

Appointment.Organization.MedicalUnit.Id

 

 

Internal id/number of the department that is responsible for the appointment.

Appointment.Organization.MedicalUnit.ShortName

 

 

Short name/code of the department that is responsible for the appointment.

Appointment.Organization.MedicalUnit.Name

 

 

The name of the department that is responsible for the appointment.

Appointment.Organization.CareUnit.Id

 

 

Internal id/number of the care unit that is responsible for the appointment.

Appointment.Organization.CareUnit.ShortName

 

 

Short name/code of the care unit that is responsible for the appointment.

Appointment.Organization CareUnit.Name

 

 

The name/description of the care unit that is responsible for the appointment.

Appointment.Organization.Section.Code

 

 

Code for department section. Section defines a collection of CareUnits within one MedicalUnit.

Appointment.Organization.Section.Text

 

 

Description of the department section code.

 

HIS90: N/A

Appointment.Resources.Resource.ResourceId

 

 

Internal unique id identifying physicians or other resources reserved for the appointment.

 

HIS90:

Combined id for unique identification of a resource.

Appointment.Resources.Resource.Id

 

 

Internal id identifying physicians or other resources reserved for the appointment.

 

HIS90: N/A

Appointment.Resources.Resource.From

 

 

Planned start date/time for an appointment/booking on the resource

Appointment.Resources.Resource.To

 

 

If an appointment is scheduled then this gives end time of the appointment/booking on the resource

Appointment.Resources.Resource.Code

 

 

Code identifying physicians or other resources reserved for the appointment.

Appointment.Resources.Resource.Name

 

 

Physician name or description of other resource reserved for the appointment.

Appointment.Resources.Resource.Type

 

 

Type/category of resources reserved for the appointment.

 

HIS90:

Valid codes in PAQRECA.

Appointment.Resources.Resource.MedicalUnit.Id

 

 

Internal id/number of the department that owns resources reserved for the appointment.

Appointment.Resources.Resource.MedicalUnit.ShortName

 

 

Short name/code of the department that owns resources reserved for the appointment.

Appointment.Resources.Resource.MedicalUnit.Name

 

 

The name of the department that owns resources reserved for the appointment.

Appointment.Resources.Resource.CareUnit.Id

 

 

Internal id/number of the unit that owns resources reserved for the appointment.

Appointment.Resources.Resource.CareUnit.ShortName

 

 

Short name/code of the unit that owns resources reserved for the appointment.

Appointment.Resources.Resource.CareUnit.Name

 

 

The name of the unit that owns resources reserved for the appointment.

Appointment.Resources.EvaluatedBy.Id

 

 

Internal id identifying responsible physician or other resource responsible for the medical care or evaluation (review of the requisition/referral).

 

HIS90: N/A

Appointment.Resources.EvaluatedBy.Code

 

 

Code identifying responsible physician or other resource responsible for the medical care or evaluation (review of the requisition/referral).

Appointment.Resources.EvaluatedBy.Name

 

 

Name identifying responsible physician or other resource responsible for the medical care or evaluation (review of the requisition/referral).

Appointment.Resources.EvaluatedBy. Property

 

 

Type/category of resource.

 

HIS90:

Valid codes in PAQRECA.

Appointment.Requesters.Requester.Id

 

 

Internal id of the requester.

 

HIS90: N/A

Appointment.Requesters.Requester.Code

 

 

Code of who requested this service/booking.

This can either be an organization or a physican.

-       1 (external or internal requester organization)

-       2 (requesting physician)

Appointment.Requesters.Requester.Name

 

 

Name of who requested this service/booking.

-       [1] Name of requesting organization

-       [2] Name of requesting physician

Appointment.Requesters.Requester.Type

 

 

Type of requester.

 

HIS90:

Valid values, description:

1: External institution (Ekstern institusjon)

2: Health station, medical centre (Helsestasjon, legesenter)

3: External physician (Ekstern lege)

4: Internal ward (Intern sengepost)

5: Internal polyclinic (Intern poliklinikk)

6: Internal physician (Intern lege)

7: Nursing home (Aldershjem)

Appointment.Reason

 

 

Reason for appointment, from referral and/or waiting list evaluation.

Appointment.BookingText.Text

 

 

Free text used in confirmation letter to patient.

 

HIS90:

If ICPC is registered in requisition then this is shown in booking_text_2 Then the text has the following format:  (Code type) Code description

Appointment.BookingText.TypeOfText

 

 

Coded description for type of text, used for identifying several texts.

 

HIS90:

BT1 = Booking text 1

BT2 = Booking text 2

Appointment.Admission.ContactedDate

 

 

Date when patient is/was contacted about admittance.

 

HIS90:

Set by server when letter is created.

Appointment.Admission.ByPhone

 

 

Admission confirmed/done by phone

 

HIS90: N/A

Appointment.Admission.Letter.ToRequester.Code

 

 

Code used in letter of admission confirmation to requester.

 

HIS90:

Valid code is found in PAQLETT using CommonCodesWS.ListLetterCodes.

Appointment.Admission.Letter.ToRequester.Text

 

 

Letter  description of code above.

Appointment.Admission.Letter.ToPatient.Code

 

 

Code used in letter to in-patient confirming admittance.

 

HIS90:

Valid code is found in PAQLETT using CommonCodesWS.ListLetterCodes.

Appointment.Admission.Letter.ToPatient.Text

 

 

Letter code description of the code above.

Appointment.Admission.Letter.TextToPatient.Text

 

 

Free text used in admittance letter.

Appointment.Admission.Letter.TextToPatient.TypeOfText

 

 

Coded description of type of text, used for identifying several texts.

 

HIS90:

LIT = Letter in text

Appointment.Update.Date

 

 

Date when waiting list instance was last modified.

 

HIS90:

Set by server.

Appointment.Update.Name

 

 

Name of updater.

 

HIS90: N/A

Appointment.Update.Organization. Id

 

 

Department responsible for last modification of waiting list instance.

 

HIS90:

Internal Id.

Appointment.Update.Organization.ShortNameId

 

 

Department code/short name.

Appointment.Update.Organization.Name

 

 

Department name.

Appointment.Update.SignedBy

 

 

Initials of user who modified waiting list instance.

 

HIS90:

Set by server using information from security token.

Appointment.Update.UpdateCount

 

 

Count used for concurrency testing when waiting list is updated.

 

Schema for GetAppointment: Booking.xsd

Schema documentation for GetAppointment: Booking.html

Sample xml file for GetAppointment: GetAppointmentRequest.xml   GetAppointmentsResponse.xml

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=GetAppointment

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

HIS90 spesific information:

Server used for the method is CWBP03 and service PWS0815.

There is no restriction regarding user access for this method.

 

 

1.1.5   ListScheduleByResource

 

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

The method is used for listing a resource’s scheduled slots giving the resource’s id as input. Filters for organization unit, from/to date and scheduled slot status can be applied.

 

·                     The response returned is scheduled slots/appointments with patient information, from/to date/time, scheduled slot status, booking status and main resource.

·                     If unit is not given in request the method will use the user’s default unit (according to the ticket/security token given).

 

ListPatientAppointments can be used to find valid appointments/scheduled slots for a patient.

 

Syntax:

 

ListScheduleByResourceResponse = ListScheduleByResource(ListScheduleByResourceRequest)

 

 

Parameter in

Type

Length byte

Description – Data format – Valid data

ListScheduleByResourceRequest

 

N/A

Dynamic

Request class according to XML schema in Booking.xsd.

Description:

 

 

 

ResourceId

String

 

Internal resource id.

 

HIS90:

Combined id: DeptNo|ResourceCode

TypeOfResourceId

String

 

Type of id given in ResourceId.

Valid type is:

LOC = Local resource id

Unit.Id

String

 

Unit where the resource is currently working and for which schedule slots are wanted. User must have access to the given unit.

If unit is blank/null then unit will the user’s default unit.

Unit.TypeOfId

String

 

Type of Unit.Id.

Valid type is:

LEN = Local care unit

From

DateTime

 

From date/time.

To

DateTime

 

To date/time.

ScheduleslotStatusFilter

Enum

 

Filter for filtering the different schedule slots on a resource. Multiple statuses can be set to select scheduled slots with several statuses in the same request.

 

If ScheduleslotStatusFilter is null/missing in request the default status is BOOKED.

 

Valid filters are:

-       ALL

-       BOOKED

-       BLOCKED

-       FREE

-       PAUSE

 

 

Returned parameter

Type

Length Byte

Description – Comments

ListScheduleByResourceResponse

ResourceSchedules.ResourceSchedule

 

N/A

Dynamic

Response class according to XML schema in Booking.xsd.

Description:

 

 

 

ScheduleSlotId

String

 

Unique id for a scheduled slot.

 

Used for getting or updating the specific scheduled slot with ListScheduleSlots or SaveScheduleSlots methods.

 

HIS90: Combined ScheduleSlotId

BookingId

String

 

Internal appointment/booking id.

 

HIS90: Combined BookingId

CarePeriod.CarePeriodId

String

 

Internal Care Period Id. An id used to identify associated contacts or referrals.

HIS90:

Combined Id Ref format PatientId|CapeNo

CarePeriod.ClinicalArea.Code

String

 

Clinical area.

HIS90: Fagområde

CarePeriod.ClinicalArea.Text

String

 

Description of clinical area code above

CarePeriod.InDiagnosis.Id

String

 

Referral diagnosis id.

 

Use CommonCodesWS.ListMedicalCodes to list all valid codes.

 

HIS90:

Combined id

PAQCAPE

CarePeriod.InDiagnosis.Code

String

 

In diagnosis code from medical register, e.g. ICD-10.

 

HIS90:

PAQCAPE

CarePeriod.InDiagnosis.Text

String

 

Diagnosis name.

CarePeriod.InDiagnosis.MedRegister.Id

String

 

Id of medical register, e.g. ICD-10.

 

HIS90:

PAQREGI

CarePeriod.InDiagnosis.MedRegister.Code

String

 

Medical register code.

 

HIS90: N/A

CarePeriod.InDiagnosis.MedRegister.Text

String

 

Description of medical register.

WaitingList.WaitingListId

String

 

Internal waiting list id the scheduled slot/appointment/booking belongs to.

 

HIS90: Combined WaitingListId

WaitingList.Reason

String

 

The reason for the scheduled slot/appointment from the waiting list.

WaitingList.Status.Code

String

 

Status code for waiting list (booking in waiting list).

Valid status codes are:

1-9

WaitingList.Status.Text

String

 

Corresponding status text for waiting list booking in waiting list).

Valid status texts are:

-       (1) Aktivt på venteliste (Actively on waiting list)

-       (2) Slettet fra venteliste (Deleted from waiting list)

-       (3) Utsatt på venteliste (Suspended from waiting list)

-       (4) Time er satt/bestilt (Active on waiting list with appointment time visit time) in place)

-       (5) Slettet fra timebestilling (Deleted from waiting list deleted from status 4))

-       (6) Ikke møtt (Did not meet)

-       (7) Ankommet poliklinikk (Arrived at policlinic)

-       (8) Ankommet sengepost (Arrived at inpatient clinic)

-       (9) Sperrekode prioritet 55 (Suspension, code 55)

WaitingList.VisitType.Code

String

 

Type of consultation.

 

HIS90: Patient_Type

Use CommonCodesWS.ListAdmitCodes to list valid values.

WaitingList.VisitType.Text

String

 

Description of VisitType.Code.

WaitingList.ClinicalArea.Code

String

 

Clinical area.

If not set on waiting list level then use clinical area from care period.

HIS90: Fagområde

WaitingList.ClinicalArea.Text

String

 

Description of clinical area code above

WaitingList.InDiagnosis.Id

String

 

Referral diagnosis id.

 

Use CommonCodesWS.ListMedicalCodes to list all valid codes.

 

HIS90:

Combined id

PAQBOOK

WaitingList.InDiagnosis.Code

String

 

In diagnosis code from medical register, e.g. ICD-10.

 

HIS90:

PAQBOOK

WaitingList.InDiagnosis.Text

String

 

Diagnosis name.

WaitingList.InDiagnosis.MedRegister.Id

String

 

Id of medical register, e.g. ICD-10.

 

HIS90:

PAQREGI

WaitingList.InDiagnosis.MedRegister.Code

String

 

Medical register code.

 

HIS90: N/A

WaitingList.InDiagnosis.MedRegister.Text

String

 

Description of medical register.

Contact.ContactId

String

 

Internal ContactId if the appointment/booking has resulted in a contact.

Normally after patient has arrived.

 

HIS90: Combined ContactId.

Contact.Status.Code

String

 

Status of the contact.

Valid values are:

-       AK = Active - Out-patient visit arrival registered (Aktiv - Ankomstregistrert)

-       FB = Treatment finished but not discharged (Ferdig behandlet, ikke utskrevet)

-       UT = Discharged - Out-patient visit finished registered (Utskrevet - Besøksregistrert)

-       PM = Leave (Permisjon)

-       IM = No-meet (Ikke møtt)

-       SL = Visit deleted (Besøk slettet)

Contact.Status.Text

String

 

Description of the contact status.

 

HIS90:

Valid values are:

-       Ankomstregistrert (2): Arrival registered

-       Pasienten ikke møtt (3): No-meet

-       Besøksregistrert (4): Visit registered

-       Besøk makulert (5): Visit deleted

Contact.Status.VisitStatus.Code

String

 

The visit status of the contact.

This is a sub detail for the Status.Code.

 

HIS90:

Valid values are 2, 3, 4, 5.

Contact.Status.VisitStatus.Text

String

 

The description of the visit status code.

ScheduleSlotStatus

String

 

Schedules slot status type, tells what type of scheduled slot the resource is allocated with.

Valid ScheduleSlotStatus are:

-       BOOKED

-       BLOCKED

-       FREE

-       PAUSE

ScheduleSlotType

String

 

Type of booking.

 

HIS90:

Valid types are T1-T5 and OB.

ScheduleSlotDescription

String

 

Appointment reason/description.

 

HIS90:

Booking reason from PAQREBO.REASON.

OpenScheduleSlot

Boolean

 

Flag to indicate if the scheduled slot is based on an open template. If open template, OpenScheduleSlot is set to TRUE.

A scheduled slot with an open template can be split into several scheduled slots/appointments when they are booked.

A scheduled slot with a fixed template has a predefined from and to time, so here the given scheduled slot is booked entirely.

If OpenSceduleSlot is NULL or false it is a fixed template.

OverBookingAllowed

Int

 

Number to indicate if overbooking is allowed for the resource.

If the scheduled slot is based on an open template (see OpenScheduleSlot above) then OverBookingAllowed will give number of minutes the resource can be overbooked on the given date.

If the scheduled slot is based on a fixed template (see OpenScheduleSlot above) then OverBookingAllowed will give number of scheduled slots for the resource that are available for overbooking on the given date.

ReservedToDate

DateTime

 

The date and time until when the scheduled slot is reserved. As long as the scheduled slot is reserved it cannot be booked.

If no reservation or the ReservedToDate is in the past, ReservedToDate will be NULL/missing in the response.

From

DateTime

 

Planned start date/time for a booking by patient responsible.

Note - If the scheduled slot/appointment is suspended/postponed (see Status.Code) the From and To date will contain the original start date/time of the scheduled slot/appointment (not the new date/time).

To

DateTime

 

If a scheduled slot/appointment is scheduled then this gives end time for booking by patient responsible.

Note - If the scheduled slot/appointment is suspended/postponed (see Status.Code) the From and To date will contain the original end date/time of the scheduled slot/appointment (not the new date/time).

Patient.PatientId

String

 

Internal Patient id.

Patient.FormattedName

String

 

Patient’s name.

Patient.BirthDate

DateTime

 

Patient’s birth date.

Patient.Dead.DeathDate

DateTime

 

Patient’s death date, if dead.

Patient.Sex.Code

String

 

Patient’s sex.

Valid values are:

M = Male (Mann)

K = Female (Kvinne)

U = Unknown (Ukjent)

Patient.Sex.OfficialCode

String

 

Patient’s sex code.

Valid values are:

1 = Male (Mann)

2 = Female (Kvinne)

9 = Unknown (Ukjent)

Patient.Sex.Text

String

 

Description of patient’s sex.

Patient.Municipality.Code

String

 

Municipality code.

 

HIS90:  Not used.

Patient.Municipality.Name

String

 

Municipality name.

 

HIS90:  Not used.

Patient.PostalAdress.Code

String

 

Postal address code (zip code).

 

HIS90:  Not used.

Patient.PostalAdress.Name

String

 

Postal address name (city).

 

HIS90:  Not used.

Patient.Telecom. MobilePhoneNumber

String

 

Patient’s mobile phone number.

 

HIS90:  Not used.

Patient.Telecom.MobilePhoneReservation

Boolean

 

If patient has reserved himself/herself that the mobile phone number can be used.

True: If tag missing, i.e. mobile phone number can be used.

False: Patient has reserved against use of mobile phone number.

 

HIS90:  Not used.

Resource.ResourceId

 

 

Internal unique id identifying physicians or other resources reserved for the scheduled slot/appointment.

 

HIS90:

Combined id for unique identification of a resource.

Resource.TypeOfId

 

 

Type of id for ResourceId.

Valid values are:

LOC = local resource id for system

Resources.Resource.Code

 

 

Code identifying physicians or other resources reserved for the scheduled slot/appointment.

Resources.Resource.Name

 

 

Physician’s name, or description of other resource reserved for the scheduled slot/appointment.

Resources.Resource.Property

 

 

Type/category of resource reserved for the scheduled slot/appointment.

 

HIS90: Not used.

BookingText.Text

 

 

Free text used in referrall/waitinglist/booking

BookingText.TypeOfText

 

 

Coded description of the text type. For valid codes see documentation.

SendNotification.Code

 

 

Sending notfication  to the patient. If not set/null the no notifictaion is sent.

Codes are:

Y (YES) only patient

N (NO) no for both patients and relations

R Relations only

A All (both aptient and relations)

SendNotification.Text

 

 

Description of notfication

SendNotification.TypeOfNotification

 

 

Type of notification to send.

Valid values are:

- SMS

- Letter

- EMail

 

Schema for ListScheduleByResource: Booking.xsd

Schema documentation for ListScheduleByResource: Booking.html

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=ListScheduleByResource

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

HIS90 spesific information:

Server used for the method is CWBR01 and service PWS1601.

There is no restriction regarding user access for this method.

 

1.1.6   ListScheduleByOrg

 

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

·                     The method is used for listing scheduled slots at a medical/department or care unit provided the unit id and type as input. Filters in from/to date and scheduled slot status can be applied.

·                     The response contains scheduled slots with patient information, from/to date/time, scheduled slot status, booking status and main resource.

·                     If unit is not provided in request the method will use the user’s default unit (according to the ticket/security token).

·                     If a patient is booked on several resources one row for each resource will be returned.

 

ListPatientAppointments can be used to find valid appointments for a patient.

 

Syntax:

 

ListScheduleByOrgResponse = ListScheduleByOrg(ListScheduleByOrgRequest)

 

 

Parameter in

Type

Length byte

Description – Data format – Valid data

ListScheduleByOrgRequest

 

N/A

Dynamic

Request class according to XML schema in Booking.xsd.

Description:

 

 

 

Unit.Id

String

 

Unit where resource is currently working for which scheduled slots are wanted. User must have access to the given unit.

If unit is blank/null then the user default unit will be used.

Use OrganizationWS.ListOrganizations2G or OrganizationWS.ListOrganizations to list valid organizations.

Required parameter.

Unit.TypeOfId

String

 

Type of Unit.Id.

Valid values are:

LAV = medical/department unit

LEN = care unit

Required parameter.

From

DateTime

 

From date/time.

To

DateTime

 

To date/time.

ScheduleslotStatusFilter

Enum

 

Filter for filtering the different schedule slots on a resource. Multiple statuses can be set to select scheduled slots with several statuses in the same request.

 

If ScheduleslotStatusFilter is null/missing in request the default status is BOOKED

 

Valid filters are:

-       ALL

-       BOOKED

-       BLOCKED

-       FREE

-       PAUSE

-       FirstEachResource

 

 

Returned parameter

Type

Length Byte

Description – Comments

ListScheduleByOrgResponse

ScheduleByOrgs.ScheduleByOrg

 

N/A

Dynamic

Response class according to XML schema in Booking.xsd.

Description:

 

 

 

ScheduleSlotId

String

 

Unique id for a scheduled slot.

 

Used for getting or updating the specific scheduled slot with ListScheduleSlots or SaveScheduleSlots methods.

 

HIS90: Combined ScheduleSlotId

BookingId

String

 

Internal appointment/booking id.

 

HIS90: Combined BookingId

CarePeriod.CarePeriodId

String

 

Internal Care Period Id. An id used to identify associated contacts or referrals.

HIS90:

Combined Id Ref format PatientId|CapeNo

CarePeriod.ClinicalArea.Code

String

 

Clinical area.

HIS90: Fagområde

CarePeriod.ClinicalArea.Text

String

 

Description of clinical area code above

CarePeriod.InDiagnosis.Id

String

 

Referral diagnosis id.

 

Use CommonCodesWS.ListMedicalCodes to list all valid codes.

 

HIS90:

Combined id

PAQCAPE

CarePeriod.InDiagnosis.Code

String

 

In diagnosis code from medical register, e.g. ICD-10.

 

HIS90:

PAQCAPE

CarePeriod.InDiagnosis.Text

String

 

Diagnosis name.

CarePeriod.InDiagnosis.MedRegister.Id

String

 

Id of medical register, e.g. ICD-10.

 

HIS90:

PAQREGI

CarePeriod.InDiagnosis.MedRegister.Code

String

 

Medical register code.

 

HIS90: N/A

CarePeriod.InDiagnosis.MedRegister.Text

String

 

Description of medical register.

WaitingList.WaitingListId

String

 

Internal waiting list id the scheduled slot/appointment/booking belongs to.

 

HIS90: Combined WaitingListId

WaitingList.Reason

String

 

The reason for the scheduled slot/appointment from the waiting list.

WaitingList.Status.Code

String

 

Status code for waiting list (booking in waiting list).

Valid status codes are:

1-9

WaitingList.Status.Text

String

 

Corresponding status text for waiting list booking in waiting list).

Valid status texts are:

-       (1) Aktivt på venteliste (Actively on waiting list)

-       (2) Slettet fra venteliste (Deleted from waiting list)

-       (3) Utsatt på venteliste (Suspended from waiting list)

-       (4) Time er satt/bestilt (Active on waiting list with appointment time visit time) in place)

-       (5) Slettet fra timebestilling (Deleted from waiting list deleted from status 4))

-       (6) Ikke møtt (Did not meet)

-       (7) Ankommet poliklinikk (Arrived at policlinic)

-       (8) Ankommet sengepost (Arrived at inpatient clinic)

-       (9) Sperrekode prioritet 55 (Suspension, code 55)

WaitingList.VisitType.Code

String

 

Type of consultation.

 

HIS90: Patient_Type

Use CommonCodesWS.ListAdmitCodes to list valid values.

WaitingList.VisitType.Text

String

 

Description of VisitType.Code.

WaitingList.ClinicalArea.Code

String

 

Clinical area.

If not set on waiting list level then use clinical area from care period.

HIS90: Fagområde

WaitingList.ClinicalArea.Text

String

 

Description of clinical area code above

WaitingList.InDiagnosis.Id

String

 

Referral diagnosis id.

 

Use CommonCodesWS.ListMedicalCodes to list all valid codes.

 

HIS90:

Combined id

PAQBOOK

WaitingList.InDiagnosis.Code

String

 

In diagnosis code from medical register, e.g. ICD-10.

 

HIS90:

PAQBOOK

WaitingList.InDiagnosis.Text

String

 

Diagnosis name.

WaitingList.InDiagnosis.MedRegister.Id

String

 

Id of medical register, e.g. ICD-10.

 

HIS90:

PAQREGI

WaitingList.InDiagnosis.MedRegister.Code

String

 

Medical register code.

 

HIS90: N/A

WaitingList.InDiagnosis.MedRegister.Text

String

 

Description of medical register.

Contact.ContactId

String

 

Internal ContactId if the appointment/booking has resulted in a contact.

Normally after patient has arrived.

 

HIS90: Combined ContactId.

Contact.Status.Code

String

 

Status of the contact.

Valid values are:

-       AK = Active - Out-patient visit arrival registered (Aktiv - Ankomstregistrert)

-       FB = Treatment finished but not discharged (Ferdig behandlet, ikke utskrevet)

-       UT = Discharged - Out-patient visit finished registered (Utskrevet - Besøksregistrert)

-       PM = Leave (Permisjon)

-       IM = No-meet (Ikke møtt)

-       SL = Visit deleted (Besøk slettet)

Contact.Status.Text

String

 

Description of the contact status.

 

HIS90:

Valid values are:

-       Ankomstregistrert (2): Arrival registered

-       Pasienten ikke møtt (3): No-meet

-       Besøksregistrert (4): Visit registered

-       Besøk makulert (5): Visit deleted

Contact.Status.VisitStatus.Code

String

 

The visit status of the contact.

This is a sub detail for the Status.Code.

 

HIS90:

Valid values are 2, 3, 4, 5.

Contact.Status.VisitStatus.Text

String

 

The description of the visit status code.

ScheduleSlotStatus

String

 

Schedules slot status type, tells what type of scheduled slot the resource is allocated with.

Valid ScheduleSlotStatus are:

-       BOOKED

-       BLOCKED

-       FREE

-       PAUSE

ScheduleSlotType

String

 

Type of booking.

 

HIS90:

Valid types are T1-T5 and OB.

ScheduleSlotDescription

String

 

Appointment reason/description.

 

HIS90:

Booking reason from PAQREBO.REASON.

OpenScheduleSlot

Boolean

 

Flag to indicate if the scheduled slot is based on an open template. If open template, OpenScheduleSlot is set to TRUE.

A scheduled slot with an open template can be split into several scheduled slots/appointments when they are booked.

A scheduled slot with a fixed template has a predefined from and to time, so here the given scheduled slot is booked entirely.

If OpenSceduleSlot is NULL or false it is a fixed template.

OverBookingAllowed

Int

 

Number to indicate if overbooking is allowed for the resource.

If the scheduled slot is based on an open template (see OpenScheduleSlot above) then OverBookingAllowed will give number of minutes the resource can be overbooked on the given date.

If the scheduled slot is based on a fixed template (see OpenScheduleSlot above) then OverBookingAllowed will give number of scheduled slots for the resource that are available for overbooking on the given date.

ReservedToDate

DateTime

 

The date and time until when the scheduled slot is reserved. As long as the scheduled slot is reserved it cannot be booked.

If no reservation or the ReservedToDate is in the past, ReservedToDate will be NULL/missing in the response.

From

DateTime

 

Planned start date/time for a booking by patient responsible.

Note - If the scheduled slot/appointment is suspended/postponed (see Status.Code) the From and To date will contain the original start date/time of the scheduled slot/appointment (not the new date/time).

To

DateTime

 

If a scheduled slot/appointment is scheduled then this gives end time for booking by patient responsible.

Note - If the scheduled slot/appointment is suspended/postponed (see Status.Code) the From and To date will contain the original end date/time of the scheduled slot/appointment (not the new date/time).

Patient.PatientId

String

 

Internal Patient id.

Patient.FormattedName

String

 

Patient’s name.

Patient.BirthDate

DateTime

 

Patient’s birth date.

Patient.Dead.DeathDate

DateTime

 

Patient’s death date, if dead.

Patient.Sex.Code

String

 

Patient’s sex.

Valid values are:

M = Male (Mann)

K = Female (Kvinne)

U = Unknown (Ukjent)

Patient.Sex.OfficialCode

String

 

Patient’s sex code.

Valid values are:

1 = Male (Mann)

2 = Female (Kvinne)

9 = Unknown (Ukjent)

Patient.Sex.Text

String

 

Description of patient’s sex.

Patient.Municipality.Code

String

 

Municipality code.

 

HIS90:  Not used.

Patient.Municipality.Name

String

 

Municipality name.

 

HIS90:  Not used.

Patient.PostalAdress.Code

String

 

Postal address code (zip code).

 

HIS90:  Not used.

Patient.PostalAdress.Name

String

 

Postal address name (city).

 

HIS90:  Not used.

Patient.Telecom. MobilePhoneNumber

String

 

Patient’s mobile phone number.

 

HIS90:  Not used.

Patient.Telecom.MobilePhoneReservation

Boolean

 

If patient has reserved himself/herself that the mobile phone number can be used.

True: If tag missing, i.e. mobile phone number can be used.

False: Patient has reserved against use of mobile phone number.

 

HIS90:  Not used.

Resource.ResourceId

 

 

Internal unique id identifying physicians or other resources reserved for the scheduled slot/appointment.

 

HIS90:

Combined id for unique identification of a resource.

Resource.TypeOfId

 

 

Type of id for ResourceId.

Valid values are:

LOC = local resource id for system

Resources.Resource.Code

 

 

Code identifying physicians or other resources reserved for the scheduled slot/appointment.

Resources.Resource.Name

 

 

Physician’s name, or description of other resource reserved for the scheduled slot/appointment.

Resources.Resource.Property

 

 

Type/category of resource reserved for the scheduled slot/appointment.

 

HIS90: Not used.

BookingText.Text

 

 

Free text used in referrall/waitinglist/booking

BookingText.TypeOfText

 

 

Coded description of the text type. For valid codes see documentation.

SendNotification.Code

 

 

Sending notfication  to the patient. If not set/null the no notifictaion is sent.

Codes are:

Y (YES) only patient

N (NO) no for both patients and relations

R Relations only

A All (both aptient and relations)

SendNotification.Text

 

 

Description of notfication

SendNotification.TypeOfNotification

 

 

Type of notification to send.

Valid values are:

- SMS

- Letter

- EMail

MedicalUnit.Id

String

 

Id of the medical/department unit where the appointment is made.

Use OrganizationWS.GetOrganization2G to get more informationan about the unit.

MedicalUnit.TypeOfId

String

 

Type of id above. For medical/department unit ‘LAV’ is the only valid value.

MedicalUnit.ShortNameId

String

 

Code/shortname of the medical/department unit where the appointment is made.

MedicalUnit.Name

String

 

Name of the medical/department unit where the appointment is made.

CareUnit.Id

String

 

Id of the care unit where the appointment is made.

Use OrganizationWS.GetOrganization2G to get more information about the unit.

CareUnit.TypeOfId

String

 

Type of id above. For care unit ‘LEN’ is the only valid value.

CareUnit.ShortNameId

String

 

Code/shortname of the care unit where the appointment is made.

CareUnit.Name

String

 

Name of the care unit where the appointment is made.

 

Schema for ListScheduleByOrg: Booking.xsd

Schema documentation for ListScheduleByOrg: Booking.html

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=ListAppointmentsByOrg

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

HIS90 spesific information:

Server used for the method is CWBR01 and service PWS1604.

There is no restriction regarding user access for this method.

 

1.1.7   ListScheduleSlots

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

Gets a specific schedule slot or list of schedule slots from a resource’s time book according to the search criteria. ListScheduleByResource og ListScheduleByOrg must be run beforehand to find available bookings on the resource or for resources in a department/unit.

 

Syntax:

 

ScheduleSlots = ListScheduleSlots(ListScheduleSlotsRequest)

 

Parameter in

Type

Length byte

Description – Data format – Valid data

ListScheduleSlotsRequest

 

N/A

Dynamic

Request class according to XSD schema in Booking.xsd.

  .ScheduleSlotId

String

Dynamic

Gets a specific booking on a resource. ScheduleSlotId is a combined value.

Use BookingWS.ListSchedulesByResource or BookingWS.ListSchedulesByResource to get valid ScheduleSlotsId

 

HIS90:

Combined id consisting of: DeptNo|ResourceCode|Period|RschDate|HourMin|SerialNoRebo.

cfr. document PasLinkWS HIS90 combined id definitions.doc.

  .WaitingListId

String

Dynamic

Gets all bookings associated with a single waiting list. WaitingListId is a combined value.

Use WaitingListWS.ListWaitingLists or WaitingListWS.ListWaitingListsByOrg to get valid waiting lists.

 

HIS90:

Combined id consisting of: PatientId|BookingNo.

cfr. document PasLinkWS HIS90 combined id definitions.doc.

  .PatientId

Int

4

Gets all bookings on a single patient. Id of patient.

Use PatientWS.ListPatients to get valid patientids.

 

HIS90:

Value consists of: PatientId.

 

Returned parameter

Type

Length Byte

Description – Comments

ListScheduleSlotsResponse

 

N/A

Dynamic

Response class according to XSD schema in Booking.xsd

ScheduleSlots[]

 

N/A

Dynamic

Collection of schedule slots.

  .ScheduleSlotId

String

Dynamic

Unique id identifying a booking on a resource. Combined value.

 

HIS90:

Combined id consisting of: DeptNo|ResourceCode|Period|RschDate|HourMin|SerialNoRebo.

cfr. document PasLinkWS HIS90 combined id definitions.doc.

  .NewScheduleSlotId

String

Dynamic

Unique id identifying a saved booking on a resource. Combined value.

Used only for SaveScheduleSlots.

 

HIS90:

Combined id consisting of: DeptNo|ResourceCode|Period|RschDate|HourMin|SerialNoRebo.

cfr. document PasLinkWS HIS90 combined id definitions.doc.

  .ScheduleSlotSequence

Int

4

Sequence of bookings. For rebooking this can be 0.

 

HIS90:

Indirectly, sequence of bookings on resources, as booking id is resource specific, if resource is 1, 2 or 3 in PAQBOOK.

  .WaitingList.WaitingListId

String

Dynamic

Waiting list id. Mandatory when creating booking on patient. Can be omitted when updating existing booking or rebooking, as it will be got from the existing booking. Patient id and booking no is got from waiting list id, a combined id, cfr. document PasLinkWS HIS90 combined id definitions.doc.

  .WaitingList. BookingText[].Text

String

Dynamic

Text from waiting list.

  .WaitingList. BookingText[].TypeOfText

String

Dynamic

Type of text.

 

HIS90:

Legal values: TXT1 (BOOKING_TEXT1), TXT2 (BOOKING_TEXT2).

  .WaitingList.Status.Code

String

Dynamic

Status of waiting list/booking.

 

HIS90:

Integer: 1-9

  .WaitingList.Status.Text

String

Dynamic

Explanatory text for code above, set by WS according to rules in WaitingListWS.

  .ScheduleSlotStatus

String

Dynamic

Appointment status.

 

HIS90:

Legal values are:

FREE, BOOKED, BLOCKED, PAUSE

  .ScheduleSlotType

String

Dynamic

Type of booking.

 

HIS90:

Valid types are T1-T5 and OB.

  .ScheduleSlotDescription

String

Dynamic

Appointment reason/description

 

HIS90:

Booking reason from PAQREBO.REASON. In case of blocked booking, this will give the reason.

  .OpenScheduleSlot

String

Dynamic

Flag to indicate if the scheduled slot is based on an open template. If open template OpenScheduleSlot is set to TRUE.

A scheduled slot with an open template can be split into several scheduled slots/appointments when they are booked.

A scheduled slot with a fixed template has predefined from and to time, so here the given scheduled slot is booked entirely.

If OpenSceduleSlot is NULL or false it is a fixed template.

  .OverBookingAllowed

String

Dynamic

Number to indicate if overbooking is allowed for the resource.

If the scheduled slot is based on an open template (see OpenScheduleSlot above) then OverBookingAllowed will give number of minutes the resource can be overbooked on the given date.

If the scheduled slot is based on a fixed template (see OpenScheduleSlot above) then OverBookingAllowed will give number of scheduled slots for the resource that is available for overbooking on the given date.

If 0 or NULL, overbooking is not allowed.

  .ReservedToDate

String

Dynamic

The date (and time) until when the scheduled slot is reserved. As long as the scheduled slot is reserved it cannot be booked.

If no reservation or ReservedToDate is in the past, ReservedToDate will be NULL/missing in the response.

  .From

DateTime

 

Planned start date/time for a booking by patient responsible.

Note - If the scheduled slot/appointment is suspended/postponed (see Status.Code) the From and To date will contain the original start and end date/time for the scheduled slot/appointment (not the new date/time).

  .To

DateTime

 

If a scheduled slot/appointment is scheduled then this gives end time for booking by patient responsible.

Note - If the scheduled slot/appointment is suspended/postponed (see Status.Code) the From and To date will contain the original start and end date/time for the scheduled slot/appointment (not the new date/time).

  .CareUnit.Id

String

Dynamic

Id of the care unit where the appointment is made at.

Use OrganizationWS.GetOrganization2G for more information about the unit.

This is where the patient will be treated.

  .CareUnit.TypeOfId

String

Dynamic

Type of Id above. For care unit only ‘LEN’ is valid.

  .CareUnit.ShortNameId

String

Dynamic

Code/short name of the care unit where the appointment is made at.

  .CareUnit.Name

String

Dynamic

Name of the care unit where the appointment is made at.

  .Resource.ResourceId

String

Dynamic

Internal unique id identifying physicians or other resources reserved for the scheduled slot/appointment.

 

HIS90:

Combined id for unique identification of a resource

consisting of DeptNo|ResourceCode.

  .Resource.TypeOfId

String

Dynamic

Type of id for ResourceId.

HIS90:

Value set to ‘LRC’ by WS, denoting resource id for system.

  .Resource.Code

String

Dynamic

Code identifying physicians or other resources reserved for the scheduled slot/appointment.

  .Resource.Name

String

Dynamic

Physician’s name, or description of other resource reserved for the scheduled slot/appointment.

  .Resource.Property

String

Dynamic

Type/category of resource reserved for the scheduled slot/appointment.

  .Resource.MedicalUnit.Id

String

Dynamic

Id of the medical/department unit where the resource is allocated.

Use OrganizationWS.GetOrganization2G for more information about the unit.

  .Resource.MedicalUnit.TypeOfId

String

Dynamic

Type of Id above. For medical/department unit only ‘LAV’ is valid.

  .Resource.MedicalUnit.ShortNameId

String

Dynamic

Code/short name of the medical/department unit where the resource is allocated.

  .Resource.MedicalUnit.Name

String

Dynamic

Name of the medical/department unit where the resource is allocated.

  .Resource.CareUnit.Id

String

Dynamic

Internal id/number of the unit that owns the resource reserved for the scheduled slot.

  .Resource.CareUnit.TypeOfId

String

Dynamic

Type of Id above.

HIS90:

Value set to ‘LEN’ by WS.

  .Resource.CareUnit.ShortNameId

String

Dynamic

Short name/code of the unit that owns the resource reserved for the scheduled slot.

  .Resource.CareUnit.Name

String

Dynamic

The name of the unit that owns the resource reserved for the scheduled slot.

  .Update.Date

DateTime

Dynamic

Date when schedule slot instance was last modified. HIS90: N/A

  .Update.Name

String

Dynamic

Name of updater.

HIS90: N/A

  .Update.Organization.Id

String

Dynamic

Department responsible for last modification of schedule slot instance.

HIS90: N/A

  .Update.Organization.TypeOfId

String

Dynamic

Type of id above.

HIS90: N/A

  .Update.Organization.ShortNameId

String

Dynamic

Department code/short name.

HIS90: N/A

  .Update.Organization.Name

String

Dynamic

Department name.

HIS90: N/A

  .Update.SignedBy

String

Dynamic

Initials of user that modified schedule slot instance. HIS90: N/A

  .Update.UpdateCount

Int

4

Counter used for concurrency testing when schedule slot is updated.

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=ListScheduleSlots

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

1.1.8   SaveScheduleSlots

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

Saves a specific schedule slot or several schedule slots belonging to patients, waiting lists or resources. Booking/appointment/slot must be retrieved by using ListScheduleSlots before saving. There are several uses of this method.

The method can update a booking/slot on a resource. Either change the booking/slot on the resource (e.g. free or block slots that have not been booked) or order/rebook/free booking/slot for a patient or waiting list.

Updating a booking on a resource requires a slot id (ScheduleSlotId) and a blank/null waiting list id (WaitingListId). A resource can free or block a slot in their time book using this method, and change the text (reason). A slot can only be blocked if not booked. To block a slot that is not booked, the slot must be freed or rebooked before blocking.

To order/rebook/free a slot belonging to a resource and booked on a patient, a slot id (ScheduleSlotId) and waiting list id (WaitingListId) is required. When ordering/rebooking/freeing the resource information in the waiting list is updated (HIS90: cfr. resource 1, 2 and 3).

The method can rebook a time slot based on an existing slot id (ScheduleSlotId) and a new slot id (NewScheduleSlotId). The patient id on the existing time slot is used.

The method can free a booked time slot by setting status to FREE for an existing slot booked/ordered on a patient.

Additionally, reason, booking texts and dates/times can be changed.

 

Syntax:

 

ScheduleSlotsResponse = SaveScheduleSlots(SaveScheduleSlotsRequest)

 

Parameter in

Type

Length byte

Description – Data format – Valid data

SaveScheduleSlotRequest

 

N/A

Dynamic

Request class according to XSD schema in Booking.xsd.

.ScheduleSlotId

String

Dynamic

Saves a specific slot. ScheduleSlotId is a combined value.

Use BookingWS.ListSchedulesByResource or BookingWS.ListSchedulesByResource to get valid ScheduleSlotId

 

Set value according to desired action:

-       required for all actions

 

HIS90:

Combined id consisting of: DeptNo|ResourceCode|Period|RschDate|HourMin|SerialNoRebo.

cfr. document PasLinkWS HIS90 combined id definitions.doc.

.NewScheduleSlotId

String

Dynamic

Updates a specific slot (rebook). ScheduleSlotId is a combined value.

Use BookingWS.ListSchedulesByResource or BookingWS.ListSchedulesByResource to get valid ScheduleSlotsId.

 

Set value according to desired action:

-       rebook: required

-       else: Not used.

 

HIS90:

Combined id consisting of: DeptNo|ResourceCode|Period|RschDate|HourMin|SerialNoRebo.

cfr. document PasLinkWS HIS90 combined id definitions.doc.

.ScheduleSlotSequence

Int

4

Sequence of bookings. For rebooking this can be 0.

 

Set value according to desired action:

-       rebook: 0 (value from existing time slot will be used), or 1/2/3

-       book: 1, 2 or 3 (required)

-       else: 0 (Not used.)

 

HIS90:

Indirectly, sequence of bookings on resources, as booking id is resource specific, if resource is 1, 2 or 3 in PAQBOOK.

.WaitingList.WaitingListId

String

Dynamic

Saves schedule slot(s) associated with a single waiting list. WaitingListId is a combined value.

Use WaitingListWS.ListWaitingLists or WaitingListWS.ListWaitingListsByOrg to get valid waiting lists.

 

Set value according to desired action:

-       rebook: optional; if blank, value from existing slot will be used

-       book: required

-       free on patient: optional; if blank, value from existing slot will be used

-       else: Not used.

 

HIS90:

Combined id consisting of: PatientId|BookingNo.

cfr. document PasLinkWS HIS90 combined id definitions.doc.

.WaitingList.BookingText.Text

String

Dynamic

Text from waiting list.

 

Set value according to desired action:

-       rebook: optional; if blank, value from existing slot will be used

-       book: optional

-       else: Not used.

.WaitingList.BookingText.TypeOfText

String

Dynamic

Type of text.

 

Set value according to desired action:

-       same as for Text above

 

HIS90:

Legal values:

TXT1 (BOOKING_TEXT1)

TXT2 (BOOKING_TEXT2)

.WaitingList.Status.Code

String

Dynamic

Status of waiting list/booking.

 

HIS90:

Integer: 1-9

.WaitingList.Status.Text

String

Dynamic

Text set by WS according to rules in WaitingListWS.

.ScheduleSlotStatus

String

ScheduleSlotStatusType

Appointment status.

 

Set value according to desired action:

-       rebook: not specified (ignored)

-       book: BOOKED

-       free/block on resource: FREE/BLOCKED

-       free on patient: FREE

.ScheduleSlotType

String

Dynamic

Type of Booking.

 

Set value according to desired action:

-       free on patient: N/A

-       else: optional

 

HIS90:

Valid types are T1-T5 and OB.

.ScheduleSlotDescription

String

Dynamic

Appointment reason/description

 

HIS90: Booking reason from PAQREBO.REASON

.OpenScheduleSlot

Boolean

 

Flag to indicate if the scheduled slot is based on a open template. If open template OpenScheduleSlot is set to TRUE.

A scheduled slot with an open template can be split into several scheduled slots/appointments when they are booked.

A scheduled slot with a fixed template has predefined from and to time, so here the given scheduled slot is booked entirely.

If OpenSceduleSlot is NULL or false, it means a fixed template will be used.

 

Set value according to desired action:

-       free/block on resource: optional; if blank, value from existing slot will be used

-       else: N/A

.OverBookingAllowed

Int

4

Number to indicate if overbooking is allowed for the resource.

 

HIS90: N/A

.ReservedToDate

DateTime

 

The date (and time) until when the scheduled slot is reserved. As long as the scheduled slot is reserved it cannot be booked.

 

HIS90: N/A

.From

DateTime

 

Planned start date/time for a booking by patient responsible.

 

Set value according to desired action:

-       book: required only if time slot is based on an open time book; if fixed time slot, slot will be booked according to slot in PAQREBO

-       free on patient: N/A

-       else: optional

.To

DateTime

 

If a schedule slot/appointment is scheduled then this gives end time for booking by patient responsible.

 

Set value according to desired action:

-       free on patient: N/A

-       else: optional

.CareUnit.Id

String

Dynamic

Id of the care unit where the appointment is made at.

Use OrganizationWS.GetOrganization2G for more information about the unit.

 

Set value according to desired action:

-       rebook: required

-       book: required (will update existing value)

-       else: N/A

.CareUnit.TypeOfId

String

Dynamic

Type of Id above. For care unit only ‘LEN’ is valid.

 

Set value according to desired action:

-       same as for TypeOfId above

.CareUnit.ShortNameId

String

Dynamic

Code/short name of the care unit where the appointment is made at.

 

HIS90: N/A

.CareUnit.Name

String

Dynamic

Name of the care unit where the appointment is made at.

 

HIS90: N/A

.Resource.MedicalUnit.Id

String

Dynamic

Id of the medical/department unit where the resource is allocated.

Use OrganizationWS.GetOrganization2G for more information about the unit.

 

HIS90: N/A

.Resource.MedicalUnit.TypeOfId

String

Dynamic

Type of Id above.

 

HIS90: N/A

.Resource.MedicalUnit.ShortNameId

String

Dynamic

Code/short name of the medical/department unit where the resource is allocated.

 

HIS90: N/A

.Resource.MedicalUnit.Name

String

Dynamic

Name of the medical/department unit where the resource is allocated.

 

HIS90: N/A

.Resource.CareUnit.Id

String

Dynamic

Internal id/number of the unit that owns the resource reserved for the scheduled slot.

 

Set value according to desired action:

-       rebook: optional

-       book: optional

-       else: N/A

.Resource.CareUnit.TypeOfId

String

Dynamic

Type of Id above. For care unit only ‘LEN’ is valid.

 

Set value according to desired action:

-       same as for Id above

.Resource.CareUnit.ShortNameId

String

Dynamic Dynamic

Short name/code of the unit that owns the resource reserved for the scheduled slot.

 

HIS90: N/A

.Resource.CareUnit.Name

String

Dynamic

The name of the unit that owns the resource reserved for the scheduled slot.

 

HIS90: N/A

.Resource.ResourceId

String

Dynamic

Internal unique id identifying physicians or other resources reserved for the scheduled slot/appointment.

 

HIS90: N/A

.Resource.TypeOfId

String

Dynamic

Type of id for ResourceId.
Valid value is ‘LRC’ for internal resource id for system.

 

HIS90: N/A

.Resource.Code

String

Dynamic

Code identifying physicians or other resources reserved for the scheduled slot/appointment.

 

HIS90: N/A

.Resource.Name

String

Dynamic

Physician’s name, or description of other resource reserved for the scheduled slot/appointment.

 

HIS90: N/A

.Resource.Property

String

Dynamic

Type/category of resources reserved for the scheduled slot/appointment.

 

HIS90: Not used.

.Update.UpdateCount

Int

4

Counter used for concurrency testing when schedule slot is updated.

 

HIS90:

Set by server.

.Update.Date

DateTime

 

Date when schedule slot instance was last modified.

 

HIS90: N/A

.Update.Name

String

Dynamic

Name of updater.

 

HIS90: N/A

.Update.Organization.Id

String

Dynamic

Department responsible for last modification of schedule slot instance.

 

HIS90: N/A

.Update.Organization.ShortNameId

String

Dynamic

Department code/short name.

 

HIS90: N/A

.Update.Organization.Name

String

Dynamic

Department name.

 

HIS90: N/A

.Update.SignedBy

String

Dynamic

Initials of user that modified schedule slot instance.

 

HIS90: N/A

 

Returned parameter

Type

Length Byte

Description – Comments

SaveScheduleSlotsResponse

 

N/A

Dynamic

Response class according to XSD schema in Booking.xsd

ScheduleSlots[]

 

N/A

Dynamic

Collection of schedule slots.

See the ListScheduleSlots method above.

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=SaveScheduleSlots

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

 

1.1.9   MoveScheduleSlots

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Description:

MoveScheduleSlots method moves scheduled slots to another day or resource.

 

Syntax:

 

MoveScheduleSlotsResponse = MoveScheduleSlots(MoveScheduleSlotsRequest)

 

Request and response:

See schema and schema documentation

Schema for BookingWS: Booking.xsd

Schema documentation for BookingWS: BookingWS.html

 

 

Web Service Response and Request:

See https://linkws.service.tieto.com/PasLinkWS/BookingWS/BookingWS.asmx?op=MoveScheduleSlots

 

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 when 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 the RequestHeader can be retrieved by using the method GetUserLogin in Authentication web Service.

 

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

 

1.1.10               ListScheduleByResources

Applicable systems for method:

HIS90

 

 

 

 

 

 

 

Method is not implemented yet, do not use the interface as it can change.