De En Fr It

Contact & Support

Referrer

Provider

Login

Register

No account yet?

Get in touch with us, we are happy to advise you.

Registration request

Language selection

Deutsch English French Italian

Developer Center

Developer Center

Seamless integration and structured data transfer with the OPAN® API.

With the OPAN® API and integration interfaces, you can connect to various applications, whether as a referring institution/organization or as a provider processing applications.

Our flexible implementation options allow you to:

  • API native integration
  • Partial integration
  • URL parameter interface

Flexible integration for optimal adaptation to operational requirements and existing systems. Increases efficiency and improves data management. An always up-to-date OpenAPI spec documentation, including Postman collection and detailed process descriptions, supports the effective implementation and use of APIs with all necessary resources and instructions.

Developer Account

Get the most out of our platform: API docs, tutorials, workflow tips, integration ideas, and current updates - all compactly compiled for you. Request your account now and start integrating!

Request account
Online appointment

Do you have questions about integration, workflows, and technical requirements? Do you have a special use case? Schedule a non-binding online appointment with our developers.

Schedule appointment
Slack Community

Become part of our Slack community to get support and valuable information for your integration. Network, exchange knowledge, and work together with like-minded people.

Join now

OPAN® API V3 for Referrers (Senders)

  • The OPAN® API V3 is designed for referring institutions such as hospitals, clinics, practices and other healthcare services to send structured data to the OPAN® platform. It facilitates the referral process for patients transitioning to aftercare organizations.
  • Target group: Hospitals, clinics, medical practices and other healthcare organizations that refer patients to aftercare institutions.

  • Full API integration: The fully integrable API of OPAN® enables a seamless connection of your own specialist software to the OPAN® platform. OPAN® can be operated entirely via the API. However, this requires considerable integration effort and is particularly suitable for app providers.

  • Partial integration: With partial API integration, master data, documents and order information are transferred automatically. The system then generates a hash and a front-end URL that directs the user to the OPAN® interface. There, a suitable provider can be selected and the registration completed. Once submitted, all further interactions, including supplements and status queries, can be made via the API again. This method eliminates the need to implement GUIs in the specialist application. In addition, OPAN® takes over a large part of the business logic, which significantly reduces the integration effort and offers an efficient, developer-friendly solution.

Advantages:

  • Efficiency: Our API optimizes the remittance process by transferring structured data.
  • Flexibility: We offer both full and partial integration options that enable flexible, cross-system technical integrations.
  • User-friendly: OPAN® provides an intuitive user interface for interactions, ensuring ease of use and accurate data entry.
API documentation

Find more details and implementation guidelines in our OpenAPI spec documentation, which includes Postman collections and detailed descriptions of the entire process.

Open API Spec

OPAN® API V3 for Providers (Recipients)

The OPAN® API for providers is designed for organizations and institutions such as Spitex, nursing homes, rehabilitation clinics and psychiatric clinics that receive registrations via OPAN®. The main goal is to facilitate the receipt of structured data from the OPAN® platform.

  • Data reception: OPAN® enables aftercare institutions to efficiently download and process structured data from submitted registrations and requests.

  • Structured data: The API provides detailed, structured information based on the enrollment fields. The more comprehensive the data provided, the more robust the processing in the primary software system of the aftercare institutions.

  • Document access: Provides easy access to submitted documents and PDF summaries of enrollment details, including comments, internal notes and all relevant interactions.

  • Automation: Enables automatic updating of subsequently submitted information and documents, minimizing the administrative burden.

  • Compliance-compliant archiving: Supports long-term, legally compliant data storage at the customer by providing comprehensive summaries.
API documentation

Find more details and implementation guidelines in our OpenAPI spec documentation, which includes Postman collections and detailed descriptions of the entire process.

Open API Spec

OPAN® UPI (URL Parameter Interface)

The OPAN® UPI (URL Parameter Interface) provides a simplified method of sending structured data to the OPAN® platform using URL parameters. This integration method is ideal for fast and uncomplicated data transmission with certain restrictions.

  • Simplified data transfer: Uses URL parameters to send data, which simplifies implementation. However, the character limit is restricted to 2048 characters.

  • Fire-and-forget mechanism: Designed for one-time data transmission without the need for status updates and reference to the login (backlink).

  • Broker UPI: With a focus on manufacturers of practice software. In this version, the API key is linked to the practice software, not to the end recipient. Users must select their own practice or organization when submitting a registration, which enables flexible data forwarding. A practice software can thus integrate the OPAN® UPI once generically to enable access for all its users. This is particularly powerful with HIN Login, a supported functionality of the OPAN® platform.

Restrictions:

  • Fire-and-forget principle: Once the data has been sent, there is no further automatic interaction with OPAN®. This corresponds to the process with the classic web form. Status updates or automatic feedback are not available in this mode. There is no direct backlink to the original application.
  • Restricted document upload: The parameter interface does not support direct document uploads. The regular browser upload form must be used to submit documents. This requires a separate step for document uploads.
UPI documentation

To access the UPI documentation and use the OPAN® UPI, you must register for a Developer Account.

Request account

Frequently Asked Questions (FAQ)

Developer Center

  • Wie erhalte ich einen API-Key?

    Registrieren Sie sich als Entwickler bei OPAN®. Im Entwickler-Account erhalten Sie Zugriff auf eine Test-Organisation und können den Test-API-Key abrufen. Für die Produktivschaltung, z.B. bei einem Kunden (wenn Sie Softwareanbieter sind), kann der Kunde Ihnen den produktiven API-Key zur Verfügung stellen.

  • Welche Testumgebungen bietet OPAN®?

    OPAN® bietet drei relevante System-Instanzen:

    • PRODUCTION: Das Livesystem für den produktiven Einsatz.
    • TESTING: Testumgebung für Integratoren zur API-Erprobung und für automatisierte Tests. Sie entspricht dem aktuellen Produktivstand.
    • STAGING: Abnahmesystem für neue Funktionen vor dem Production-Release. Hier werden Updates getestet und freigegeben.

  • Welche Daten können übermittelt und abgerufen werden?

    Über die API können Sie alle Daten und Felder, die im Anmeldeformular enthalten sind, übermitteln oder abrufen.

  • Wie erstelle ich eine Support-Anfrage oder einen Change-Request?

    Melden Sie sich mit Ihrem Entwickler-Account an und klicken Sie anschliessend auf das Fragezeichen-Symbol unten rechts im Bildschirm. Darüber können Sie Ihr Anliegen direkt an den OPAN® Service Desk über das integrierte Ticketing-System übermitteln. Der OPAN® Support bearbeitet Ihre Anfrage werktags während den Bürozeiten nach Priorität und Dringlichkeit.