Начните поиск...

Обмен электронными транспортными накладными (ЭТрН) в API

Чтобы обрабатывать ЭТрН в интерфейсе своей системы, используйте методы API.

Метод запроса: POST

Заголовок запроса (обязательно):

адрес сервера https://online.sbis.ru/service/
идентификатор сессии X-SBISSessionID — возвращается в результате запроса команд «СБИС.АутентифицироватьПоСертификату» или «СБИС.Аутентифицировать»
кодировка символов в поле Content-Type:
1. utf-8 — application/json-rpc; charset=utf-8 (рекомендуем)
2. windows-1251 — application/json-rpc; charset=windows-1251

Как обмениваться ЭТрН

ЭТрН состоит из титулов — электронных документов в формате *.xml. В таблице описаны действия участников документооборота для формирования и отправки титула.

Чтобы подписывать документы, в запросах «СБИС.ВыполнитьДействие» и «СБИС.ПодготовитьДействие» укажите тип электронного ключа в параметре «Сертификат/Ключ/Тип».

Примеры с указанием типа ключа

Титул грузоотправителя
Формирование во внешней системе	Формирование в СБИС
Для загрузки титула используйте метод СБИС.ЗаписатьДокумент. «Документ/Вложение/Файл/ДвоичныеДанные» — содержимое файла «Транспортная накладная» в системе кодирования base64 в кодировке windows-1251 Скачать пример запроса и ответа	Выполните команду СБИС.СгенерироватьВложение. Скачать пример запроса и ответа Есть вопросы по работе с командой — обратитесь в техническую поддержку.
СБИС.ПодготовитьДействие — подготовьте документ к запуску в ЭДО. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента «Документ/Этап/Название» — название этапа: «Отправка» «Документ/Этап/Действие/Название» — название перехода: «Погружен» Скачайте документы из ответа в разделе «Вложение/Файл/Ссылка» или используйте значение «Вложение/Файл/Хеш». Сформируйте отсоединенную подпись под каждым вложением. Скачать пример запроса и ответа
СБИС.ВыполнитьДействие — отправьте ЭТрН. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента «Документ/Этап/Название» — название этапа: «Отправка» «Документ/Этап/Действие/Название» — название перехода: «Погружен» Скачать пример запроса и ответа
Титул перевозчика (погрузка), этап «Получение груза»
СБИС.СписокИзменений — получите идентификатор документа. Передайте параметр «ДопПоля: Расширение», чтобы получить текущий статус обработки ЭТрН. Скачать пример запроса и ответа
СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п.1 «Документ/Этап/Название» — название этапа: «Получение груза» «Документ/Этап/Действие/Название» — название перехода: «Принят»/«Не принят» Скачайте документы из ответа в разделе «Вложение/Файл/Ссылка» или используйте значение «Вложение/Файл/Хеш». Сформируйте отсоединенную подпись под каждым вложением. Скачать пример запроса и ответа
СБИС.ВыполнитьДействие — отправьте ЭТрН. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента «Документ/Этап/Вложение/Идентификатор» — UUID файла, который был загружен в п. 2 этапа «Получение груза» «Документ/Этап/Вложение/Подпись/Файл/Имя» — название файла отсоединенной подписи «Документ/Этап/Название» — название этапа: «Получение груза» «Документ/Этап/Действие/Название» — название перехода: «Принят»/«Не принят» Скачать пример запроса и ответа
Титул получателя, этап «Приемка груза»
СБИС.СписокИзменений — получите идентификатор документа. Передайте параметр «ДопПоля: Расширение», чтобы получить текущий статус обработки ЭТрН. Скачать пример запроса и ответа
СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента «Документ/Этап/Название» — название этапа: «Приемка груза» «Документ/Этап/Действие/Название» — название перехода: «Получен»/«Получен частично»/«Не принят» Скачайте документы из ответа в разделе «Вложение/Файл/Ссылка» или используйте значение «Вложение/Файл/Хеш». Сформируйте отсоединенную подпись под каждым вложением. Скачать пример запроса и ответа
СБИС.ВыполнитьДействие — отправьте ЭТрН. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента «Документ/Этап/Вложение/Идентификатор» — UUID файла, который был загружен в п. 2 «Документ/Этап/Вложение/Подпись/Файл/Имя» — название файла отсоединенной подписи «Документ/Этап/Название» — название этапа: «Приемка груза» «Документ/Этап/Действие/Название» — название перехода: «Получен»/«Получен частично»/«Не принят» Скачать пример запроса и ответа
Титул перевозчика (выгрузка), этап «Выдача груза»
СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента «Документ/Этап/Вложение/Подпись/Файл/Имя» — название файла отсоединенной подписи «Документ/Этап/Название» — название этапа: «Выдача груза» «Документ/Этап/Действие/Название» — название перехода: «Выдан»/«Выдан частично»/«Не выдан» Скачать пример запроса и ответа
СБИС.ВыполнитьДействие — отправьте ЭТрН. Скачать пример запроса и ответа
Титул уведомления о переадресовке (формирует лицо, инициирующее переадресовку)
Формирование во внешней системе	Формирование в СБИС
СБИС.ЗаписатьВложение — загрузите в СБИС титул, сформированный в вашей системе. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п. 1	СБИС.СгенерироватьВложение — используйте команду для формирования титула переадресовки. Есть вопросы по работе с командой — обратитесь в техническую поддержку.
СБИС.ПодготовитьДействие — подготовьте документ для отправки уведомления. Скачать пример запроса и ответа	СБИС.ЗаписатьВложение — загрузите титул, сформированный в вашей системе. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п. 1 Скачать пример: запроса переадресовки ответа переадресовки
СБИС.ВыполнитьДействие — отправьте уведомление. Скачать пример запроса и ответа	СБИС.ПодготовитьДействие — подготовьте документ для отправки уведомления. Скачать пример запроса и ответа
	СБИС.ВыполнитьДействие — отправьте уведомление. Скачать пример запроса и ответа
Титул переадресовки, формирует транспортная компания
Формирование во внешней системе	Формирование в СБИС
СБИС.СписокИзменений — транспортная компания запрашивает список уведомлений по файлам, для которых нужна переадресовка. Фильтрация по «Тип»: «ConsignmentNote» и «Подтип»: «1167009» Скачать пример запроса
СБИС.ЗаписатьВложение — загрузите в СБИС титул, сформированный в вашей системе. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п. 1 Скачать пример: запроса переадресовки ответа переадресовки	СБИС.СгенерироватьВложение — используйте команду для формирования титула переадресовки. Скачать пример: запроса ответа Есть вопросы по работе с командой — обратитесь в техническую поддержку.
СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. Скачать пример запроса и ответа	СБИС.ЗаписатьВложение — загрузите титул, сформированный в вашей системе. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п. 1 Скачать пример: запроса ответа
СБИС.ВыполнитьДействие — отправьте информацию о переадресовке. Скачать пример запроса и ответа	СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. Скачать пример запроса и ответа
	СБИС.ВыполнитьДействие — отправьте информацию о переадресовке. Скачать пример запроса и ответа
Титул замены водителей/ТС, этап «Замена водителей/ТС»
Формирование во внешней системе	Формирование в СБИС
СБИС.СписокИзменений — получите идентификатор документа. Скачать пример запроса и ответа
СБИС.ЗаписатьВложение — загрузите в СБИС титул, сформированный в вашей системе. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п. 1 Скачать пример: запроса замены водителя/транспортного средства ответа на запрос замены	СБИС.СгенерироватьВложение — используйте команду для формирования титула переадресовки. Скачать пример: запроса замены водителя/транспортного средства ответа на запрос замены Есть вопросы по работе с командой — обратитесь в техническую поддержку.
СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. Скачать пример запроса и ответа	СБИС.ЗаписатьВложение — загрузите титул, сформированный в вашей системе. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п. 1 Скачать пример: запроса замены водителя/транспортного средства ответа на запрос замены
СБИС.ВыполнитьДействие — отправьте информацию о передаче эстафеты. Скачать пример запроса и ответа	СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. Скачать пример запроса и ответа
	СБИС.ВыполнитьДействие — отправьте информацию о передаче эстафеты/переадресовке. Скачать пример запроса и ответа
Титул перевозчика (фин. состояние), запрос на изменение стоимости
Формирование во внешней системе	Формирование в СБИС
СБИС.ЗаписатьВложение — загрузите в СБИС титул, сформированный в вашей системе.	СБИС.СгенерироватьВложение — используйте команду для формирования титула переадресовки. Скачать пример: запроса на изменение стоимости ответа на запрос Есть вопросы по работе с командой — обратитесь в техническую поддержку.
СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота.	СБИС.ЗаписатьВложение — загрузите титул, сформированный в вашей системе.
СБИС.ВыполнитьДействие — отправьте информацию об изменении стоимости.	СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. Скачать пример запроса
	СБИС.ВыполнитьДействие — отправьте информацию об изменении стоимости. Скачать пример запроса
Титул отправителя (фин. состояние), рассмотреть запрос на изменение стоимости
СБИС.СписокИзменений — запросить список уведомлений по файлам, для которых нужно рассмотреть изменение стоимости. Отфильтруйте результат по полям «Тип»: «ConsignmentNote» и «Подтип»: «1110345» или «1110346».
СБИС.ПодготовитьДействие — подготовьте документ к переходу на следующий этап документооборота. «Документ/Идентификатор» — строковый идентификатор документа в системе клиента, полученный в п.1 Скачать пример запроса
СБИС.ВыполнитьДействие — отправьте информацию об изменении стоимости. Укажите вариант действия в параметре «Этап.Действие.Название»: «Согласовано» или «Отклонено» Скачать пример запроса

Готовы подключить
или остались вопросы?

Оставить заявку

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.