Zusammenfassung
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.
Geführte Einrichtung
SmartBill in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde SmartBill in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten 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.
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
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.
Einrichtung
Die Einrichtung dauert etwa 2 Minuten.
- Melde dich bei SmartBill Cloud an und öffne Contul meu, Integrari, Abschnitt API (https://cloud.smartbill.ro/core/integrari/).
- Kopiere die E-Mail in
SMARTBILL_EMAIL, das Token inSMARTBILL_API_TOKENund die CIF des Unternehmens inSMARTBILL_CIF.
Die Aufrufe verwenden die HTTP-Basisauthentifizierung 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 du anfangen kannst: 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 eine Proforma in eine Rechnung. smartbill_get_invoice_payment_status gibt an, 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 Schätzung per E-Mail an den Kunden. smartbill_reverse_invoice (Storno), smartbill_cancel_invoice, smartbill_restore_invoice und smartbill_delete_invoice sind standardmäßig deaktiviert.
Schätzungen (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 Lagerbezeichnungen 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ürfen, 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 an, was noch verfügbar 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.
Voraussetzungen: SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
Connector lokal 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
Öffne http://localhost:3000/connectors/store, wähle SmartBill und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
smartbill_list_series | Listet die in SmartBill konfigurierten Dokumentenserien auf: list mit jedem Serien name, seiner nextNumber und type (f Rechnungen, p Schätzungen und… |
smartbill_list_taxes | Listet 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_stocks | Liest die Bestandsniveaus an einem Datum: list mit einem Eintrag pro Lager (warehouseName, warehouseType en gros oder en detail) und seinen products… |
smartbill_create_invoice | Erstellt 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_estimate | Erstellt eine Rechnung aus einer bestehenden Schätzung (Proforma): Kunde und Zeilen werden aus der Schätzung 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_pdf | Lä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_email | Sendet eine ausgestellte Rechnung oder Schätzung per E-Mail an den Kunden als Anhang, mit dem Betreff und dem Text der E-Mail-Vorlage, die in… |
smartbill_reverse_invoice | Stellt 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_invoice | Storniert (anulare) eine ausgestellte Rechnung. Die Rechnung behält ihre Nummer und wird als storniert markiert; sie kann mit… |
smartbill_restore_invoice | Stellt eine stornierten Rechnung wieder her, sodass sie wieder gültig ist. Standardmäßig deaktiviert; bestätige mit dem Benutzer, bevor du sie aufrufst |
smartbill_delete_invoice | Lö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_estimate | Erstellt eine Schätzung (Proforma) in SmartBill. Standardmäßig wird sie als Entwurf gespeichert (keine Nummer); mit is_draft false wird sie sofort mit… |
smartbill_get_estimate_invoices | Überprüft, ob eine Schätzung (Proforma) in Rechnung gestellt wurde: areInvoicesCreated und invoices mit der series und number jeder ausgestellten Rechnung… |
smartbill_get_estimate_pdf | Lädt eine Schätzung (Proforma) als PDF-Datei herunter. Die Antwort ist die Datei selbst, die als Anhang übergeben wird. Eine falsche Serie oder Nummer ist… |
smartbill_cancel_estimate | Storniert eine Schätzung (Proforma). Sie behält ihre Nummer und kann mit smartbill_restore_estimate wiederhergestellt werden. Standardmäßig deaktiviert; bestätige… |
smartbill_restore_estimate | Stellt eine stornierten Schätzung (Proforma) wieder her. Standardmäßig deaktiviert; bestätige mit dem Benutzer, bevor du sie aufrufst |
smartbill_delete_estimate | Löscht eine Schätzung (Proforma) dauerhaft. Dies kann nicht rückgängig gemacht werden. Standardmäßig deaktiviert; bestätige mit dem Benutzer, bevor du sie aufrufst |
smartbill_register_payment | Zeichnet eine von einem Kunden erhaltene Zahlung in SmartBill auf, optional gegen Rechnungen. Der Typ entscheidet, was erstellt wird: Chitanta stellt eine… |
smartbill_get_fiscal_receipt_text | Liest den Inhalt eines fiskalischen Belegs (bon fiscal) anhand seiner ID: message enthält den Belegtext für den Fiskaldrucker, Base64-kodiert, in… |
smartbill_delete_receipt | Löscht einen Beleg (chitanta) dauerhaft. Nur der letzte Beleg einer Serie kann gelöscht werden. Standardmäßig deaktiviert; bestätige mit dem Benutzer… |
smartbill_delete_payment | Lö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 die 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?"
Nächste Schritte
War dieser Guide hilfreich?