Connector-Anleitung8 Minuten Lesezeit22 MCP-Tools7 Sprachen

SmartBill MCP mit Gemini CLI verbinden

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

HCVom HelpCode-TeamAktualisiert 8 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

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.

Tools

22

Region

RO

Kategorie

Buchhaltung

Authentifizierung

Basic Auth

Benötigte Env-Vars

SMARTBILL_EMAILSMARTBILL_API_TOKENSMARTBILL_CIF
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

Zusammenfassung

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

Geführte Einrichtung

SmartBill in 2 Minuten mit Gemini verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde SmartBill in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Frag einfach

Beispiel-Prompts für SmartBill

Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.

SmartBill · live via MCP
Teilen
Opus 4.7

Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → SmartBill, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

SmartBill + Gemini

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF

Schritt 1 — Zugangsdaten erhalten

Die Einrichtung dauert etwa 2 Minuten.

  1. Melde dich bei SmartBill Cloud an und öffne Contul meu, Integrari, Abschnitt API (https://cloud.smartbill.ro/core/integrari/).
  2. Kopiere die E-Mail in SMARTBILL_EMAIL, das Token in SMARTBILL_API_TOKEN und die CIF des Unternehmens in SMARTBILL_CIF.

Die Aufrufe verwenden die HTTP Basic-Authentifizierung mit der E-Mail als Benutzer und dem Token als Passwort. Der Connector fügt die Unternehmens-CIF zu jedem Aufruf hinzu, sodass ein Connector für ein Unternehmen funktioniert; installiere ihn erneut für ein zweites Unternehmen.

Wo anfangen: smartbill_list_series (die Seriennamen, die jedes Dokument benötigt) und smartbill_list_taxes (die Namen der Mehrwertsteuersätze). Dann smartbill_create_invoice oder smartbill_create_estimate.

Was die API nicht kann: V1 hat keine Liste oder Suche nach Rechnungen, Kunden oder Produkten und keine JSON-Ansicht eines Dokuments. Ein Dokument wird durch seine Serie und Nummer adressiert, die der Benutzer angibt oder die der Erstellungsaufruf zurückgegeben hat. Behalte die series, number und documentViewUrl von dem, was du erstellst.

Rechnungen: smartbill_create_invoice speichert einen Entwurf, es sei denn, is_draft ist falsch. Eine endgültige Rechnung erhält die nächste Nummer der Serie und ist ein fiskalisches Dokument: SmartBill sendet sie an ANAF e-Factura gemäß den Kontoeinstellungen, die diese API nicht steuert. smartbill_create_invoice_from_estimate verwandelt einen Proforma in eine Rechnung. smartbill_get_invoice_payment_status zeigt, was bezahlt ist und was fällig ist, smartbill_get_invoice_pdf lädt die Datei herunter, smartbill_send_document_email sendet eine Rechnung oder einen Kostenvoranschlag per E-Mail an den Kunden. smartbill_reverse_invoice (Storno), smartbill_cancel_invoice, smartbill_restore_invoice und smartbill_delete_invoice sind standardmäßig deaktiviert.

Kostenvoranschläge (Proforma): smartbill_create_estimate, smartbill_get_estimate_invoices (wurde es in Rechnung gestellt), smartbill_get_estimate_pdf; smartbill_cancel_estimate, smartbill_restore_estimate und smartbill_delete_estimate sind deaktiviert.

Zahlungen: smartbill_get_fiscal_receipt_text liest einen fiskalischen Beleg. smartbill_register_payment (zeichnet eine Zahlung auf oder stellt einen Beleg aus), smartbill_delete_receipt und smartbill_delete_payment sind deaktiviert. Nichts hier belastet eine Karte oder bewegt Geld: Zahlungen sind Buchhaltungsunterlagen.

Bestand: smartbill_list_stocks gibt Mengen pro Lager (gestiune) an einem Datum zurück; die Lagernamen sind groß- und kleinschreibungsempfindlich.

Ein Dokument schreiben: seriesName, taxName und measuringUnitName müssen genau mit dem Konto übereinstimmen; erfinde sie niemals. Preise sind ohne Mehrwertsteuer, es sei denn, isTaxIncluded ist wahr. taxPercentage ist für jede Zeile erforderlich (21 ist der Standardsteuersatz seit August 2025). Wenn das Konto Produktcodes verwendet, benötigt jede Zeile code. Eine Rabattzeile benötigt numberOfItems und einen negativen discountValue, andernfalls wird sie stillschweigend ignoriert oder hinzugefügt. Für einen Kunden in Bukarest muss die city Sektor 1 bis Sektor 6 sein, sonst lehnt e-Factura die Rechnung ab. Jedes Dokument, einschließlich Entwürfe, zählt zu den Dokumenten des SmartBill-Plans.

Fehler: Der errorText der Antwort ist die Ursache, auf Rumänisch (zum Beispiel Seria nu a fost gasita! für eine unbekannte Serie); er kann HTML enthalten, also zitiere nur seinen ersten Satz. Eine Anfrage mit einem unbekannten Feld oder einem falschen Typ wird mit 400 beantwortet, wobei errors[].message und errors[].param das Feld benennen. 401 bedeutet falsche E-Mail oder Token, 403, dass der Benutzer kein Recht auf das Unternehmen oder die Serie hat.

Limits: 30 Aufrufe pro 10 Sekunden pro Token; Überschreitungen blockieren das Token für 10 Minuten. Die Header X-RateLimit-Remaining und X-RateLimit-Reset zeigen, was übrig ist.

Nicht abgedeckt: Die neuere API V3 (Listen von Kunden, Produkten, Lagern, Lieferanten und Wareneingangsnotizen) verwendet ein separates Bearer-Token und ist nicht Teil dieses Connectors. Fiskalische Belege (bon fiscal) benötigen eine Registrierkasse und werden hier nicht ausgestellt.

Schritt 2 — Adapter installieren

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

Schritt 3 — Den Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
  2. Speichere die Datei und starte gemini neu.
  3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
  4. Leg los: Gemini CLI kann jetzt die SmartBill-Tools aufrufen.

Verfügbare Tools

ToolWas es tut
smartbill_list_seriesListet die in SmartBill konfigurierten Dokumentenserien auf: list mit jedem Serien name, seiner nextNumber und type (f Rechnungen, p Kostenvoranschläge und…
smartbill_list_taxesListet die in SmartBill konfigurierten Mehrwertsteuersätze auf: taxes mit jedem Satz name (z.B. Normala) und percentage. Verwende den Namen als taxName und die…
smartbill_list_stocksLiest die Bestände an einem Datum: list mit einem Eintrag pro Lager (warehouseName, warehouseType en gros oder en detail) und seinen products…
smartbill_create_invoiceErstellt eine Rechnung in SmartBill. Standardmäßig wird sie als Entwurf gespeichert (keine Nummer), die der Benutzer in SmartBill überprüft und finalisiert; mit…
smartbill_create_invoice_from_estimateErstellt eine Rechnung aus einem bestehenden Kostenvoranschlag (Proforma): Kunde und Zeilen werden vom Kostenvoranschlag kopiert. Standardmäßig wird die Rechnung als…
smartbill_get_invoice_payment_statusÜberprüft, ob eine Rechnung bezahlt ist: invoiceTotalAmount (gesamt mit Mehrwertsteuer), paidAmount, unpaidAmount und paid (wahr, wenn vollständig bezahlt).…
smartbill_get_invoice_pdfLädt eine ausgestellte Rechnung als PDF-Datei herunter. Die Antwort ist die Datei selbst, die als Anhang übergeben wird; die API hat keine JSON-Ansicht eines…
smartbill_send_document_emailSendet eine ausgestellte Rechnung oder einen Kostenvoranschlag per E-Mail an den Kunden als Anhang, mit dem Betreff und dem Text der E-Mail-Vorlage, die in…
smartbill_reverse_invoiceStellt eine Rückbuchungsrechnung (Storno) für eine bestehende Rechnung aus: ein neues fiskalisches Dokument mit negativen Beträgen auf derselben Serie. Es zählt zu…
smartbill_cancel_invoiceStorniert (anulare) eine ausgestellte Rechnung. Die Rechnung behält ihre Nummer und wird als storniert markiert; sie kann mit…
smartbill_restore_invoiceStellt eine stornierte Rechnung wieder her, sodass sie wieder gültig ist. Standardmäßig deaktiviert; bestätige dies mit dem Benutzer, bevor du sie aufrufst.
smartbill_delete_invoiceLöscht eine Rechnung dauerhaft. Nur die letzte Rechnung einer Serie kann gelöscht werden, und dies kann nicht rückgängig gemacht werden. Standardmäßig deaktiviert; bestätige…
smartbill_create_estimateErstellt einen Kostenvoranschlag (Proforma) in SmartBill. Standardmäßig wird er als Entwurf gespeichert (keine Nummer); mit is_draft false wird er sofort mit…
smartbill_get_estimate_invoicesÜberprüft, ob ein Kostenvoranschlag (Proforma) in Rechnung gestellt wurde: areInvoicesCreated und invoices mit der series und number jeder ausgestellten Rechnung…
smartbill_get_estimate_pdfLädt einen Kostenvoranschlag (Proforma) als PDF-Datei herunter. Die Antwort ist die Datei selbst, die als Anhang übergeben wird. Eine falsche Serie oder Nummer wird…
smartbill_cancel_estimateStorniert einen Kostenvoranschlag (Proforma). Er behält seine Nummer und kann mit smartbill_restore_estimate wiederhergestellt werden. Standardmäßig deaktiviert; bestätige…
smartbill_restore_estimateStellt einen stornierten Kostenvoranschlag (Proforma) wieder her. Standardmäßig deaktiviert; bestätige dies mit dem Benutzer, bevor du ihn aufrufst.
smartbill_delete_estimateLöscht einen Kostenvoranschlag (Proforma) dauerhaft. Dies kann nicht rückgängig gemacht werden. Standardmäßig deaktiviert; bestätige dies mit dem Benutzer, bevor du ihn aufrufst.
smartbill_register_paymentZeichnet eine Zahlung, die von einem Kunden in SmartBill erhalten wurde, optional gegen Rechnungen auf. Der Typ entscheidet, was erstellt wird: Chitanta stellt eine…
smartbill_get_fiscal_receipt_textLiest den Inhalt eines fiskalischen Belegs (bon fiscal) anhand seiner ID: message enthält den Belegtext für den Fiskaldrucker, Base64-kodiert, in…
smartbill_delete_receiptLöscht einen Beleg (chitanta) dauerhaft. Nur der letzte Beleg einer Serie kann gelöscht werden. Standardmäßig deaktiviert; bestätige dies mit dem Benutzer…
smartbill_delete_paymentLöscht eine aufgezeichnete Zahlung, die kein Beleg ist (Karte, Ordin plata, CEC usw.). Identifiziere sie anhand der Rechnung, die sie begleicht (invoice_series…

Beispielaufforderungen

  • "Welche Dokumentenserien und Mehrwertsteuersätze sind in SmartBill eingerichtet?"
  • "Erstelle eine Entwurfsrechnung in der Serie FCT für SC Exemplu SRL: 10 Stunden Beratung zu 200 Lei zuzüglich Mehrwertsteuer."
  • "Ist die Rechnung FCT 0142 bezahlt, und wie viel ist noch fällig?"
  • "Verwandle den Proforma PRF 0031 in eine Rechnung und sende sie per E-Mail an den Kunden."
  • "Wie hoch ist der Bestand im Lager Depozit Central heute?"

FAQ

Woher kommen die Zugangsdaten? SmartBill Cloud, Contul meu, Integrari, Abschnitt API: kopiere die E-Mail, das Token und die CIF des Unternehmens. Ein Connector funktioniert für ein Unternehmen; installiere ihn erneut für ein zweites Unternehmen. Dies ist das V1-Token, nicht das Bearer-Token der API V3.

Was deckt es ab? Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente, Rechnungen aus Kostenvoranschlägen, Zahlungsstatus, PDFs, das Versenden von Dokumenten an Kunden, fiskalischen Belegtext, Dokumentenserien, Mehrwertsteuersätze und Bestände pro Lager. Die API V1 hat keine Liste oder Suche nach Rechnungen, Kunden oder Produkten: Ein Dokument wird durch seine Serie und Nummer adressiert. Eine endgültige Rechnung ist ein fiskalisches Dokument, das SmartBill gemäß den Kontoeinstellungen an ANAF e-Factura sendet.

Welche Tools sind standardmäßig deaktiviert? 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 und smartbill_delete_payment. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll. Kein Tool belastet eine Karte oder bewegt Geld.

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

War dieser Guide hilfreich?

SmartBill in 2 Minuten mit Gemini verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde SmartBill in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.

Verwandte Anleitungen

Connectors

SmartBill MCP mit ChatGPT verbinden

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

Connectors

SmartBill MCP mit Claude verbinden

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

Connectors

SmartBill MCP mit Microsoft Copilot verbinden

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

Connectors

SmartBill MCP mit Cursor verbinden

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

Connectors

SmartBill MCP mit Meta Muse verbinden

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Kostenvoranschläge (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einem Kostenvoranschlag erstellen, den Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.

Connectors

SmartBill MCP-Server für Rechnungen und Lager

SmartBill Cloud API für rumänische Rechnungsstellung: Rechnungen und Schätzungen (Proforma) als Entwürfe oder endgültige Dokumente ausstellen, eine Rechnung aus einer Schätzung erstellen, Zahlungsstatus überprüfen, PDFs herunterladen, Dokumente an Kunden per E-Mail senden und Dokumentenserien, Mehrwertsteuersätze und Bestände nach Lager lesen. Rückbuchung, Stornierung, Löschung und Zahlungsregistrierung sind deaktiviert. E-Mail und API-Token.