I servizi RicettaPro, nella tua applicazione.
API REST per integrare la Ricetta Bianca Elettronica Farmaceutica nel tuo gestionale.
Confrontiamoci sul tuo progetto: definiamo insieme il perimetro e il percorso verso l’integrazione.
Richieste via HTTPS / JSON → RicettaPro → Sistema TS. Esiti e promemoria ritornano attraverso RicettaPro.
Il perimetro dell’integrazione
Le API REST permettono al tuo gestionale di utilizzare i servizi RicettaPro per la Ricetta Bianca Elettronica Farmaceutica. Il tuo software gestisce l’esperienza del medico e invia le richieste in formato JSON tramite HTTPS; RicettaPro gestisce la comunicazione con RBE/Sistema TS e restituisce gli esiti dell’operazione.
Il percorso comprende la sessione di autenticazione del medico, l’invio della prescrizione, la consultazione e l’annullamento secondo le condizioni previste. Condividiamo il contratto tecnico durante l’avvio del progetto, per definire come gestire dati, risposte e promemoria nella tua applicazione.
Sessione del medico
Gestione del ciclo di autenticazione 2FA secondo il contratto tecnico fornito al partner.
Ciclo prescrittivo
Invio, consultazione e annullamento delle prescrizioni secondo le condizioni applicabili.
Esiti e promemoria
Risposte strutturate e riferimenti utili a gestire il risultato dell’operazione.
Ambienti distinti
Configurazione di test e produzione separate, con collaudo prima dell’attivazione.
Il client del partner comunica con il gateway RicettaPro in JSON su HTTPS, con autenticazione machine-to-machine dedicata e richieste identificate e firmate secondo il contratto tecnico. L’autenticazione del client è distinta dalla sessione 2FA del medico, che deve essere valida per le operazioni prescrittive. Il gateway valida i dati e gestisce internamente il collegamento con RBE/Sistema TS: non serve installare RicettaPro sulle postazioni del partner né implementare i protocolli dei servizi nazionali.
L’invio della prescrizione utilizza una chiave di idempotenza per consentire la ripetizione della richiesta dopo un errore di rete senza creare duplicati. Le risposte riportano esito, codice, messaggio, dati e riferimenti di tracciabilità; in caso di successo sono disponibili i riferimenti della ricetta e il promemoria PDF. Consultazione e annullamento seguono le condizioni del contratto. Credenziali e configurazioni TEST/PRODUZIONE restano separate; gli identificativi tecnici aiutano l’assistenza senza esporre credenziali o dati sanitari non necessari nei log.
Ritorno al gestionale: esito e riferimenti tecnici; in caso di successo, identificativi della ricetta e promemoria PDF.
Dal primo confronto alla produzione
- Ci racconti il gestionale e i servizi che vuoi integrare.
- Definiamo perimetro e proposta tecnico-commerciale.
- Ricevi la documentazione e i parametri per il test.
- Completiamo il collaudo concordato e prepariamo l’attivazione.
Documentazione tecnica su richiesta
Endpoint, autenticazione, campi e regole di validazione vengono condivisi durante il percorso di integrazione. Nessuna credenziale operativa viene pubblicata sul sito.
Nel confronto iniziale partiamo dal tuo gestionale e dal modo in cui vuoi offrire la prescrizione ai medici. Il team fornisce i riferimenti per l’integrazione; il partner predispone il client applicativo, l’interfaccia e l’ambiente di test, seguendo le regole concordate per autenticazione e protezione delle credenziali.
Il collaudo serve a verificare il percorso completo: sessione del medico, invio, lettura degli esiti e gestione delle operazioni successive. Test e produzione utilizzano configurazioni separate. Prima dell’attivazione definiamo insieme i controlli da completare e i riferimenti da usare per l’assistenza.
La prossima integrazione: richiesta per Malattia trasmessa direttamente all'INPS.
Una nuova famiglia di servizi RicettaPro dedicata ai partner, attualmente in preparazione.
Questa integrazione è pensata per i partner che vogliono affiancare alla prescrizione farmaceutica un ulteriore servizio nel proprio gestionale. Nel confronto possiamo raccogliere il contesto d’uso, le esigenze dei medici e il punto del tuo flusso applicativo in cui vorresti inserire la richiesta malattia.
Il servizio non è ancora disponibile: funzioni, modalità di integrazione e tempi di attivazione saranno precisati quando il perimetro sarà definito. Il contatto con il team ti permette di condividere le tue esigenze e richiedere informazioni sul progetto.
Le risposte, prima di scegliere
A chi sono rivolte le API?
A software house, gestionali e partner che vogliono integrare i servizi RicettaPro nelle proprie applicazioni.
Come si avvia un’integrazione?
Si parte da un confronto tecnico-commerciale, seguito dalla documentazione di integrazione e dal collaudo concordato prima della produzione.
Quali servizi sono disponibili?
Le API REST per Ricetta Bianca Elettronica Farmaceutica sono disponibili. Le API relative alla richiesta malattia INPS sono in arrivo.
Parliamo della tua integrazione
Raccontaci il tuo progetto: valuteremo insieme servizi, integrazione e percorso di attivazione.