e-invoice.uz — платформа электронного документооборота (ЭДО) Узбекистана. Через API вы полностью автоматизируете работу с электронными документами: создание, подпись через E-IMZO и обмен с налоговым органом (роуминг).
Это руководство проведёт вас от получения токена до первого отправленного счёта-фактуры. Если вы интегрируетесь впервые — проходите разделы по порядку.
Что вам понадобится
| Требование | Для чего | Где получить |
|---|---|---|
| Токен доступа | Авторизация запросов к API | POST /api/{lang}/login — см. Авторизация |
| Ключ E-IMZO | Электронная подпись документов | Электронная цифровая подпись (ЭЦП) вашей организации |
| ИНН / ПИНФЛ | Идентификатор организации | Свидетельство о регистрации |
Базовый адрес
Все запросы отправляются на:
https://back.e-invoice.uz
Формат пути — /api/{lang}/..., где {lang} определяет язык ответов и текста ошибок:
ru— русскийuz— узбекскийen— английский
Например: POST https://back.e-invoice.uz/api/ru/login
Как устроен процесс
Отправка документа — единая цепочка. Каждый счёт-фактура проходит её от начала до конца:
- Получить ID. Уникальный идентификатор документа через
GET /api/{lang}/utils/get/id. - Создать документ.
POST /api/{lang}/documents/invoice/saveс данными продавца, покупателя и товаров. - Подписать и отправить. Электронная подпись E-IMZO через
POST /api/{lang}/sign/invoice/send/single. - Отслеживать статус. Документ проходит путь: доставлен → принят или отклонён контрагентом.
Полный разбор каждого шага с примерами запросов и ответов — в разделе Первый счёт-фактура.
Дальше
- Настройте авторизацию и получите токен доступа.
- Пройдите первую отправку счёта-фактуры.
- Разберитесь со статусами документа и обработкой ошибок.