In breve
SmartBill Cloud API per la fatturazione rumena: emetti fatture e preventivi (proforma) come bozze o documenti finali, crea una fattura da un preventivo, controlla lo stato dei pagamenti, scarica PDF, invia documenti ai clienti e leggi serie di documenti, aliquote IVA e giacenze per magazzino. Le operazioni di storno, annullamento, eliminazione e registrazione dei pagamenti sono disattivate. Email e token API.
Configurazione guidata
Collega SmartBill a Cursor in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega SmartBill con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per SmartBill
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → SmartBill, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
SmartBill + Cursor
SmartBill Cloud API per la fatturazione rumena: emetti fatture e preventivi (proforma) come bozze o documenti finali, crea una fattura da un preventivo, controlla lo stato dei pagamenti, scarica PDF, invia documenti ai clienti e leggi serie di documenti, aliquote IVA e giacenze per magazzino. Le operazioni di storno, annullamento, eliminazione e registrazione dei pagamenti sono disattivate. Email e token API.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti.
- Accedi a SmartBill Cloud e apri Contul meu, Integrari, sezione API (https://cloud.smartbill.ro/core/integrari/).
- Copia l'Email in
SMARTBILL_EMAIL, il Token inSMARTBILL_API_TOKENe il CIF dell'azienda inSMARTBILL_CIF.
Le chiamate utilizzano l'autenticazione HTTP Basic con l'email come utente e il token come password. Il connettore aggiunge il CIF dell'azienda a ogni chiamata, quindi un connettore funziona su un'azienda; installalo di nuovo per una seconda azienda.
Dove iniziare: smartbill_list_series (i nomi delle serie di ogni documento necessario) e smartbill_list_taxes (i nomi delle aliquote IVA). Poi smartbill_create_invoice o smartbill_create_estimate.
Cosa non può fare l'API: V1 non ha lista o ricerca di fatture, clienti o prodotti e nessuna vista JSON di un documento. Un documento è identificato dalla sua serie e numero, che l'utente fornisce o che la chiamata di creazione ha restituito. Tieni series, number e documentViewUrl di ciò che crei.
Fatture: smartbill_create_invoice salva una bozza a meno che is_draft sia falso. Una fattura finale riceve il numero successivo della serie ed è un documento fiscale: SmartBill la invia ad ANAF e-Factura secondo le impostazioni dell'account, che questa API non controlla. smartbill_create_invoice_from_estimate trasforma un proforma in una fattura. smartbill_get_invoice_payment_status indica cosa è stato pagato e cosa è dovuto, smartbill_get_invoice_pdf scarica il file, smartbill_send_document_email invia una fattura o un preventivo al cliente via email. smartbill_reverse_invoice (storno), smartbill_cancel_invoice, smartbill_restore_invoice e smartbill_delete_invoice sono installati disattivati.
Preventivi (proforme): smartbill_create_estimate, smartbill_get_estimate_invoices (è stato fatturato), smartbill_get_estimate_pdf; smartbill_cancel_estimate, smartbill_restore_estimate e smartbill_delete_estimate sono disattivati.
Pagamenti: smartbill_get_fiscal_receipt_text legge un ricevuta fiscale. smartbill_register_payment (registra una riscossione o emette una ricevuta), smartbill_delete_receipt e smartbill_delete_payment sono disattivati. Niente qui addebita una carta o sposta denaro: i pagamenti sono registrazioni contabili.
Giacenze: smartbill_list_stocks restituisce le quantità per magazzino (gestiune) in una data; i nomi dei magazzini sono case-sensitive.
Scrivere un documento: seriesName, taxName e measuringUnitName devono corrispondere esattamente all'account; non inventarli mai. I prezzi sono senza IVA a meno che isTaxIncluded sia vero. taxPercentage è richiesto su ogni riga (21 è l'aliquota standard da agosto 2025). Se l'account utilizza codici prodotto, ogni riga ha bisogno di code. Una riga di sconto ha bisogno di numberOfItems e di un discountValue negativo, altrimenti viene silenziosamente ignorata o aggiunta. Per un cliente a Bucuresti la city deve essere Settore 1 a Settore 6, altrimenti e-Factura rifiuta la fattura. Ogni documento, comprese le bozze, conta per i documenti del piano SmartBill.
Errori: il errorText della risposta è la causa, in rumeno (ad esempio Seria nu a fost gasita! per una serie sconosciuta); può contenere HTML, quindi cita solo la sua prima frase. Una richiesta con un campo sconosciuto o di tipo errato riceve risposta 400 con errors[].message e errors[].param che nominano il campo. 401 significa email o token errati, 403 che l'utente non ha diritti sull'azienda o sulla serie.
Limiti: 30 chiamate per 10 secondi per token; superare il limite blocca il token per 10 minuti. Le intestazioni X-RateLimit-Remaining e X-RateLimit-Reset mostrano cosa è rimasto.
Non coperto: la nuova API V3 (liste di clienti, prodotti, magazzini, fornitori e note di ricevimento merci) utilizza un token Bearer separato e non fa parte di questo connettore. Le ricevute fiscali (bon fiscal) necessitano di una cassa e non vengono emesse qui.
Passo 2 — Installa l'adattatore
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Passo 3 — Aggiungi il connettore in Cursor
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
SmartBill.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
smartbill_list_series | Elenca le serie di documenti configurate in SmartBill: list con ogni serie name, il suo nextNumber e type (f fatture, p preventivi e… |
smartbill_list_taxes | Elenca le aliquote IVA configurate in SmartBill: taxes con ogni aliquota name (ad esempio Normala) e percentage. Usa il nome come taxName e il… |
smartbill_list_stocks | Leggi i livelli di stock in una data: list con un'entrata per magazzino (warehouseName, warehouseType en gros o en detail) e i suoi products… |
smartbill_create_invoice | Crea una fattura in SmartBill. Di default viene salvata come bozza (nessun numero), che l'utente controlla e finalizza in SmartBill; con… |
smartbill_create_invoice_from_estimate | Crea una fattura da un preventivo esistente (proforma): cliente e righe vengono copiati dal preventivo. Di default la fattura viene salvata come una… |
smartbill_get_invoice_payment_status | Controlla se una fattura è stata pagata: invoiceTotalAmount (totale con IVA), paidAmount, unpaidAmount e paid (vero quando completamente pagata).… |
smartbill_get_invoice_pdf | Scarica una fattura emessa come file PDF. La risposta è il file stesso, fornito come allegato; l'API non ha vista JSON di un… |
smartbill_send_document_email | Invia una fattura o un preventivo emesso al cliente via email come allegato, con l'oggetto e il testo del modello email configurati in… |
smartbill_reverse_invoice | Emissione di una fattura di storno per una fattura esistente: un nuovo documento fiscale con importi negativi sulla stessa serie. Conta per… |
smartbill_cancel_invoice | Annulla (anulare) una fattura emessa. La fattura mantiene il suo numero ed è contrassegnata come annullata; può essere ripristinata con… |
smartbill_restore_invoice | Ripristina una fattura che è stata annullata, rendendola di nuovo valida. Installata disattivata; conferma con l'utente prima di chiamarla |
smartbill_delete_invoice | Elimina una fattura in modo permanente. Solo l'ultima fattura di una serie può essere eliminata, e questo non può essere annullato. Installata disattivata; conferma… |
smartbill_create_estimate | Crea un preventivo (proforma) in SmartBill. Di default viene salvato come bozza (nessun numero); con is_draft falso viene emesso subito con… |
smartbill_get_estimate_invoices | Controlla se un preventivo (proforma) è stato fatturato: areInvoicesCreated e invoices con la series e il number di ogni fattura emessa… |
smartbill_get_estimate_pdf | Scarica un preventivo (proforma) come file PDF. La risposta è il file stesso, fornito come allegato. Una serie o numero errato è… |
smartbill_cancel_estimate | Annulla un preventivo (proforma). Mantiene il suo numero e può essere ripristinato con smartbill_restore_estimate. Installata disattivata; conferma… |
smartbill_restore_estimate | Ripristina un preventivo (proforma) che è stato annullato. Installata disattivata; conferma con l'utente prima di chiamarla |
smartbill_delete_estimate | Elimina un preventivo (proforma) in modo permanente. Questo non può essere annullato. Installata disattivata; conferma con l'utente prima di chiamarla |
smartbill_register_payment | Registra un pagamento ricevuto da un cliente in SmartBill, eventualmente contro fatture. Il tipo decide cosa viene creato: Chitanta emette un… |
smartbill_get_fiscal_receipt_text | Leggi il contenuto di una ricevuta fiscale (bon fiscal) tramite il suo id: message contiene il testo della ricevuta per la stampante fiscale, codificato in Base64, in… |
smartbill_delete_receipt | Elimina una ricevuta (chitanta) in modo permanente. Solo l'ultima ricevuta di una serie può essere eliminata. Installata disattivata; conferma con l'utente… |
smartbill_delete_payment | Elimina un pagamento registrato che non è una ricevuta (Carta, Ordin plata, CEC e così via). Identificalo tramite la fattura che regola (invoice_series… |
Esempi di prompt
- "Quali serie di documenti e aliquote IVA sono configurate in SmartBill?"
- "Crea una fattura bozza nella serie FCT per SC Exemplu SRL: 10 ore di consulenza a 200 lei più IVA."
- "La fattura FCT 0142 è pagata, e quanto è ancora dovuto?"
- "Trasforma il proforma PRF 0031 in una fattura e inviala al cliente via email."
- "Qual è la giacenza nel magazzino Depozit Central oggi?"
FAQ
Da dove provengono le credenziali? SmartBill Cloud, Contul meu, Integrari, sezione API: copia l'Email, il Token e il CIF dell'azienda. Un connettore funziona su un'azienda; installalo di nuovo per una seconda azienda. Questo è il token V1, non il token Bearer dell'API V3.
Cosa copre? Fatture e preventivi (proforme) come bozze o documenti finali, fatture da preventivi, stato dei pagamenti, PDF, invio di documenti ai clienti, testo della ricevuta fiscale, serie di documenti, aliquote IVA e giacenze per magazzino. L'API V1 non ha lista o ricerca di fatture, clienti o prodotti: un documento è identificato dalla sua serie e numero. Una fattura finale è un documento fiscale che SmartBill invia ad ANAF e-Factura secondo le impostazioni dell'account.
Quali strumenti sono installati disattivati? smartbill_reverse_invoice, smartbill_cancel_invoice, smartbill_restore_invoice, smartbill_delete_invoice, smartbill_cancel_estimate, smartbill_restore_estimate, smartbill_delete_estimate, smartbill_register_payment, smartbill_delete_receipt e smartbill_delete_payment. Attivali nella pagina del connettore solo se l'AI deve usarli. Nessuno strumento addebita una carta o sposta denaro.
Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?