Panoramica: API e integrazioni

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

1. Apri Impostazioni.
2. 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. Sotto c'è il link Documentazione interattiva della API, che apre la pagina pubblica per sviluppatori: vedi La documentazione per sviluppatori.

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 e Gestire le connessioni.

Per usare la API da un tuo sistema vedi Usare l'API pubblica, Caricare e aggiornare contratti via API ed Errori e limiti dell'API.

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. Senza il permesso la voce API & Integrazioni non compare nel menu delle Impostazioni.

Problemi comuni

• Non vedo la voce API & Integrazioni — ti manca il permesso «Gestisci integrazioni e API»: chiedi a un amministratore o al titolare di assegnartelo, oppure di completare la configurazione al posto tuo.
• "Non hai il permesso per accedere a questa sezione." — hai aperto la sezione da un link diretto senza il permesso: vale la stessa soluzione del punto precedente.
• "Configura un'organizzazione per gestire le chiavi API." — seleziona o crea un'organizzazione prima di procedere.
• La creazione di una chiave viene rifiutata o la API risponde sempre con errore 402 — la API pubblica non è disponibile per la tua organizzazione: vedi L'API non è disponibile per la mia organizzazione.