API электронной транспортной накладной (ЭТрН)
Последовательность вызовов для создания и отправки первого титула (титула грузоотправителя) ЭТрН
- Создание ЭТрН
- Сохранение данных первого титула (титула грузоотправителя)
- Сохранение участников
- Формирование XML-файла первого титула (титула грузоотправителя)
- Отправка первого титула (титула грузоотправителя)
Последовательность вызовов для создания и отправки второго титула (титула перевозчика) ЭТрН
- Сохранение данных второго титула (титула перевозчика)
- Формирование XML-файла второго титула (титула перевозчика)
- Отправка второго титула (титула перевозчика)
Последовательность вызовов для создания и отправки третьего титула (титула грузополучателя) ЭТрН
- Сохранение данных третьего титула (титула грузополучателя)
- Формирование XML-файла третьего титула (титула грузополучателя)
- Отправка третьего титула (титула грузополучателя)
Последовательность вызовов для создания и отправки четвёртого титула (титула перевозчика) ЭТрН
- Сохранение данных четвёртого титула (титула перевозчика)
- Формирование XML-файла четвёртого титула (титула перевозчика)
- Отправка четвёртого титула (титула перевозчика)
Получение информации по ЭТрН
- Получение информации по участнику документооборота
- Получение метаинформации по ЭТрН (подписанты, статус и т.д.)
- Получение ключа доступа к печатной форме и QR-коду
- Скачивание файла печатной формы и QR-кода
Работа с первым титулом (титулом грузоотправителя) ЭТрН
Создание ЭТрН
Позволяет создать пустой первый титул ЭТрН с данными грузоотправителя. С этого момента можно получать метаинформацию по документу.
Сохранение черновика первого титула (титула грузоотправителя). JSON
Позволяет сохранить данные первого титула.
В теле передаётся JSON в утверждённом законодательством формате.
Параметр send_to_driver
отвечает за отправку ЭТрН в приложение «АТИ Водитель» после успешного подписания первого титула.
Сохранение участников ЭТрН
Сохраняет участников (подписантов) ЭТрН.
Формирование первого титула (титула грузоотправителя). XML-файл
Позволяет создать XML-файл первого титула, чтобы в дальнейшем подписать и отправить его. Указывается отпечаток сертификата электронной подписи SHA-1 и номер МЧД (если есть).
Отправка первого титула (титула грузоотправителя)
Позволяет отправить первый титул в ГИС (в Государственную информационную систему) и контрагентам. После отправки титула в ГИС, ЭТрН меняет свой статус на “title_1_waiting_operator”. После получения первого титула ГИС проводит валидацию титула:
- если валидация пройдена успешно — титул поступает контрагентам, а статус ЭТрН меняется на “title_1_success”;
- если валидация не пройдена — статус ЭТрН меняется вновь на “draft” и первый титул контрагентам не поступает. При отправке необходимо указать строку подписи прикладываемого XML-файла первого титула в формате base64.
Работа со вторым титулом ЭТрН (титулом перевозчика)
Сохранение черновика второго титула (титула перевозчика). JSON
Позволяет сохранить данные второго титула. В теле передаётся JSON в утверждённом законодательством формате.
Формирование второго титула (титула перевозчика). XML-файл
Позволяет создать XML-файл второго титула, чтобы в дальнейшем подписать и отправить его. Указывается отпечаток сертификата электронной подписи SHA-1 и номер МЧД (если есть).
Отправка второго титула (титула перевозчика)
Позволяет отправить второй титул ЭТрН в ГИС (в Государственную информационную систему) и контрагентам. После отправки титула в ГИС, ЭТрН меняет свой статус на “title_2_waiting_operator”. После получения второго титула ГИС проводит валидацию титула:
- если валидация пройдена успешно — титул поступает контрагентам, статус ЭТрН меняется на “title_2_success”;
- если валидация не пройдена — статус ЭТрН меняется вновь на “title_1_success” и второй титул контрагентам не поступает. При отправке необходимо указать строку подписи прикладываемого XML-файла второго титула в формате base64.
Работа с третьим титулом ЭТрН (титулом грузополучателя)
Сохранение черновика третьего титула (титула грузополучателя). JSON
Позволяет сохранить данные третьего титула. В теле передаётся JSON в утверждённом законодательством формате.
Формирование третьего титула (титула грузополучателя). XML-файл
Позволяет создать XML-файл третьего титула, чтобы в дальнейшем подписать и отправить его. Указывается отпечаток сертификата электронной подписи SHA-1 и номер МЧД (если есть).
Отправка третьего титула (титула грузополучателя)
Позволяет отправить третий титул ЭТрН в ГИС (в Государственную информационную систему) и контрагентам. После отправки титула в ГИС, ЭТрН меняет свой статус на “title_3_waiting_operator”. После получения третьего титула ГИС проводит валидацию титула:
- если валидация пройдена — титул поступает контрагентам, статус ЭТрН меняется на “title_3_success”;
- если валидация не пройдена — статус ЭТрН меняется вновь на “title_2_success” и третий титул контрагентам не поступает. При отправке необходимо указать строку подписи прикладываемого XML-файла третьего титула в формате base64.
Работа с четвёртым титулом ЭТрН (титулом перевозчика)
Сохранение черновика четвёртого титула (титула перевозчика). JSON
Позволяет сохранить данные четвёртого титула. В теле передаётся JSON в утверждённом законодательством формате.
Формирование четвёртого титула (титула перевозчика). XML-файл
Позволяет создать XML-файл четвёртого титула, чтобы в дальнейшем подписать и отправить его. Указывается отпечаток сертификата электронной подписи SHA-1 и номер МЧД (если есть).
Отправка четвёртого титула (титула перевозчика)
Позволяет отправить четвёртый титул ЭТрН в ГИС (в Государственную информационную систему) и контрагентам. После отправки титула в ГИС, ЭТрН меняет свой статус на “title_4_waiting_operator”. После получения четвёртого титула ГИС проводит валидацию титула:
- если валидация пройдена успешно, то титул поступает контрагентам, статус ЭТрН меняется на “title_4_success”;
- если валидация не пройдена — статус ЭТрН меняется вновь на “title_3_success” и четвёртый титул контрагентам не поступает. При отправке необходимо указывать строку подписи прикладываемого XML-файла четвёртого титула в формате base64.
Получение информации по ЭТрН
Поиск участников документооборота по ИНН
Позволяет получить данные участника документооборота по ИНН.
По умолчанию astral_stand = real
. Для тестового стенда astral_stand = fake
Получение метаинформации по ЭТрН
Позволяет получить метаинформацию по ЭТрН (подписанты, статус и т. д.).
Получение ключа доступа к печатной форме и QR-коду
Позволяет получить ключ доступа, необходимый для скачивания файлов печатной формы и QR-кода. Если файл печатной формы или QR-кода ранее не генерировался, то для успешного ответа потребуется время — вызов метода надо будет повторить.
Скачивание файла печатной формы и QR-кода
Позволяет скачивать файлы печатной формы и QR-кода. Требуется ключ доступа из метода выше.