Apotheken-SKUs

Lagerbestände und Preise von Apotheken-SKUs verwalten

​

Apotheken-SKUs

Sehen Sie die Produktbestände, Preise und externen System-IDs Ihrer Apotheke ein und aktualisieren Sie diese.

​

SKUs auflisten

GET /v1/external_pharmacy_api/pharmacy_skus/

page · integer · Standard: "0"

Seitennummer (0-indiziert)

limit · integer · Standard: "50"

Einträge pro Seite (max. 200)

pharmacy_uid · string

Erforderlich für gruppenweite API-Schlüssel

​

Antwort

{
  "data": [
    {
      "uid": "psku-abc123",
      "external_id": "EXT-001",
      "price": 1299,
      "stock": 50,
      "pharmacy": "pharmacy-123",
      "sku": {
        "uid": "sku-456",
        "display_name": "Medication X 100mg",
        "pzn": "12345678",
        "product_uid": "prod-789",
        "product_display_name": "Medication X",
        "standard_selling_unit": 10.0,
        "unit": "g",
        "product_handle": "medication-x",
        "digital": false
      },
      "created_at": 1716200000,
      "updated_at": 1716203600,
      "deleted_at": null
    }
  ],
  "totalRegistries": 150,
  "totalPages": 3
}

Das Feld price wird in Euro-Cent angegeben (z. B. 1299 = 12,99 EUR).

Ausgeblendete SKU-Typen: Ihr Konto kann so konfiguriert sein, dass SKUs eines bestimmten Typs (digital oder physisch) ausgeblendet werden. SKUs des ausgeblendeten Typs werden automatisch aus dieser Liste ausgeschlossen — sie erscheinen weder im data-Array noch werden sie in totalRegistries gezählt. Diese Einstellung ist standardmäßig deaktiviert und wird von Ihrem rxscale-Administrator konfiguriert. Wenn Sie der Meinung sind, dass SKUs in Ihrer Liste fehlen, wenden Sie sich an den rxscale-Support.

​

SKU aktualisieren

Wenn Ihr Konto so konfiguriert ist, dass ein SKU-Typ ausgeblendet wird, gibt jeder Versuch, eine Apotheken-SKU dieses ausgeblendeten Typs zu aktualisieren — über PATCH /pharmacy_skus/{uid}, PATCH /pharmacy_skus/{uid}/stock oder PATCH /pharmacy_skus/{uid}/external_id — 404 Not Found zurück. Stellen Sie sicher, dass die SKU in Ihrer GET /pharmacy_skus-Liste erscheint, bevor Sie versuchen, sie zu aktualisieren.

Aktualisieren Sie Preis, Bestand und/oder external_id für eine Apotheken-SKU.

PATCH /v1/external_pharmacy_api/pharmacy_skus/{pharmacy_sku_uid}

​

Anfragekörper

Alle Felder sind optional — geben Sie nur die Felder an, die Sie aktualisieren möchten.

{
  "price": 1499,
  "stock": 25,
  "external_id": "EXT-002"
}

Lagerbestände dürfen negativ sein (z. B. -40), um überverkaufte Bestände in Ihrem eigenen System abzubilden.

​

Nur Bestand aktualisieren

Ein praktischer Endpoint, um ausschließlich den Lagerbestand zu aktualisieren.

PATCH /v1/external_pharmacy_api/pharmacy_skus/{pharmacy_sku_uid}/stock

{
  "stock": 100
}

​

Externe ID aktualisieren

Verknüpfen Sie eine Apotheken-SKU mit Ihrem externen System.

PATCH /v1/external_pharmacy_api/pharmacy_skus/{pharmacy_sku_uid}/external_id

{
  "external_id": "YOUR-SYSTEM-ID"
}