Zapier

[fraperfra]

Sto integrando Fatture in Cloud con Zapier tramite API e il mio obiettivo è estrarre automaticamente le fatture includendo il dettaglio dei prodotti / line items (descrizione, quantità, prezzo, IVA).

Vorrei chiarire alcuni punti prima di consolidare l’architettura:
1. Quali endpoint API consigliate per ottenere fatture complete di righe prodotto (non solo intestazione), considerando un utilizzo via Zapier?
2. Quali sono gli scope minimi indispensabili per leggere correttamente fatture e line items senza incorrere in errori 403 Forbidden?
3. La Manual Authentication è supportata e affidabile in uno scenario di estrazione automatizzata continua (Zapier), oppure consigliate esplicitamente l’OAuth2 anche per questo caso?
4. Esistono limitazioni note (paginazione, rate limit, campi non restituiti, differenze tra fatture elettroniche e non) che potrei incontrare usando Zapier invece di un backend custom?

L’obiettivo è costruire un flusso stabile che non richieda interventi manuali futuri per errori di permessi o incompletezza dei dati.

[valmoz]

Buongiorno @fraperfra
Prima di tutto, Zapier è costruita per semplificare il più possibile l'integrazione tramite API nascondendo dettagli complessi come Scopes e Autenticazione.

Per questo motivo, la nostra integrazione Zapier funziona esclusivamente tramite flusso OAuth2, già integrato nelle diverse Action; non è quindi possibile utilizzare gli altri metodi di autenticazione in Zapier. Il meccanismo di refresh token è inoltre nativo di Zapier, quindi il token verrà rigenerato quando necessario.
Per quanto riguarda gli scopes, l'integrazione Zapier richiede tutti i permessi in fase di ottenimento del token, in quanto deve poter agire con tutte le action senza necessariamente richiedere un token diverso per ciascuna di esse.

Zapier utilizza le nostre API all'interno del codice delle Action, quindi non esistono differenze tra Zapier e un Backend custom. Puoi controllare la sezione Basics della nostra documentazione per verificare tutte le caratteristiche principali delle nostre API. Comunque sì, esistono Rate Limiting, Paginazione e Personalizzazione delle risposte.
Esistono infine alcuni campi relativi alle fatture elettroniche, puoi controllare le guide E-Invoice management e E-Invoice XML customizarion.

Per quanto riguarda le API da utilizzare, le consiglio di usare i nostri Webhooks per essere notificato della creazione di un nuovo documento, e di usare poi la Get Issued Document per recuperare il documento appena creato.
Le faccio notare che per utilizzare i webhooks all'interno di Zapier le sarà sufficiente utilizzare i Trigger Zapier, che si occuperanno di inizializzare la sottoscrizione all'evento selezionato e di fornire gli eventi ricevuti al suo Zap. Qualora dovesse usare i Trigger Enriched, anche la chiamata Get verrà effettuata direttamente dal trigger, senza la necessità di recuperare manualmente la fattura.

In alternativa potrà usare il metodo List Issued Document per recuperare la lista paginata dei documenti, sconsigliamo però di utilizzare questo metodo in polling per aggiornare lo stato delle fatture, in quanto porterebbe ad un consumo elevato di quote API.

A disposizione
Mauro

[fraperfra]

Grazie per la celere risposta, potresti gentilmente indicarmi qual'é l'action event su zapier corretto per far sì che, dopo il trigger riesca ad estrapolare le fatture contenute qui? Grazie

[valmoz]

Ciao @fraperfra
attualmente non è possibile.

L'event in realtà esiste ed è corrispondente all'evento Webhook "it.fattureincloud.webhooks.received_documents.e_invoices.receive", ma al momento il metodo API per recuperare le informazioni corrispondenti non è pubblico.
Questa è una limitazione nota delle nostre API, nel caso in cui dovessero esserci novità a riguardo provvederemo a pubblicare una nota sulla nostra documentazione.

Grazie
Mauro