docnow24 Integration

docnow24 is a telemedicine platform. These endpoints support the two integration points used by partners running on docnow24: a product feed that your Custom Sync service polls to mirror stock, availability and price, and prescription injection, used after a doctor completes the digital (QES) signature on a prescription.

Authentication

Authenticate with your API key via the X-API-Key, X-RxScale-Authorization, or Authorization: Bearer <api-key> header. See Authentication for details.

Product Feed

Retrieve the catalogue of SKUs mapped to your provider account in a shop. Poll this endpoint from your Custom Sync service to mirror stock, availability and price.

GET /v2/public-api/products/{shop_identifier}/docnow24

string

required

Unique identifier for the shop

integer

default:"1"

Page number (1-indexed)

integer

default:"500"

Results per page (max 5000)

string

Filter mapped products by name

Required permission: read_sku_single_telemedicine_provider

Only SKUs mapped to your provider account and listed in the shop as ACTIVE or UNLISTED are included. Draft or archived shop products, and SKUs that are deactivated or unmapped, simply stop appearing in the feed — they are never emitted with stock: 0.

Example Request

curl -X GET "https://api.rxscale.com/v2/public-api/products/my-shop/docnow24?page=1&limit=500" \
  -H "X-API-Key: your-api-key-here"

Response

[
  {
    "flowzUrl": "partner-sku-456",
    "stock": 42,
    "price": 1299,
    "productId": "sku-456"
  },
  {
    "flowzUrl": "partner-sku-789",
    "stock": 7,
    "price": 1999,
    "productId": "sku-789"
  }
]

The response is a plain JSON array (no pagination envelope) — one row per SKU mapped to your provider account in this shop.

Response Fields

Field	Type	Description
`flowzUrl`	string	Your product identifier for this SKU. Configure your Custom Sync’s `flowzUrl` key to read this value
`stock`	integer	Physical stock, aggregated across every pharmacy linked to the shop. Reservations already held against that stock are not subtracted
`price`	integer	Price in euro cents
`productId`	string	RxScale SKU UID

price is an integer number of euro cents (for example 1299 means €12.99). Your Custom Sync’s built-in “Cent → Euro (÷100)” transform must be applied when mapping this field — do not store the raw integer as a euro amount.

Backoffice Field Mapping

Configure your Custom Sync with this mapping:

Our field	Your target field	Transformation
`flowzUrl`	`flowzUrl` (key)	None
`stock`	`stockCount`	Integer, 1:1
`price`	`priceGross`	Cent → Euro (÷100)

We do not send an active field. Derive availability on your side from stockCount > 0.

Error Responses

Status Code	Description
`400`	Invalid `page` or `limit`, or the API key is not linked to a telemedicine provider
`404`	Shop not found

Prescription Injection

Submit a signed prescription and its order details after a doctor completes the QES signature. RxScale creates the checkout and, unless prepaid is 1, sends the patient a Shopify checkout request.

POST /v2/public-api/prescriptions/{shop_identifier}/docnow24

string

required

Unique identifier for the shop

Required permission: create_prescription_checkout

Request Body

{
  "customer": {
    "firstname": "Max",
    "lastname": "Mustermann",
    "email": "max.mustermann@example.com",
    "phone": "+4917612345678",
    "homeAddress": {
      "streetName": "Hauptstraße",
      "houseNr": "42",
      "postalCode": "10115",
      "city": "Berlin"
    },
    "deliveryAddress": {
      "streetName": "Nebenstraße",
      "houseNr": "7",
      "postalCode": "10115",
      "city": "Berlin"
    }
  },
  "products": [
    {
      "id": "partner-sku-456",
      "name": "Medication X 100mg",
      "quantity": 1,
      "price": 12.99,
      "crushed": false
    }
  ],
  "pharmacy_id": "BF8dMH0ERu3giFJltCAG",
  "doctor": {
    "name": "Schmidt",
    "firstname": "Jane",
    "phone": "+4930987654321",
    "cityOfSignature": "Berlin",
    "dateOfSignature": "2026-09-01"
  },
  "prescriptionURL": "JVBERi0xLjQK...",
  "isThirdPartyPrescription": false,
  "internalOrderId": "ORD123456",
  "deliveryType": "shipping",
  "prepaid": 1
}

Field	Type	Required	Description
`customer`	object	Yes	Patient / recipient details
`customer.firstname`	string	Yes	Customer first name
`customer.lastname`	string	Yes	Customer last name
`customer.email`	string	No	Customer email address
`customer.phone`	string	No	Customer phone number. Send it in E.164 (`+4917612345678`). A national number (`0176 12345678`), `+49 (0)176 …` and `0049 …` are converted to E.164 as a German number. A number that cannot be converted — no leading `+`, `00` or `0` — is not set as the contact phone number of the order; the request still succeeds and reports it under `warnings`. The same applies to a number that has the right format but that Shopify rejects as invalid
`customer.homeAddress`	object	No	Patient’s home address, used as the order’s billing address
`customer.homeAddress.streetName`	string	No	Street name
`customer.homeAddress.houseNr`	string	No	House number
`customer.homeAddress.postalCode`	string	No	Postal code
`customer.homeAddress.city`	string	No	City
`customer.deliveryAddress`	object	No	Delivery address, used as the order’s shipping address. Falls back to `homeAddress` when omitted. Same shape as `homeAddress`
`products`	array	Yes	Order line items
`products[].id`	string	Yes	Your product identifier — must be the same value RxScale returns as `flowzUrl` in the product feed
`products[].name`	string	No	Product name. Informational only — the RxScale order line is priced and named from the catalog SKU resolved via `id`, not from this field
`products[].quantity`	integer	Yes	Quantity ordered. Must be at least `1`
`products[].price`	number	No	Informational only — not used to price the order
`products[].crushed`	boolean	No	Whether the medication should be dispensed crushed
`pharmacy_id`	string	No	Your pharmacy identifier for this order. Stored for reference; not matched against an RxScale pharmacy record
`doctor`	object	No	Signing doctor’s details
`doctor.name`	string	No	Doctor’s last name
`doctor.firstname`	string	No	Doctor’s first name
`doctor.phone`	string	No	Doctor’s phone number
`doctor.email`	string	No	Doctor’s email address
`doctor.cityOfSignature`	string	No	City where the prescription was signed
`doctor.dateOfSignature`	string	No	Date the prescription was signed
`prescriptionURL`	string	Yes	Despite the field name, this is not a URL. Base64-encoded content of the signed prescription PDF
`isThirdPartyPrescription`	boolean	No	Whether the prescription was issued by a third party
`internalOrderId`	string	Yes	Your order identifier. Used to detect duplicate submissions — see the note below
`deliveryType`	string	No	Delivery type for this order (for example `shipping` or `pickup`). Recorded for reference only
`prepaid`	integer	No	`0` (default) or `1`. When `1`, RxScale creates the order without sending the patient a Shopify checkout request — use this when the patient has already paid on your platform. For providers RxScale has configured accordingly, the order is also booked as paid; see Prepaid Orders

The prescription PDF must be digitally signed (QES). Unsigned PDFs are rejected with 422 unless your provider account has been explicitly configured to allow them.

products[].id is resolved against SKUs mapped to your provider account — the same mapping the product feed publishes as flowzUrl. An id that does not resolve is rejected; see Error Responses below.

Example Request

curl -X POST "https://api.rxscale.com/v2/public-api/prescriptions/my-shop/docnow24" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "firstname": "Max",
      "lastname": "Mustermann",
      "email": "max.mustermann@example.com",
      "phone": "+4917612345678",
      "homeAddress": {
        "streetName": "Hauptstraße",
        "houseNr": "42",
        "postalCode": "10115",
        "city": "Berlin"
      }
    },
    "products": [
      {
        "id": "partner-sku-456",
        "name": "Medication X 100mg",
        "quantity": 1,
        "crushed": false
      }
    ],
    "pharmacy_id": "BF8dMH0ERu3giFJltCAG",
    "doctor": {
      "name": "Schmidt",
      "firstname": "Jane",
      "phone": "+4930987654321",
      "cityOfSignature": "Berlin",
      "dateOfSignature": "2026-09-01"
    },
    "prescriptionURL": "JVBERi0xLjQK...",
    "isThirdPartyPrescription": false,
    "internalOrderId": "ORD123456",
    "deliveryType": "shipping",
    "prepaid": 1
  }'

Response

{
  "status": "success",
  "prescriptions": [
    {
      "id": "ORD123456",
      "prescription_uid": "px-abc123"
    }
  ]
}

prescriptions[].id echoes your internalOrderId. Use prescription_uid to query order status via the Orders endpoint.

Warnings

A successful response can carry an optional warnings list. It is only present when there is something to report, so check for the key rather than for an empty list.

{
  "status": "success",
  "prescriptions": [
    {
      "id": "ORD123456",
      "prescription_uid": "px-abc123"
    }
  ],
  "warnings": [
    {
      "code": "phone_not_forwarded",
      "field": "customer.phone",
      "message": "The phone number is not a valid E.164 number (e.g. +4917612345678) and was not set as the contact phone number of the order."
    }
  ]
}

Field	Type	Description
`warnings[].code`	string	Machine-readable code. Currently only `phone_not_forwarded`
`warnings[].field`	string	The request field the warning is about
`warnings[].message`	string	Human-readable explanation

phone_not_forwarded means the prescription was accepted, but customer.phone was not set as the contact phone number of the order: either it could not be converted to E.164, or Shopify rejected it as invalid. Correct the number on your side; the request does not need to be repeated.

Error Responses

Status Code	Description
`400`	Request body validation failed
`400`	The API key is not linked to a telemedicine provider
`400`	Your provider account has no usable identifier. This is a configuration problem on our side — contact support
`400`	The signature-validation service was unavailable, so the prescription signature could not be validated. No prescription or order is created — safe to retry
`404`	Shop not found
`404`	A `products[].id` does not resolve to a SKU mapped to your provider account
`409`	This `internalOrderId` was already successfully submitted. No new prescription, PDF, or order is created
`422`	The prescription PDF is not digitally signed (QES) and unsigned prescriptions are not allowed for your provider account

{
  "code": "not_found",
  "error": "Product with external ID 'partner-sku-456' not found"
}

{
  "error": "Duplicate prescription injection: prescription id(s) ['ORD123456'] already submitted by provider docnow24 (existing prescription(s) ['px-abc123']); no order created."
}

internalOrderId is only blocked once a submission with that id has been successfully accepted. If an earlier request failed (for example, it returned a 4xx/5xx before completing), resubmitting the same internalOrderId is not blocked and is processed normally — safe to retry after a failed or uncertain request.

Getting Started

External Pharmacy API

Management API

Scheduling API

Public API

Patient API

Anamnesis API

Webhooks

Guides

docnow24 Integration

docnow24 Integration

Authentication

Product Feed

Example Request

Response

Response Fields

Backoffice Field Mapping

Error Responses

Prescription Injection

Request Body

Example Request

Response

Warnings

Error Responses

See Also

​docnow24 Integration

​Authentication

​Product Feed

​Example Request

​Response

​Response Fields

​Backoffice Field Mapping

​Error Responses

​Prescription Injection

​Request Body

​Example Request

​Response

​Warnings

​Error Responses

​See Also

docnow24 Integration

Authentication

Product Feed

Example Request

Response

Response Fields

Backoffice Field Mapping

Error Responses

Prescription Injection

Request Body

Example Request

Response

Warnings

Error Responses

See Also