Magentus Practice Management FHIR Implementation Guide
1.2.60 - ci-build Australia flag

Magentus Practice Management FHIR Implementation Guide - Local Development build (v1.2.60) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: Add Placer Subscription Operation

Official URL: http://fhir.geniesolutions.io/OperationDefinition/EOrderAddPlacerSubscriptionOperation Version: 1.2.60
Active as of 2026-04-03 Computable Name: EOrderAddPlacerSubscriptionOperation

This operation submits a Subscription resource to the SmileCDR partitions mapped from the provided brand Organization references. Each Organization (EOrdersOrganizationPathologyLaboratory or EOrdersOrganizationImagingService) maps to a SmileCDR partition. The Subscription is created in each resolved partition, enabling a placer to register for notifications across multiple diagnostic service brands in a single call.

URL: [base]/Subscription/$add_placer_subscription

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INsubscription1..1Subscription

The Subscription resource to be submitted to each brand partition.

INorganization1..*Reference (eOrders Organisation Pathology Laboratory, eOrders Organisation Imaging Service)

References to brand Organization resources (EOrdersOrganizationPathologyLaboratory or EOrdersOrganizationImagingService). May be literal references (e.g. Organization/123) or logical references using an identifier. Each organization is resolved to a SmileCDR partition where the Subscription will be submitted.

OUTresult1..*

A result entry per organization indicating the outcome of the subscription submission.

OUTresult.organization1..1Reference

The Organization reference that was processed.

OUTresult.outcome1..1CodingAdd Placer Subscription Result ValueSet (Required)

The outcome of submitting the Subscription to this organization's partition.

OUTresult.subscription0..1Reference

The Subscription resource as created in the partition, if successful. Contains the server-assigned id.

Notes:

Result Codes

Each element of the result output part contains an outcome Coding bound to the following codes:

Code Display Description
ok OK Subscription was successfully created in the partition.
organization-not-found Organization Not Found The referenced Organization could not be resolved.
partition-not-found Partition Not Found No SmileCDR partition is mapped to the resolved Organization.
subscription-invalid Subscription Invalid The Subscription resource failed validation.
subscription-exists Subscription Exists An equivalent Subscription already exists in the partition.
error Error An unexpected error occurred while submitting the Subscription.

Example Response

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "part": [
        {
          "name": "organization",
          "valueReference": {
            "reference": "Organization/dda4a656-f60e-11ed-baf1-d2cbed391bcf"
          }
        },
        {
          "name": "outcome",
          "valueCoding": {
            "system": "http://fhir.geniesolutions.io/CodeSystem/eorder-add-placer-subscription-result-codesystem",
            "code": "ok",
            "display": "OK"
          }
        },
        {
          "name": "subscription",
          "valueReference": {
            "reference": "Subscription/sub-12345"
          }
        }
      ]
    }
  ]
}