didox-skill

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

СкиллВысокий риск

smixs/didox-skill

Установка

npx skills add smixs/didox-skill -g

Без -g установщик спросит, куда ставить.

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

Что делает

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.

Проверка безопасности

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

Коротко о README

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

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 "…"` |

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

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

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

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

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

Выбор редакции

Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills

СкиллСредний риск176,3 тыс.

Набор скиллов для Claude Code: исследование, написание статьи, рецензирование и проверка цитат по шагам

СкиллСредний риск48 тыс.

Превращает техническую книгу или папку документов в структурированный скилл с главами, глоссарием и шпаргалкой

СкиллСредний риск30,6 тыс.

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

СкиллСредний риск9,3 тыс.