Create an unpaid prescription order directly

post

https://api-pharmacy.cannaflow.de/api/v1/prescriptions/unpaid-order

Creates a prescription and order immediately with your supplied unit prices, VAT and shipping fee, bypassing patient checkout. The pharmacy collects payment later; this endpoint never records a completed payment. Currently supports payment at pickup with pickup shipping only. Requires directUnpaidOrderCreationEnabled on your account, an active pharmacy affiliation, and active pickup shipping and payment methods. Pharmacies whose ERP collects patient payments are not supported. This capability does not affect ordinary prescription submission or payment methods available during patient checkout. Signed documents may be submitted now or later. The total to collect must be positive. Each referenceId must be unique for your account; submitting an existing referenceId is rejected, including identical retries. Non-prescription products, discounts and external shipping are not supported.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

referenceId

string

required

length ≥ 1

An ID used to identify the prescription. This id should be unique in your system (e.g. internal ID of your treatment/prescription).

referencePatientId

Optional patient identifier from your system

referencePharmacyId

Optional pharmacy identifier from your system

signedDocument

string

DEPRECATED: Use signedDocuments instead. Single base64 encoded signed prescription document without MIME-type prefix. If not provided, the signed document must be submitted later via POST /prescriptions/{id}/document before the pharmacy can process the order.

signedDocuments

array of strings

length ≤ 5

Array of base64 encoded signed prescription documents without MIME-type prefix. Can be 0-n documents. If not provided, the signed document must be submitted later via POST /prescriptions/{id}/document before the pharmacy can process the order.

signedDocuments

designatedPharmacyId

string

required

length ≥ 1

Cannaflow pharmacy ID. If provided, the patient can only choose this pharmacy for their order. If the pharmacy is out of stock, the prescription cannot be created and an error is thrown.

patient

object

required

Patient information

doctor

object

required

Prescribing doctor's information. Can be also provided by submitting the prescription.

prescriptionDate

string

Prescription date in YYYY-MM-DD format. Current date will be used if not provided

notifications

object

Notification settings. Support for SMS notifications is coming soon.

metadata

string

Optional dynamic data attached to the prescription. Structure varies based on source.

products

array of objects

required

Prescribed products with TP-supplied unit gross prices. cannaflow trusts these prices as-is.

products*

shipping

object

required

paymentMethod

const

enum

required

Payment is collected at the pharmacy using its configured pickup payment method.

Allowed:

Responses

200Successful response

400InvalidArguments (payload.issues lists each failed rule), InvalidRegistryItems, UnsupportedShippingOption, or UniqueConstraintViolation (referenceId already used; legacy error statuses).

404NotFound: unknown pharmacy, product or product mapping.

409InsufficientStock. UniqueConstraintViolation when declared error statuses are enabled.

422DirectUnpaidOrderCreationNotEnabled, UnsupportedPharmacy (no active affiliation, or the pharmacy collects payments through its ERP), ProductsNotAvailable or UnsupportedPaymentProvider.

429A rate limit bucket is empty. Retry after Retry-After seconds.

`Retry-After` seconds.