Fattura elettronica via LLM/AI
Il supporto del protocollo MCP varia significativamente tra i diversi modelli LLM e IDE attualmente disponibili (elenco dei client disponibili). In questo tutorial dimostreremo come collegare Claude al servizio MCP di Invoicetronic, consentendoti di interagire con la nostra API utilizzando il linguaggio naturale. Al momento, Claude offre il supporto più completo per il protocollo.
Prerequisiti
Presupponiamo che questi prerequisiti siano soddisfatti:
- Hai ottenuto una Chiave API attiva
- Hai un abbonamento attivo a Claude (al momento della stesura di questo documento è richiesto Pro o superiore)
Collegare Claude al servizio MCP di Invoicetronic
- Vai alle Impostazioni di Claude (clicca sul tuo nome, poi clicca Impostazioni nel menu).
- Clicca su "Connettori".
- Se hai un abbonamento, sarà disponibile il pulsante "Aggiungi connettore personalizzato". Cliccalo. 4 Digita "Invoicetronic" nel campo Nome.
- Digita "https://mcp.invoicetronic.com" nel campo "URL server MCP remoto"
- Clicca sul pulsante "Aggiungi".
Come dovrebbe apparire il modulo "Aggiungi connettore personalizzato" prima di premere il pulsante "Aggiungi".
A questo punto, il connettore Invoicetronic sarà elencato nella pagina Connettori:
Il connettore personalizzato "Invoicetronic" è ora elencato nei Connettori Claude disponibili.
Ora puoi cliccare sul pulsante "Connetti" per attivare il connettore Invoicetronic. Una volta fatto ciò, Claude si connette al servizio MCP di Invoicetronic, che ti chiederà la tua chiave API:
Inserisci qui la tua chiave API, poi clicca sul pulsante "Autorizza".
Inserisci la tua chiave API e clicca sul pulsante "Autorizza". Una volta fatto ciò, tornerai a Claude, dove il connettore Invoicetronic viene mostrato come "Connesso"
Claude è ora connesso al servizio Invoicetronic.
Ora sei pronto per interagire con Invoicetronic API usando il linguaggio naturale. Nell'esempio qui sotto, abbiamo iniziato una nuova chat e chiesto informazioni sullo stato dell'account Invoicetronic.
Un'interazione in linguaggio naturale con Invoicetronic.
Ricorda, la chiave API che scegli per la connessione è importante. Se fornisci una chiave di test, le risposte dell'LLM proverranno dalla Sandbox. Se invece invii una chiave API live, i dati proverranno dall'ambiente di produzione.
Consultare la cronologia delle notifiche
Quando invii una fattura allo SDI, la consegna non è istantanea: lo SDI esegue una serie di controlli e poi inoltra il documento al destinatario, restituendo una sequenza di notifiche che descrivono lo stato del processo (Inviato, Consegnato, Scartato, ecc.). La risorsa send espone l'ultimo stato, ma per ricostruire l'intera cronologia delle transizioni — per esempio per capire perché una fattura è stata scartata — l'API espone l'endpoint /update.
Tramite il connettore MCP puoi richiedere la cronologia in linguaggio naturale, senza dover conoscere i dettagli dell'endpoint. Alcuni esempi di prompt:
- "Mostrami la cronologia delle notifiche SDI per la fattura inviata con id 225."
- "Quali fatture inviate negli ultimi 7 giorni risultano scartate? Per ognuna, indica il motivo del rifiuto."
- "Per la fattura con identifier 234234234, elenca tutte le transizioni di stato in ordine cronologico."
Claude tradurrà la richiesta in chiamate ai tool MCP corrispondenti (filtrando per send_id, state, intervallo temporale, ecc.) e ti restituirà un riepilogo leggibile delle notifiche, comprensivo del campo description quando lo SDI fornisce un motivo di rifiuto.
Le query su /update sono gratuite
Le richieste a /update non vengono conteggiate sul tuo piano: puoi consultare la cronologia delle notifiche con la frequenza che preferisci.