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
Seitennummer (0-indexiert)
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}
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": [...]
}