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

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

АТИ-Доки — сервис электронного документооборота. Подробнее

Для обмена документами с контрагентами, работающими с другими операторами ЭДО, используется роуминг. С кем можно настроить роуминг — указано на странице ФНС в разделе «Роуминг с иными операторами». Если статус оператора «0 — нет соединения», значит, настроить с ним роуминг пока нельзя.

Неформализованные документы — это документы, формат обмена которыми не утвержден законодательно. Они считаются юридически значимыми, если заверены электронной подписью. Полный список таких документов представлен в соответствующем разделе.

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

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

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

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

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

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

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

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

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

Формализованный счёт:

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

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

Извещение о получении — служебный документ, регламентированный приказом 14Н, формируется при получении документа (УПД, формализованного счёта и т.д.) и гарантирует, что документ доставлен до получателя без ошибок.

Уведомление об уточнении — служебный документ, регламентированный приказом 14Н, формируется получателем документа (УПД, формализованного счёта и т.д.) в случае выявления им ошибок в документе.

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

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

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

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

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

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

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