{
  "resourceType": "StructureDefinition",
  "url": "https://shark.kanta.fi/fhir/StructureDefinition/SocialWelfareDocumentReference",
  "version": "0.0.2",
  "name": "SocialWelfareDocumentReference",
  "title": "Social Welfare DocumentReference",
  "status": "draft",
  "date": "2026-03-25",
  "publisher": "Kela",
  "description": "DocumentReference-profiili, jolla Sosiaalihuollon asiakastietovaranto palauttaa merkinnän toimintakyvystä ja toimintakykyarvion haussa merkintään toimintakyvystä/toimintakykyarvioon liittyvien Sosiaalihuollon asiakastietovarantoon tallennettujen liiteasiakirjojen tiedot. \r\n\r\nProfiilia ei käytetä toimintakykytietojen tallentamisessa. ",
  "fhirVersion": "4.0.1",
  "kind": "resource",
  "abstract": false,
  "type": "DocumentReference",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/DocumentReference",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "DocumentReference",
        "path": "DocumentReference",
        "short": "Liiteasiakirjan tiedot",
        "definition": "Profiili, jolla Sosiaalihuollon asiakastietovaranto palauttaa merkinnän toimintakyvystä ja toimintakykyarvion haussa merkintään toimintakyvystä/toimintakykyarvioon liittyvien Sosiaalihuollon asiakastietovarantoon tallennettujen liiteasiakirjojen tiedot. \r\n\r\nProfiilia ei käytetä toimintakykytietojen tallentamisessa. "
      },
      {
        "id": "DocumentReference.extension",
        "path": "DocumentReference.extension",
        "min": 1,
        "max": "1"
      },
      {
        "id": "DocumentReference.extension:creationTime",
        "path": "DocumentReference.extension",
        "sliceName": "creationTime",
        "short": "Liiteasiakirjan laatimisaika",
        "definition": "Sosiaalihuollon asiakastietovaranto palauttaa tiedossa liiteasiakirjan metatiedossa Asiakrjan laatimisaika (ClinicalDocument.effectiveTime) ilmoitetun laatimisajan. ",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "https://shark.kanta.fi/fhir/StructureDefinition/extension/CreationTime"
            ]
          }
        ],
        "isModifier": false
      },
      {
        "id": "DocumentReference.masterIdentifier",
        "path": "DocumentReference.masterIdentifier",
        "max": "0"
      },
      {
        "id": "DocumentReference.identifier",
        "path": "DocumentReference.identifier",
        "short": "Liiteasiakirjan yksilöintitunnus",
        "definition": "Sosiaalihuollon asiakastietovaranto palauttaa tiedossa liiteasiakirjan metatiedossa Asiakirjan yksilöintitunnus (ClinicalDocument.id) ilmoitetun yksilöintitunnuksen. ",
        "min": 1,
        "max": "1"
      },
      {
        "id": "DocumentReference.identifier.system",
        "path": "DocumentReference.identifier.system",
        "min": 1,
        "fixedUri": "urn:ietf:rfc:3986 "
      },
      {
        "id": "DocumentReference.identifier.value",
        "path": "DocumentReference.identifier.value",
        "short": "Liiteasiakirjan OID-tunnus",
        "min": 1
      },
      {
        "id": "DocumentReference.status",
        "path": "DocumentReference.status",
        "fixedCode": "current"
      },
      {
        "id": "DocumentReference.docStatus",
        "path": "DocumentReference.docStatus",
        "max": "0"
      },
      {
        "id": "DocumentReference.type",
        "path": "DocumentReference.type",
        "short": "Liiteasiakirjan tarkennettu asiakirjatyyppi",
        "definition": "Sosiaalihuollon asiakastietovaranto palauttaa tiedossa liiteasiakirjan metatiedossa Asiakirjan tarkennettu asiakirjatyyppi (ClinicalDocument.hl7fi:localSocialHeader.specificDocumentType) ilmoitetun tarkennetun asiakirjatyypin. Tarkennettu asiakirjatyyppi ilmoitetaan koodiston Sosiaalihuolto - Asiakasasiakirjatyyppi (1.2.246.537.6.1506.201701) alatason arvoilla.",
        "min": 1,
        "binding": {
          "strength": "required",
          "valueSet": "http://shark.kanta.fi/ValueSet/fishark-vs-documenttype"
        }
      },
      {
        "id": "DocumentReference.type.coding",
        "path": "DocumentReference.type.coding",
        "min": 1,
        "max": "1",
        "binding": {
          "strength": "required",
          "valueSet": "http://shark.kanta.fi/ValueSet/fishark-vs-documenttype"
        }
      },
      {
        "id": "DocumentReference.type.coding.system",
        "path": "DocumentReference.type.coding.system",
        "min": 1,
        "fixedUri": "urn:oid:1.2.246.537.6.1506.201701"
      },
      {
        "id": "DocumentReference.type.coding.code",
        "path": "DocumentReference.type.coding.code",
        "short": "Liiteasiakirjan tarkennetun asiakirjatyypin koodiarvo",
        "definition": "Valuesetin Social Welfare Document Type mukainen liiteasiakirjan tarkennetun asiakirjatyypin koodiarvo.",
        "min": 1
      },
      {
        "id": "DocumentReference.type.coding.display",
        "path": "DocumentReference.type.coding.display",
        "short": "Liiteasiakirjan tarkennetun asiakirjatyypin nimi",
        "definition": "Valuesetin Social Welfare Document Type mukainen liiteasiakirjan tarkennetun asiakirjatyypin arvo. Arvon nimi vastaa annettua koodiarvoa."
      },
      {
        "id": "DocumentReference.category",
        "path": "DocumentReference.category",
        "short": "Liiteasiakirjan yleinen asiakirjatyyppi",
        "definition": "Sosiaalihuollon asiakastietovaranto palauttaa tiedossa liiteasiakirjan metatiedossa Yleinen asiakirjatyyppi (ClinicalDocument.Code) ilmoitetun yleisen asiakirjatyypin. Yleinen asiakirjatyyppi ilmoitetaan koodiston Sosiaalihuolto - Asiakasasiakirjatyyppi (1.2.246.537.6.1506.201701) ylätason arvoilla.",
        "min": 1,
        "max": "1",
        "binding": {
          "strength": "required",
          "valueSet": "http://shark.kanta.fi/ValueSet/fishark-vs-documenttype"
        }
      },
      {
        "id": "DocumentReference.category.coding",
        "path": "DocumentReference.category.coding",
        "min": 1,
        "max": "1",
        "binding": {
          "strength": "required",
          "valueSet": "http://shark.kanta.fi/ValueSet/fishark-vs-documenttype"
        }
      },
      {
        "id": "DocumentReference.category.coding.system",
        "path": "DocumentReference.category.coding.system",
        "min": 1,
        "fixedUri": "urn:oid:1.2.246.537.6.1506.201701"
      },
      {
        "id": "DocumentReference.category.coding.code",
        "path": "DocumentReference.category.coding.code",
        "short": "Liiteasiakirjan yleisen asiakirjatyypin koodiarvo",
        "definition": "Valuesetin Social Welfare Document Type mukainen yleisen asiakirjatyypin koodiarvo.",
        "min": 1
      },
      {
        "id": "DocumentReference.category.coding.display",
        "path": "DocumentReference.category.coding.display",
        "short": "Yleisen asiakirjatyypin nimi",
        "definition": "Valuesetin Social Welfare Document Type mukainen yleisen asiakirjatyypin arvo. Arvon nimi vastaa annettua koodiarvoa."
      },
      {
        "id": "DocumentReference.subject",
        "path": "DocumentReference.subject",
        "max": "0"
      },
      {
        "id": "DocumentReference.date",
        "path": "DocumentReference.date",
        "max": "0"
      },
      {
        "id": "DocumentReference.author",
        "path": "DocumentReference.author",
        "max": "0"
      },
      {
        "id": "DocumentReference.authenticator",
        "path": "DocumentReference.authenticator",
        "max": "0"
      },
      {
        "id": "DocumentReference.custodian",
        "path": "DocumentReference.custodian",
        "max": "0"
      },
      {
        "id": "DocumentReference.relatesTo",
        "path": "DocumentReference.relatesTo",
        "max": "0"
      },
      {
        "id": "DocumentReference.description",
        "path": "DocumentReference.description",
        "short": "Liiteasiakirjan kuvaus",
        "definition": "Sosiaalihuollon asiakastietovarannon hakuvastauksessa palauttaman liiteasiakirjan kuvaus. Asiakastietovaranto palauttaa tiedossa liiteasiakirjan metatiedossa Asiakirjan kuvaus (ClinicalDocument.hl7fi:localSocialHeader.description) ilmoitetun kuvauksen."
      },
      {
        "id": "DocumentReference.securityLabel",
        "path": "DocumentReference.securityLabel",
        "max": "0"
      },
      {
        "id": "DocumentReference.content.attachment.contentType",
        "path": "DocumentReference.content.attachment.contentType",
        "short": "CDA-asiakirjan tyyppi",
        "min": 1,
        "fixedCode": "text/xml"
      },
      {
        "id": "DocumentReference.content.attachment.language",
        "path": "DocumentReference.content.attachment.language",
        "max": "0"
      },
      {
        "id": "DocumentReference.content.attachment.data",
        "path": "DocumentReference.content.attachment.data",
        "max": "0"
      },
      {
        "id": "DocumentReference.content.attachment.url",
        "path": "DocumentReference.content.attachment.url",
        "max": "0"
      },
      {
        "id": "DocumentReference.content.attachment.size",
        "path": "DocumentReference.content.attachment.size",
        "max": "0"
      },
      {
        "id": "DocumentReference.content.attachment.hash",
        "path": "DocumentReference.content.attachment.hash",
        "max": "0"
      },
      {
        "id": "DocumentReference.content.attachment.title",
        "path": "DocumentReference.content.attachment.title",
        "max": "0"
      },
      {
        "id": "DocumentReference.content.attachment.creation",
        "path": "DocumentReference.content.attachment.creation",
        "short": "Liiteasiakirjan luontiaika",
        "definition": "Sosiaalihuollon asiakastietovarannon hakuvastauksessa palauttaman liiteasiakirjan luontiaika. Asiakastietovaranto palauttaa tiedossa liiteasiakirjan metatiedossa Asiakirjan luontiaika (ClinicalDocument.effectiveTime) ilmoitetun luontiajan. ",
        "min": 1
      },
      {
        "id": "DocumentReference.content.format",
        "path": "DocumentReference.content.format",
        "max": "0"
      },
      {
        "id": "DocumentReference.context",
        "path": "DocumentReference.context",
        "min": 1
      },
      {
        "id": "DocumentReference.context.encounter",
        "path": "DocumentReference.context.encounter",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.event",
        "path": "DocumentReference.context.event",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.period",
        "path": "DocumentReference.context.period",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.facilityType",
        "path": "DocumentReference.context.facilityType",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.practiceSetting",
        "path": "DocumentReference.context.practiceSetting",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.sourcePatientInfo",
        "path": "DocumentReference.context.sourcePatientInfo",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.related",
        "path": "DocumentReference.context.related",
        "min": 1,
        "max": "1"
      },
      {
        "id": "DocumentReference.context.related.reference",
        "path": "DocumentReference.context.related.reference",
        "short": "Viittaus Observation-resurssiin",
        "definition": "Sosiaalihuollon asiakastietovaranto palauttaa tiedossa sen merkinnän toimintakyvystä/toimintakykyarvion Observation-resurssin yksilöivän tunnuksen (Observation.id), johon liiteasiakirja liittyy. ",
        "min": 1
      },
      {
        "id": "DocumentReference.context.related.type",
        "path": "DocumentReference.context.related.type",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.related.identifier",
        "path": "DocumentReference.context.related.identifier",
        "max": "0"
      },
      {
        "id": "DocumentReference.context.related.display",
        "path": "DocumentReference.context.related.display",
        "max": "0"
      }
    ]
  }
}