Кратко
Bling ERP API v3 (Бразилия): продукты и категории, остатки и движения запасов, склады, заказы на продажу и статусы, контакты, чтение и черновики NF-e, дебиторская и кредиторская задолженность (чтение). Выпуск NF-e отключен. Вход по OAuth 2 с использованием вашего приложения Bling.
Пошаговая настройка
Подключи Bling к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Bling в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Bling
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Bling, вставь Client ID и Client Secret своего приложения Bling, нажми Authorize with Provider и разреши доступ в Bling, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Bling
Bling ERP API v3 (Бразилия): продукты и категории, остатки и движения запасов, склады, заказы на продажу и статусы, контакты, чтение и черновики NF-e, дебиторская и кредиторская задолженность (чтение). Выпуск NF-e отключен. Вход по OAuth 2 с использованием вашего приложения Bling.
Настройка
Настройка занимает около 10 минут.
- В Bling открой Central de Extensoes, Area do Integrador и нажми Criar aplicativo. Выбери видимость Privado (тогда оно будет работать только с твоим аккаунтом Bling, без проверки Bling).
- Заполни название и контактные данные. В качестве Link de redirecionamento введи
https://cloud.anythingmcp.com/api/mcp-oauth/callbackна AnythingMCP Cloud, или<your AnythingMCP URL>/api/mcp-oauth/callback, если ты сам хостишь AnythingMCP. - Выбери scopes, которые нужны этому коннектору: продукты, запасы, склады, заказы на продажу, контакты, NF-e, дебиторская и кредиторская задолженность, методы оплаты, статусы и данные компании. Сохрани. Изменение scopes позже выведет всех пользователей из системы.
- На вкладке Informacoes do app скопируй Client ID и Client Secret в
BLING_CLIENT_IDиBLING_CLIENT_SECRET, сохрани коннектор и нажми Authorize with Provider, затем войди в Bling и разреши доступ.
Токены доступа действуют 6 часов и обновляются с помощью refresh token, который действует 30 дней: коннектор, не использовавшийся дольше этого времени, нуждается в Authorize with Provider снова. Bling блокирует адрес на час после 20 запросов токенов за минуту, поэтому не пытайся повторно войти в систему в цикле.
С чего начать: bling_get_company проверяет соединение. Затем bling_list_orders (фильтр по дате или статусу) и bling_get_order, или bling_list_products и bling_get_product.
Продукты и запасы: 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 установлен отключенным. saldoVirtual — это физический запас минус то, что резервируют открытые заказы.
Заказы на продажу: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Идентификаторы статусов различаются для каждого аккаунта: читай их с помощью bling_list_status_modules (модуль Vendas) и bling_list_statuses. bling_delete_order установлен отключенным. Никакой инструмент не публикует дебиторскую задолженность или не производит расчеты.
Контакты: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (заменяет весь контакт: сначала прочитай его).
NF-e: bling_list_invoices, bling_get_invoice (с ссылками на DANFE и XML), bling_generate_invoice_from_order (создает только ожидающий черновик). bling_send_invoice, который передает NF-e в SEFAZ, установлен отключенным: авторизованный NF-e является налоговым документом. Включай его только осознанно.
Финансы (только для чтения): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. Коннектор никогда не перемещает деньги: никаких расчетов (baixa), boleto или действий Pix не предусмотрено.
Полевые заметки: идентификаторы — это числа. Суммы в BRL с десятичной точкой. Даты в формате YYYY-MM-DD; диапазон дат может охватывать не более одного года. CPF и CNPJ указываются как цифры. Ответы обернуты в data; ошибки содержат error.type, error.message, error.description и error.fields, указывая на недействительное поле.
Пагинация и лимиты: списки принимают pagina от 1 и limite до 100; пустой список data означает конец. Bling позволяет 3 запроса в секунду и 120,000 в день на аккаунт (429 выше); 300 ошибок или 600 запросов в течение 10 секунд блокируют адрес на 10 минут, поэтому не повторяй неудачные вызовы в цикле.
Предварительные требования: BLING_CLIENT_ID, BLING_CLIENT_SECRET
Установка коннектора локально
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
Открой http://localhost:3000/connectors/store, выбери Bling и вставь переменные окружения, указанные в предварительных требованиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
bling_get_company | Получает основные данные аккаунта Bling, в который вошел коннектор: id, nome (название компании), cnpj, email и dataContrato. Дешевый вызов… |
bling_list_products | Список продуктов: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (виртуальный баланс), tipo, situacao, formato, descricaoCurta… |
bling_get_product | Получает один продукт со всеми деталями: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque… |
bling_create_product | Создает продукт или услугу. nome, tipo, situacao и formato обязательны. Возвращает data.id нового продукта (и его вариаций). Налог… |
bling_update_product | Изменяет продукт (PATCH: изменяются только отправленные поля): name, SKU, price, status, unit, GTIN, brand, short description, weights или category.… |
bling_delete_product | Удаляет продукт навсегда. Продукты, использованные в заказах или счетах, могут быть отклонены; предпочтительнее установить situacao I. Установлен отключенным |
bling_list_product_categories | Список категорий продуктов: id, descricao и categoriaPai (родитель). До 100 на странице |
bling_get_stock_balances | Получает остатки запасов продуктов по всем складам: по продукту saldoFisicoTotal (физический), saldoVirtualTotal (физический минус зарезервированный… |
bling_get_warehouse_stock_balances | Получает остатки запасов продуктов на одном складе (deposito): saldoFisico и saldoVirtual по продукту |
bling_create_stock_movement | Регистрирует движение запасов для продукта на складе: E entrada (вход), S saida (выход) или B balanco (устанавливает баланс на количество). Возвращает… |
bling_list_warehouses | Список складов (depositos): id, descricao, situacao, padrao (по умолчанию) и desconsiderarSaldo |
bling_list_orders | Список заказов на продажу (pedidos de venda): id, numero, numeroLoja (номер заказа на маркетплейсе), data, dataSaida, dataPrevista, totalProdutos… |
bling_get_order | Получает один заказ на продажу: numero, numeroLoja, даты, contato, situacao, loja, itens (produto, codigo, descricao, quantidade, valor, desconto)… |
bling_create_order | Создает заказ на продажу. Обязательные поля: contato (id), data, dataSaida, dataPrevista, itens и parcelas. Возвращает data.id. Создание заказа не… |
bling_update_order_status | Изменяет статус (situacao) заказа на продажу, например, на Em andamento или Atendido. Действительные идентификаторы статусов берутся из bling_list_statuses для… |
bling_delete_order | Удаляет заказ на продажу навсегда. Не может быть отменено. Установлен отключенным |
bling_list_status_modules | Список модулей Bling, которые имеют статусы (situacoes): id, nome и descricao, например, Vendas (заказы на продажу). Используй id с… |
bling_list_statuses | Список статусов одного модуля: id, nome, cor и idHerdado (стандартный статус, от которого он происходит). Идентификаторы — это то, что bling_list_orders и… |
bling_list_contacts | Список контактов (клиенты, поставщики и другие): id, nome, codigo, situacao, numeroDocumento (CPF или CNPJ), telefone и celular. Поиск по… |
bling_get_contact | Получает один контакт: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral и… |
bling_create_contact | Создает контакт (клиент или поставщик). nome, tipo и situacao обязательны. Возвращает data.id |
bling_update_contact | Заменяет контакт (PUT: весь контакт переписывается, пропущенные поля могут быть очищены). Сначала прочитай его с помощью bling_get_contact, измени то… |
bling_list_invoices | Список NF-e (электронные счета): id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato… |
bling_get_invoice | Получает один NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens с налогами, transporte, parcelas, valorNota, xml (ссылка)… |
bling_generate_invoice_from_order | Создает ожидающий черновик NF-e из заказа на продажу (situacao pendente). Он не отправляется в SEFAZ: выпуск — это отдельный шаг, выполняемый в Bling или… |
bling_send_invoice | Выпускает NF-e: передает его в SEFAZ для авторизации. Авторизованный NF-e является юридическим налоговым документом, который можно отменить только в пределах… |
bling_list_receivables | Список дебиторской задолженности (contas a receber): id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (заказ или… |
bling_get_receivable | Получает одну дебиторскую задолженность: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto и Pix… |
bling_list_payables | Список кредиторской задолженности (contas a pagar): id, situacao, vencimento, valor, contato и origem. Только для чтения. До 100 на странице |
bling_list_payment_methods | Список методов оплаты (formas de pagamento): id, descricao, tipoPagamento и situacao. Идентификатор используется в parcelas заказа |
Примеры запросов
- "Какие заказы на продажу с сегодняшнего дня все еще открыты?"
- "Каков запас продукта SKU CAM-PRETA-M на каждом складе?"
- "Создай черновик NF-e из заказа на продажу 15873."
- "Какие дебиторские задолженности подлежат оплате на этой неделе и на какую сумму в BRL?"
- "Перемести заказ 15873 в статус Em andamento."
Следующие шаги
Это руководство помогло?