API-Dokumentation für Partner

Über unsere Schnittstellen

Die Sanvivo Cannabis-Apotheke ist eine hochmoderne medizinische Apotheke mit Fokus auf vollständig digitalisierte Prozesse. Unser Ziel ist es, medizinisches Cannabis schnell, sicher und unkompliziert für Patienten verfügbar zu machen.

Für unsere Partner – insbesondere Ärzte, Hersteller und andere medizinische Dienstleister – stellen wir professionelle API-Schnittstellen zur Verfügung, die eine nahtlose Integration in bestehende Praxisverwaltungssysteme ermöglichen.

Unser digitaler Ansatz

Als digitale Apotheke verfolgen wir das Ziel, administrative Belastungen für alle Beteiligten zu minimieren und gleichzeitig die Behandlungsqualität zu maximieren. Durch die Reduzierung analoger Prozesse können wir Fehlerquellen eliminieren und Wartezeiten erheblich verkürzen.

Unsere API-Infrastruktur ermöglicht es Partnern, direkt auf unser Produktsortiment zuzugreifen und Rezepteinreichungen digital abzuwickeln. Dies führt zu einer erheblichen Verbesserung der Effizienz in der Patientenversorgung.

Die bereitgestellten Schnittstellen ergänzen herkömmliche Kommunikationswege und bieten eine sichere, zuverlässige Alternative für den professionellen Datenaustausch.

Verfügbare Schnittstellen

Wir stellen Ihnen zwei zentrale API-Endpunkte zur Verfügung:

📊 Produktdaten-API

Ermöglicht den Abruf aktueller Produktinformationen, Verfügbarkeiten und Preise zur Integration in Ihre Praxisverwaltungssoftware oder andere medizinische Systeme.

📋 Rezepteinreichungs-API

Bietet die Möglichkeit zur sicheren digitalen Übermittlung von Rezepten und Patientendaten. Die Abrechnung erfolgt direkt zwischen Patient und Apotheke.

Produktdaten-API

Diese Schnittstelle ermöglicht es Ihnen, aktuelle Informationen zu unserem gesamten Produktsortiment abzurufen. Sie erhalten Zugriff auf Verfügbarkeiten, Preise und detaillierte Produktspezifikationen.

API-Endpunkt

GET https://sanvivo-cannabis-apotheke.de/api/products?limit=9999&offset=0

URL-Parameter

Parameter	Typ	Beschreibung
limit	Integer	Maximale Anzahl der zurückgegebenen Produktdatensätze
offset	Integer	Startwert für die Paginierung der Ergebnisse

API-Antwort

Die Schnittstelle liefert strukturierte Produktdaten im JSON-Format zurück:

{
  "items": [
    {
      "id": "19921531",
      "THC": 24,
      "CBD": 1,
      "productName": "Buuo 24/1",
      "kultivar": "Sudz",
      "genetics": "Hybrid - Indica dominant",
      "price": 779,
      "available": false,
      "irradiated": false,
      "country": "Kanada"
    },
    {
      "id": "19921530",
      "THC": 30,
      "CBD": 1,
      "productName": "Barongo 30/1 KM",
      "kultivar": "Animal Kush Mintz",
      "genetics": "Hybrid - Indica dominant",
      "price": 999,
      "available": true,
      "irradiated": false,
      "country": "Kanada"
    }
  ]
}

Rezepteinreichungs-API

Über diese Schnittstelle können Sie Rezepte und Patientendaten sicher an unsere Apotheke übermitteln. Die API unterstützt ausschließlich Rezepte mit qualifizierter elektronischer Signatur (QES) zur Gewährleistung höchster Sicherheitsstandards und rechtlicher Compliance.

Datenschutz & Sicherheit: Alle übermittelten Patientendaten werden nach höchsten Datenschutzstandards verarbeitet und ausschließlich für die Rezeptbearbeitung verwendet.

API-Endpunkt

POST http://platform.sanvivo-cannabis.de/api/orders/partner

Erforderliche Header

Header	Wert	Beschreibung
Content-Type	application/json	Format der übermittelten Daten
x-api-key	YL9bNstHbDPNPXKRrd7QVrq9xRcLB2Mx	API-Authentifizierungsschlüssel

Datenformat der Anfrage

Übermitteln Sie die Rezept- und Patientendaten als strukturiertes JSON-Objekt:

{
  "partner_id": 100,
  "order_data": {
    "customer": {
      "firstname": "string",
      "lastname": "string",
      "email": "user@example.com",
      "phone": "string",
      "homeAddress": {
        "delivery_type": "string",
        "streetName": "string",
        "houseNr": "string",
        "postalCode": "string",
        "city": "string",
        "name2": "string",
        "addtionalAdressInformation1": "string"
      },
      "deliveryAddress": {
        "delivery_type": "string",
        "streetName": "string",
        "houseNr": "string",
        "postalCode": "string",
        "city": "string",
        "name2": "string",
        "addtionalAdressInformation1": "string"
      },
      "date_of_birth": "2025-06-26"
    },
    "products": [
      {
        "id": "string",
        "name": "string",
        "quantity": 1,
        "price": 0,
        "crushed": false
      }
    ],
    "pharmacy_id": "Sanvivo",
    "prescriptionURL": "string",
    "doctor": {
      "name": "string",
      "firstname": "string",
      "phone": "string",
      "cityOfSignature": "string",
      "dateOfSignature": "string"
    },
    "isThirdPartyPrescription": true,
    "internalOrderId": "string",
    "draft": false
  }
}

Wichtige Datenfelder

partner_id

Ihre eindeutige Partner-Identifikationsnummer. Für Testzwecke verwenden Sie "100".

prescriptionURL

Base64-kodierte PDF-Datei des Rezepts mit QES (qualifizierte elektronische Signatur). Rezepte ohne QES können nicht über diese API verarbeitet werden.

internalOrderId

Eindeutige Referenznummer aus Ihrem System zur Nachverfolgung der Bestellung.

pharmacy_id

Fester Wert "Sanvivo" zur Identifikation unserer Apotheke im System.

Integration & Support

Unser technisches Team unterstützt Sie gerne bei der Integration unserer APIs in Ihre bestehenden Systeme. Wir bieten umfassende Beratung und Dokumentation für eine reibungslose Anbindung.

Kontakt für technische Fragen

E-Mail: hello@sanvivo-apotheke.de

Unterstützung bei der Integration

• API-Dokumentation und Testumgebung
• Technische Beratung und Implementierungshilfe
• Monitoring und Fehleranalyse
• Regelmäßige Updates und Wartung

🛡️ Datenschutz & Compliance

DSGVO-Konformität: Alle API-Schnittstellen entsprechen den Anforderungen der Datenschutz-Grundverordnung und den besonderen Bestimmungen für Gesundheitsdaten.

Technische Sicherheit: Verschlüsselte Datenübertragung über HTTPS/TLS, sichere Authentifizierung und Autorisierung sowie regelmäßige Sicherheitsaudits.

Apothekenrecht: Vollständige Konformität mit deutschem Apothekengesetz, Apothekenbetriebsordnung und allen relevanten pharmazeutischen Vorschriften.