didox-skill

Install

npx skills add smixs/didox-skill -g

This is third-party code. Review the repository files before installing.

What it does

The didox.py CLI talks to the Didox partner API directly: login with a 6-hour token cache, filtered document lists, document cards and PDF print forms, company data and VAT status by TIN. It can create a free-form draft with a PDF attachment or any of 14 document types from JSON, and accept, reject or cancel documents. Signing goes through local E-IMZO, where the key password is typed in its own window, and submitting a signature needs the --submit flag.

Who it is for. For accountants, freelancers and companies in Uzbekistan exchanging documents through Didox.

Example request

File a work completion act to the counterparty with TIN 123456789 under contract No. 42, PDF in act.pdf

Limitations

The partner token is issued by a Didox account manager, and an account password is also required. Signing works only with locally installed E-IMZO. Signing, accepting, rejecting and cancelling are legal actions and cannot be undone.

How to disable. Uninstall via npx skills or remove the didox folder from the skills directory. Credentials live in ~/.didox/env.

Security check

• Performs legally binding actions: signing, accepting, rejecting and cancelling documents
• Stores the Didox partner token and account password
• Works with the local signing key via E-IMZO

README in short

The README describes a dependency-free Python 3.8+ CLI with JSON output and a bundled SKILL.md agent skill. Install via skills.sh, as a Claude Code plugin, for Codex CLI or manually. It gives a quick start with ~/.didox/env, a command table, document subtypes and statuses. The description is repeated in English and Uzbek. MIT licensed.

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

Related