Zusammenfassung
Bling ERP API v3 (Brasilien): Produkte und Kategorien, Lagerbestände und -bewegungen, Lagerhäuser, Verkaufsbestellungen und -status, Kontakte, NF-e-Lesungen und -Entwürfe, Forderungen und Verbindlichkeiten (lesen). Die Ausstellung von NF-e ist deaktiviert. OAuth 2-Anmeldung mit deiner eigenen Bling-App.
Geführte Einrichtung
Bling in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Bling 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 Bling
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 → Bling, füge die Client-ID und das Client Secret deiner Bling-App ein, klicke auf Authorize with Provider und erlaube den Zugriff in Bling, generiere einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Bling
Bling ERP API v3 (Brasilien): Produkte und Kategorien, Lagerbestände und -bewegungen, Lagerhäuser, Verkaufsbestellungen und -status, Kontakte, NF-e-Lesungen und -Entwürfe, Forderungen und Verbindlichkeiten (lesen). Die Ausstellung von NF-e ist deaktiviert. OAuth 2-Anmeldung mit deiner eigenen Bling-App.
Einrichtung
Die Einrichtung dauert etwa 10 Minuten.
- Öffne in Bling Central de Extensoes, Area do Integrador und klicke auf Criar aplicativo. Wähle die Sichtbarkeit Privado (es funktioniert dann nur mit deinem eigenen Bling-Konto, ohne Überprüfung durch Bling).
- Fülle den Namen und die Kontaktdaten aus. Als Link de redirecionamento gib
https://cloud.anythingmcp.com/api/mcp-oauth/callbackfür AnythingMCP Cloud ein oder<deine AnythingMCP URL>/api/mcp-oauth/callback, wenn du AnythingMCP selbst hostest. - Wähle die Scopes, die dieser Connector benötigt: Produkte, Lager, Lagerhäuser, Verkaufsbestellungen, Kontakte, NF-e, Forderungen und Verbindlichkeiten, Zahlungsmethoden, Status und Unternehmensdaten. Speichern. Änderungen an den Scopes melden alle Benutzer ab.
- Kopiere im Tab Informacoes do app die Client-ID und das Client Secret in
BLING_CLIENT_IDundBLING_CLIENT_SECRET, speichere den Connector und klicke auf Authorize with Provider, melde dich dann bei Bling an und erlaube den Zugriff.
Zugangstoken halten 6 Stunden und werden mit dem Refresh-Token erneuert, das 30 Tage hält: Ein Connector, der länger als das nicht verwendet wird, benötigt erneut Authorize with Provider. Bling blockiert eine Adresse für eine Stunde nach 20 Token-Anfragen in einer Minute, also versuche nicht, die Anmeldung in einer Schleife zu wiederholen.
Wo du anfangen kannst: bling_get_company überprüft die Verbindung. Dann bling_list_orders (nach Datum oder Status filtern) und bling_get_order, oder bling_list_products und bling_get_product.
Produkte und Lager: bling_list_products, bling_get_product, bling_create_product, bling_update_product, bling_list_product_categories, bling_get_stock_balances, bling_get_warehouse_stock_balances, bling_create_stock_movement, bling_list_warehouses. bling_delete_product ist standardmäßig deaktiviert. saldoVirtual ist der physische Lagerbestand minus das, was offene Bestellungen reservieren.
Verkaufsbestellungen: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Status-IDs unterscheiden sich je nach Konto: Lies sie mit bling_list_status_modules (Modul Vendas) und bling_list_statuses. bling_delete_order ist standardmäßig deaktiviert. Kein Tool verbucht Forderungen oder begleicht Zahlungen.
Kontakte: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (ersetzt den gesamten Kontakt: lies ihn zuerst).
NF-e: bling_list_invoices, bling_get_invoice (mit DANFE- und XML-Links), bling_generate_invoice_from_order (erstellt nur einen ausstehenden Entwurf). bling_send_invoice, das die NF-e an SEFAZ überträgt, ist standardmäßig deaktiviert: Eine autorisierte NF-e ist ein Steuerdokument. Schalte es nur absichtlich ein.
Finanzen (nur lesen): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. Der Connector bewegt niemals Geld: keine Abrechnung (baixa), boleto oder Pix-Aktion ist enthalten.
Feldnotizen: IDs sind Zahlen. Beträge sind in BRL mit einem Dezimalpunkt. Daten sind YYYY-MM-DD; ein Datumsbereich kann höchstens ein Jahr umfassen. CPF und CNPJ werden als Ziffern angegeben. Antworten sind in data eingekapselt; Fehler enthalten error.type, error.message, error.description und error.fields, die das ungültige Feld benennen.
Paging und Limits: Listen nehmen pagina von 1 und limite bis zu 100; eine leere data-Liste ist das Ende. Bling erlaubt 3 Anfragen pro Sekunde und 120.000 pro Tag und Konto (429 darüber); 300 Fehler oder 600 Anfragen innerhalb von 10 Sekunden blockieren die Adresse für 10 Minuten, also wiederhole keine fehlgeschlagenen Aufrufe in einer Schleife.
Voraussetzungen: BLING_CLIENT_ID, BLING_CLIENT_SECRET
Installiere den Connector lokal
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 Bling und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
bling_get_company | Hole die Basisdaten des Bling-Kontos, bei dem der Connector angemeldet ist: id, nome (Firmenname), cnpj, email und dataContrato. Ein günstiger Aufruf… |
bling_list_products | Liste Produkte auf: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (virtueller Bestand), tipo, situacao, formato, descricaoCurta… |
bling_get_product | Hole ein Produkt mit allen Details: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque… |
bling_create_product | Erstelle ein Produkt oder eine Dienstleistung. nome, tipo, situacao und formato sind erforderlich. Gibt data.id des neuen Produkts (und seiner Varianten) zurück. Steuer… |
bling_update_product | Ändere ein Produkt (PATCH: nur die gesendeten Felder ändern): name, SKU, preis, status, einheit, GTIN, marke, kurze beschreibung, gewichte oder kategorie.… |
bling_delete_product | Lösche ein Produkt dauerhaft. Produkte, die in Bestellungen oder Rechnungen verwendet werden, können abgelehnt werden; bevorzuge es, situacao auf I zu setzen. Standardmäßig deaktiviert |
bling_list_product_categories | Liste Produktkategorien auf: id, descricao und categoriaPai (Eltern). Bis zu 100 pro Seite |
bling_get_stock_balances | Hole Lagerbestände von Produkten über alle Lagerhäuser: pro Produkt saldoFisicoTotal (physisch), saldoVirtualTotal (physisch minus reserviert… |
bling_get_warehouse_stock_balances | Hole Lagerbestände von Produkten in einem Lagerhaus (deposito): saldoFisico und saldoVirtual pro Produkt |
bling_create_stock_movement | Zeichne eine Lagerbewegung für ein Produkt in einem Lagerhaus auf: E entrada (rein), S saida (raus) oder B balanco (setze den Bestand auf die Menge). Gibt… |
bling_list_warehouses | Liste Lagerhäuser (depositos) auf: id, descricao, situacao, padrao (Standard) und desconsiderarSaldo |
bling_list_orders | Liste Verkaufsbestellungen (pedidos de venda) auf: id, numero, numeroLoja (Marktplatz-Bestellnummer), data, dataSaida, dataPrevista, totalProdutos… |
bling_get_order | Hole eine Verkaufsbestellung: numero, numeroLoja, daten, contato, situacao, loja, itens (produto, codigo, descricao, quantidade, valor, desconto)… |
bling_create_order | Erstelle eine Verkaufsbestellung. Erforderlich: contato (id), data, dataSaida, dataPrevista, itens und parcelas. Gibt data.id zurück. Die Erstellung der Bestellung… |
bling_update_order_status | Ändere den Status (situacao) einer Verkaufsbestellung, zum Beispiel auf Em andamento oder Atendido. Gültige Status-IDs stammen von bling_list_statuses für… |
bling_delete_order | Lösche eine Verkaufsbestellung dauerhaft. Kann nicht rückgängig gemacht werden. Standardmäßig deaktiviert |
bling_list_status_modules | Liste die Bling-Module auf, die Status (situacoes) haben: id, nome und descricao, zum Beispiel Vendas (Verkaufsbestellungen). Verwende die ID mit… |
bling_list_statuses | Liste die Status eines Moduls auf: id, nome, cor und idHerdado (der Standardstatus, von dem er abgeleitet ist). Die IDs sind das, was bling_list_orders und… |
bling_list_contacts | Liste Kontakte (Kunden, Lieferanten und andere) auf: id, nome, codigo, situacao, numeroDocumento (CPF oder CNPJ), telefone und celular. Suche nach… |
bling_get_contact | Hole einen Kontakt: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral und… |
bling_create_contact | Erstelle einen Kontakt (Kunde oder Lieferant). nome, tipo und situacao sind erforderlich. Gibt data.id zurück |
bling_update_contact | Ersetze einen Kontakt (PUT: der gesamte Kontakt wird neu geschrieben, ausgelassene Felder können geleert werden). Lies ihn zuerst mit bling_get_contact, ändere was… |
bling_list_invoices | Liste NF-e (elektronische Rechnungen) auf: id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato… |
bling_get_invoice | Hole eine NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens mit Steuern, transporte, parcelas, valorNota, xml (link)… |
bling_generate_invoice_from_order | Erstelle einen ausstehenden NF-e-Entwurf aus einer Verkaufsbestellung (situacao pendente). Es wird nicht an SEFAZ gesendet: die Ausstellung ist ein separater Schritt, der in Bling oder… |
bling_send_invoice | Stelle eine NF-e aus: übertrage sie an SEFAZ zur Genehmigung. Eine autorisierte NF-e ist ein rechtliches Steuerdokument, das nur innerhalb der… |
bling_list_receivables | Liste Forderungen (contas a receber) auf: id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (die Bestellung oder… |
bling_get_receivable | Hole eine Forderung: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto und Pix… |
bling_list_payables | Liste Verbindlichkeiten (contas a pagar) auf: id, situacao, vencimento, valor, contato und origem. Nur lesen. Bis zu 100 pro Seite |
bling_list_payment_methods | Liste Zahlungsmethoden (formas de pagamento) auf: id, descricao, tipoPagamento und situacao. Die ID geht in die parcelas einer Bestellung |
Beispielaufforderungen
- "Welche Verkaufsbestellungen von heute sind noch offen?"
- "Wie hoch ist der Lagerbestand des Produkts SKU CAM-PRETA-M in jedem Lager?"
- "Erstelle einen Entwurf für eine NF-e aus der Verkaufsbestellung 15873."
- "Welche Forderungen sind diese Woche fällig und wie viel in BRL?"
- "Bewege die Bestellung 15873 in den Status Em andamento."
Nächste Schritte
War dieser Guide hilfreich?