Välityksen kuittaus

Välityspyynnön HTTP pyyntö (request)

Välityspyyntö lähetetään kysely- ja välityspalvelulle HTTP POST-pyyntönä operaatiolla $complete-communication. Välityspyyntö kuvataan FHIR standardin Communication-resurssilla. Voit lukea CommunicationRequest-resurssista lisää FHIR-standardista.

Rajapinnan OperationDefinition-kuvaus

Could not find subject. Resource was not found for 'canonical=http://kvp.kanta.fi/fhir/OperationDefinition/complete-communication'

Sekvenssikaavio



HTTP pyynnön header

HTTP-pyyntöjen header-osuudet noudattavat Kanta-palveluiden yhteisiä Kanta FHIR HTTP header ja Kanta JSON Web Token määrittelyitä ja näissä kuvattuja tietoja ja tietojen pakollisuuksia.

Kannattaa kuitenkin huomioida erityisesti headerin kenttä X-Request-Id, jonka arvo on oltava yksilöllinen jokaiselle http-pyynnölle.

Pyynnön HTTP header esimerkki

POST [base][api] HTTP/1.1 
Accept: application/fhir+json
Authorization: Bearer eyJraWQiOiJyc2ExIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJhMTcxYjFmNC04ZDkwLT...
X-Request-Id: 1.2.246.10.1.20241208102307.93.2023.11023072024880604629
Content-Type: application/x-www-form-urlencoded

HTTP pyynnön body

Välityspyynnön tiedot välitetään HTTP pyynnön body-osuudessa Parameters-resurssin avulla. Voit lukea lisää Parameters-resurssista FHIR-stadnardista.

idΣ0..1string
id0..1string
extensionC0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ0..*canonical(StructureDefinition)Fixed Value
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..0uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionC0..*Extension
modifierExtension?! C0..*Extension
identifierΣ0..0Identifier
instantiatesCanonicalΣ0..0canonical(PlanDefinition | ActivityDefinition | Measure | OperationDefinition | Questionnaire)
instantiatesUriΣ0..0uri
id0..0string
extensionC0..*Extension
referenceΣ C0..0string
typeΣ0..0uriBinding
id0..1string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ0..0Period
assignerΣ0..0Reference(Organization)
displayΣ0..1string
partOfΣ0..0Reference(Resource)
inResponseTo0..0Reference(Communication)
statusΣ ?!1..1codeBinding
id0..1string
extensionC0..*Extension
codingΣ0..0Coding
textΣ0..1string
category0..0CodeableConcept
priorityΣ0..0codeBinding
medium0..0CodeableConcept
id0..1string
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
displayΣ0..0string
topic0..0CodeableConcept
about0..0Reference(Resource)
encounterΣ0..0Reference(Encounter)
sent0..1dateTime
received0..1dateTime
id0..0string
extensionC0..*Extension
referenceΣ C0..0string
typeΣ0..0uriBinding
id0..0string
extensionC0..*Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ0..0Period
assignerΣ0..0Reference(Organization)
displayΣ0..1string
id0..0string
extensionC0..*Extension
referenceΣ C0..0string
typeΣ0..0uriBinding
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ0..0Period
assignerΣ0..0Reference(Organization)
displayΣ0..1string
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
reasonReferenceΣ0..0Reference(Condition | Observation | DiagnosticReport | DocumentReference)
id0..0string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
id0..1string
extensionC0..*Extension
contentTypeΣ0..1codeBindingFixed Value
languageΣ0..0codeBinding
data1..1base64Binary
urlΣ0..0url
sizeΣ0..0unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
note0..0Annotation
{
"resourceType": "Parameters",
{
"name": "Valityspyynto",
"resourceType": "CommunicationRequest",
"id": "example",
"meta": {
"profile": [
"https://kvp.kanta.fi/fhir/StructureDefinition/valityspyynto"
]
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Esimerkkiresurssi välityspyynnöstä. </div>"
},
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:0b0a55d2-799a-45f5-a161-6a4a5faad1f5"
}
],
"status": "active",
"subject": {
"system": "urn:oid:1.2.246.21",
"value": "090878-915W"
},
"display": "Mauri Antero, Numminen"
},
"payload": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:oid:1.2.246.10.10345159"
}
},
{
"url": "https://kvp.kanta.fi/fhir/StructureDefinition/Nakymakoodi",
"system": "urn:oid:1.2.246.537.6.12.2002",
"code": "151",
"display": "Lääkärinlausunto ajokyvystä"
}
}
]
}
],
"system": "urn:oid:1.2.246.537.26",
"value": "10005398475"
},
"display": "Lääkäri, Luttinen"
},
{
"system": "urn:oid:1.2.246.537.6.40191.201701",
"value": "urn:oid:1.2.246.10.10317159"
},
"display": "Traficom"
}
],
{
"coding": [
{
"system": "urn:oid:1.2.246.537.6.40192.2012",
"code": "1",
"display": "Asiakkaan toimeksianto"
}
]
}
]
}
}
]
}

Vastaussanoma virhetilanteessa

Virhetilanteissa vastauksena palautuu HTTP virhestatuskoodi sekä HTTP bodyssa OperationOutcome resurssi-instanssi, jolla ilmaistaan tarkempi virhe. KVP:n Käyttämää OperationOutcome-resurssia ei ole profiloitu.

Command 'pagelink' could not render: Page not found.
-sivulla on kuvattu tarkemmin, miten KVP palauttaa virheilmoitukset OperationOutcome-resussilla.