Интеграция со СБИС

СБИС.ВыполнитьДействие

СБИС.ВыполнитьДействие

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

Адрес для выполнения запроса: https://online.sbis.ru/service/?srv=1

Параметры строки запроса

  • "Документ": объект:
    • "Идентификатор"*: строка
    • Редакция": объект:
      • "Идентификатор"*: строка
    • "Этап"*: объект:
      • "Исполнитель": объект:

        • "Фамилия": строка

        • "Имя": строка

        • "Отчество": строка

        • "Идентификатор": строка, табельный номер (идентификатор)

      • "Подразделение": объект:

        • "Название": строка, название подразделения

        • "Идентификатор": строка, код подразделения

      • "Название"*: строка, необязательна для некоторых этапов
      • "Идентификатор"*: строка, необязательный для некоторых этапов"Отправка"
      • "Действие"*: массив из одного объекта:
        • "Название"*: строка
        • "Комментарий"*: строка, обязательна, если требуется указать комментарий
        • "Сертификат": объект. При серверном подписании указывает на требуемый сертификат:
          • "Отпечаток": строка, используется как фильтр для поиска сертификата
          • ...
      • "Вложение": массив объектов:
        • "Идентификатор": строка
        • "Файл": объект:
          • "Имя": строка
          • "ДвоичныеДанные": строка в кодировке Base64
        • "Подпись": массив объектов:
          • "Файл": объект
            • "Имя": строка
            • "ДвоичныеДанные": строка в кодировке Base64

Комментарий

Вызов «СБИС.ВыполнитьДействие» при подписании подразумевает:

  1. предварительный вызов «СБИС.ПодготовитьДействие».
  2. обязательную передачу информации о сертификате для подписания ЭП (объект «Этап.Действие.Сертификат»).

После вызова «СБИС.ПодготовитьДействие» вы можете заменить сгенерированные сервером служебные вложения на ваши собственные. При этом важно указать идентификаторы заменяемых вложений и передать двоичные данные.

Обязательно нужно указывать поле «Документ.Идентификатор» или «Документ.Редакция.Идентификатор». При заполненном «Документ.Идентификатор» обрабатывается этап и действия последней редакции. Если заполнено поле «Документ.Редакция.Идентификатор», то обрабатывается этап и действия конкретной редакции.

Рекомендуется передавать идентификатор этапа и идентификатор редакции.

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

Исключите отправку прочих, входящих в формат полей — она является лишней. Исключение — поле «Подпись» при подписании ЭП на носителе.

При вызовах функции «СБИС.ВыполнитьДействие», которые отличаются от подготовки к отправке документа, нужно передать значение поля «Документ.Этап.Идентификатор». Оно может быть получено от вызова, например, «СБИС.ПодготовитьДействие». В крайнем случае, можно указать «Документ.Этап.Название», но этот способ ненадежен. Он допускает подготовку к неверному этапу (в случае отправки новой редации документа и при попытке подготовки этапа по предыдущей).

При использовании команды можно добавлять новые неслужебные вложения. Для этого их нужно добавить к массиву «Этап.Вложение». При локальном подписании допустимо одновременное приложение электронной подписи.

Результат запроса

  • "Документ": объект:
    • "Идентификатор": строка
    • "Направление": строка
    • "СсылкаДляНашаОрганизация": строка
    • "СсылкаДляКонтрагент": строка
    • "Состояние": объект:
      • "Код": число
      • "Название": строка
      • "Примечание": строка
    • "НашаОрганизация": объект:
      • ...
    • "Контрагент": объект:
      • ...
    • "Подразделение": объект:
      • ...
    • "Ответственный": объект:
      • ...
    • "Событие": массив объектов:
      • "ДатаВремя": строка в формате "ДД.ММ.ГГГГ ЧЧ.ММ.СС"
      • "Название": строка
      • "Идентификатор": строка
      • "Комментарий": строка
      • "Вложение": массив объектов:
        • ...
    • "Этап": массив объектов:
      • "Название": строка
      • "Идентификатор": строка
      • ...
      • "Действие": массив объектов:
        • "Название": строка
        • ...

* — обязательные параметры

Пример запроса

{
  "jsonrpc": "2.0",
  "method": "СБИС.ВыполнитьДействие",
  "params": {
    "Документ": {
      "Идентификатор": "d8e74588-f9e9-4a50-a4f8-82753abc6eb2",
      "Этап": {
        "Вложение": [
          {
            "Идентификатор": "8b8d54e2-44ae-4de3-8433-f4a7c86c2c5d",
            "Подпись": [
              {
                "Файл": {
                  "ДвоичныеДанные": "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",
                  "Имя": "ON_SFAKT_1111681325111101001_1111654353111101001_20150417_0703ba7c-62d0-404d-a984-f78eed336d3a.xml.sgn"
                }
              }
            ]
          }
        ],
        "Действие": [
          {
            "Комментарий": "",
            "Название": "Отправить",
            "Сертификат": [
              {
                "Отпечаток": "6E3D6E662D33BF520312CAC4935912B039A5F5E2"
              }
            ]
          }
        ],
        "Название": "Отправка"
      }
    }
  },
  "id": 0
}
Скачать пример

Пример ответа (успех)

{
  "jsonrpc": "2.0",
  "result": {
    "Документ": [
      {
        "Вложение": [
          {
            "ВерсияФормата": "5.01",
            "Дата": "16.04.2015",
            "Идентификатор": "34fb6b9a-c902-41a9-89cf-ebc9ef0796c3",
            "Название": "Накладная № 56089268 от 16.04.15 на сумму 59 979.40р., в т.ч. НДС 9 149.40р.",
            "Направление": "Исходящий",
            "Номер": "56089268",
            "Подтип": "1175004",
            "Редакция": {
              "ДатаВремя": "16.04.2015 09.49.52",
              "Номер": "1"
            },
            "Сумма": "59979.40",
            "Тип": "ЭДОНакл"
          }
        ],
        "Дата": "16.04.2015",
        "ДатаВремяСоздания": "16.04.2015 09.49.51",
        "Идентификатор": "fc597a23-f59c-45b8-9c6e-00e98fbaac76",
        "Контрагент": {
          "СвЮЛ": {
            "ИНН": "1111681325",
            "КПП": "111101001",
            "КодСтраны": "643",
            "Название": "Тестовый Получатель"
          }
        },
        "Название": "Реализация № 56089268 от 16.04.2015",
        "Направление": "Исходящий",
        "НашаОрганизация": {
          "СвЮЛ": {
            "ИНН": "1111654353",
            "КПП": "111101001",
            "КодСтраны": "643",
            "Название": "Тестовый Отправитель"
          }
        },
        "Номер": "56089268",
        "Ответственный": {
          "Идентификатор": "",
          "Имя": "Иван",
          "Отчество": "Иванович",
          "Фамилия": "Иванов"
        },
        "Примечание": "Здесь обычно указывают примечание",
        "Регламент": {
          "Идентификатор": "8861254e-4354-11e1-9d64-005056a63fed",
          "Название": "Реализация"
        },
        "Редакция": [
          {
            "Актуален": "Нет",
            "ДатаВремя": "16.04.2015 09.49.51",
            "Идентификатор": "c84c4c5c-e404-11e4-9a9c-005056b7595f",
            "ПримечаниеИС": "РеализацияТоваровУслуг:d258e102-56a0-45c8-8108-c83a6dc610db"
          }
        ],
        "Состояние": {
          "Код": "7",
          "Название": "Выполнение завершено успешно",
          "Описание": "",
          "Примечание": ""
        },
        "СсылкаДляКонтрагент": "https://online.sbis.ru/reg/showdoc.html?params=eyJHVUlEIjoiOTM3NmkZDg5MTBmIiwi0JjQndCdIjoiMTExMTY4MTMyNSIsItCa0J%2FQnyI6IjExMTEwMTAwMSJ9",
        "СсылкаДляНашаОрганизация": "https://online.sbis.ru/opendoc.html?guid=9376c06c-8c90-4e5a",
        "СсылкаНаPDF": "https://online.sbis.ru/service/?method=%D0%A1%D0%B5%D1%80%D0%B2%D0%B8%D1D1%85%D1%80%D0%BE%D0%BD%D0%BD%D0%B0%D1%8F%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8Cparams=eyLQlNC%2B0LrRg9C80LXQvdGC0YsiOnsicyI6W3sibiI6ItCY0LTQniIsInQiOiLQp9C40YHQu9C%2BINGG0LXQu9C%2B0LUifSx7Im4iOiLQoNCw0LfQtNC10LsiLCJ0Ijoi0KfQuNGB0LvQviDRhtC10LvQvtC1In1dLCJkIjpbWzcsbnVsbF1dfSwi0JjQvNGP0J7QsdGK0LXQutGC0LAiOiLQn9C10YfQsNGC0YzQlNC%2B0LrRg9C80LXQvdGC0L7QsiIsItCY0LzRj9Cc0LXRgtC%2B0LTQ%0AsCI6ItCh0L%2FQuNGB0L7QutCU0LvRj9Cc0LDRgdGB0L7QstC%2B0LnQn9C10YfQsNGC0LgiLCLQmNC80Y%2FQpNCw0LnQu9CwIjoiIiwi0JDQstGC0L7Qv9C10YfQsNGC0YwiOnRydWV9&protocol=3&id=0",
        "СсылкаНаАрхив": "https://online.sbis.ru/service/?method=%D0%92%D0%B5%D1%80%D1%81%D0%B8%8%D0%BD%D0%B5%D0%B3%D0%BE%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0.%D0%A1%D0%BE%D1%85%D1%80%D0%B0%D0%BD%D0%B8%D1%82%D1%8C%D0%9D%D0%B0%D0%94%D0%B8%D1%81%D0%BAparams=eyLQmNC00J4iOjd9&protocol=3&id=0",
        "Сумма": "",
        "Тип": "ДокОтгрИсх",
        "Удален": "Нет"
      }
    ],
    "Навигация": {
      "ЕстьЕще": "Нет",
      "РазмерСтраницы": "25",
      "Страница": "0"
    }
  },
  "id": 0
}
Скачать пример