Кратко
Siigo API для Siigo Nube, колумбийского программного обеспечения для бухгалтерского учета и электронного выставления счетов: клиенты и поставщики, продукты, счета-фактуры с их статусом DIAN, котировки, кредитные ноты, кассовые и платежные квитанции, журнальные ордера, каталоги (типы документов, налоги, способы оплаты, центры затрат, пользователи, склады), пробный баланс и кредиторская задолженность. Имя пользователя и ключ доступа.
Пошаговая настройка
Подключи Siigo к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Siigo в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Siigo
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Siigo, вставь свои учетные данные, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Siigo
Siigo API для Siigo Nube, колумбийского программного обеспечения для бухгалтерского учета и электронного выставления счетов: клиенты и поставщики, продукты, счета-фактуры с их статусом DIAN, котировки, кредитные ноты, кассовые и платежные квитанции, журнальные ордера, каталоги (типы документов, налоги, способы оплаты, центры затрат, пользователи, склады), пробный баланс и кредиторская задолженность. Имя пользователя и ключ доступа.
Настройка
Настройка занимает около 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 дней, поэтому не угадывай идентификаторы или коды: сначала читай их из каталогов.
Предварительные условия: SIIGO_USERNAME, SIIGO_ACCESS_KEY
Установи коннектор локально
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, выбери 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, название и активный. Новому продукту нужен id одного как account_group.… |
siigo_list_customers | Список клиентов и других третьих лиц (clientes, proveedores, terceros): id, тип, тип лица, тип идентификации, идентификация, контрольная цифра… |
siigo_get_customer | Чтение одного третьего лица полностью: идентификация и тип, имена, ответственность по НДС и налоговые обязательства, адрес с указанием страны, штата… |
siigo_create_customer | Создание третьего лица (клиента, поставщика или другого) в Siigo и возврат его с его id. Сначала ищи его с помощью siigo_list_customers по… |
siigo_list_products | Список продуктов и услуг, начиная с новейших: id, код, название, account_group, тип (Продукт, Услуга, Потребительский товар), контроль запасов, активный… |
siigo_get_product | Чтение одного продукта или услуги полностью: код, название, классификация, тип, налоги, цены, единица, описание, дополнительные поля (штрих-код, бренд… |
siigo_create_product | Создание продукта или услуги в Siigo и возврат его с его id. Код должен быть уникальным; account_group — это id одного из запасов… |
siigo_list_invoices | Список счетов-фактур (facturas de venta): id, тип документа, номер, название (например, FV-2-22), дата, клиент, центр затрат, общая сумма, баланс… |
siigo_get_invoice | Чтение одного счета-фактуры полностью: номер и название, дата, клиент, продавец, центр затрат, валюта, каждый элемент с количеством, ценой, скидкой… |
siigo_create_invoice | Создание счета-фактуры в Siigo для существующего клиента и возврат его с его id, номером, общей суммой и public_url. По умолчанию счет… |
siigo_get_invoice_stamp_errors | Чтение причин, по которым DIAN отклонил электронный счет: errors с сообщением каждого отклонения. Используй это, когда статус печати счета… |
siigo_send_invoice_email | Отправка существующего счета-фактуры на до 5 адресов. Возвращает status отправлено, когда Siigo принял запрос. Подтверди получателей с… |
siigo_annul_invoice | Аннулирование (anular) счета-фактуры. Siigo отказывает в аннулировании счетов, уже отправленных в DIAN или принятых DIAN (с CUFE) и счетов с связанными… |
siigo_delete_invoice | Удаление счета-фактуры навсегда. Siigo отказывает в удалении счетов, отправленных в DIAN или принятых 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 по списочной цене."
- "Какие задолженности поставщиков открыты прямо сейчас?"
- "Сгенерировать пробный баланс за сентябрь."
Следующие шаги
Это руководство помогло?