{ "resourceType" : "OperationDefinition", "id" : "search-from-Kanta", "text" : { "status" : "generated", "div" : "

Generated Narrative: OperationDefinition search-from-Kanta

URL: [base]/Appointment/$search-from-Kanta

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INpatientIdentifier1..1Identifier

patient.identifier - Identifier of the patient who is the subject of the appointment.

\n
INidentifier0..1Identifier

appointment.identifier - Business identifier of the appointment.

\n
INserviceOrganiser0..1Coding

Provenance.agent.who.identifier - Organiser of the booked service.

\n
INappointmentServiceProvider0..1Coding

organization.partOf.identifier - Provider of the booked service. For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code value should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.

\n
INappointmentServiceProviderUnit0..1Coding

organization.identifier - Organization where the booked service takes place. For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.

\n
INproducingServiceProviderUnit0..1Coding

Provenance.agent.who.identifier - Organization that produced the Appointment resource. If this parameter is provided, the service provider parameter 'appointment-service-provider' must also be provided (in addition to the patient identifier). For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.

\n
INdate0..2string

appointment.start – Start time of the appointment. The accepted date formats are yyyy-mm-dd, yyyy-mm-ddThh:mm:ss or yyyy-mm-ddThh:mm:ss[Z|(+|-)hh:mm]. A value entered without a time zone is treated as the Helsinki time zone. Mandatory prefix options include eq, gt, lt, ge, le. When two dates are provided, they must not include the eq prefix. The eq prefix can only be used with a single date.

\n
INrecorded0..2string

provenance.recorded - Creation time of the appointment, i.e. the moment when the Appointment resource was created. The accepted date formats are yyyy-mm-dd, yyyy-mm-ddThh:mm:ss or yyyy-mm-ddThh:mm:ss[Z|(+|-)hh:mm]. A value entered without a time zone is treated as the Helsinki time zone. Mandatory prefix options include eq, gt, lt, ge, le. When two recorded are provided, they must not include the eq prefix. The eq prefix can only be used with a single recorded.

\n
INregisterTypeCode0..1Coding

provenance.extension.RegisterType - Patient register identifier.

\n
INserviceEvent0..1string

provenance.extension.ServiceEvent - Service event identifier used as a search filter.

\n
INdisclosureServiceEventId0..1string

Disclosure service event identifier. This parameter must be provided if performing a disclosure search.

\n
INincludeOwn0..1boolean

Whether the search result should return data from the inquirer’s own register or exclude it (default: true).

\n
INcount0..1integer

Maximum number of search results to return in one response. When continuing a paged search, provide resultSetKey and originalXRequestId along with the same count value as in the previous search request.

\n
INresultSetKey0..1Identifier

Result set identifier used for continuing a paged appointment search. This parameter must be provided together with originalXRequestId and count. Omit both resultSetKey and originalXRequestId when starting a new search.

\n
INoriginalXRequestId0..1string

Original X-Request-ID used for continuing a paged appointment search. This parameter must be provided together with resultSetKey and count. Omit both resultSetKey and originalXRequestId when starting a new search.

\n
INconfirmed-protected-content0..*

Codes of protected contents views that are included in the search result, and information on whether viewing the protected content has been confirmed automatically. The user must be asked for separate confirmation before showing protected content unless viewing that content has been separately defined as part of the user's work tasks.

\n
INconfirmed-protected-content.content1..1Codingfipta-vs-tableofcontentsprotected (Required)

The value must be from ValueSet fipta-vs-tableofcontentsprotected.

\n
INconfirmed-protected-content.automatic0..1boolean

Whether viewing the protected content has been confirmed automatically without asking the user. The default value is false.

\n
INconfirmed-protected-content.reason0..1string

Optional free-text reason for showing the protected content.

\n
OUTreturn1..1Bundle

Appointment and Provenance (appointment meta information) resource pairs that matched the given search parameters. If search results were filtered because of protected content, the response Bundle also contains an OperationOutcome that describes which protected table of contents views were omitted from the result.

\n
" }, "url" : "https://eradocumentation.atostek.com/OperationDefinition/Appointment-search-from-Kanta", "version" : "1.0.0", "name" : "search-from-Kanta", "title" : "AppointmentFi Search From Kanta", "status" : "draft", "kind" : "operation", "date" : "2026-10-28T11:52:12+00:00", "publisher" : "Atostek", "contact" : [{ "name" : "Atostek", "telecom" : [{ "system" : "url", "value" : "https://atostek.com/" }] }], "description" : "The operation can be used to search for appointments from the Kanta Patient Data Repository. \n\nThe operation requires an active ERA session and the client registry ID. Please provide these in the request header.", "code" : "search-from-Kanta", "resource" : ["Appointment"], "system" : false, "type" : true, "instance" : false, "parameter" : [{ "name" : "patientIdentifier", "use" : "in", "min" : 1, "max" : "1", "documentation" : "patient.identifier - Identifier of the patient who is the subject of the appointment.", "type" : "Identifier" }, { "name" : "identifier", "use" : "in", "min" : 0, "max" : "1", "documentation" : "appointment.identifier - Business identifier of the appointment.", "type" : "Identifier" }, { "name" : "serviceOrganiser", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Provenance.agent.who.identifier - Organiser of the booked service.", "type" : "Coding" }, { "name" : "appointmentServiceProvider", "use" : "in", "min" : 0, "max" : "1", "documentation" : "organization.partOf.identifier - Provider of the booked service. For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code value should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.", "type" : "Coding" }, { "name" : "appointmentServiceProviderUnit", "use" : "in", "min" : 0, "max" : "1", "documentation" : "organization.identifier - Organization where the booked service takes place. For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.", "type" : "Coding" }, { "name" : "producingServiceProviderUnit", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Provenance.agent.who.identifier - Organization that produced the Appointment resource. If this parameter is provided, the service provider parameter 'appointment-service-provider' must also be provided (in addition to the patient identifier). For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.", "type" : "Coding" }, { "name" : "date", "use" : "in", "min" : 0, "max" : "2", "documentation" : "appointment.start – Start time of the appointment. The accepted date formats are yyyy-mm-dd, yyyy-mm-ddThh:mm:ss or yyyy-mm-ddThh:mm:ss[Z|(+|-)hh:mm]. A value entered without a time zone is treated as the Helsinki time zone. Mandatory prefix options include eq, gt, lt, ge, le. When two dates are provided, they must not include the eq prefix. The eq prefix can only be used with a single date.", "type" : "string" }, { "name" : "recorded", "use" : "in", "min" : 0, "max" : "2", "documentation" : "provenance.recorded - Creation time of the appointment, i.e. the moment when the Appointment resource was created. The accepted date formats are yyyy-mm-dd, yyyy-mm-ddThh:mm:ss or yyyy-mm-ddThh:mm:ss[Z|(+|-)hh:mm]. A value entered without a time zone is treated as the Helsinki time zone. Mandatory prefix options include eq, gt, lt, ge, le. When two recorded are provided, they must not include the eq prefix. The eq prefix can only be used with a single recorded.", "type" : "string" }, { "name" : "registerTypeCode", "use" : "in", "min" : 0, "max" : "1", "documentation" : "provenance.extension.RegisterType - Patient register identifier.", "type" : "Coding" }, { "name" : "serviceEvent", "use" : "in", "min" : 0, "max" : "1", "documentation" : "provenance.extension.ServiceEvent - Service event identifier used as a search filter.", "type" : "string" }, { "name" : "disclosureServiceEventId", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Disclosure service event identifier. This parameter must be provided if performing a disclosure search.", "type" : "string" }, { "name" : "includeOwn", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Whether the search result should return data from the inquirer’s own register or exclude it (default: true).", "type" : "boolean" }, { "name" : "count", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Maximum number of search results to return in one response. When continuing a paged search, provide resultSetKey and originalXRequestId along with the same count value as in the previous search request.", "type" : "integer" }, { "name" : "resultSetKey", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Result set identifier used for continuing a paged appointment search. This parameter must be provided together with originalXRequestId and count. Omit both resultSetKey and originalXRequestId when starting a new search.", "type" : "Identifier" }, { "name" : "originalXRequestId", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Original X-Request-ID used for continuing a paged appointment search. This parameter must be provided together with resultSetKey and count. Omit both resultSetKey and originalXRequestId when starting a new search.", "type" : "string" }, { "name" : "confirmed-protected-content", "use" : "in", "min" : 0, "max" : "*", "documentation" : "Codes of protected contents views that are included in the search result, and information on whether viewing the protected content has been confirmed automatically. The user must be asked for separate confirmation before showing protected content unless viewing that content has been separately defined as part of the user's work tasks.", "part" : [{ "name" : "content", "use" : "in", "min" : 1, "max" : "1", "documentation" : "The value must be from ValueSet fipta-vs-tableofcontentsprotected.", "type" : "Coding", "binding" : { "strength" : "required", "valueSet" : "https://pta.kanta.fi/fhir/ValueSet/fipta-vs-tableofcontentsprotected" } }, { "name" : "automatic", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Whether viewing the protected content has been confirmed automatically without asking the user. The default value is false.", "type" : "boolean" }, { "name" : "reason", "use" : "in", "min" : 0, "max" : "1", "documentation" : "Optional free-text reason for showing the protected content.", "type" : "string" }] }, { "name" : "return", "use" : "out", "min" : 1, "max" : "1", "documentation" : "Appointment and Provenance (appointment meta information) resource pairs that matched the given search parameters. If search results were filtered because of protected content, the response Bundle also contains an OperationOutcome that describes which protected table of contents views were omitted from the result.", "type" : "Bundle" }] }