De In Fr It

Contatto & Supporto

Referente

Fornitore

Accesso

Registro

Non hai ancora un account?

Contattaci, saremo lieti di consigliarti.

Richiesta di registrazione

Selezione della lingua

Deutsch Inglese Francese Italiano

Developer Center

Developer Center

Integrazione e trasferimento di dati strutturati con l'API OPAN®.

Con l'API OPAN® e le interfacce di integrazione, puoi connetterti a varie applicazioni, sia come istituzione/organizzazione di riferimento che come fornitore che elabora le iscrizioni.

Le nostre opzioni di implementazione flessibili ti permettono di:

  • Integrazione nativa API
  • Integrazione parziale
  • Interfaccia parametri URL

Integrazione flessibile per un adattamento ottimale alle esigenze operative e ai sistemi esistenti. Aumenta l'efficienza e migliora la gestione dei dati. Una documentazione OpenAPI spec sempre aggiornata, che include una collezione Postman e descrizioni dettagliate dei processi, supporta l'implementazione e l'uso efficace delle API con tutte le risorse e le istruzioni necessarie.

Account sviluppatore

Ottieni il massimo dalla nostra piattaforma: documentazione API, tutorial, suggerimenti sui flussi di lavoro, idee di integrazione e aggiornamenti attuali - tutto compilato in modo compatto per te. Richiedi il tuo account ora e inizia l'integrazione!

Richiedi account
Appuntamento online

Hai domande sull'integrazione, i flussi di lavoro e i requisiti tecnici? Hai un caso d'uso speciale? Pianifica un appuntamento online senza impegno con i nostri sviluppatori.

Pianifica appuntamento
Comunità Slack

Diventa parte della nostra comunità Slack per ottenere supporto e informazioni preziose per la tua integrazione. Fai rete, scambia conoscenze e lavora insieme a persone che la pensano come te.

Unisciti ora

OPAN® API V3 per i referenti (mittenti)

L'API OPAN® V3 è stata progettata per consentire alle organizzazioni di riferimento, come ospedali, cliniche, studi medici e altri servizi sanitari, di inviare dati strutturati alla piattaforma OPAN®. Facilita il processo di referral per i pazienti che si trasferiscono alle organizzazioni di aftercare.

  • Gruppo target: Ospedali, cliniche, studi medici e altre organizzazioni sanitarie che indirizzano i pazienti agli istituti di assistenza.

  • Integrazione API completa: l'API completamente integrabile di OPAN® consente di collegare senza problemi il vostro software specializzato alla piattaforma OPAN®. OPAN® può essere gestito interamente tramite l'API. Tuttavia, ciò richiede un notevole sforzo di integrazione ed è particolarmente indicato per i fornitori di app.

  • Integrazione parziale: con un'integrazione API parziale, i dati anagrafici, i documenti e le informazioni sugli ordini vengono trasferiti automaticamente. Il sistema genera quindi un hash e un URL front-end che indirizza l'utente all'interfaccia OPAN® . Qui è possibile selezionare un fornitore adatto e completare la registrazione. Una volta effettuata, tutte le ulteriori interazioni, comprese le richieste di supplementi e di stato, possono essere effettuate nuovamente tramite l'API. Questo metodo elimina la necessità di implementare le GUI nell'applicazione specializzata. Inoltre, OPAN® si fa carico di gran parte della logica aziendale, riducendo in modo significativo lo sforzo di integrazione e offrendo una soluzione efficiente e facile da sviluppare.

Vantaggi:

  • Efficienza: la nostra API ottimizza il processo di trasferimento di dati strutturati.
  • Flessibilità: offriamo opzioni di integrazione completa e parziale che consentono integrazioni tecniche flessibili e trasversali ai sistemi.
  • Facilità d'uso: OPAN® offre un'interfaccia utente intuitiva per le interazioni, garantendo facilità d'uso e un'immissione accurata dei dati.
Documentazione API

Trova maggiori dettagli e linee guida per l'implementazione nella nostra documentazione OpenAPI spec, che include collezioni Postman e descrizioni dettagliate dell'intero processo.

Open API Spec

OPAN® API V3 per i fornitori (destinatari)

L'API OPAN® per i fornitori è pensata per organizzazioni e istituzioni come Spitex, case di cura, cliniche di riabilitazione e cliniche psichiatriche che ricevono registrazioni tramite OPAN®. L'obiettivo principale è quello di facilitare la ricezione di dati strutturati dalla piattaforma OPAN®.

  • Ricezione dei dati: OPAN® consente agli istituti di cura di scaricare ed elaborare in modo efficiente i dati strutturati delle registrazioni e delle richieste inviate.

  • Dati strutturati: L'API fornisce informazioni dettagliate e strutturate sulla base dei campi di iscrizione. Più completi sono i dati forniti, più solida è l'elaborazione nel sistema software principale degli istituti di assistenza.

  • Accesso ai documenti: consente di accedere facilmente ai documenti inviati e ai riepiloghi in PDF dei dettagli dell'iscrizione, compresi i commenti, le note interne e tutte le interazioni pertinenti.

  • Automazione: consente l'aggiornamento automatico delle informazioni e dei documenti inviati successivamente, riducendo al minimo gli oneri amministrativi.

  • Archiviazione conforme alla normativa: consente l'archiviazione dei dati a lungo termine e conforme alla legge presso il cliente, fornendo riepiloghi completi.
Documentazione API

Trova maggiori dettagli e linee guida per l'implementazione nella nostra documentazione OpenAPI spec, che include collezioni Postman e descrizioni dettagliate dell'intero processo.

Open API Spec

OPAN® UPI (URL Parameter Interface)

L'OPAN® UPI (URL Parameter Interface) fornisce un metodo semplificato per inviare dati strutturati alla piattaforma OPAN® utilizzando parametri URL. Questo metodo di integrazione è ideale per una trasmissione di dati rapida e semplice, con alcune limitazioni.

  • Trasferimento dati semplificato: utilizza i parametri URL per inviare i dati, semplificando l'implementazione. Tuttavia, il limite di caratteri è limitato a 2048 caratteri.

  • Meccanismo Fire-and-forget: sviluppato per la trasmissione di dati una tantum senza la necessità di aggiornamenti di stato e riferimenti al login (backlink).

  • Broker UPI: con un'attenzione particolare ai produttori di software per la pratica. In questa versione, la chiave API è collegata al software dello studio, non al destinatario finale. Gli utenti devono selezionare il proprio studio o la propria organizzazione al momento della registrazione, il che consente un inoltro flessibile dei dati. Un software di studio può quindi integrare l'OPAN® UPI una sola volta in modo generico per consentire l'accesso a tutti i suoi utenti. Ciò è particolarmente efficace con l'HIN Login, una funzionalità supportata dalla piattaforma OPAN®.

Restrizioni:

  • Principio Fire-and-forget: una volta inviati i dati, non c'è più alcuna interazione automatica con OPAN®. Ciò corrisponde al processo con il classico modulo web. Gli aggiornamenti di stato o il feedback automatico non sono disponibili in questa modalità. Non esiste un collegamento diretto con l'applicazione originale.
  • Caricamento limitato dei documenti: L'interfaccia dei parametri non supporta il caricamento diretto dei documenti. Per inviare i documenti è necessario utilizzare il normale modulo di caricamento del browser. Ciò richiede una fase separata per il caricamento dei documenti.
Documentazione UPI

Per accedere alla documentazione UPI e utilizzare l'OPAN® UPI, devi registrarti per un account sviluppatore.

Richiedi account

Domande Frequenti (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.