Guida al connettore7 minuti di lettura22 tool MCP7 lingue

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.

HCA cura del team HelpCodeAggiornato 7 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 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.

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

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

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 es. 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 (senza 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 una 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 di email configurato 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. Installato disattivato; conferma con l'utente prima di chiamarlo
smartbill_delete_invoiceElimina 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_estimateCrea un preventivo (proforma) in SmartBill. Di default viene salvato come bozza (senza 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 un numero errati sono…
smartbill_cancel_estimateAnnulla un preventivo (proforma). Mantiene il suo numero e può essere ripristinato con smartbill_restore_estimate. Installato disattivato; conferma…
smartbill_restore_estimateRipristina un preventivo (proforma) che è stato annullato. Installato disattivato; conferma con l'utente prima di chiamarlo
smartbill_delete_estimateElimina un preventivo (proforma) permanentemente. Questa operazione non può essere annullata. Installato disattivato; conferma con l'utente prima di chiamarlo
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) permanentemente. Solo l'ultima ricevuta di una serie può essere eliminata. Installato disattivato; 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 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?

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.

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

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.