# Add Placer Subscription Operation - Magentus Practice Management FHIR Implementation Guide v1.2.60

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Add Placer Subscription Operation**

## 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. 

### Notes:

### Result Codes

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

| | | |
| :--- | :--- | :--- |
| 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"
          }
        }
      ]
    }
  ]
}

```



## Resource Content

```json
{
  "resourceType" : "OperationDefinition",
  "id" : "EOrderAddPlacerSubscriptionOperation",
  "url" : "http://fhir.geniesolutions.io/OperationDefinition/EOrderAddPlacerSubscriptionOperation",
  "version" : "1.2.60",
  "name" : "EOrderAddPlacerSubscriptionOperation",
  "title" : "Add Placer Subscription Operation",
  "status" : "active",
  "kind" : "operation",
  "date" : "2026-04-03",
  "publisher" : "Magentus Practice Management",
  "contact" : [{
    "name" : "Magentus Practice Management",
    "telecom" : [{
      "system" : "url",
      "value" : "https://www.magentus.com/practice-management"
    },
    {
      "system" : "email",
      "value" : "andy.bond@magentus.com"
    }]
  },
  {
    "name" : "Magentus Practice Management",
    "telecom" : [{
      "system" : "url",
      "value" : "https://www.magentus.com/practice-management",
      "use" : "work"
    }]
  }],
  "description" : "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.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "AU"
    }]
  }],
  "code" : "add_placer_subscription",
  "resource" : ["Subscription"],
  "system" : false,
  "type" : true,
  "instance" : false,
  "parameter" : [{
    "name" : "subscription",
    "use" : "in",
    "min" : 1,
    "max" : "1",
    "documentation" : "The Subscription resource to be submitted to each brand partition.",
    "type" : "Subscription"
  },
  {
    "name" : "organization",
    "use" : "in",
    "min" : 1,
    "max" : "*",
    "documentation" : "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.",
    "type" : "Reference",
    "targetProfile" : ["http://fhir.geniesolutions.io/StructureDefinition/eorders-organization-pathology-laboratory",
    "http://fhir.geniesolutions.io/StructureDefinition/eorders-organization-imaging-service"]
  },
  {
    "name" : "result",
    "use" : "out",
    "min" : 1,
    "max" : "*",
    "documentation" : "A result entry per organization indicating the outcome of the subscription submission.",
    "part" : [{
      "name" : "organization",
      "use" : "out",
      "min" : 1,
      "max" : "1",
      "documentation" : "The Organization reference that was processed.",
      "type" : "Reference"
    },
    {
      "name" : "outcome",
      "use" : "out",
      "min" : 1,
      "max" : "1",
      "documentation" : "The outcome of submitting the Subscription to this organization's partition.",
      "type" : "Coding",
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://fhir.geniesolutions.io/ValueSet/eorder-add-placer-subscription-result-valueset"
      }
    },
    {
      "name" : "subscription",
      "use" : "out",
      "min" : 0,
      "max" : "1",
      "documentation" : "The Subscription resource as created in the partition, if successful. Contains the server-assigned id.",
      "type" : "Reference"
    }]
  }]
}

```
