> ## 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.

# 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

```bash theme={null}
GET /v1/management/products
```

<ParamField query="page" type="integer" default="0">
  Seitennummer (0-indexiert)
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Anzahl der Produkte pro Seite
</ParamField>

**Erforderliche Berechtigung:** `product:read`

### Beispielanfrage

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

### Antwort

```json theme={null}
{
  "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   |

<Note>
  Das Feld `price` bei Apotheken-SKUs ist in **Euro-Cent** angegeben (z.B. `1299` = 12,99 EUR).
</Note>

## Produktdetails abrufen

```bash theme={null}
GET /v1/management/products/{product_uid}
```

<ParamField path="product_uid" type="string" required>
  Die Produkt-UID
</ParamField>

**Erforderliche Berechtigung:** `product:read`

### Beispielanfrage

```bash theme={null}
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.

```json theme={null}
{
  "uid": "prod-abc123",
  "display_name": "Medikament X",
  "skus": [...],
  "shop_products": [...]
}
```