Zum Hauptinhalt springen

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_id404 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"
}

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"
}