Requisiti e permessi
- Richiedi a Provet l’attivazione dell’integrazione OAuth con Client ID e Client secret, flusso client_credentials e ambito restapi. I permessi dell’utente virtuale associato determinano le risorse accessibili.
- Il computer ImaCash necessita di accesso HTTPS in uscita a Provet Cloud. Conferma con Provet il dominio dell’istanza e la compatibilità con la versione installata; non cambiare dominio o certificati per aggirare gli errori.
- Autorizza la lettura di department, invoice, invoicepayment, unallocatedpayment e user per il reparto interessato. Un token valido non garantisce l’accesso a ogni risorsa. Queste consultazioni non richiedono permessi di scrittura.
- Richiedi anche l’accesso in lettura al catalogo paymentmethod per identificare metodi personalizzati, incluse le carte personalizzate. Provet deve assegnare i permessi di catalogo appropriati; non concedere privilegi amministrativi generali come soluzione.
Configurazione in ImaCash
- Apri Configurazione > Integrazione e seleziona Provet Cloud. Il nome precedente Provet Cloud V2 rimane soltanto come alias di compatibilità, non come seconda integrazione.
- Provet ID (tenantId): identificativo numerico dell’istanza o della clinica fornito da Provet. Non è un nome utente, un indirizzo email né l’ID del reparto; inserisci soltanto l’identificativo, non un URL.
- Client ID: identificativo OAuth dell’integrazione abilitata per quell’istanza.
- Client secret: Dato riservato fornito dall’amministratore. Inserirlo esclusivamente in ImaCash.
- Salva la configurazione e seleziona il reparto relativo a questa cassa quando richiesto. Verifica anche i filtri degli utenti e la valuta attiva prima della prova.
Acquisizione e metodi di pagamento
- ImaCash legge le fatture finalizzate del reparto, i relativi pagamenti e i pagamenti non allocati. Confronta sempre importi, valuta e metodo di pagamento nei due sistemi; una lettura API non conferma un movimento fisico di contante.
- I tipi standard documentati sono payment_type=1 per contanti e payment_type=0 per carta. La loro identificazione non dipende dal successo della consultazione ausiliaria paymentmethod.