In breve
SmartBill Cloud API per la fatturazione romena: emetti fatture e preventivi (proforme) come bozze o documenti finali, crea una fattura da un preventivo, controlla lo stato di pagamento, scarica PDF, invia documenti ai clienti e leggi serie di documenti, aliquote IVA e stock per magazzino. Le operazioni di storno, annullamento, eliminazione e registrazione dei pagamenti sono disattivate. Email e token API.
Configurazione guidata
Collega SmartBill a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega SmartBill con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. 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 Connectors → SmartBill, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
SmartBill
SmartBill Cloud API per la fatturazione romena: emetti fatture e preventivi (proforme) come bozze o documenti finali, crea una fattura da un preventivo, controlla lo stato di pagamento, scarica PDF, invia documenti ai clienti e leggi serie di documenti, aliquote IVA e stock per magazzino. Le operazioni di storno, annullamento, eliminazione e registrazione dei pagamenti sono disattivate. Email e token API.
Configurazione
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 una sola azienda; installalo di nuovo per una seconda azienda.
Da 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 un elenco o una 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 il series, number e documentViewUrl di ciò che crei.
Fatture: smartbill_create_invoice salva una bozza a meno che is_draft non sia falso. Una fattura finale ottiene 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 una 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 (è stata fatturata), smartbill_get_estimate_pdf; smartbill_cancel_estimate, smartbill_restore_estimate e smartbill_delete_estimate sono disattivati.
Pagamenti: smartbill_get_fiscal_receipt_text legge una 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.
Stock: 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 non 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 romeno (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 un tipo errato riceve una 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 questo 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 (elenco di clienti, prodotti, magazzini, fornitori e note di ricevimento merci) utilizza un token Bearer separato ed è al di fuori di questo connettore. Le ricevute fiscali (bon fiscal) necessitano di una cassa e non vengono emesse qui.
Prerequisiti: SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli SmartBill e incolla le variabili d'ambiente elencate sotto Prerequisiti.
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 es. 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 (senza 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 una 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 di email configurato 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. Installato disattivato; conferma con l'utente prima di chiamarlo |
smartbill_delete_invoice | Elimina una fattura permanentemente. Solo l'ultima fattura di una serie può essere eliminata, e questa operazione non può essere annullata. Installato disattivato; conferma… |
smartbill_create_estimate | Crea un preventivo (proforma) in SmartBill. Di default viene salvato come bozza (senza 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 un numero errati sono… |
smartbill_cancel_estimate | Annulla un preventivo (proforma). Mantiene il suo numero e può essere ripristinato con smartbill_restore_estimate. Installato disattivato; conferma… |
smartbill_restore_estimate | Ripristina un preventivo (proforma) che è stato annullato. Installato disattivato; conferma con l'utente prima di chiamarlo |
smartbill_delete_estimate | Elimina un preventivo (proforma) permanentemente. Questa operazione non può essere annullata. Installato disattivato; conferma con l'utente prima di chiamarlo |
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) permanentemente. Solo l'ultima ricevuta di una serie può essere eliminata. Installato disattivato; 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 richieste
- "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 la proforma PRF 0031 in una fattura e inviala al cliente via email."
- "Qual è lo stock nel magazzino Depozit Central oggi?"
Prossimi passi
Questa guida ti è stata utile?