Usare le API di QuoteCrest — QuoteCrest Help

Panoramica

Nel piano Business, QuoteCrest espone API REST complete perché il tuo software — un ERP, un CRM, un'app di field service — possa gestire i preventivi direttamente. Tutto ciò che l'app sa fare è disponibile: preventivi e voci, clienti, la libreria articoli, aliquote fiscali, modelli di termini, pagamenti, generazione dei PDF, l'assistente AI per i preventivi e i trigger di sincronizzazione contabile.

Il riferimento completo e sempre aggiornato degli endpoint si trova su quotecrest.com/api-docs.

Ottenere l'accesso

Assicurati che il tuo team sia sul piano Business (Impostazioni → Fatturazione). Le chiamate API da team Free o Pro restituiscono 403 plan_required.
Vai su Impostazioni → Sviluppatori e clicca su Registra applicazione.
Assegna un nome, il tuo redirect URI (HTTPS, oppure localhost durante lo sviluppo) e gli scope necessari: read per l'accesso in lettura, write per creare e aggiornare.
Copia il Client Secret quando viene mostrato — appare esattamente una volta. Il Client ID resta visibile nella pagina dell'applicazione.

Autenticazione

Le API usano OAuth 2.0 Authorization Code con PKCE — nessuna chiave API. La tua app invia un utente a /oauth/authorize, l'utente approva gli scope richiesti e tu scambi il codice restituito (più il tuo verifier PKCE) su /oauth/token per un token di accesso.

I token di accesso durano 2 ore; usa il refresh token per ottenere una nuova coppia.
I refresh token ruotano a ogni utilizzo — conserva sempre la coppia più recente.
Ogni token è legato a un solo team: quello dell'utente che lo ha autorizzato.

Invia il token a ogni richiesta:

Authorization: Bearer YOUR_ACCESS_TOKEN

Inizia con GET /api/v1/me — restituisce il team autorizzato, le sue impostazioni predefinite per i preventivi e gli scope del tuo token.

Cosa puoi costruire

Automazione dei preventivi — crea clienti e preventivi (POST /api/v1/quotes), aggiungi voci in blocco, invia o pubblica e scarica il PDF. Le impostazioni predefinite del team (termini, scadenza, condizioni di pagamento, modalità di prezzo) si applicano automaticamente.
Preventivi con AI — POST /api/v1/ai_quotes trasforma una descrizione del lavoro in linguaggio naturale in una bozza di preventivo completa usando la tua libreria articoli.
Monitoraggio dei pagamenti — interroga status / payment_status del preventivo o elenca /api/v1/payments per importi, commissioni e incassi netti.
Contabilità — controlla lo stato della connessione su GET /api/v1/integrations e avvia un'importazione del catalogo QuickBooks o Xero con POST /api/v1/integrations/{provider}/sync.

Per una guida completa con richieste di esempio, leggi la nostra guida in due parti: configurare il tuo workspace e collegare la tua app alle API.

Limiti ed errori

Il traffico API generale è limitato per IP; la generazione con AI è limitata a 10 richieste al minuto per team. Una risposta 429 significa attendere e riprovare.
401 — token scaduto o revocato (aggiorna e riprova). 402 insufficient_credits — il saldo di crediti AI del team è esaurito. 422 — errori di validazione, con i dettagli nel corpo della risposta.

Revoca un'applicazione collegata in qualsiasi momento da Impostazioni → Sviluppatori, oppure come utente finale dalla tua pagina delle applicazioni autorizzate — i suoi token smettono di funzionare immediatamente.