# API для работы с АТИ-Доками

## Используемые термины

**АТИ-Доки** — сервис электронного документооборота. [Подробнее](https://ati.su/landings/d-welcome/)

Для обмена документами с контрагентами, работающими с другими операторами ЭДО, используется **роуминг**.
С кем можно настроить роуминг — указано [на странице ФНС в разделе «Роуминг с иными операторами»](https://www.nalog.gov.ru/rn77/oedo/info/?operator=33). Если статус оператора «0 — нет соединения», значит, настроить с ним роуминг пока нельзя. 

**Неформализованные документы** — это документы, формат обмена которыми не утвержден законодательно. Они считаются юридически значимыми, если заверены электронной подписью. Полный список таких документов представлен в [соответствующем разделе](https://ati.su/developers/raw/api/doki/informal.md#неформализованные-документы).

**Роуминговые неформализованные документы** — это любые электронные документы, отправленные в роуминг или полученные из роуминга, для которых нет разработанных и утвержденных регулятором форматов. Обмениваться такими документами можно в произвольных форматах, например, в PDF или JPG. В таком случае в ЭДО подписывается сам файл. 

**Статус документа** — текущее состояние документа. Например: отправлен, подписан, ожидает решения, одобрен, отклонен, отозван.

**Документ, связанный с заказом** — создается из Заказа. Содержит информацию о перевозке, которая была указана в Заказе.

**ИП** — индивидуальный предприниматель.

**ЮЛ** — юридическое лицо.

**ЭПД** — система ГИС ЭПД - это государственная информационная система (запущена Минтрансом с 1 сентября 2022 года), обеспечивающая формирование, обмен и хранение электронных транспортных накладных (ЭТрН), путевых листов и других документов в цифровом виде.

**КЭП** — квалифицированная электронная подпись.

**СКЗИ** — средство криптографической защиты информации. Программа, позволяющая подписывать документы.

**УПД** — универсальный передаточный документ. Его можно использовать вместо первичного документа и счета-фактуры. 

**Формализованный счёт:**
- Счёт ― документ, который продавец выставляет покупателю для оплаты товаров, работ или услуг. А также счёт выставляется для перечисления предоплаты за запланированную поставку или услугу. 
- Счёт-оферта — выполняет те же функции, что и счет, а также содержит признаки договора и условия сделки.

Электронный счёт и счёт-оферта — однотитульный документ, подписывается только отправителем.

**Извещение о получении** — служебный документ, регламентированный [приказом 14Н](https://normativ.kontur.ru/document?moduleId=1&documentId=451786), формируется при получении документа (УПД, формализованного счёта и т.д.) и гарантирует, что документ доставлен до получателя без ошибок.

**Уведомление об уточнении** — служебный документ, регламентированный [приказом 14Н](https://normativ.kontur.ru/document?moduleId=1&documentId=451786), формируется получателем документа (УПД, формализованного счёта и т.д.) в случае выявления им ошибок в документе.

## Возможности API

С помощью API АТИ-Доков участник ATI.SU может:

- получать список документов;
- создавать, редактировать и отправлять неформализованные документы;
- подписывать неформализованные документы КЭП;
- одобрять и отклонять неформализованные документы;
- комментировать неформализованные документы;
- создавать черновики формализованных документов;
- отправлять, одобрять или отклонять (обязательно с подписью) формализованные документы.

:::caution
Описание методов [создания документов из заказа](https://ati.su/developers/raw/api/orders/documents.md) и [создания Заказа с документом через АТИ-Доки](https://ati.su/developers/raw/api/orders/deals.md#post-v1.2-orders-%7bdealId%7d-accept)
доступно в разделе «Заказы».
:::

### Предоставляются следующие категории методов:

- [Работа с неформализованными документами](https://ati.su/developers/raw/api/doki/informal.md)
- [Общие методы для всех типов документов](https://ati.su/developers/raw/api/doki/common.md)
- [Работа с сертификатами КЭП](https://ati.su/developers/raw/api/doki/certificates.md)
- [Работа с подписанием документов](https://ati.su/developers/raw/api/doki/signing.md)
- [Работа с Электронной транспортной накладной](https://ati.su/developers/raw/api/doki/etrn.md)
- [Работа с Универсальным передаточным документом](https://ati.su/developers/raw/api/doki/upd.md)
- [Работа с формализованным счётом](https://ati.su/developers/raw/api/doki/fs.md)
- [Работа с роуминговыми неформализованными документами](https://ati.su/developers/raw/api/doki/rnf.md)