Кратко
API Siigo для Siigo Nube, колумбийского программного обеспечения для бухгалтерского учета и электронного выставления счетов: клиенты и поставщики, продукты, счета-фактуры с их статусом DIAN, котировки, кредитные ноты, кассовые и платежные квитанции, журнальные ордера, каталоги (типы документов, налоги, способы оплаты, центры затрат, пользователи, склады), пробный баланс и кредиторская задолженность. Имя пользователя и ключ доступа.
Пошаговая настройка
Подключи Siigo к Gemini за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Siigo в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Siigo
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Siigo, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Siigo + Gemini
API Siigo для Siigo Nube, колумбийского программного обеспечения для бухгалтерского учета и электронного выставления счетов: клиенты и поставщики, продукты, счета-фактуры с их статусом DIAN, котировки, кредитные ноты, кассовые и платежные квитанции, журнальные ордера, каталоги (типы документов, налоги, способы оплаты, центры затрат, пользователи, склады), пробный баланс и кредиторская задолженность. Имя пользователя и ключ доступа.
Предварительные условия
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
SIIGO_USERNAME, SIIGO_ACCESS_KEY
Шаг 1 — Получи учетные данные
Настройка занимает около 3 минут.
- Войди в Siigo Nube как администратор и открой Alianzas в левом меню, затем Mi Credencial API.
- Сгенерируй учетные данные и скопируй имя пользователя в
SIIGO_USERNAME, а ключ доступа вSIIGO_ACCESS_KEY.
Коннектор входит в систему по адресу POST /auth с обоими значениями, получает токен, который действует 24 часа, и обновляет его самостоятельно. Каждый вызов содержит заголовок Partner-Id: AnythingMCP, который Siigo требует для идентификации интегрируемого приложения.
С чего начать: siigo_list_document_types (типы счетов компании), siigo_list_users (продавцы), siigo_list_payment_types и siigo_list_taxes: их идентификаторы необходимы для создания документов. siigo_list_invoices с клиентом или диапазоном дат отвечает на большинство вопросов по продажам.
Каталоги: siigo_list_document_types, siigo_list_taxes, siigo_list_payment_types, siigo_list_cost_centers, siigo_list_users, siigo_list_warehouses, siigo_list_account_groups. Они редко меняются: читай каждый раз за разговор.
Третьи лица и продукты: siigo_list_customers (фильтруй по identification), siigo_get_customer, siigo_create_customer; siigo_list_products (фильтруй по code), siigo_get_product, siigo_create_product.
Счета-фактуры: siigo_list_invoices, siigo_get_invoice, siigo_create_invoice, siigo_get_invoice_stamp_errors, siigo_send_invoice_email. siigo_create_invoice сохраняет счет без отправки его в DIAN, если send_to_dian не истинно; счет, принятый DIAN, имеет cufe и не может быть аннулирован или удален, только исправлен с помощью кредитной ноты. siigo_annul_invoice и siigo_delete_invoice установлены выключенными. public_url счета — это печатная версия для обмена; коннектор не возвращает PDF-файлы.
Другие документы (только для чтения): siigo_list_quotations, siigo_get_quotation, siigo_list_credit_notes, siigo_get_credit_note, siigo_list_vouchers и siigo_get_voucher (кассовые квитанции: полученные деньги), siigo_list_payment_receipts (деньги, уплаченные поставщикам), siigo_list_journals. Коннектор не создает квитанции, кредитные ноты или журнальные ордера и не перемещает деньги.
Отчеты: siigo_generate_trial_balance и siigo_generate_trial_balance_by_third_party возвращают ссылку на файл Excel, а не цифры. siigo_list_accounts_payable возвращает открытые задолженности поставщиков в формате JSON.
Пагинация: списки возвращают results, pagination (page, page_size, total_results) и _links. Запрашивай следующую page, пока остаются строки; page_size может достигать 100.
Форматы: даты — yyyy-MM-dd; фильтры созданных и обновленных также принимают даты и время в UTC. Идентификаторы документов — это GUID, идентификаторы каталогов — числа. Клиент обозначается в документах по identification и branch_office, продукт — по code. Суммы — это числа в местной валюте (COP), если документ не имеет currency.
Ошибки — это Status и Errors с Code, Message и Params: parameter_required и invalid_reference указывают на поле или идентификатор, который не существует, invalid_total_payments означает, что платежи не складываются в общую сумму, already_exists — дублирующийся код или идентификация, unauthorized — неверные или заблокированные учетные данные.
Ограничения: 100 вызовов в минуту на компанию (requests_limit). Siigo блокирует пользователя API, если его вызовы более чем на 80 % являются ошибками в течение 7 дней, поэтому не угадывай идентификаторы или коды: сначала читай их из каталогов.
Шаг 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" }
}
}
}
- Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо
YOUR_MCP_API_KEY. - Сохрани файл и перезапусти
gemini. - Выполни
/mcpв Gemini CLI (илиgemini mcp listв терминале) —anythingmcpдолжен отображаться как подключённый. - Начинай писать промпты: Gemini CLI теперь может вызывать инструменты
Siigo.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
siigo_list_document_types | Список типов документов (comprobantes), настроенных в Siigo для одного типа документа: id, код, имя, описание, является ли он электронным… |
siigo_list_taxes | Список налогов, настроенных в Siigo: id, имя, тип (IVA, Retefuente, ReteIVA, ReteICA, Impoconsumo, AdValorem, Autorretencion), процент… |
siigo_list_payment_types | Список способов оплаты (formas de pago), используемых для одного типа документа: id, имя, тип (Cartera, Proveedor, CarteraProveedor), активный и… |
siigo_list_cost_centers | Список центров затрат (centros de costo): id, код, имя и активный. Некоторые типы документов требуют одного на каждом счете. Только для чтения |
siigo_list_users | Список пользователей Siigo компании: id, имя пользователя, имя, фамилия, электронная почта, идентификация и активный. id пользователя — это… |
siigo_list_warehouses | Список складов (bodegas), используемых для учета запасов: id, имя, активный и has_movements. Только для чтения |
siigo_list_account_groups | Список классификаций запасов (grupos de inventario): id, имя и активный. Новому продукту нужен идентификатор одного как account_group… |
siigo_list_customers | Список клиентов и других третьих лиц (clientes, proveedores, terceros): id, тип, person_type, id_type, идентификация, контрольная цифра… |
siigo_get_customer | Полное чтение одного третьего лица: идентификация и тип, имена, ответственность по НДС и налоговые обязательства, адрес с указанием страны, штата… |
siigo_create_customer | Создание третьего лица (клиента, поставщика или другого) в Siigo и возврат его с его идентификатором. Сначала найди его с помощью siigo_list_customers по… |
siigo_list_products | Список продуктов и услуг, начиная с новейших: id, код, имя, account_group, тип (Product, Service, ConsumerGood), stock_control, активный… |
siigo_get_product | Полное чтение одного продукта или услуги: код, имя, классификация, тип, налоги, цены, единица, описание, дополнительные поля (штрих-код, бренд… |
siigo_create_product | Создание продукта или услуги в Siigo и возврат его с его идентификатором. Код должен быть уникальным; account_group — это идентификатор одного из запасов… |
siigo_list_invoices | Список продажных счетов (facturas de venta): id, тип документа, номер, имя (например, FV-2-22), дата, клиент, cost_center, всего, баланс… |
siigo_get_invoice | Полное чтение одного продажного счета: номер и имя, дата, клиент, продавец, центр затрат, валюта, каждый элемент с количеством, ценой, скидкой… |
siigo_create_invoice | Создание продажного счета в Siigo для существующего клиента и возврат его с его идентификатором, номером, общей суммой и public_url. По умолчанию счет… |
siigo_get_invoice_stamp_errors | Чтение причин, по которым DIAN отклонил электронный счет: errors с сообщением каждого отклонения. Используй это, когда статус печати счета… |
siigo_send_invoice_email | Отправка существующего продажного счета на адреса до 5 получателей. Возвращает status, отправленный, когда Siigo принял запрос. Подтверди получателей с… |
siigo_annul_invoice | Аннулирование (anular) продажного счета. Siigo отказывает в счетах, которые уже были отправлены или приняты DIAN (с CUFE), и счетах с связанными… |
siigo_delete_invoice | Удаление продажного счета навсегда. Siigo отказывает в счетах, отправленных или принятых DIAN, и счетах с связанными документами. Это нельзя… |
siigo_list_quotations | Список котировок (cotizaciones): id, номер, имя (например, C-1-22), дата, клиент, всего, продавец, элементы и public_url. Фильтруй по имени… |
siigo_get_quotation | Полное чтение одной котировки: номер, имя, дата, клиент, продавец, элементы с количествами, ценами и налогами, всего и public_url. Только для чтения |
siigo_list_credit_notes | Список кредитных нот (notas credito): id, тип документа, номер, имя, дата, счет, который каждая исправляет, клиент, всего, печать DIAN, элементы… |
siigo_get_credit_note | Полное чтение одной кредитной ноты: номер, дата, счет, который она исправляет, клиент, причина, элементы, платежи, всего и печать DIAN. Только для чтения |
siigo_list_vouchers | Список кассовых квитанций (recibos de caja), запись полученных денег от клиентов: id, тип документа, номер, имя, дата, тип, клиент… |
siigo_get_voucher | Полное чтение одной кассовой квитанции (recibo de caja): номер, дата, клиент, счета, которые она оплачивает, с их значениями, способ оплаты, стоимость… |
siigo_list_payment_receipts | Список платежных квитанций (recibos de pago или egreso), запись денег, уплаченных поставщикам: id, тип документа, номер, имя, дата, поставщик… |
siigo_list_journals | Список журнальных ордеров (comprobantes contables): id, тип документа, номер, имя, дата и дебетовые и кредитовые элементы с счетом, третьим… |
siigo_generate_trial_balance | Генерация общего пробного баланса (balance de prueba) за год для диапазона месяцев и счетов. Siigo создает файл Excel и возвращает… |
siigo_generate_trial_balance_by_third_party | Генерация пробного баланса по третьему лицу (balance de prueba por tercero) для диапазона месяцев и счетов, для всех третьих лиц или одного.… |
siigo_list_accounts_payable | Список кредиторской задолженности (cuentas por pagar): одна строка на открытую задолженность с due (префикс, последовательный, котировка, дата, баланс в местной… |
Примеры подсказок
- "Список продажных счетов для клиента NIT 900123456 за октябрь с их статусом DIAN."
- "Почему счет FV-1-2045 был отклонен DIAN?"
- "Создать черновик счета для Comercial Andina: 3 единицы продукта CAF-500 по списочной цене."
- "Какие задолженности поставщиков открыты прямо сейчас?"
- "Сгенерировать пробный баланс за сентябрь."
Часто задаваемые вопросы
Откуда берутся учетные данные? Войди в Siigo Nube как администратор, открой Alianzas в левом меню, затем Mi Credencial API и сгенерируй учетные данные: имя пользователя идет в SIIGO_USERNAME, ключ доступа в SIIGO_ACCESS_KEY. Коннектор входит в систему с обоими и самостоятельно обновляет свой 24-часовой токен.
Что он охватывает? Клиенты и поставщики, продукты, счета-фактуры с их статусом DIAN и ошибками печати, отправка счетов по электронной почте, котировки, кредитные ноты, кассовые и платежные квитанции, журнальные ордера, каталоги, необходимые документу, пробный баланс (как ссылка на файл Excel) и кредиторская задолженность. Кредитные ноты, квитанции и журнальные ордера только для чтения, и ни один инструмент не перемещает деньги.
Какие инструменты установлены выключенными? siigo_annul_invoice и siigo_delete_invoice. Включай их на странице коннектора только если ИИ должен их использовать. Счет отправляется в DIAN только когда send_to_dian истинно; после принятия его можно исправить только с помощью кредитной ноты.
Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.
Следующие шаги
Это руководство помогло?