Produkte

Produkte und SKUs über die Management API auflisten

​

Produkte

Rufen Sie eine paginierte Liste aller Produkte Ihrer Organisation ab, einschließlich zugehöriger SKUs, Shop-SKUs, Shop-Produkte und Apotheken-SKUs.

​

Produkte auflisten

GET /v1/management/products

page · integer · Standard: "0"

Seitennummer (0-indexiert)

limit · integer · Standard: "50"

Anzahl der Produkte pro Seite

Erforderliche Berechtigung: product:read

​

Beispielanfrage

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

​

Antwort

{
  "products": [
    {
      "uid": "prod-abc123",
      "display_name": "Medication X",
      "skus": [
        {
          "uid": "sku-456",
          "display_name": "Medication X 100mg",
          "pzn": "12345678",
          "shop_skus": [
            {
              "uid": "ssku-789",
              "shop_uid": "shop-001",
              "external_id": "shopify-variant-123"
            }
          ],
          "pharmacy_skus": [
            {
              "uid": "psku-012",
              "pharmacy_uid": "ph-xyz",
              "price": 1299,
              "stock": 50,
              "external_id": "EXT-001"
            }
          ]
        }
      ],
      "shop_products": [
        {
          "uid": "sp-345",
          "shop_uid": "shop-001",
          "external_id": "shopify-product-456"
        }
      ]
    }
  ],
  "totalRegistries": 42,
  "totalPages": 2
}

​

Antwortfelder

Feld	Typ	Beschreibung
products	array	Liste der Produktobjekte
products[].uid	string	Produkt-UID
products[].display_name	string	Anzeigename des Produkts
products[].skus	array	SKUs, die zu diesem Produkt gehören
products[].skus[].pzn	string	Pharmazentralnummer (deutsche Arzneimittelkennung)
products[].skus[].pharmacy_skus	array	Apothekenspezifische SKU-Daten (Preis, Bestand)
totalRegistries	integer	Gesamtanzahl der Produkte
totalPages	integer	Gesamtanzahl der Seiten für das angegebene Limit

Das Feld price bei Apotheken-SKUs ist in Euro-Cent angegeben (z.B. 1299 = 12,99 EUR).

​

Produktdetails abrufen

GET /v1/management/products/{product_uid}

product_uid · string · erforderlich

Die Produkt-UID

Erforderliche Berechtigung: product:read

​

Beispielanfrage

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

​

Antwort

Gibt die gleiche Produktstruktur wie der Listen-Endpoint zurück, jedoch für ein einzelnes Produkt inklusive aller verbundenen SKUs, Shop-SKUs, Shop-Produkte und Apotheken-SKUs.

{
  "uid": "prod-abc123",
  "display_name": "Medikament X",
  "skus": [...],
  "shop_products": [...]
}