didox-skill

CLI и скилл для Didox.uz, оператора ЭДО Узбекистана: черновики, подача контрагенту, статусы и подпись через E-IMZO

  • 1 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • Выполняет юридически значимые действия: подпись, прием, отказ и отмену документов
  • Хранит партнерский токен и пароль аккаунта Didox
  • Взаимодействует с локальным ключом ЭЦП через E-IMZO
Все причины и проверки

smixs/didox-skill

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/didox-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Выполняет юридически значимые действия: подпись, прием, отказ и отмену документов
  • Хранит партнерский токен и пароль аккаунта Didox
  • Взаимодействует с локальным ключом ЭЦП через E-IMZO

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

CLI didox.py работает с партнерским API Didox напрямую: логин с кешем токена на 6 часов, список документов с фильтрами, карточка и печатная форма в PDF, данные компании и статус НДС по ИНН. Можно создать черновик произвольного документа с PDF-вложением или любого из 14 типов из JSON, принять, отклонить или отменить документ. Подпись идет через локальный E-IMZO, пароль ключа вводится в его окне, а отправка подписи требует флага --submit.

Для кого. Для бухгалтеров, фрилансеров и компаний в Узбекистане, которые обмениваются документами через Didox.

Подходит, если

  • Нужно выставить акт контрагенту по подписанному договору
  • Нужно проверить, подписал ли контрагент документ
  • Нужно пробить компанию по ИНН в налоговой базе

Не подходит, если

  • Работа с российскими операторами ЭДО, например Диадок или СБИС
  • Нет партнерского токена Didox

Пример запроса к агенту

Выстави акт выполненных работ контрагенту с ИНН 123456789 по договору № 42, PDF в act.pdf

Ограничения

Партнерский токен выдает аккаунт-менеджер Didox, также нужен пароль аккаунта. Подпись работает только с локально установленным E-IMZO. Подпись, прием, отказ и отмена являются юридическими действиями и не отменяются.

Как отключить. Удалите скилл через npx skills или папку didox из каталога скиллов. Учетные данные лежат в ~/.didox/env.

Частые вопросы

Проходит ли пароль ключа ЭЦП через CLI?

Нет, пароль вводится в окне E-IMZO. Отправка подписи дополнительно требует флага --submit.

Есть ли тестовый стенд?

Да, через переменную DIDOX_URL=https://testapi3.didox.uz.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы
Российский стек

MCP-сервер для ЭДО Контур.Диадок: поиск организаций по ИНН, список и содержимое документов, отправка и подписание

MCP-серверШирокий доступ4Звезды репозитория

Скилл для редактируемых диаграмм draw.io из текста, кода, Terraform, Kubernetes, SQL и OpenAPI с экспортом и самопроверкой

СкиллРасширенный доступ10,4 тыс.Звезды репозитория
Выбор редакции

Скилл и CLI от Firecrawl: агент переводит Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV и PDF в Markdown на вашей машине

СкиллРасширенный доступ23,2 тыс.Звезды репозитория

Официальный скилл Nutrient для работы с PDF через DWS Processor API: конвертация, OCR, извлечение, редактирование, подпись и PDF/A

СкиллШирокий доступ19Звезды репозитория
Российский стек

MCP-сервер по всему API Диадока (Контур): документы, контрагенты, подписание и МЧД, с подтверждением перед записью и необратимыми действиями

MCP-серверШирокий доступ3Звезды репозитория

Скилл-конвейер документов: что угодно в markdown, markdown в аккуратный html и docx уровня издательства, html обратно в markdown

СкиллРасширенный доступ933Звезды репозитория

Коротко о README

README описывает CLI на Python 3.8+ без зависимостей с выводом в JSON и приложенный скилл для агентов в формате SKILL.md. Установка через skills.sh, как плагин Claude Code, для Codex CLI или вручную. Приведены быстрый старт с файлом ~/.didox/env, таблица команд, подтипы и статусы документов. Описание продублировано на английском и узбекском. Лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: didox
description: >
  Operate Didox.uz (Uzbekistan e-document exchange) end to end: turn a Word
  draft into a clean PDF, file any document type (акт, договор, ЭСФ
  счёт-фактура, акт сверки, доверенность, письмо) to a counterparty, accept
  or reject incoming documents, cancel sent ones, check signing status, look
  up companies and VAT status by ИНН/TIN, sign with the local E-IMZO key.
  Use when the user says didox / дидокс / didoks / дидокс.уз in any spelling
  or layout, or asks to выставить, подать or отправить акт/договор/СФ
  контрагенту, принять или отклонить входящий документ, проверить подписал
  ли контрагент, найти документ, пробить компанию по ИНН, подписать ЭЦП,
  hujjat yuborish — even if they don't say "Didox". Do NOT use for Russian
  EDO operators (Diadoc, СБИС).
---

# didox — управление Didox.uz через партнёрский API

## Overview

Полный жизненный цикл документов ЭДО: подготовка PDF из docx → черновик
любого типа → подпись E-IMZO → приём/отказ/отмена. CLI `scripts/didox.py`
покрывает партнёрский API, `scripts/eimzo_sign.py` — мост к локальному
E-IMZO. Вывод — JSON в stdout; ошибка — JSON в stderr, exit 1.

Что обратимо, а что нет: черновик удаляется (`draft-delete`); подпись,
приём, отказ и отмена — юридические действия, назад не отматываются.

## Pre-flight

→ `references/runtime-setup.md`. Если чего-то нет (python3, env-файл с
токенами, живой логин) — стоп, сказать пользователю, что именно и где взять.
Перед первой подписью проверь `profile` → `offerSigned: 1` (оферта Didox);
не подписана — маршрут в `references/api-details.md` § Оферта.

## Команды

| Задача | Команда |
|---|---|
| Получить/обновить user-токен | `scripts/didox.py login` |
| Свои реквизиты | `scripts/didox.py profile` |
| Документы по контрагенту | `scripts/didox.py docs --partner <ИНН>` |
| Компания по ИНН | `scripts/didox.py partner <ИНН>` |
| Подписать исходящий | `scripts/didox.py sign <ID> --serial <serial>` |
| Принять входящий | `scripts/didox.py accept <ID> --serial <serial>` |
| Отклонить входящий | `scripts/didox.py reject <ID> --serial <serial> --comment "…"` |

Сообщить о проблеме

Foxx AIdidox-skill
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.