Magentus Practice Management FHIR Implementation Guide
1.2.60 - ci-build

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

Use | Name | Scope | Cardinality | Type | Binding | Documentation
IN | subscription |  | 1..1 | Subscription |  | The Subscription resource to be submitted to each brand partition.
IN | organization |  | 1..* | 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.
OUT | result |  | 1..* |  |  | A result entry per organization indicating the outcome of the subscription submission.
OUT | result.organization |  | 1..1 | Reference |  | The Organization reference that was processed.
OUT | result.outcome |  | 1..1 | Coding | Add Placer Subscription Result ValueSet (Required) | The outcome of submitting the Subscription to this organization's partition.
OUT | result.subscription |  | 0..1 | Reference |  | 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"
              }
            }
          ]
        }
      ]
    }