> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# weed.de-Integration

> Bestellungen vom Marktplatz weed.de als Shopify-Bestellentwürfe in Ihrem Shop empfangen

# weed.de-Integration

weed.de ist ein Cannabis-Marktplatz. Verkauft Ihre Apotheke über weed.de, schickt weed.de jede neue Bestellung an eine Webhook-URL, die Sie bei weed.de hinterlegen. Hinterlegen Sie dort eine RxScale-URL, dann kommt jede weed.de-Bestellung genauso in Ihrem Shop an wie die Bestellung eines anderen Telemedizin-Anbieters:

1. weed.de schickt einen `order.created`-Webhook an RxScale.
2. RxScale prüft das Rezept-PDF: Es muss eine qualifizierte elektronische Signatur (QES) tragen, wie bei allen anderen Telemedizin-Anbietern auch.
3. RxScale legt in Ihrem Shop einen Shopify-Bestellentwurf (Draft Order) mit den Produkten, Preisen, Adressen und der Versandart der weed.de-Bestellung an.
4. Eine auf weed.de bereits bezahlte Bestellung wird als bezahlt verbucht. Für eine noch nicht bezahlte Bestellung schickt Shopify der Patientin oder dem Patienten eine Rechnung.
5. Shopify legt die Bestellung an, und sie kommt wie jede andere Shopify-Bestellung in RxScale an.

Den auf dieser Seite beschriebenen Endpoint ruft weed.de auf, nicht Sie selbst. Sie richten die Integration einmalig im RxScale-Admin-Tool und bei weed.de ein.

## Voraussetzungen

* Ihre Organisation betreibt in RxScale einen Shopify-Shop, und die Produkte, die Sie über weed.de verkaufen möchten, sind in diesem Shop vorhanden.
* Der Shop verkauft in EUR. weed.de sendet alle Beträge in EUR, und RxScale setzt die Preise von weed.de im Bestellentwurf in EUR.
* Ihre Apotheke hat Zugang zur Pharmacy API von weed.de (im API-Management von weed.de). Dort registrieren Sie Webhooks und pflegen Ihre Produktdaten.

## Integration einrichten

**1. Telemedizin-Anbieter für weed.de anlegen**

Öffnen Sie im Admin-Tool **Einstellungen → Telemedizin-Anbieter** und wählen Sie **Anbieter hinzufügen**. Geben Sie einen Anzeigenamen (zum Beispiel `weed.de`) und eine Kennung (zum Beispiel `weed`) ein. Verknüpfen Sie einen API-Schlüssel mit der Berechtigung `create_prescription_checkout`, oder legen Sie einen neuen Schlüssel mit dieser Berechtigung an.

weed.de sendet diesen API-Schlüssel nie, und Sie geben ihn auch nicht an weed.de weiter. RxScale legt anhand des Schlüssels fest, was die Integration tun darf.

**2. Vorausbezahlte Bestellungen als bezahlt verbuchen**

Öffnen Sie den neuen Anbieter. Wählen Sie unter **Vorausbezahlte Bestellungen** die Option **Handhabung ändern**, geben Sie zur Bestätigung die Kennung des Anbieters ein und wählen Sie **Als bezahlt verbuchen**.

In der Regel bezahlt die Patientin oder der Patient direkt auf weed.de. Mit dieser Einstellung wird eine vorausbezahlte weed.de-Bestellung in Shopify als bezahlt verbucht, und es geht keine Zahlungsaufforderung an die Patientin oder den Patienten. Siehe [Vorausbezahlte und offene Bestellungen](#prepaid).

**3. Versandarten von weed.de zuordnen**

Öffnen Sie **Einstellungen → Versandmethoden-Zuordnungen** und wählen Sie **Zuordnung erstellen**. Wählen Sie Ihren Shop und den weed.de-Anbieter. Tragen Sie als **Externer Liefertyp** den Versanddienstleister genau so ein, wie weed.de ihn bezeichnet (zum Beispiel `DHL Standard`), und als **Shopify-Versandmethodentitel** die passende Versandmethode Ihres Shops. Legen Sie für jeden Versanddienstleister, den Sie auf weed.de anbieten, eine Zuordnung an, und eine weitere für `pickup` (Abholung). Siehe [Versandmethode](#delivery).

**4. weed.de-Produkte mit Ihren Shopify-Varianten verknüpfen**

Setzen Sie in Ihren Produktdaten bei weed.de die `externalId` jedes Produkts auf die ID der zugehörigen Shopify-Produktvariante in Ihrem Shop. Das ist die Zahl am Ende der Adresse der Variante im Shopify-Adminbereich, zum Beispiel `44012345678901`. Die GID der Variante, `gid://shopify/ProductVariant/44012345678901`, wird ebenfalls angenommen, jede andere GID — etwa die eines Produkts — dagegen nicht.

weed.de verkauft grammweise, deshalb muss jede dieser Varianten für **1 g** stehen. Siehe [Preise und Mengen](#prices).

**5. Webhook-URL bei weed.de registrieren**

Registrieren Sie diese URL bei weed.de, und zwar nur für das Ereignis `order.created`:

```
https://api.rxscale.com/v2/public-api/prescriptions/{shop_identifier}/weed/{telemedicine_provider_uid}
```

Ersetzen Sie `{shop_identifier}` durch die Kennung Ihres Shops und `{telemedicine_provider_uid}` durch die UID des Anbieters aus Schritt 1. Die UID ist der letzte Teil der Adresse der Anbieterseite im Admin-Tool. Die [Management API](https://docs.rxscale.com/de/api-reference/management/telemedicine-providers.md) liefert sie außerdem als `uid`.

weed.de prüft, ob die URL antwortet, bevor es sie annimmt. RxScale beantwortet diese Prüfung erfolgreich (siehe [URL-Prüfung](#url-check)), und weed.de zeigt Ihnen anschließend ein Webhook-Secret an.

**6. Webhook-Secret hinterlegen**

Öffnen Sie im Admin-Tool wieder den weed.de-Anbieter. Tragen Sie unter **Zugangsdaten** das von weed.de angezeigte Secret als **Webhook-Secret** ein und speichern Sie es. Das Webhook-Secret wird danach als **Hinterlegt** angezeigt.

Erledigen Sie das sofort: Solange das Secret fehlt, verarbeitet RxScale keine weed.de-Bestellungen. Siehe [Solange kein Secret hinterlegt ist](#not-configured).

**7. Testbestellung senden**

Senden Sie bei weed.de eine Testbestellung und prüfen Sie, ob sie in Ihrem Shop ankommt. Eine Testbestellung wird wie eine echte Bestellung verarbeitet: Sie legt einen Bestellentwurf in Ihrem Shop an, und eine vorausbezahlte Testbestellung wird als bezahlt verbucht. Stornieren Sie sie in Shopify, sobald Sie sie geprüft haben.

## Endpoint

```bash theme={null}
POST /v2/public-api/prescriptions/{shop_identifier}/weed/{telemedicine_provider_uid}
```

**shop\_identifier** `string` *required*

Eindeutiger Bezeichner für den Shop

**telemedicine\_provider\_uid** `string` *required*

UID Ihres weed.de-Telemedizin-Anbieters. Der Anbieter muss zu der Organisation gehören, der der Shop gehört

**X-Signature** `string` *required*

Das Webhook-Secret, das weed.de bei der Registrierung der URL ausgegeben hat. weed.de sendet es bei jeder Zustellung mit

**Erforderliche Berechtigung** (am API-Schlüssel des Anbieters): `create_prescription_checkout`

### Authentifizierung

weed.de kann keinen RxScale-API-Schlüssel senden. Stattdessen schreibt weed.de das Webhook-Secret selbst in den Header `X-Signature` jeder Zustellung. Anders als der Name vermuten lässt, enthält der Header keine über den Anfragekörper berechnete Signatur. RxScale vergleicht den Wert mit dem Webhook-Secret, das für den Anbieter hinterlegt ist. Leerzeichen vor oder nach dem Wert werden ignoriert. Eine Zustellung ohne diesen Header oder mit einem anderen Wert wird mit `401` abgelehnt. Ein RxScale-API-Schlüssel im Header `X-API-Key` ersetzt `X-Signature` nicht.

Gibt Ihnen weed.de ein neues Secret, ersetzen Sie das hinterlegte unter **Zugangsdaten** — siehe [Webhook-Secret wechseln](#rotate-secret). Bis dahin werden Zustellungen mit `401` abgelehnt.

### Solange kein Secret hinterlegt ist

weed.de zeigt das Secret erst an, nachdem die URL die Prüfung bestanden hat. Solange für den Anbieter kein Webhook-Secret hinterlegt ist, beantwortet RxScale deshalb jede Anfrage an diese URL mit `200` und tut sonst nichts:

```json theme={null}
{
  "status": "not_configured"
}
```

Shop und Anbieter werden zuerst geprüft. Eine URL mit einer Shop-Kennung oder Anbieter-UID, die es nicht gibt, oder mit dem Anbieter einer anderen Organisation, wird schon vor dem Hinterlegen eines Secrets mit `404` abgelehnt — die Prüfung durch weed.de schlägt dann fehl.

> [!WARNING]
>
> Solange kein Webhook-Secret hinterlegt ist, werden weed.de-Bestellungen zwar quittiert, aber nicht verarbeitet. weed.de wertet sie als zugestellt und sendet sie nicht erneut. Hinterlegen Sie das Secret direkt nach der Registrierung der URL, bevor Sie Bestellungen über weed.de annehmen, und entfernen Sie es nicht, solange Sie über weed.de verkaufen.

### Webhook-Secret wechseln

Wenn Sie das hinterlegte Webhook-Secret entfernen, ist der Endpoint wieder im [Zustand ohne Secret](#not-configured): weed.de-Bestellungen werden mit `200` und `{"status": "not_configured"}` beantwortet, Bestellungen aus dieser Zeit also quittiert, aber nicht angelegt. So wechseln Sie das Secret:

1. Registrieren Sie den Webhook bei weed.de neu oder lassen Sie dort ein neues Secret erzeugen.
2. Tragen Sie das neue Secret sofort im Admin-Tool unter **Zugangsdaten** ein und speichern Sie es. Das Speichern ersetzt das alte Secret; entfernen Sie das alte nicht vorher.
3. Prüfen Sie das neue Secret mit der [URL-Prüfung](#url-check), oder senden Sie eine Testbestellung aus der Sandbox von weed.de.

Zustellungen, die weed.de mit dem neuen Secret sendet, bevor Sie es gespeichert haben, werden mit `401` abgelehnt. weed.de wiederholt sie, sodass sie ankommen, sobald das neue Secret gespeichert ist — vorausgesetzt, das geschieht vor der letzten Wiederholung durch weed.de (siehe [Antworten und Wiederholungen](#responses)). Würden Sie das Secret stattdessen entfernen, bekämen diese Zustellungen `not_configured` als Antwort, und weed.de würde sie nicht erneut senden.

### URL-Prüfung

```bash theme={null}
GET /v2/public-api/prescriptions/{shop_identifier}/weed/{telemedicine_provider_uid}
```

weed.de prüft die URL, bevor es die Registrierung annimmt. Für diese Prüfung beantwortet die URL auch `GET` und `HEAD`, mit denselben Pfadparametern und demselben Header `X-Signature`. Dabei wird kein Anfragekörper gelesen und nichts gespeichert oder gesendet — Sie können damit also auch selbst das hinterlegte Secret testen, ohne eine Bestellung anzulegen.

| Situation | Antwort |
| - | - |
| Es ist kein Webhook-Secret hinterlegt | `200` `{"status": "not_configured"}` |
| `X-Signature` stimmt mit dem hinterlegten Secret überein | `200` `{"status": "ok"}` |
| `X-Signature` fehlt oder stimmt nicht überein | `401` `invalid_api_key` |
| Shop oder Anbieter existiert nicht, oder der Anbieter gehört zu einer anderen Organisation | `404` `not_found` |
| Dem API-Schlüssel des Anbieters fehlt `create_prescription_checkout` | `403` `permission_denied` |
| Die Einrichtung des Anbieters in RxScale ist unvollständig | `500` `telemedicine_provider_misconfigured` |

`HEAD` antwortet mit demselben Status, aber ohne Antwortkörper.

```bash theme={null}
curl -X GET "https://api.rxscale.com/v2/public-api/prescriptions/my-shop/weed/7d2c1e8a-4b6f-4f1e-9a3b-2c5d8e9f0a1b" \
  -H "X-Signature: your-weed-webhook-secret"
```

```json theme={null}
{
  "status": "ok"
}
```

### Ereignisse

RxScale verarbeitet nur `order.created`. Jedes andere Ereignis wird mit `200` beantwortet und ändert nichts. Sein `data` wird nicht geprüft:

```json theme={null}
{
  "status": "ignored"
}
```

## So wird eine weed.de-Bestellung übernommen

weed.de sendet jede Bestellung als `{"event", "data", "timestamp"}`, wobei `data` die Bestellung enthält. RxScale verwendet diese Felder aus `data`:

| weed.de-Feld | Verwendet für |
| - | - |
| `id` | Die weed.de-Bestellnummer. Sie identifiziert die Bestellung bei der [Duplikaterkennung](#duplicates), wird als `prescriptions[].id` zurückgegeben und als Attribute `external_order_id` und `weed_order_id` an die Shopify-Bestellung gehängt |
| `prescriptionBase64` | Das Rezept-PDF. Es wird geprüft (QES) und mit der Bestellung gespeichert |
| `products[].id` | Die eigene Produkt-ID von weed.de. Sie dient nur dazu, das Produkt bei einer Ablehnung zu benennen. Höchstens 255 Zeichen |
| `products[].externalId` | Das Produkt: die Shopify-Variante mit dieser ID oder mit ihrer GID `gid://shopify/ProductVariant/…` in dem Shop aus der URL. Höchstens 255 Zeichen. Jede andere GID bezeichnet kein Produkt des Shops und wird als unbekannt abgelehnt |
| `products[].quantity` | Die Menge der Position. Muss eine ganze Zahl von `1` bis `1000` sein |
| `products[].unitPrice` | Der Preis der Position in EUR pro Einheit, sofern gesetzt. Bei `null` gilt der Shopify-Preis der Variante |
| `products[].totalPrice` | Wird mit `unitPrice` × `quantity` abgeglichen, wenn beide gesetzt sind |
| `customer.firstName`, `customer.lastName` | Der Name der Patientin oder des Patienten sowie der Name auf Rechnungs- und Lieferadresse |
| `customer.email` | Die Kontakt-E-Mail-Adresse des Bestellentwurfs. Bei einer noch nicht bezahlten Bestellung (`prepaid` `false`) schickt Shopify die Rechnung an diese Adresse, deshalb ist sie dort Pflicht: Eine offene Bestellung ohne E-Mail-Adresse wird abgelehnt. Bei einer vorausbezahlten Bestellung gilt ein leerer Wert als keine E-Mail-Adresse. Ein Wert, der keine gültige E-Mail-Adresse ist, wird immer abgelehnt |
| `customer.phone` | Die Kontakttelefonnummer des Bestellentwurfs. Eine Nummer ohne Ländervorwahl wird im Land der Lieferadresse gelesen, ohne Lieferadresse im Land der Rechnungsadresse, und in Deutschland, wenn keine der beiden gesendet wird: Bei einer deutschen Adresse wird aus `0700000000` die Nummer `+49700000000`, bei einer österreichischen aus `06641234567` die Nummer `+436641234567`. Die Nummer steht außerdem unverändert auf der Rechnungs- und der Lieferadresse |
| `customer.address` | Die Rechnungsadresse |
| `deliveryDetails.address` | Die Lieferadresse. Fehlt sie oder sind alle ihre Felder leer, wie bei einer Abholung, wird die Rechnungsadresse verwendet |
| `doctor.firstName`, `doctor.lastName`, `doctor.email`, `doctor.phone` | Die Angaben zur verschreibenden Ärztin oder zum verschreibenden Arzt, sofern weed.de sie mitsendet |
| `deliveryDetails.shippingProvider`, sonst `deliveryDetails.deliveryForm` | Die Versandmethode — siehe [Versandmethode](#delivery) |
| `priceBreakdown.deliveryPrice` | Der Versandpreis, sofern weed.de ihn mitsendet. Setzt `deliveryDetails.shippingProvider` oder `deliveryDetails.deliveryForm` voraus — siehe [Preise und Mengen](#prices) |
| `prepaid` | Ob die Bestellung als bezahlt verbucht wird oder Shopify eine Rechnung schickt — siehe [Vorausbezahlte und offene Bestellungen](#prepaid) |
| `prepaid`, `deliveryDetails.deliveryForm`, `deliveryDetails.shippingProvider`, `deliveryDetails.externalDelivery`, `prescriptionVersion`, `isThirdPartyPrescription` | Werden als Attribute an die Shopify-Bestellung gehängt — siehe [Bestellattribute](#attributes) |

Adressen werden so umgesetzt:

* `street` und `houseNr` werden zu einer Adresszeile zusammengeführt, zum Beispiel `Hauptstraße 42`. Endet `street` bereits mit der Hausnummer, wird sie nicht ein zweites Mal angehängt: `Main St 154` mit `houseNr` `154` bleibt `Main St 154`.
* `state` wird zum Bundesland bzw. zur Region der Adresse.
* `country` ist ein Ländername wie `Germany` und wird in den Ländercode umgewandelt. Eine Adresse ohne Land oder mit einem Ländernamen, der sich nicht zuordnen lässt, wird abgelehnt.
* Eine Adresse, deren Felder alle leer sind, gilt als keine Adresse.

Produkte werden ausschließlich über `externalId` erkannt. Andere Produktfelder wie `pzn` oder `name` verändern den Bestellentwurf nicht: Jede Position zeigt die Variante aus Ihrem Shop. Felder, die hier nicht aufgeführt sind, werden weder verwendet noch geprüft, etwa `customer.dateOfBirth`, `priceBreakdown.productsTotalPrice` und `priceBreakdown.totalPrice`. Felder, die weed.de künftig zu seinen Webhooks hinzufügt, werden angenommen und ignoriert.

### Bestellattribute

Zusätzlich zu den Attributen, die RxScale an die Bestellungen aller Telemedizin-Anbieter hängt, trägt die Shopify-Bestellung diese Attribute. Ein Attribut, dessen weed.de-Feld fehlt oder `null` ist, entfällt; `true` / `false` werden als Text geschrieben.

| Attribut | Wert |
| - | - |
| `external_order_id` | `id`, die weed.de-Bestellnummer |
| `weed_order_id` | `id`, die weed.de-Bestellnummer |
| `weed_prepaid` | `prepaid` |
| `weed_delivery_form` | `deliveryDetails.deliveryForm` |
| `weed_shipping_provider` | `deliveryDetails.shippingProvider` |
| `weed_external_delivery` | `deliveryDetails.externalDelivery` |
| `weed_prescription_version` | `prescriptionVersion` |
| `weed_is_third_party_prescription` | `isThirdPartyPrescription`. RxScale hält den Wert fest, wertet ihn aber nicht aus |

## Preise und Mengen

Alle Beträge sind in EUR, und der Shop muss in EUR verkaufen. Mengen und Beträge müssen als JSON-Zahlen gesendet werden. Ein Wert, der als Text gesendet wird, etwa `"10.50"`, wird abgelehnt.

weed.de verkauft grammweise: `products[].unit` ist `"g"`, und `quantity` ist die Anzahl Gramm. RxScale übernimmt die Menge als Anzahl Einheiten der Shopify-Variante. Jede Variante, die Sie auf weed.de anbieten, muss deshalb für 1 g stehen. Eine Menge von `5` bestellt fünf Einheiten der Variante, also 5 g.

* **Mengen** müssen ganze Zahlen von `1` bis `1000` sein. `2.0` zählt als `2`; eine Zustellung mit einer Menge wie `2.5`, `0` oder `1001` wird abgelehnt.
* **Beträge:** `unitPrice`, `totalPrice` und `priceBreakdown.deliveryPrice` müssen zwischen `0` und `99999.99` EUR liegen und dürfen höchstens zwei Nachkommastellen haben. Ein negativer Betrag oder einer wie `10.555` wird abgelehnt.
* **Produktpreise:** Ist `unitPrice` gesetzt, ist das der Preis pro Einheit der Position im Bestellentwurf, in EUR, unabhängig davon, was die Variante in Shopify kostet. Ist `unitPrice` `null`, gilt der Shopify-Preis der Variante.
* **Summen:** Sind `unitPrice` und `totalPrice` beide gesetzt, muss `totalPrice` genau `unitPrice` × `quantity` entsprechen. Andernfalls wird die Zustellung abgelehnt.
* **Versandpreis:** `priceBreakdown.deliveryPrice` wird als Versandpreis übernommen, wenn weed.de ihn mitsendet. weed.de sendet `priceBreakdown` nur bei vorausbezahlten Bestellungen. Ohne diese Angabe gilt der Preis der zugeordneten Shopify-Versandmethode. Ein `deliveryPrice` setzt `deliveryDetails.shippingProvider` oder `deliveryDetails.deliveryForm` voraus, damit die Bestellung nie ohne den Versand verbucht wird, den die Patientin oder der Patient bezahlt hat. Eine Zustellung ohne beides wird abgelehnt.

Beispiel: Ein Produkt mit `unitPrice` `10.5` und `quantity` `2` wird zu einer Position mit zwei Einheiten zu je 10,50 €, insgesamt 21,00 €.

## Vorausbezahlte und offene Bestellungen

| `prepaid` | Was passiert |
| - | - |
| `true` | Die Patientin oder der Patient hat bereits auf weed.de bezahlt. RxScale legt den Bestellentwurf an, ohne eine Zahlungsaufforderung zu senden, und verbucht ihn als bezahlt. Über Ihren Shop wird kein Geld eingezogen. |
| `false` | RxScale legt einen Bestellentwurf an, und Shopify schickt der Patientin oder dem Patienten per E-Mail eine Rechnung. Erst wenn sie bezahlt ist, wird die Bestellung in Shopify angelegt und kommt in RxScale an. weed.de muss `customer.email` mitsenden; ohne sie wird die Zustellung abgelehnt, bevor etwas angelegt wird. |

> [!WARNING]
>
> Damit vorausbezahlte Bestellungen als bezahlt verbucht werden, brauchen Sie die Einstellung **Als bezahlt verbuchen** aus [Schritt 2](#setup). Ohne sie bleibt eine vorausbezahlte weed.de-Bestellung ein unbezahlter Bestellentwurf in Shopify, und die Patientin oder der Patient erhält auch keine Zahlungsaufforderung. Eine verbuchte Bestellung lässt sich nicht wieder in einen Entwurf zurückverwandeln.

Verbucht Shopify eine vorausbezahlte Bestellung nicht als bezahlt, wird die Zustellung mit `502` beantwortet. Der `code` sagt, ob die Bestellung trotzdem verbucht sein könnte; siehe [Vorausbezahlte Bestellungen](https://docs.rxscale.com/de/api-reference/public/prescriptions.md#prepaid-orders).

## Versandmethode

RxScale entnimmt die Versandart aus `deliveryDetails.shippingProvider` (zum Beispiel `DHL Standard`). Sendet weed.de keinen Versanddienstleister, wird stattdessen `deliveryDetails.deliveryForm` verwendet (zum Beispiel `pickup`). Dieser Wert wird in den Versandmethoden-Zuordnungen Ihres weed.de-Anbieters nachgeschlagen. Er muss exakt übereinstimmen, einschließlich Groß- und Kleinschreibung und Leerzeichen.

Für die Versandposition gelten danach dieselben Regeln wie bei jedem Telemedizin-Anbieter, beschrieben unter [Zuordnung der Versandmethode](https://docs.rxscale.com/de/api-reference/public/prescriptions.md#shipping-method-mapping):

* Mit Zuordnung trägt die Versandposition den Namen der zugeordneten Shopify-Versandmethode. Ihr Preis ist der Preis dieser Methode, es sei denn, weed.de hat einen anderen `deliveryPrice` gesendet.
* Ohne Zuordnung wird eine Versandposition mit dem Wert von weed.de als Namen angelegt, sofern weed.de einen `deliveryPrice` gesendet hat. Ohne Preis erhält der Bestellentwurf keine Versandposition.

## Beispiel-Zustellung

Sie können selbst eine Zustellung senden, um Ihre Einrichtung zu testen. Die folgende Anfrage ist gekürzt: weed.de sendet weitere Felder. Ersetzen Sie `prescriptionBase64` durch den Base64-kodierten Inhalt eines signierten Rezept-PDFs und die `externalId`-Werte durch Varianten-IDs aus Ihrem Shop.

> [!NOTE]
>
> Eine Anfrage, die Sie selbst senden, wird wie eine echte weed.de-Bestellung verarbeitet. Sie legt einen Bestellentwurf in Ihrem Shop an, und mit `"prepaid": true` wird er als bezahlt verbucht.

```bash theme={null}
curl -X POST "https://api.rxscale.com/v2/public-api/prescriptions/my-shop/weed/7d2c1e8a-4b6f-4f1e-9a3b-2c5d8e9f0a1b" \
  -H "X-Signature: your-weed-webhook-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "order.created",
    "timestamp": "2026-11-07T09:30:00.000Z",
    "data": {
      "id": "0A789AG9",
      "products": [
        {
          "id": "weed-product-1001",
          "externalId": "44012345678901",
          "pzn": "12345678",
          "name": "Cannabis flower 22/1",
          "unitPrice": 10.5,
          "quantity": 2,
          "totalPrice": 21.0,
          "unit": "g"
        },
        {
          "id": "weed-product-1002",
          "externalId": "44012345678902",
          "pzn": "87654321",
          "name": "Cannabis flower 18/1",
          "unitPrice": 7.0,
          "quantity": 1,
          "totalPrice": 7.0,
          "unit": "g"
        }
      ],
      "customer": {
        "firstName": "Max",
        "lastName": "Mustermann",
        "email": "max.mustermann@example.com",
        "phone": "+4917612345678",
        "address": {
          "street": "Hauptstraße",
          "houseNr": "42",
          "zipCode": "10115",
          "city": "Berlin",
          "state": "Berlin",
          "country": "Germany"
        }
      },
      "doctor": null,
      "deliveryDetails": {
        "deliveryForm": "delivery",
        "shippingProvider": "DHL Standard",
        "externalDelivery": false,
        "address": {
          "street": "Nebenstraße",
          "houseNr": "7",
          "zipCode": "10115",
          "city": "Berlin",
          "state": "Berlin",
          "country": "Germany"
        }
      },
      "prepaid": true,
      "isThirdPartyPrescription": false,
      "priceBreakdown": {
        "productsTotalPrice": 28.0,
        "deliveryPrice": 4.99,
        "totalPrice": 32.99
      },
      "prescriptionVersion": 1,
      "prescriptionBase64": "JVBERi0xLjQK..."
    }
  }'
```

Mit der Zuordnung für `DHL Standard` aus [Schritt 3](#setup) entsteht ein Bestellentwurf mit zwei Positionen: zwei Einheiten zu 10,50 € und eine Einheit zu 7,00 €. Er erhält eine Versandposition für die zugeordnete Methode zu 4,99 €, die Rechnungsadresse `Hauptstraße 42` und die Lieferadresse `Nebenstraße 7`, und er wird als bezahlt verbucht.

### Antwort

```json theme={null}
{
  "status": "success",
  "prescriptions": [
    {
      "id": "0A789AG9",
      "prescription_uid": "px-abc123"
    }
  ]
}
```

`prescriptions[].id` ist die weed.de-Bestellnummer (`data.id`). `prescription_uid` identifiziert das Rezept in RxScale. Damit können Sie die Bestellung über den [Bestellungen-Endpoint](https://docs.rxscale.com/de/api-reference/public/orders.md) abfragen.

Eine erfolgreiche Antwort kann zusätzlich eine Liste `warnings` enthalten. Sie ist nur vorhanden, wenn es etwas zu melden gibt — prüfen Sie daher auf den Schlüssel, nicht auf eine leere Liste. Derzeit ist ihr einziger Eintrag `phone_not_forwarded` mit `field` `data.customer.phone`: Die Bestellung wurde angenommen, aber `customer.phone` wurde nicht als Kontakttelefonnummer der Bestellung gesetzt, weil sich die Nummer nicht nach E.164 umwandeln ließ oder Shopify sie abgelehnt hat. Siehe [Warnungen](https://docs.rxscale.com/de/api-reference/public/prescriptions.md#warnungen).

```json theme={null}
{
  "status": "success",
  "prescriptions": [
    {
      "id": "0A789AG9",
      "prescription_uid": "px-abc123"
    }
  ],
  "warnings": [
    {
      "code": "phone_not_forwarded",
      "field": "data.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."
    }
  ]
}
```

## Antworten und Wiederholungen

weed.de wartet bis zu 30 Sekunden auf eine Antwort. Jede Antwort außer `2xx` — und auch gar keine Antwort — gilt als fehlgeschlagene Zustellung. Im Produktivbetrieb wiederholt weed.de eine fehlgeschlagene `order.created`-Zustellung bis zu viermal: nach 5 Minuten, 30 Minuten, 1 Stunde und 2 Stunden.

| Status | `status` / `code` | Bedeutung |
| - | - | - |
| `200` | `status: success` | Die Bestellung wurde angenommen und der Bestellentwurf angelegt. Die Antwort kann [`warnings`](#response) enthalten |
| `200` | `status: not_configured` | Es ist kein Webhook-Secret hinterlegt. Es wurde nichts verarbeitet — siehe [Solange kein Secret hinterlegt ist](#not-configured) |
| `200` | `status: ignored` | Ein anderes Ereignis als `order.created`. Es wurde nichts verarbeitet |
| `400` | `code: validation_error` | Die Bestellung lässt sich so nicht verarbeiten: eine Menge oder ein Betrag, der als Text statt als Zahl gesendet wurde, eine Menge, die keine ganze Zahl von `1` bis `1000` ist, ein Betrag außerhalb von `0` bis `99999.99` oder mit mehr als zwei Nachkommastellen, ein `totalPrice`, der nicht `unitPrice` × `quantity` entspricht, eine Adresse ohne Land oder mit einem Land, das sich nicht zuordnen lässt, eine ungültige E-Mail-Adresse, eine fehlende `customer.email` bei einer offenen Bestellung, eine Produkt-`id` oder `externalId` mit mehr als 255 Zeichen oder ein `deliveryPrice` ohne Versanddienstleister oder Lieferart. Alle Probleme werden auf einmal gemeldet, und es werden alle betroffenen Produkte genannt, nicht nur das erste |
| `400` | `code: invalid_json` | Der Anfragekörper ist kein gültiges JSON |
| `400` | — | Der Signatur-Validierungsdienst war nicht erreichbar, daher konnte das Rezept nicht geprüft werden. Die Wiederholung durch weed.de gelingt in der Regel |
| `401` | `code: invalid_api_key` | `X-Signature` fehlt oder stimmt nicht mit dem hinterlegten Webhook-Secret überein |
| `403` | `code: permission_denied` | Dem API-Schlüssel des Anbieters fehlt `create_prescription_checkout` |
| `404` | `code: not_found` | Der Shop oder der Anbieter aus der URL existiert nicht, oder der Anbieter gehört zu einer anderen Organisation |
| `404` | `code: unknown_sku` | Mindestens eine `externalId` ist weder die ID noch die GID `gid://shopify/ProductVariant/…` einer Variante in diesem Shop. `lines` nennt jedes dieser Produkte in der Reihenfolge, in der weed.de sie gesendet hat, und nur diese |
| `409` | `code: duplicate_prescription_injection` oder `order_already_exists` | Diese weed.de-Bestellung wurde bereits angenommen — siehe [Duplikate](#duplicates) |
| `409` | `code: product_unavailable_in_shop`, `shop_not_shopify` oder `shop_misconfigured` | Der Shop kann diese Bestellung nicht annehmen: Ein Produkt ist dort nicht mehr bestellbar (`lines` nennt es mit der `externalId`, die weed.de gesendet hat), es ist kein Shopify-Shop, oder seine Shopify-Anbindung ist unvollständig. Muss auf Seiten des Shops behoben werden |
| `422` | — | Das Rezept ist kein gültiges PDF, oder es trägt keine qualifizierte elektronische Signatur (QES) und Ihr Anbieter lässt keine unsignierten Rezepte zu |
| `500` | `code: telemedicine_provider_misconfigured` | Die Einrichtung des weed.de-Anbieters in RxScale ist unvollständig: Es ist kein API-Schlüssel verknüpft, oder der verknüpfte Schlüssel existiert nicht mehr, gehört zu einer anderen Organisation oder ist mit einem anderen Anbieter verknüpft. Verknüpfen Sie im Admin-Tool einen gültigen Schlüssel |
| `500` | `code: internal_error` | Ein unerwarteter Fehler bei RxScale, auch wenn ein hinterlegtes Webhook-Secret nicht mehr gelesen werden kann. Die Bestellung selbst war nicht fehlerhaft |
| `502` | `code: shopify_error` | Shopify hat den Bestellentwurf abgelehnt oder mit einem Fehler geantwortet |
| `502` | `code: draft_order_complete_failed` oder `draft_order_complete_uncertain` | Eine vorausbezahlte Bestellung konnte nicht als bezahlt verbucht werden — siehe [Vorausbezahlte Bestellungen](https://docs.rxscale.com/de/api-reference/public/prescriptions.md#prepaid-orders) |

Jede Fehlerantwort enthält einen `code` — ausgenommen die `422` und die `400` bei nicht erreichbarem Signatur-Validierungsdienst. Siehe [Reason-Codes der Public API](https://docs.rxscale.com/de/error-handling.md#reason-codes-der-public-api).

> [accordion] 401 — X-Signature fehlt oder ist falsch
>
> ```json theme={null}
> {
>   "code": "invalid_api_key",
>   "description": "Invalid API key",
>   "error": "Invalid API key"
> }
> ```

> [accordion] 404 — unbekannter Shop oder Anbieter
>
> ```json theme={null}
> {
>   "code": "not_found",
>   "error": "Resource not found"
> }
> ```

> [accordion] 400 — eine Menge, die keine ganze Zahl ist
>
> `details` nennt jedes abgelehnte Feld mit seinem Pfad in der Zustellung. Eine Meldung zu einem Produkt nennt es mit seiner weed.de-`id` und seiner `externalId`; die gesendeten Werte werden in den Meldungen nie wiederholt. Alle Probleme werden gemeinsam gemeldet: hier die Menge `2.5` des zweiten Produkts und der `totalPrice`, der dadurch nicht mehr passt. Andere Felder werden genauso gemeldet, zum Beispiel `data.customer.address.country` mit `Unknown country.` oder `Country is required.`, ein als Text gesendeter Wert mit `Not a valid number.`, eine zu lange `id` mit `Longer than maximum length 255.`, eine zu lange `externalId` mit `Length must be between 1 and 255.` und eine fehlende E-Mail-Adresse bei einer offenen Bestellung, `data.customer.email`, mit `Required when prepaid is false: the patient is sent the invoice by email.`
>
> ```json theme={null}
> {
>   "code": "validation_error",
>   "error": {
>     "data": {
>       "products": {
>         "1": {
>           "quantity": ["Must be a whole number from 1 to 1000 (product id 'weed-product-1002', externalId '44012345678902')."],
>           "totalPrice": ["Must equal unitPrice x quantity (product id 'weed-product-1002', externalId '44012345678902')."]
>         }
>       }
>     }
>   },
>   "details": {
>     "data.products.1.quantity": ["Must be a whole number from 1 to 1000 (product id 'weed-product-1002', externalId '44012345678902')."],
>     "data.products.1.totalPrice": ["Must equal unitPrice x quantity (product id 'weed-product-1002', externalId '44012345678902')."]
>   }
> }
> ```

> [accordion] 404 — Produkte, die es im Shop nicht gibt
>
> `lines` enthält jedes Produkt, dessen `externalId` keine Variante des Shops ist, mit der `externalId` und der `quantity`, die weed.de gesendet hat. Gefundene Produkte werden nicht aufgeführt.
>
> ```json theme={null}
> {
>   "code": "unknown_sku",
>   "error": "SKU not found in this shop.",
>   "lines": [
>     {
>       "sku_uid": null,
>       "external_id": "44012345678901",
>       "quantity": 2
>     },
>     {
>       "sku_uid": null,
>       "external_id": "44012345678902",
>       "quantity": 1
>     }
>   ]
> }
> ```

> [accordion] 500 — Einrichtung des Anbieters unvollständig
>
> ```json theme={null}
> {
>   "code": "telemedicine_provider_misconfigured",
>   "error": "This telemedicine provider's setup in RxScale is incomplete."
> }
> ```

Eine mit `4xx` abgelehnte Zustellung legt nichts an: kein Rezept und keinen Bestellentwurf. Sobald Sie die Ursache behoben haben, zum Beispiel eine fehlende `externalId` oder ein falsches Secret, kann die nächste Wiederholung durch weed.de gelingen. Nach der letzten Wiederholung sendet weed.de die Bestellung nicht mehr.

### Duplikate

Jede weed.de-Bestellung wird nur einmal angenommen. Eine erneute Zustellung einer bereits angenommenen Bestellung wird mit `409` beantwortet und legt nichts an. Der `code` ist `duplicate_prescription_injection` oder `order_already_exists`; behandeln Sie beide gleich:

```json theme={null}
{
  "code": "duplicate_prescription_injection",
  "error": "Duplicate prescription injection: prescription id(s) ['0A789AG9'] already submitted by provider weed (existing prescription(s) ['px-abc123']); no order created.",
  "duplicates": [
    {
      "id": "0A789AG9",
      "prescription_uid": "px-abc123",
      "order_uid": null
    }
  ]
}
```

`duplicates[].id` ist die weed.de-Bestellnummer. `order_uid` bleibt `null`, bis Shopify die Bestellung angelegt hat und sie in RxScale angekommen ist.

Das passiert meist, wenn RxScale eine Bestellung angenommen hat, die Antwort aber nicht rechtzeitig bei weed.de angekommen ist. weed.de wertet die `409` als fehlgeschlagene Zustellung und wiederholt sie höchstens viermal. Jede Wiederholung wird wieder mit `409` beantwortet; Sie müssen nichts tun. Die einzige Ausnahme ist eine Bestellung, deren erste Zustellung mit `502` und `draft_order_complete_uncertain` beantwortet wurde: Wenden Sie sich dann an RxScale, damit die Bestellung abgeglichen wird.

Eine Bestellung, deren frühere Zustellung abgelehnt wurde, ist nicht blockiert: Ihre nächste Zustellung wird ganz normal verarbeitet.

## Siehe auch

* [Rezepte & Behandlungen](https://docs.rxscale.com/de/api-reference/public/prescriptions.md) — der generische Checkout-Endpoint, die Zuordnung der Versandmethode und vorausbezahlte Bestellungen
* [Bestellungen](https://docs.rxscale.com/de/api-reference/public/orders.md) — Bestellstatus anhand der Rezept-UID abfragen
* [Telemedizin-Anbieter](https://docs.rxscale.com/de/api-reference/management/telemedicine-providers.md) — Ihre Anbieter und deren UIDs auflisten
* [Fehlerbehandlung](https://docs.rxscale.com/de/error-handling.md) — Fehlerformate und Reason-Codes der Public API


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.