Руководство по коннектору8 мин чтенияMCP-инструментов: 227 языков

SmartBill MCP с Gemini CLI: проформы

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

HCАвтор: команда HelpCodeОбновлено 8 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

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.

инструментов

22

Регион

RO

Категория

Бухгалтерия

Аутентификация

Basic Auth

Требуемые env-vars

SMARTBILL_EMAILSMARTBILL_API_TOKENSMARTBILL_CIF
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

Пошаговая настройка

Подключи SmartBill к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи SmartBill в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для SmartBill

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

SmartBill · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → SmartBill, вставь свои учетные данные, создай ключ API MCP, и готово. Никакого Docker, никакого git clone, никакого локального сервера.

SmartBill + Gemini

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

Предварительные требования

Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF

Шаг 1 — Получи учетные данные

Настройка занимает около 2 минут.

  1. Войди в SmartBill Cloud и открой Contul meu, Integrari, раздел API (https://cloud.smartbill.ro/core/integrari/).
  2. Скопируй Email в SMARTBILL_EMAIL, Token в SMARTBILL_API_TOKEN и CIF компании в SMARTBILL_CIF.

Вызовы используют HTTP Basic аутентификацию с электронной почтой в качестве пользователя и токена в качестве пароля. Коннектор добавляет CIF компании к каждому вызову, поэтому один коннектор работает с одной компанией; установи его снова для второй компании.

С чего начать: smartbill_list_series (имена серий, которые нужны каждому документу) и smartbill_list_taxes (имена ставок НДС). Затем smartbill_create_invoice или smartbill_create_estimate.

Что API не может сделать: V1 не имеет списка или поиска счетов, клиентов или продуктов и не имеет JSON представления документа. Документ адресуется по его серии и номеру, которые пользователь предоставляет или которые возвращает вызов создания. Сохраняй series, number и documentViewUrl того, что ты создаешь.

Счета: smartbill_create_invoice сохраняет черновик, если is_draft не равен false. Окончательный счет получает следующий номер серии и является фискальным документом: SmartBill отправляет его в ANAF e-Factura в соответствии с настройками аккаунта, которые этот API не контролирует. smartbill_create_invoice_from_estimate превращает проформу в счет. smartbill_get_invoice_payment_status сообщает, что оплачено и что еще должно быть оплачено, smartbill_get_invoice_pdf загружает файл, smartbill_send_document_email отправляет счет или смету клиенту по электронной почте. smartbill_reverse_invoice (сторно), smartbill_cancel_invoice, smartbill_restore_invoice и smartbill_delete_invoice установлены отключенными.

Сметы (проформы): smartbill_create_estimate, smartbill_get_estimate_invoices (была ли она выставлена), smartbill_get_estimate_pdf; smartbill_cancel_estimate, smartbill_restore_estimate и smartbill_delete_estimate отключены.

Платежи: smartbill_get_fiscal_receipt_text читает фискальный чек. smartbill_register_payment (регистрирует поступление или выдает чек), smartbill_delete_receipt и smartbill_delete_payment отключены. Ничто из этого не списывает деньги с карты или не перемещает деньги: платежи являются бухгалтерскими записями.

Запасы: smartbill_list_stocks возвращает количества по складам (gestiune) на дату; имена складов чувствительны к регистру.

Создание документа: seriesName, taxName и measuringUnitName должны точно соответствовать аккаунту; никогда не выдумывай их. Цены без НДС, если isTaxIncluded не равно true. taxPercentage требуется на каждой строке (21 — стандартная ставка с августа 2025 года). Если аккаунт использует коды продуктов, каждая строка нуждается в code. Строка со скидкой требует numberOfItems и отрицательное discountValue, в противном случае она будет тихо проигнорирована или добавлена. Для клиента в Бухаресте city должен быть от Сектора 1 до Сектора 6, иначе e-Factura отклонит счет. Каждый документ, включая черновики, учитывается в документах плана SmartBill.

Ошибки: errorText ответа — это причина, на румынском (например, Seria nu a fost gasita! для неизвестной серии); он может содержать HTML, поэтому цитируй только его первое предложение. Запрос с неизвестным полем или неправильным типом отвечает 400 с errors[].message и errors[].param, указывающими на поле. 401 означает неправильный email или токен, 403 — что у пользователя нет прав на компанию или серию.

Ограничения: 30 вызовов за 10 секунд на токен; превышение блокирует токен на 10 минут. Заголовки X-RateLimit-Remaining и X-RateLimit-Reset показывают, что осталось.

Не охвачено: более новый API V3 (списки клиентов, продуктов, складов, поставщиков и накладных на получение товаров) использует отдельный токен Bearer и не является частью этого коннектора. Фискальные чеки (bon fiscal) требуют кассовый аппарат и не выдаются здесь.

Шаг 2 — Установи адаптер

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

Шаг 3 — Добавь коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
  2. Сохрани файл и перезапусти gemini.
  3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
  4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты SmartBill.

Доступные инструменты

ИнструментЧто он делает
smartbill_list_seriesСписок серий документов, настроенных в SmartBill: list с каждой серией name, ее nextNumber и type (f счета, p сметы и…
smartbill_list_taxesСписок ставок НДС, настроенных в SmartBill: taxes с каждой ставкой name (например, Normala) и percentage. Используй имя как taxName и…
smartbill_list_stocksЧтение уровней запасов на дату: list с одной записью на склад (warehouseName, warehouseType en gros или en detail) и его products…
smartbill_create_invoiceСоздание счета в SmartBill. По умолчанию он сохраняется как черновик (без номера), который пользователь проверяет и завершает в SmartBill; с…
smartbill_create_invoice_from_estimateСоздание счета из существующей сметы (проформы): клиент и строки копируются из сметы. По умолчанию счет сохраняется как…
smartbill_get_invoice_payment_statusПроверка, был ли счет оплачен: invoiceTotalAmount (итог с НДС), paidAmount, unpaidAmount и paid (true, когда полностью оплачен).…
smartbill_get_invoice_pdfЗагрузка выставленного счета в виде PDF-файла. Ответ — это сам файл, переданный в виде вложения; API не имеет JSON представления документа…
smartbill_send_document_emailОтправка выставленного счета или сметы клиенту по электронной почте в виде вложения с темой и текстом шаблона электронной почты, настроенного в…
smartbill_reverse_invoiceВыдача обратного (сторно) счета для существующего счета: новый фискальный документ с отрицательными суммами на той же серии. Он учитывается в…
smartbill_cancel_invoiceОтмена (anulare) выставленного счета. Счет сохраняет свой номер и помечается как отмененный; его можно восстановить с…
smartbill_restore_invoiceВосстановление отмененного счета, делая его снова действительным. Установлен отключенным; подтвердите с пользователем перед вызовом
smartbill_delete_invoiceУдаление счета навсегда. Только последний счет серии может быть удален, и это нельзя отменить. Установлен отключенным; подтвердите…
smartbill_create_estimateСоздание сметы (проформы) в SmartBill. По умолчанию она сохраняется как черновик (без номера); с is_draft false она выставляется сразу с…
smartbill_get_estimate_invoicesПроверка, была ли смета (проформа) выставлена: areInvoicesCreated и invoices с series и number каждого выставленного счета…
smartbill_get_estimate_pdfЗагрузка сметы (проформы) в виде PDF-файла. Ответ — это сам файл, переданный в виде вложения. Неправильная серия или номер…
smartbill_cancel_estimateОтмена сметы (проформы). Она сохраняет свой номер и может быть восстановлена с smartbill_restore_estimate. Установлена отключенной; подтвердите…
smartbill_restore_estimateВосстановление отмененной сметы (проформы). Установлена отключенной; подтвердите с пользователем перед вызовом
smartbill_delete_estimateУдаление сметы (проформы) навсегда. Это нельзя отменить. Установлена отключенной; подтвердите с пользователем перед вызовом
smartbill_register_paymentРегистрация платежа, полученного от клиента в SmartBill, возможно, против счетов. Тип определяет, что создается: Chitanta выдает…
smartbill_get_fiscal_receipt_textЧтение содержания фискального чека (bon fiscal) по его id: message содержит текст чека для фискального принтера, закодированный в Base64, в…
smartbill_delete_receiptУдаление чека (chitanta) навсегда. Только последний чек серии может быть удален. Установлен отключенным; подтвердите с пользователем…
smartbill_delete_paymentУдаление зарегистрированного платежа, который не является чеком (Card, Ordin plata, CEC и так далее). Определите его по счету, который он погашает (invoice_series…

Примеры подсказок

  • "Какие серии документов и ставки НДС настроены в SmartBill?"
  • "Создай черновик счета в серии FCT для SC Exemplu SRL: 10 часов консультаций по 200 лей плюс НДС."
  • "Оплачен ли счет FCT 0142, и сколько еще должно быть оплачено?"
  • "Преобразуй проформу PRF 0031 в счет и отправь его клиенту по электронной почте."
  • "Каковы запасы на складе Depozit Central сегодня?"

Часто задаваемые вопросы

Откуда берутся учетные данные? SmartBill Cloud, Contul meu, Integrari, раздел API: скопируй Email, Token и CIF компании. Один коннектор работает с одной компанией; установи его снова для второй компании. Это токен V1, а не токен Bearer API V3.

Что он охватывает? Счета и сметы (проформы) в виде черновиков или окончательных документов, счета из смет, статус оплаты, PDF, отправка документов клиентам, текст фискального чека, серии документов, ставки НДС и запасы по складам. API V1 не имеет списка или поиска счетов, клиентов или продуктов: документ адресуется по его серии и номеру. Окончательный счет является фискальным документом, который SmartBill отправляет в ANAF e-Factura в соответствии с настройками аккаунта.

Какие инструменты установлены отключенными? 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 и smartbill_delete_payment. Включай их на странице коннектора только если ИИ должен их использовать. Ни один инструмент не списывает деньги с карты или не перемещает деньги.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

Это руководство помогло?

Подключи SmartBill к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи SmartBill в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

SmartBill MCP с ChatGPT: счета и НДС

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

Коннекторы

SmartBill MCP с Claude: счета и склад

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

Коннекторы

SmartBill MCP с Microsoft Copilot

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

Коннекторы

SmartBill MCP с Cursor: счета и склад

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

Коннекторы

SmartBill MCP с Meta Muse: счета

SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.

Коннекторы

SmartBill MCP-сервер: счета и остатки на складах

SmartBill Cloud API для румынского выставления счетов: выпуск счетов и смет (проформ) в виде черновиков или окончательных документов, создание счета из сметы, проверка статуса платежа, загрузка PDF, отправка документов клиентам по электронной почте и чтение серий документов, ставок НДС и остатков по складам. Отключены функции отмены, аннулирования, удаления и регистрации платежей. Электронная почта и API токен.