Panoramica: API e integrazioni
Cos'è la sezione API & Integrazioni, cosa trovi nei suoi 4 tab e chi può gestirla nella tua organizzazione.
Prima di iniziare: Permesso «Gestisci integrazioni e API» per operare; la sezione è visibile a tutti ma resta in sola consultazione senza questo permesso.
Se vuoi collegare Accordyx al tuo gestionale, a un CRM, a un foglio Excel o a un sistema esterno tramite API, tutto parte da un'unica sezione delle Impostazioni.
Dove si trova
- Apri Impostazioni.
- Nel gruppo «Organizzazione», apri API & Integrazioni.
In cima alla pagina trovi un riquadro con l'endpoint base della API pubblica, il tipo di autenticazione richiesto e il link alla specifica tecnica: informazioni utili se stai passando l'integrazione a chi sviluppa.
I quattro tab
La sezione è organizzata in quattro tab, in quest'ordine:
- Chiavi API — crea e revoca le chiavi che danno accesso alla API pubblica. Vedi Le chiavi API.
- Importa dati — carica controparti o contratti in blocco da un file CSV o Excel. Vedi Importare da Excel o CSV.
- Webhook — ricevi una notifica automatica sul tuo endpoint a ogni evento rilevante. Vedi I webhook in uscita.
- Gestionali — collega gestionali, CRM e cartelle cloud per sincronizzare controparti e documenti. Vedi Collegare Fatture in Cloud o Business Central.
Chi può gestirla
Creare e revocare chiavi API, collegare sistemi esterni e configurare webhook richiede il permesso «Gestisci integrazioni e API». Di norma è assegnato al titolare e agli amministratori dell'organizzazione; gli altri ruoli non lo hanno per impostazione predefinita.
Problemi comuni
- "Non hai il permesso per gestire le integrazioni. Chiedi a un amministratore dell'organizzazione (permesso «Gestisci integrazioni e API»)." — chiedi a un amministratore o al titolare di assegnarti il permesso, oppure di completare la configurazione al posto tuo.
- "Configura un'organizzazione per gestire le chiavi API." — seleziona o crea un'organizzazione prima di procedere.
Ultimo aggiornamento: 2026-07-19