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

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

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

HCАвтор: команда HelpCodeОбновлено 6 мин чтения Открытый код на 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 к Claude, ChatGPT или Copilot за 2 минуты

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

Без банковской карты · 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

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

Настройка

Настройка занимает около 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 означает неправильную электронную почту или токен, 403 — что у пользователя нет прав на компанию или серию.

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

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

Предварительные условия: SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF

Установка коннектора локально

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, выбери 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 к Claude, ChatGPT или Copilot за 2 минуты

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

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

Коннекторы

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 с Gemini CLI: проформы

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

Коннекторы

SmartBill MCP с Meta Muse: счета

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