Over-the-Counter Items and Packaging Materials

How to request Over-the-Counter or Packaging Materials when placing an order for a Prescription

There are often use cases for when a partner may need to request additional items from Honeybee Health that do not require a prescription. To support these use cases, the Partners Orders API permits SKUs for specific over-the-counter items or packaging materials. Honeybee Health and the partner will come up with pre-agreed upon SKUs that can be used in the Create New Order API request.

An example request body where a prescription medication and an over-the-counter item are included may look like the following:

{
  "shipping": {
    "method_id": 1,
  },
  "patient": {
    "patient_id": "abc123",
    "patient_safety": {
      "medications": [],
      "health_conditions": [],
      "allergies": []
    }
  },
  "items": [
    {
      "prescription_id": 123456
    },
    {
      "sku": "my-product-identifier",
      "quantity": 1,
      "package_size": 3
    }
  ]
}

This is a commonly used request payload that does not include:

Patient information other than the patient ID
A shipping address

In this scenario, an order will be created for the patient associated with the patient ID sent in RX_RECEIVED webhook event. We will use the shipping address provided on the prescription.

To place an order with only the over-the-counter item, simply omit the item with the prescription ID:

{
  "shipping": {
    "method_id": 1,
  },
  "patient": {
    "patient_id": "abc123",
    "patient_safety": {
      "medications": [],
      "health_conditions": [],
      "allergies": []
    }
  },
  "items": [
    {
      "sku": "my-product-identifier",
      "quantity": 1,
      "package_size": 3
    }
  ]
}