Listing-Anfragen

Apotheken können einen Shop bitten, ein Produkt aufzunehmen, das sie bereits führen. Die Management API stellt den organisationsweiten Posteingang für diese Anfragen bereit: auflisten, eingereichte Felder einsehen und eine Annahme oder Ablehnung festhalten. Annahme und Ablehnung halten nur die Entscheidung fest. Sie legen keine Katalogzeilen an (Product, SKU, ShopProduct) und stoßen nichts an Shopify oder WooCommerce an. Alle Endpoints sind auf die Organisation beschränkt, der der API-Schlüssel gehört. UIDs einer anderen Organisation werden als nicht gefunden behandelt. Welche Felder eine Apotheke liefern muss, konfigurieren Sie in der Admin-Oberfläche, nicht über diese API.

Berechtigungen

Listing-Anfrage-Endpoints werden durch zwei Berechtigungen gesteuert:

listing_request:read — erforderlich für alle Lese-Endpoints (GET).
listing_request:write — erforderlich zum Annehmen oder Ablehnen.

Ein Schlüssel mit listing_request:write erhält nicht automatisch listing_request:read; fügen Sie beide hinzu, wenn Sie lesen und schreiben müssen. Kontaktieren Sie Ihren RxScale-Kundenbetreuer, um Berechtigungen anzupassen. Alle Anfragen authentifizieren sich mit dem Header X-API-Key. Siehe Authentifizierung für Details.

Form der Anfrage

Es gibt kein Top-Level-Feld pzn. PZN ist ein gewöhnlicher Extras-Schlüssel: ein Shop muss eine pzn-Extras-Anforderung konfigurieren, bevor eine Apotheke eine PZN senden kann. Der Wert erscheint dann unter extras.pzn in der Antwort. price_indication ist eine Ganzzahl in Kleinsteinheiten (Cent), analog zu Apotheken-SKU-Preisen.

Attributfilter (attr.*) und PZN-Filter sind in v1 auf der Management API nicht verfügbar. Sie sind nur in der Admin-Oberfläche vorhanden. Filtern Sie hier nur mit shop_uid, pharmacy_uid und status.

Listing-Anfragen auflisten

GET /v1/management/listing-requests

Gibt eine paginierte Liste der Listing-Anfragen der Organisation zurück. Erforderliche Berechtigung: listing_request:read

integer

Standard:"0"

Seitennummer (0-basiert)

integer

Standard:"50"

Anzahl der Listing-Anfragen pro Seite

string

Nach Shop-UID filtern. Unbekannte Shops dieser Organisation liefern 404.

string

Nach Apotheken-UID filtern

string

Nach Status filtern. Einer von PENDING, ACCEPTED, DECLINED oder WITHDRAWN.

Beispielanfrage

curl -X GET "https://api.rxscale.com/v1/management/listing-requests?page=0&limit=25&status=PENDING" \
  -H "X-API-Key: your-api-key-here"

Antwort

{
  "data": [
    {
      "uid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "shop_uid": "a8c829ca-de1a-4b5e-9f6d-c1957d28aa4a",
      "pharmacy_uid": "22c49130-90aa-4384-aff2-4551f227cab4",
      "product_name": "Ibuprofen 400mg",
      "price_indication": 1250,
      "additional_notes": null,
      "status": "PENDING",
      "decision_note": null,
      "decided_at": null,
      "decided_by_user_uid": null,
      "decided_by_identifier": null,
      "extras": {
        "pzn": {
          "value": "01234567",
          "value_normalized": "01234567",
          "field_requirement_uid": "3f17e567-77c2-49e1-9eb2-2d8d901a4bb7",
          "display_name": "PZN",
          "field_type": "TEXT"
        }
      }
    }
  ],
  "totalRegistries": 1,
  "totalPages": 1
}

Listing-Anfrage abrufen

GET /v1/management/listing-requests/{listing_request_uid}

Erforderliche Berechtigung: listing_request:read

string

erforderlich

UID der Listing-Anfrage

Beispielanfrage

curl -X GET "https://api.rxscale.com/v1/management/listing-requests/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "X-API-Key: your-api-key-here"

Eine fehlende UID oder eine UID einer anderen Organisation liefert 404.

Listing-Anfrage annehmen

POST /v1/management/listing-requests/{listing_request_uid}/accept

Hält eine Annahme fest. Legt keine Katalogprodukte an und stößt nichts an einen Storefront an. Erforderliche Berechtigung: listing_request:write

string

erforderlich

UID der Listing-Anfrage

string

Optionale Notiz zur Entscheidung

Beispielanfrage

curl -X POST "https://api.rxscale.com/v1/management/listing-requests/7c9e6679-7425-40de-944b-e07fc1f90ae7/accept" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"decision_note": "Wird intern gelistet"}'

Nur Anfragen mit Status PENDING können angenommen werden. Eine bereits entschiedene Anfrage liefert 400.

Listing-Anfrage ablehnen

POST /v1/management/listing-requests/{listing_request_uid}/decline

Hält eine Ablehnung fest. Erforderliche Berechtigung: listing_request:write

string

erforderlich

UID der Listing-Anfrage

string

Optionale Notiz zur Entscheidung

Beispielanfrage

curl -X POST "https://api.rxscale.com/v1/management/listing-requests/7c9e6679-7425-40de-944b-e07fc1f90ae7/decline" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"decision_note": "Bereits unter einer anderen SKU gelistet"}'

Nur Anfragen mit Status PENDING können abgelehnt werden. Eine bereits entschiedene Anfrage liefert 400.

Erste Schritte

Externe Apotheken-API

Management-API

Scheduling API

Öffentliche API

Patienten-API

Anamnese-API

Webhooks

Anleitungen

Listing-Anfragen

Listing-Anfragen

Berechtigungen

Form der Anfrage

Listing-Anfragen auflisten

Beispielanfrage

Antwort

Listing-Anfrage abrufen

Beispielanfrage

Listing-Anfrage annehmen

Beispielanfrage

Listing-Anfrage ablehnen

Beispielanfrage

​Listing-Anfragen

​Berechtigungen

​Form der Anfrage

​Listing-Anfragen auflisten

​Beispielanfrage

​Antwort

​Listing-Anfrage abrufen

​Beispielanfrage

​Listing-Anfrage annehmen

​Beispielanfrage

​Listing-Anfrage ablehnen

​Beispielanfrage

Listing-Anfragen

Berechtigungen

Form der Anfrage

Listing-Anfragen auflisten

Beispielanfrage

Antwort

Listing-Anfrage abrufen

Beispielanfrage

Listing-Anfrage annehmen

Beispielanfrage

Listing-Anfrage ablehnen

Beispielanfrage