Rezepte

Rezeptdetails über die Management API anzeigen

​

Rezepte

Rufen Sie Rezeptinformationen ab, einschließlich Arztdaten und Status.

​

Rezeptdetails abrufen

GET /v1/management/prescriptions/{prescription_uid}

prescription_uid · string · erforderlich

Die Rezept-UID

Erforderliche Berechtigung: prescription:read

​

Beispielanfrage

curl -X GET "https://api.rxscale.com/v1/management/prescriptions/px-abc123" \
  -H "X-API-Key: your-api-key-here"

​

Antwort

{
  "uid": "px-abc123",
  "status": "signed",
  "doctor": {
    "uid": "doc-456",
    "display_name": "Dr. Schmidt"
  },
  "rendered": true
}

​

Antwortfelder

Feld	Typ	Beschreibung
uid	string	Eindeutiger Bezeichner für das Rezept
status	string	Aktueller Rezeptstatus (z.B. signed, waiting_for_doctor)
doctor	object	Der verschreibende Arzt
doctor.uid	string	Arzt-UID
doctor.display_name	string	Anzeigename des Arztes
rendered	boolean	true, wenn ein gerendertes PDF für das Rezept verfügbar ist, andernfalls false

​

Fehlerantworten

Statuscode	Beschreibung
403	Fehlende Berechtigung prescription:read
404	Rezept nicht gefunden oder gehört zu einer anderen Organisation

​

Extern signierte Rezepte

Rezepte, deren Items mit _skip_validation (oder _rxscale_skip_validation) auf Shopify-Line-Item-Ebene, auf der Line-Item-Gruppe dieser Position (bei Bundles) oder in den zusätzlichen Details auf Bestellebene angelegt wurden – also Items ohne angehängte Anamnese – können außerhalb der rxscale-Plattform signiert und anschließend über die Management API zur Belieferung registriert werden. Sind mehrere Ebenen gesetzt, löst RxScale die Einstellung mit einer dreistufigen Rückfalllogik auf: Zuerst zählt der Wert der Bestellposition selbst, dann der Wert ihrer Line-Item-Gruppe, dann der Wert auf Bestellebene.

Der Ablauf besteht aus zwei API-Aufrufen:

1. POST /v1/management/prescriptions/{prescription_uid}/render – fordert rxscale auf, das unsignierte Rezept-PDF zu rendern. Der Endpoint kehrt sofort zurück; das PDF wird asynchron erzeugt und steht anschließend als prescription.file zur Verfügung.
2. POST /v1/management/prescriptions/{prescription_uid}/external-sign – sobald das PDF verfügbar ist, wird das Rezept als EXTERNALLY_SIGNED markiert, das PDF in den Signed-Bucket kopiert und an die Apotheke übermittelt.

Beide Endpoints erfordern die Berechtigung prescription:external_sign.

Nur Rezepte, bei denen alle Items keine anamnesis_uid besitzen, können extern signiert werden. Gemischte Rezepte werden mit 409 Conflict abgelehnt.

​

Rezept-PDF rendern

POST /v1/management/prescriptions/{prescription_uid}/render

prescription_uid · string · erforderlich

Die Rezept-UID

Erforderliche Berechtigung: prescription:external_sign

Stößt das asynchrone Rendern des unsignierten Rezept-PDFs an. Der Endpoint veröffentlicht ein prescription.render-Event und antwortet mit 202 Accepted. Pollen Sie GET /v1/management/prescriptions/{prescription_uid} (oder warten Sie auf einen Webhook), bis file befüllt ist, bevor Sie External-Sign aufrufen.

​

Beispielanfrage

curl -X POST "https://api.rxscale.com/v1/management/prescriptions/px-abc123/render" \
  -H "X-API-Key: your-api-key-here"

​

Antwort (202 Accepted)

{
  "uid": "px-abc123",
  "message": "Prescription rendering triggered"
}

​

Fehlerantworten

Statuscode	Beschreibung
403	Fehlende Berechtigung prescription:external_sign
404	Rezept nicht gefunden oder gehört zu einer anderen Organisation

​

Rezept extern signieren

POST /v1/management/prescriptions/{prescription_uid}/external-sign

prescription_uid · string · erforderlich

Die Rezept-UID

Erforderliche Berechtigung: prescription:external_sign

Markiert ein bereits gerendertes Rezept als EXTERNALLY_SIGNED. Der Endpoint:

1. Prüft, dass das Rezept den Status WAITING_FOR_DOCTOR hat, alle Items keine Anamnese besitzen und das gerenderte file vorhanden ist.
2. Kopiert das PDF vom Unsigned-Bucket in den Signed-Prescription-Bucket.
3. Setzt den Rezeptstatus auf EXTERNALLY_SIGNED und schreibt einen PrescriptionLog-Eintrag, der dem aufrufenden API-Key zugeordnet ist.
4. Veröffentlicht ein pharmacy_manager.send_prescription-Event, damit das Rezept an die Apotheke übermittelt wird.

​

Beispielanfrage

curl -X POST "https://api.rxscale.com/v1/management/prescriptions/px-abc123/external-sign" \
  -H "X-API-Key: your-api-key-here"

​

Antwort (200 OK)

{
  "uid": "px-abc123",
  "status": "EXTERNALLY_SIGNED"
}

​

Fehlerantworten

Statuscode	Beschreibung
403	Fehlende Berechtigung prescription:external_sign
404	Rezept nicht gefunden oder gehört zu einer anderen Organisation
409	Rezept ist nicht im Status WAITING_FOR_DOCTOR, mindestens ein Item hat eine Anamnese, oder das gerenderte PDF ist noch nicht vorhanden