Кратко
SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.
Пошаговая настройка
Подключи SmartBill к Meta Muse за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи SmartBill в пошаговой настройке и добавь свой MCP URL в Meta Muse. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для SmartBill
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → SmartBill, вставь свои учетные данные, создай ключ API MCP, и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
SmartBill + Meta Muse
SmartBill Cloud API для румынского выставления счетов: выставляй счета и сметы (проформы) в виде черновиков или окончательных документов, создавай счет из сметы, проверяй статус оплаты, загружай PDF, отправляй документы клиентам по электронной почте и читай серии документов, ставки НДС и запасы по складам. Обратные операции, отмена, удаление и регистрация платежей отключены. Электронная почта и токен API.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
Шаг 1 — Получи учетные данные
Настройка занимает около 2 минут.
- Войди в SmartBill Cloud и открой Contul meu, Integrari, раздел API (https://cloud.smartbill.ro/core/integrari/).
- Скопируй 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 — Добавь коннектор в Muse
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.
- В Muse открой Settings → Connectors и выбери Add custom connector.
- Вставь URL MCP-сервера
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
- В чате попроси Muse о том, для чего нужны инструменты
SmartBill.
Настроить коннектор можно и из чата — в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
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. Включай их на странице коннектора только если ИИ должен их использовать. Ни один инструмент не списывает деньги с карты или не перемещает деньги.
Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.
Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.
Следующие шаги
Это руководство помогло?