Zum Inhalt

PharmaOne API

Verbinden Sie Kassensysteme, ERP-Anbindungen, n8n, WooCommerce/JTL-Plugins und eigene Backends mit PharmaOne Manager.

  • Authentifizierung

    Tauschen Sie Ihren Organisations-API-Schlüssel gegen ein bereichsbezogenes JWT.

    Auth-Leitfaden

  • API-Referenz

    Vollständige v2-Routenübersicht — Bestellungen, Bestand, Produkte, Berichte, Webhooks.

    Übersicht

  • Interaktiver API-Explorer

    Testen Sie alle Endpunkte im Browser mit Swagger UI.

    Swagger öffnen

  • Bestand & Lager

    Bestand anpassen, Produkte Shops zuweisen, mit externen Systemen synchronisieren.

    Bestands-Leitfaden

  • Bestellungen & Bestellanfragen

    Bestellungen direkt anlegen oder Anfragen zur manuellen Prüfung einreichen.

    Bestellungen

  • Externer Telemedizin-Connector

    Shop-bezogene Bestellanfragen für Telemedizin-Partner (nur URL + API-Schlüssel).

    Externer Telemedizin-Connector

  • Webhooks

    HMAC-signierte ausgehende Ereignisse für Bestellungen, Bestand und Rezepte.

    Webhooks

So funktioniert es

sequenceDiagram
    participant Partner
    participant API as PharmaOne API
    participant Backend as PharmaOne Backend

    Partner->>API: POST /v2/.../auth/token + apikey
    API->>Backend: Schlüssel prüfen
    Backend-->>Partner: JWT (1h, bereichsbezogen)

    Partner->>API: GET /v2/.../orders + Bearer JWT
    API->>Backend: Token + Bereiche prüfen
    Backend-->>Partner: JSON-Antwort

Umgebungen

Umgebung API-Basis-URL
Produktion https://manager.prod.pharmaone.shop
Sandbox Wird von Ihrem Apotheken-Kontakt bereitgestellt

Ersetzen Sie {orgId} in allen Pfaden durch Ihre Organisations-ID (z. B. org1).

Schnellstart

export BASE="https://manager.prod.pharmaone.shop"
export ORG="org1"
export APIKEY="your-integration-api-key"

TOKEN=$(curl -s -X POST "$BASE/api/v2/public/orgs/$ORG/auth/token" \
  -H "apikey: $APIKEY" | jq -r .access_token)

curl -s "$BASE/api/v2/public/orgs/$ORG/shops" \
  -H "Authorization: Bearer $TOKEN" | jq .

API-Schlüssel konfigurieren Sie in Manager → Org Settings → Integrations.

Weiterführend