Кратко
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 и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → SmartBill, вставь свои учетные данные, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
SmartBill
SmartBill Cloud API для румынского выставления счетов: выпуск счетов и смет (проформ) в виде черновиков или окончательных документов, создание счета из сметы, проверка статуса платежа, загрузка PDF, отправка документов клиентам по электронной почте и чтение серий документов, ставок НДС и остатков по складам. Отключены функции отмены, аннулирования, удаления и регистрации платежей. Электронная почта и API токен.
Настройка
Настройка занимает около 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 означает неправильную электронную почту или токен, 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 сегодня?"
Следующие шаги
Это руководство помогло?