PCA™ - Create practitioner role

Quick intro

Now that you have created an Organization and HealthcareService at a Location, and have found a Practitioner, you can create a PractitionerRole.

RESTful create interaction

This operation is a RESTful create interaction (type level Interaction) as described in https://www.hl7.org/fhir/http.html#create of a PractitionerRole FHIR resource as profiled for Australian and described at https://pca.digitalhealth.gov.au/fhir/4.0/currentdraft/StructureDefinition-pca-practitioner-role.html.

POST /PcaFhirApi/v2/publisher/org-6ac00cb80e4b4dbbabb489ee8a9c942b/fhir/PractitionerRole HTTP/1.1
Content-Type: application/fhir+json; charset=utf-8
Accept: application/fhir+json; charset=utf-8
Authorization: Bearer 19.1649245493.3792386a289047c5bd8ae502cee717d6
User-Agent: PostmanRuntime/7.29.0
Cache-Control: no-cache
Postman-Token: a7bc424a-2e13-4573-8cbb-57cdd9420ac7
Host: pca-vendor-test.digitalhealth.gov.au
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 2792
Cookie: __cf_bm=QfEfdaD2AvKeu7sN694K_vZvmlrf94kuyH3ruc49wSA-1649244626-0-AXTa1cGvRPdUepk3jZmkocVi9DDaZrnlwDIyFhCY11fw9GJSvENQq3059wpFzsf4sgJqYf2AxAfH9gMUZI/f8bo=
  
{
"resourceType": "PractitionerRole",
"extension": [
{
"url": "http://pca.digitalhealth.gov.au/fhir/4.0/StructureDefinition/pca-preferred-name",
"valueHumanName": {
"text": "Dr Smith"
}
}
],
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org.au/CodeSystem/v2-0203",
"code": "UPIN"
}
]
},
"system": "http://ns.electronichealth.net.au/id/medicare-provider-number",
"value": "4003434J"
},
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org.au/CodeSystem/v2-0203",
"code": "AHPRA"
}
]
},
"system": "http://hl7.org.au/id/ahpra-registration-number",
"value": "MED0000978637"
}
],
"active": true,
"period": {
"start": "2021-01-21"
},
"practitioner": {
"reference": "Practitioner/pra-c4b1451d91074567b54f0a9e997acec2"
},
"organization": {
"reference": "Organization/org-6ac00cb80e4b4dbbabb489ee8a9c942b"
},
"code": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-preferred",
"valueBoolean": true
}
],
"coding": [
{
"system": "http://snomed.info/sct",
"code": "158965000",
"display": "Medical practitioner"
}
]
},
{
"coding": [
{
"system": "http://pca.digitalhealth.gov.au/fhir/4.0/CodeSystem/pca-hi-service-role",
"code": "ProvidesHealthcareToIndividuals",
"display": "Provider of healthcare services to individuals"
}
]
}
],
"specialty": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394814009",
"display": "General practice (specialty)"
}
]
}
],
"location": [
{
"reference": "Location/loc-11b0946845354d79a265a6f5a70b7964"
}
],
"healthcareService": [
{
"reference": "HealthcareService/hcs-62b1d633f81745ba9c41e6adbfda5065"
}
]
}
  
HTTP/1.1 200 OK
Date: Wed, 06 Apr 2022 11:40:02 GMT
Content-Type: application/fhir+json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Last-Modified: Wed, 06 Apr 2022 11:40:02 GMT
ETag: W/"1"
Location: PractitionerRole/prr-4d0a80c543894b53a50ec043dd57bab4/_history/1
X-XSS-Protection: 1; mode=block
X-Frame-Options: DENY
X-Content-Type-Options: nosniff
CF-Cache-Status: DYNAMIC
Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
Strict-Transport-Security: max-age=15552000; includeSubDomains; preload
Server: cloudflare
CF-RAY: 6f7a3f005a14fe89-MEL
  
{"resourceType":"PractitionerRole","id":"prr-4d0a80c543894b53a50ec043dd57bab4","meta":{"versionId":"1","lastUpdated":"2022-04-06T21:40:02.6370641+10:00"},"extension":[{"url":"http://pca.digitalhealth.gov.au/fhir/4.0/StructureDefinition/pca-preferred-name","valueHumanName":{"text":"Dr Smith"}}],"identifier":[{"system":"http://pca.digitalhealth.gov.au/id/pca-practitioner-role","value":"prr-4d0a80c543894b53a50ec043dd57bab4"},{"type":{"coding":[{"system":"http://terminology.hl7.org.au/CodeSystem/v2-0203","code":"UPIN"}]},"system":"http://ns.electronichealth.net.au/id/medicare-provider-number","value":"4003434J"},{"type":{"coding":[{"system":"http://terminology.hl7.org.au/CodeSystem/v2-0203","code":"AHPRA"}]},"system":"http://hl7.org.au/id/ahpra-registration-number","value":"MED0000978637"}],"active":true,"period":{"start":"2021-01-21"},"practitioner":{"reference":"Practitioner/pra-c4b1451d91074567b54f0a9e997acec2"},"organization":{"reference":"Organization/org-6ac00cb80e4b4dbbabb489ee8a9c942b"},"code":[{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/iso21090-preferred","valueBoolean":true}],"coding":[{"system":"http://snomed.info/sct","code":"158965000","display":"Medical practitioner"}]}],"specialty":[{"coding":[{"system":"http://snomed.info/sct","code":"394814009","display":"General practice (specialty)"}]}],"location":[{"reference":"Location/loc-11b0946845354d79a265a6f5a70b7964"}],"healthcareService":[{"reference":"HealthcareService/hcs-62b1d633f81745ba9c41e6adbfda5065"}]}

Upon successful creation of the PractitionerRole the newly assigned logical id for the PractitionerRole should be saved by the publishing system as they can be used as reference for future operations (e.g. updates)

 Home | Back: Find a practitioner | Next: Get status of matched records