Guida al connettore9 minuti di lettura22 tool MCP7 lingue

Collegare SmartBill a Claude via MCP

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.

HCA cura del team HelpCodeAggiornato 9 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

SmartBill

SmartBill

SmartBill Cloud API for Romanian invoicing: issue invoices and estimates (proforme) as drafts or final documents, create an invoice from an estimate, check payment status, download PDFs, email documents to clients, and read document series, VAT rates and stock by warehouse. Reversal, cancel, delete and payment registration are switched off. Email and API token.

tool

22

Regione

RO

Categoria

Contabilità

Autenticazione

Basic Auth

Env vars richieste

SMARTBILL_EMAILSMARTBILL_API_TOKENSMARTBILL_CIF
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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 Claude in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega SmartBill con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.

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.

SmartBill · live via MCP
Condividi
Opus 4.7

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 + Claude

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.

  1. Accedi a SmartBill Cloud e apri Contul meu, Integrari, sezione API (https://cloud.smartbill.ro/core/integrari/).
  2. Copia l'Email in SMARTBILL_EMAIL, il Token in SMARTBILL_API_TOKEN e il CIF dell'azienda in SMARTBILL_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 Claude

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 mostri YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.

  1. In Claude apri Plugins (in alcuni piani ancora Customize) → Connectors.
  2. Clicca + Add e poi Add custom connector.
  3. Inserisci un nome, ad esempio SmartBill, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Continue, mantieni le impostazioni rilevate e clicca di nuovo Continue.
  4. Scegli Sign in now, clicca Add e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.

Strumenti disponibili

StrumentoCosa fa
smartbill_list_seriesElenca le serie di documenti configurate in SmartBill: list con ogni serie name, il suo nextNumber e type (f fatture, p preventivi e…
smartbill_list_taxesElenca 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_stocksLeggi 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_invoiceCrea 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_estimateCrea 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_statusControlla se una fattura è stata pagata: invoiceTotalAmount (totale con IVA), paidAmount, unpaidAmount e paid (vero quando completamente pagata).…
smartbill_get_invoice_pdfScarica 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_emailInvia 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_invoiceEmissione di una fattura di storno per una fattura esistente: un nuovo documento fiscale con importi negativi sulla stessa serie. Conta per…
smartbill_cancel_invoiceAnnulla (anulare) una fattura emessa. La fattura mantiene il suo numero ed è contrassegnata come annullata; può essere ripristinata con…
smartbill_restore_invoiceRipristina una fattura che è stata annullata, rendendola di nuovo valida. Installata disattivata; conferma con l'utente prima di chiamarla
smartbill_delete_invoiceElimina 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_estimateCrea un preventivo (proforma) in SmartBill. Di default viene salvato come bozza (nessun numero); con is_draft falso viene emesso subito con…
smartbill_get_estimate_invoicesControlla se un preventivo (proforma) è stato fatturato: areInvoicesCreated e invoices con la series e il number di ogni fattura emessa…
smartbill_get_estimate_pdfScarica un preventivo (proforma) come file PDF. La risposta è il file stesso, fornito come allegato. Una serie o numero errato è…
smartbill_cancel_estimateAnnulla un preventivo (proforma). Mantiene il suo numero e può essere ripristinato con smartbill_restore_estimate. Installata disattivata; conferma…
smartbill_restore_estimateRipristina un preventivo (proforma) che è stato annullato. Installata disattivata; conferma con l'utente prima di chiamarla
smartbill_delete_estimateElimina un preventivo (proforma) in modo permanente. Questo non può essere annullato. Installata disattivata; conferma con l'utente prima di chiamarla
smartbill_register_paymentRegistra un pagamento ricevuto da un cliente in SmartBill, eventualmente contro fatture. Il tipo decide cosa viene creato: Chitanta emette un…
smartbill_get_fiscal_receipt_textLeggi 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_receiptElimina una ricevuta (chitanta) in modo permanente. Solo l'ultima ricevuta di una serie può essere eliminata. Installata disattivata; conferma con l'utente…
smartbill_delete_paymentElimina 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

Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

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.

Prossimi passi

Questa guida ti è stata utile?

Collega SmartBill a Claude in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega SmartBill con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare SmartBill a ChatGPT via MCP

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.

Connettori

Collegare SmartBill a Microsoft Copilot via MCP

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.

Connettori

Collegare SmartBill a Cursor via MCP

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.

Connettori

Collegare SmartBill a Gemini CLI via MCP

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.

Connettori

Collegare SmartBill a Meta Muse via MCP

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.

Connettori

SmartBill MCP Server: fatture e magazzino

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.