API ЭДО.Поток

Программный интерфейс приложений (API)
для работы с ИС «ЭДО.Поток»

Версия 3.8 от 09.12.21 Открыть pdf-файл

Введение

Информационной системе «ЭДО.Поток» реализован программный интерфейс приложений (API). API позволяет сторонним приложениям работать с данными информационной системы (ИС) «ЭДО.Поток». В инструкции описаны методы API для получения данных из информационной системы (ИС) «ЭДО.Поток» сторонними приложениями. Взаимодействие клиентского приложения и API производится путем отправки приложением HTTP-запросов к серверу и получением ответов на них. Для отправки запросов и получения ответов используется протокол HTTPS.
В случае возникновения проблем использования ИС «ЭДО.Поток», подробно опишите их и отправьте на edo@edo.ru.
Ниже описаны запросы HTTP, которыми реализуются функции API по работе с ИС «ЭДО.Поток».

Общий вид запроса и ответа в API
Кодировка, используемая в запросах и ответах — Windows-1251. Запросы выполняются методами POST и GET, параметры запроса располагаются в структуре данных формата JSON, передаваемой в блоке данных запроса (при использовании POST), также параметры могут передаваться в строке запроса (при использовании GET).
Ответы выдаются сервером в формате JSON и, в случае успешности ответа согласно его заголовку (код ответа по протоколу HTTP равен 200), данные имеют следующий обобщенный вид:

{
  "status": {
    "code": 0,
    "message": "string"
  }
  "result": {
  ...
  }
}

Здесь:

  • «result» — произвольный тип данных (часто — структура данных, вид которой определяется видом запроса);
  • «status» — структура, описывающая состояние обработки запроса.

Состав и назначение полей см. в раздел 1.2. таблицу 1.1.

1. Начало работы в ИС «ЭДО.Поток»

1.1 Регистрация в ИС «ЭДО.Поток»

Метод позволяет зарегистрироваться в ИС «ЭДО.Поток» и получить логин и пароль. Логин и пароль необходим для авторизации и работы с API.

Используется метод POST следующего вида:

POST https://lk.edo.ru/api/edo/{version}/clients/registration

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Запрос должен выглядеть следующим образом:

POST https://lk.edo.ru/api/edo/v1/clients/registration
Content-Type: application/json

{
  certificate: "MIIKJTCCCdKgAwIBAgIRAgHuzADNrbL....Строка"
  email: "belka@ofd.ru"
  fullLegalAddress: "г Москва"
  fullName: "ИП Пирогова Александра Андреевна"
  ifns: "7700"
  inn: "772863973810"
  kpp: ""
  legalAddress: {fullName: "г Москва", area: null, building: null, city: "Москва", houseNumber: null, office: null,…}
  area: null
  building: null
  city: "Москва"
  fullName: "г Москва"
  houseNumber: null
  office: null
  postalCode: "101000"
  region: "Москва"
  settlement: null
  street: null
  mailAddress: "г Москва"
  name: "Виктория"
  ogrn: "314774617000610"
  password: "TestTest94"
  phone: "99999999999"
}

Назначение полей структуры запроса регистрации приведено в таблице 1.1.

Таблица 1.1. Поля структуры запроса регистрации

Параметр Вложенные поля Формат значения Описание
certificate String Сертификат, экспортированный в формате base64
email String Email клиента
fullLegalAddress String Юридический адрес клиента (полный)
fullName String Полное название организации
ifns String Код ИФНС, состоит из 4-х цифр
inn String ИНН
kpp String КПП
legalAddress Структура Юридический адрес клиента (по составляющим)
fullName String Юридический адрес клиента (единое название), например «г Москва, ул Хуторская 2-я, д 38А стр 15»
area String Область
city String Город
street String Улица
houseNumber String Номер здания
building String Строение/корпус
office String Номер офиса
postalCode String Почтовый индекс
region String Регион
settlement String Поселок
mailAddress mailAddress String Адрес компании для корреспонденции (полный, например «г Москва, ул Хуторская 2-я, д 38А стр 15»)
name String ФИО пользователя
ogrn String ОГРН/ОГРИП компании
password String Пароль от личного кабинета EDO.ru
phone String Номер телефона

В ответ на запрос сервер возвращает структуру данных (приведены примеры значений):

{
  "result": {
    "clientId": "string",
    "password": "string"
  },
  "status": {
    "code": 0,
    "message": "some message here"
  }
}

Назначение полей структуры ответа на запрос регистрации приведено в таблице 1.2.

Таблица 1.2. Поля структуры ответа на запрос регистрации

Параметр Вложенные поля Формат значения Описание
result Структура Состояние запроса
clientId String логин клиента
password String пароль клиента
status Структура Состояние запроса
code Integer Числовое представление статуса
message String Сообщение с описанием статуса/ошибки

Доступ в ИС «ЭДО.Поток» возможен при использовании учетной записи пользователя.
Для получения доступа к учетной записи пользователя необходимо успешно пройти процедуру авторизации с помощью механизма AuthToken.

После успешной авторизации пользователь получает токен. И далее к каждому HTTP-запросу к ЭДО.Поток требуется добавлять HTTP-заголовок Authorization с параметром Token {TOKEN}.

Authorization: Token {TOKEN}

Здесь: {TOKEN} — токен, возвращенный в результате авторизации (см. п. 1.1.).

Например, команда получения списка доступных входящих документов транслируется в следующий HTTP-запрос

GET https://lk.edo.ru/api/edo/v1/documents?direction=in
Authorization: Token 99a6f59f-4b2d-4b85-a8e8-0b3231983573

1.2. Авторизация через AuthToken

Авторизация посредством механизма AuthToken предполагает использование квалифицированной электронной подписи (КЭП). Для авторизации необходимо проделать следующую последовательность действий.

1. Со стороны клиента должен быть направлен запрос следующего вида:

GET https://lk.edo.ru/api/edo/{version}/clients/auth-with-ds?fingerprint={fprint1}

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {fprint1} — отпечаток сертификата.

В ответ на запрос сервер возвращает структуру данных (приведены примеры значений):

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": "c698a3c9-d22f-4a93-9a8d-d8310cac326a"
}

Назначение полей структуры ответа на запрос авторизации приведено в таблице 1.3.

Таблица 1.3. Поля структуры ответа на запрос авторизации

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result String Поле с ключом «result» имеет тип данных «Строка», и в нем возвращается строка для подписания, которая будет использована в следующих шагах.
Действителен в течение суток с момента получения

2. Клиент подписывает строку для подписания с помощью КЭП, а затем отправляет ее вместе с подписью (CMS detached container), закодированную по алгоритму “Base64”, на тот же адрес URL с помощью запроса следующего вида:

POST https://lk.edo.ru/api/edo/{version}/clients/auth-with-ds

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Тело запроса содержит следующую структуру (приведены примеры значений):

POST https://lk.edo.ru/api/edo/v1/clients/auth-with-ds
Content-Type: application/json

{
  "cmsDetached": "UTA9STK1...",
  "content": "IDMYUTA9STK11070FQL..."
}

Назначение полей тела запроса на получение токена приведено в таблице 1.4.

Таблица 1.4. Поля структуры запроса на получение токена

Параметр Формат значения Описание
cmsDetached String Результат подписания строки (параметр result в ответе на запрос GET /auth-with-ds), закодированный с помощью “Base64”. Результат, после кодировки должен быть представлен в виде строки (не забудьте удалить символы переноса срок, например '\n' и '\r')
content String Сама строка для подписания, полученная на предыдущем шаге (параметр result в ответе на запрос GET /auth-with-ds)

3. Сервер производит проверку переданной строки, и в случае успешной проверки возвращает структуру данных (приведены примеры значений):

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    {
    "sessionId": "440d14a5-9070-49e1-abcd-baa013ff23ad",
    "edoOrgId": "2PS-24610035090000000000000095636522"
    }
  }
}

Назначение полей структуры ответа на запрос авторизации приведено в таблице 1.5.

Таблица 1.5. Поля структуры ответа на запрос авторизации

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Параметры авторизации
sessionId String Токен, далее используемый клиентом в качестве дополнительного параметра в последующих запросах к API.
Действителен в течение суток с момента получения
edoOrgId String Ваш идентификатор участника ЭДО

2. ЭДО.Поток

Запросы (функции) программного интерфейса приложений ИС «ЭДО.Поток» предназначены для выполнения операций документооборота (пересылка, сохранение, подписание документов) для внешних информационных систем, взаимодействующих с ИС «ЭДО.Поток». Большинство запросов и ответов имеет вид, описанный в разделе 2, если входные и выходные данные будут другого вида, это будет описываться дополнительно. Данные документов при передаче кодируются алгоритмом “Base64”. Запросы API ИС «ЭДО.Поток» можно разделить на три группы: запросы, связанные с документами, запросы связанные с клиентами и запросы, связанные с контрагентами. К запросам, связанным с клиентами относится также и авторизация пользователя в системе, описанная в разделе 3.

2.1. Документооборот

2.1.1. УПД/УКД

Универсальный передаточный документ (УПД) можно использовать как:

  • счет-фактуру (функция СЧФ);
  • первичный документ, подтверждающий совершение хозяйственной операции, например накладную или акт (функция СЧФДОП);
  • документ, который совмещает в себе счет-фактуру и первичный документ, подтверждающий совершение хозяйственной операции (функция ДОП).

Универсальный корректировочный документ (УКД) можно использовать как:

  • корректировочную счет-фактуру (функция КСЧФ);
  • документ об изменении стоимости в первичном документе (функция КСЧФДИС);
  • документ, который совмещает в себе корректировочную счет-фактуру и документ об изменении стоимости в первичном документе (функция ДИС).

Форматы

Документ Подробное описание Форматы Тип документа
в ЭДО.Поток
Счет-фактура Счет-фактура
УПД с функцией СЧФ
Приказ №93 (устарел)
Приказ №155 (устарел)
Приказ №820
1
Счет-фактура (исправительный)
УПД (исправительный) с функцией СЧФ
Приказ №93 (устарел)
Приказ №155 (устарел)
Приказ №820
9
Счет-фактура Корректировочный Счет-фактура Корректировочный
УКД с функцией КСЧФ
Приказ №93 (устарел)
Приказ №189 (устарел)
Приказ №736
2
Счет-фактура Корректировочный (исправительный)
УКД (исправительный) с функцией КСЧФ
Приказ №93 (устарел)
Приказ №189 (устарел)
Приказ №736
10
УПД УПД с функциями СЧФДОП и ДОП Приказ №155 (устарел)
Приказ №820
8
УПД (исправительный) с функциями СЧФДОП и ДОП Приказ №155 (устарел)
Приказ №820
30
Титул покупателя УПД Приказ №155 (устарел)
Приказ №820
11
УКД УКД с функциями КСЧФДИС и ДИС Приказ №189 (устарел)
Приказ №736
12
УКД (исправительный) с функциями КСЧФДИС и ДИС Приказ №189 (устарел)
Приказ №736
31
Титул покупателя УКД Приказ №189 (устарел)
Приказ №736
13

Порядок обмена по приказу 14Н

УПД с функцией СЧФ / УКД с функцией КСЧФ


Рисунок 1. Счет-фактура

УПД с функцией СЧФДОП / УКД с функцией КСЧФДИС


Рисунок 2. УПД

2.1.1. Описание "Action"

«Action»- это список возможных процедур с документами. Список возможных процедур выводится в соответствии с документом. В таблице 2.2. описаны процедуры с документами в соответствие с Action.

Таблица 2.2. Описание процедур с документами в соответствие с Action

Action Документы Действия Описания процедуры
W_BuyerTitle_Accept_Sign_Title_Iop УПД (функция СЧФДОП), УКД (функция КСЧФДИС), в том числе исправительные.
Порядок обмена согласно Приказу 14н
Подписать Для подписания документа требуется:
1. Запросить извещение о получении (ИОП) методом "Сформировать ИОП", подписать КЭП и отправить методом "Отправить ИОП".
2. Запросить титул покупателя методом "2.3.4. Сформировать титул покупателя", подписать КЭП и отправить методом "Отправить титул покупателя".
W_BuyerTitle_Accept_Sign_Title Подписать Извещение о получении (ИОП) уже успешно подписано, осталось запросить титул покупателя методом "2.3.4. Сформировать титул покупателя", подписать КЭП и отправить методом "Отправить титул покупателя".
W_BuyerTitle_Accept_Sign_Ukd_Title_Iop Подписать 1. Запросить извещение о получении (ИОП) методом "Сформировать ИОП", подписать КЭП и отправить методом "Отправить ИОП".
2. Запросить титул покупателя методом "2.3.4. Сформировать титул покупателя", подписать КЭП и отправить методом "Отправить титул покупателя".
W_BuyerTitle_Accept_Sign_Ukd_Title Подписать Извещение о получении (ИОП) уже успешно подписано, осталось запросить титул покупателя методом "2.3.4. Сформировать титул покупателя", подписать КЭП и отправить методом "Отправить титул покупателя".
W_BuyerTitle_Reject_Sign_Uou_Iop Отказать в подписи 1. Запросить извещение о получении (ИОП) методом "Сформировать ИОП", подписать КЭП и отправить методом "Отправить ИОП".
2. Запросить Уведомление об уточнении (УОУ) методом "Сформировать УОУ", подписать КЭП и отправить методом "Отправить УОУ".
W_BuyerTitle_Reject_Sign_Uou Отказать в подписи Извещение о получении (ИОП) уже успешно подписано, осталось запросить Уведомление об уточнении (УОУ) методом "Сформировать УОУ", подписать КЭП и отправить методом "Отправить УОУ".
Wo_BuyerTitle_Reject_Sign_Uou_Iop Счет-фактура, корректировочная счет-фактура, УПД (функция СЧФ), УКД (функция ксчф), в том числе исправительные.
Порядок обмена согласно Приказу 14н
Запросить уточнение 1. Запросить извещение о получении (ИОП) методом "Сформировать ИОП", подписать КЭП и отправить методом "Отправить ИОП".
2. Запросить Уведомление об уточнении (УОУ) методом "Сформировать УОУ", подписать КЭП и отправить методом "Отправить УОУ".
Wo_BuyerTitle_Reject_Sign_Uou Запросить уточнение Извещение о получении (ИОП) уже подписано или по схеме работы с некоторыми операторами ЭДО ИОП не нужен.
Осталось запросить Уведомление об уточнении (УОУ) методом "Сформировать УОУ", подписать КЭП и отправить методом "Отправить УОУ".
Wo_BuyerTitle_Accept_Sign_Iop Подтвердить получение Запросить извещение о получении (ИОП) методом "Сформировать ИОП", подписать КЭП и отправить методом "Отправить ИОП"
ActionTakeUPD УПД (функция СЧФДОП, ДОП), в том числе исправительные. Подписать
ActionTakeUKD УКД (функция КСЧФДИС), в том числе исправительные. Отказать в подписи
ActionSign Неформализованные документы с запросом подписи Подписать
ActionRequestRefine Отказать в подписи
ActionRequestRefine_FastFinished Отказать в подписи
ActionSign_FastFinished Подписать
ActionRemove Доступно для всех неархивированных документов Архивировать
ActionRecover Доступно для всех архивированных документов Восстановить документ из архива

2.2. Работа с документами

2.2.1. Получение списка документов клиента

Для получения списка документов клиента используется HTTP-метод “GET”, в ответ на запрос возвращается список документов клиента, в соответствии с переданным токеном. Список документов клиента может быть запрошен как по всему времени пользования системой, так и по заданному периоду (см. ниже).
Также может быть запрошен как полный список документов, так и его часть (страница), исходя из принципа деления списка на страницы равной длины. Длина страницы и номер выдаваемой страницы определяются в параметрах запроса (см. ниже).
Запрос на получение списка документов клиента имеет вид:

GET https://lk.edo.ru/api/edo/{version}/documents?direction=DIRECTION&from=DATE1&to=DATE2&pageIndex=INDEX&pageRecords=NUM1&sortKey=KEY1&sortDirection=DIR1&typeOfDate=TYPE

Все параметры в данном запросе приведены в таблице 2.3.

Таблица 2.3. Параметры запроса на получение списка документов

Параметр Заменяемая строка Описание Значение по умолчанию Обязательно в запросе
{version} Версия системы v1 да
direction DIRECTION Направление документооборота. Возможные значения:
in — входящие документы;
out — исходящие документы;
deleted — удаленные документы.
да
from DATE1 Начальная дата периода поиска документов в формате (dd.mm.yyyy), где dd — день, mm — месяц, yyyy — год нет
to DATE2 Конечная дата периода поиска документов в формате (dd.mm.yyyy) нет
pageIndex INDEX Номер запрашиваемой страницы списка документов; в виде десятичного целого числа 1 нет
pageRecords NUM Количество записей на странице. В виде десятичного целого числа 1000 нет
sortKey KEY1 Столбец для сортировки doc_id нет
sortDirection DIR1 Порядок сортировки. Возможные значения:
asc — восходящая (прямой порядок);
desc — нисходящая (обратный порядок).
desc нет
typeOfDate TYPE Способ интерпретации даты в полях from и to:
STATUS_CHANGE_DATE — дата изменения статуса;
RECEIVED_DATE — дата получения документа;
CREATION_IN_DOCUMENT_DATE — дата формирования документа.
RECEIVED_DATE нет

Далее здесь во всех запросах будет указана первая версия API (“v1”).

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

GET https://lk.edo.ru/api/edo/v1/documents?direction=out&from=31.08.2018&to=01.09.2018&pageIndex=1&pageRecords=50&sortKey=Doc_id&sortDirection=asc&docType=without_service_docs
Authorization: Token 99a6f59f-4b2d-4b85-a8e8-0b3231983573

Пример успешного ответа на запрос (приведены примеры значений, многоточие означает многократно повторяющуюся структуру):

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "data": [
      {
        "direction": "OUT",
        "docId": 2610,
        "fromOrgId": "2PS-003245025998032",
        "fromOrgName": "PS ST",
        "toOrgId": "2PS-00440111648005445",
        "toOrgName": "ИП Иванов",
        "edoIdFrom": "000-00010035090000000000000095600000",
        "edoIdTo": "000-0000000000003516438590065861909",
        "docTypeId": 1,
        "docTypeName": "Счёт-фактура",
        "docStateId": 0,
        "docStateName": "Создан",
        "sfStateName": "Подписано отправителем",
        "sfStateId": 3,
        "innFrom": "000000000",
        "innTo": "000000000000",
        "kppFrom": "00000000",
        "kppTo": null,
        "content": null,
        "xmlBody": "PD94bWwgdmVyc2...",
        "imgBody": null,
        "signature": "MIIGGAYJKoZIhvcNAQcCoII Строка...",
        "certificateSerialNumber": null,
        "fileName": "ON_SCHFDOPPR_2PS-0069110332410689418822_2PS-007841465194609667_20180820_80aa0ec5-d512-48a1-b504-7d84872d5dcf",
        "docName": null,
        "docNumber": "11321",
        "docDate": "01.09.2020 00:00:00",
        "sumAll": null,
        "sumNds": null,
        "updPokupatelyaId": null,
        "marking": false,
        "fingerprint": "4ff4214c64e8d8db2046defab0dAAAA",
        "mcDocState": "MC_NONE",
        "actions": [
          "ActionRemove",
          "ActionSentRefine",
          "ActionVisualization"
        ],
        "forDocument": [
          null
        ],
        "guid": null,
        "updated": "2018-08-31 13:17"
        "nds": false,
        "signRequested": false
       }
       ...
     ],
    "pageInfo": {
      "pageIndex": 1,
      "pageRecords": 1000,
      "pageCount": 1,
      "sortKey": "doc_id",
      "sortDirection": "desc"
    }
  }
}

Описание параметров структуры ответа приведены в таблице 2.4.

Таблица 2.4. Описание параметров структуры ответа на запрос списка документов

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Содержащая список документов
data Структура Данные списка документов
direction String Признак документа:
OUT — исходящий;
IN — входящий
docId Integer Идентификационный номер (индекс) документа
fromOrgId String Идентификатор организации-отправителя
fromOrgName String Название организации-отправителя
edoIdFrom String Идентификатор в ЭДО организации-отправителя
edoIdTo String Идентификатор в ЭДО организации-получателя
toOrgId String Идентификатор организации-получателя
docTypeId Integer Идентификатор типа документа
docTypeName String Название типа документа
docStateId Integer Идентификатор статуса (состояния) документа
sfStateName String Статус подписи документа
sfStateId Integer Идентификатор статуса подписи документа
innFrom String ИНН организации-отправителя
innTo String ИНН организации-получателя
kppFrom String КПП организации-отправителя
kppTo String КПП организации-получателя
content String Содержимое документа, закодированное с помощью алгоритма “Base 64”
xmlBody String Содержит тело документа в виде двоичного массива, закодированного с помощью алгоритма «Base 64”
imgBody String Содержит тело документа в виде двоичного массива, закодированного с помощью алгоритма «Base 64”
signature String Открепленная подпись в формате PKCS#7/CMS с публичной частью сертификата, закодированная с помощью алгоритма “Base 64”
certificateSerialNumber String Серийный номер сертификата
fileName String Наименование файла
docName String Наименование документа
docNumber String Номер документа
docDate String Дата генерации документа
sumAll String Общая сумма по документу
sumNds String Общая сумма НДС по документу
updPokupatelyaId String Идентификатор УПД покупателя
marking Boolean Признак наличия маркировки
mcDocState String Стейт отправки документа в ЦРПТ
actions Структура Служебная информация о возможных действиях с документом
forDocument Структура Информация о родительском документе
guid String Уникальный идентификатор
updated String Дата и время последнего обновления, формат ISO, с указанием часов и минут (без секунд, дата и время разделены пробелом)
nds Boolean Признак необходимости расчета НДС
signRequested Boolean Признак необходимости подписания документа
pageInfo Структура Информация о делении списка на страницы и о передаваемой странице списка
pageIndex Integer Номер передаваемой страницы
pageRecords Integer Количество строк списка на странице
pageCount Integer Количество страниц в списке
sortKey String Имя поля ключа сортировки (аналогично запросу)
sortDirection String Направление сортировки (аналогично запросу)

2.2.2. Метод получения справочника статусов документов

Для получения справочника статусов документов используется HTTP-метод “GET”, в ответ на запрос возвращается справочник статусов документов. Запрос на получения справочника статусов документов имеет вид:

GET https://lk.edo.ru/api/edo/{version}/dictionary/get-document-status?direction={status}

Описание параметров запроса приведены в таблице 2.5.

Таблица 2.5. Описание параметров запроса на получения статусов документов

Параметр Заменяемая строка Описание Значение по умолчанию Обязательно в запросе
{version} Версия системы v1 да
direction {status} Направление документооборота. Возможные значения:
in — входящие документы;
out — исходящие документы;
deleted — архивные документы.
да

Далее здесь во всех запросах будет указана первая версия API (“v1”).

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

GET https://lk.edo.ru/api/edo/v1/dictionary/get-document-status?direction=in
Authorization: Token 99a6f59f-4b2d-4b85-a8e8-0b3231983573

Пример успешного ответа на запрос (приведены примеры значений, многоточие означает многократно повторяющуюся структуру):

{
    "status": {
        "code": 0,
        "message": "OK"
    },
    "result": {
        "Завершенные": [
            {
                "idList": [
                    "32"
                ],
                "name": "Аннулирован"
            },
            {
                "idList": [
                    "16",
                    "26",
                    "24"
                ],
                "name": "Подписан"
            },
            ...
        ],
        "Требуется обработка": [
            {
                "idList": [
                    "7",
                    "6",
                    "5",
                    "4",
                    "2004",
                    "12",
                    "2026",
                    "2002"
                ],
                "name": "Требуется подписать извещение"
            },
            ...
        ],
        "Ожидается ответ контрагента": [
            {
                "idList": [
                    "701"
                ],
                "name": "В обработке"
            },
           ...
        ]
    }
}

Описание параметров структуры ответа приведены в таблице 2.6.

Таблица 2.6. Описание параметров структуры ответа

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Список ID номеров статусов
Завершенные Array Список ID номеров статусов
Массив может содержать списки документов со статусами:
— «Аннулирован»;
— «Подписан»;
— «Ошибка»;
— «Документооборот завершен»;
— «Отказ в подписи».
Требуется обработка Array Список ID номеров статусов
Массив может содержать списки документов со статусами:
— «Требуется подписать извещение»;
— «Требуется подпись».
Ожидается ответ контрагента Array Список ID номеров статусов
Массив может содержать списки документов со статусами:
— «В обработке»;
— «Ожидается ответ о доставке»;
— «Отправлен запрос уточнения».

2.2.3. Отправка документа

Для отправки формализованного документа заданному получателю используется запрос на основе метода POST.
Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/documents/send

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

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

POST https://lk.edo.ru/api/edo/v1/documents/send
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "to": "2PS-00631566061106315010010016107897",
  "docType": 7,
  "content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNv...",
  "signature": "MIIGGAYJKoZIhvcNAQcCoIIGCTCCBg...",
  "fileName": "my_file.txt",
  "parentDocId": "",
  "docAttrs": {
    "docName": "docName",
    "docNumber": "N-345",
    "docDate": "04.10.2018",
    "sumAll": "154.3",
    "sumNds": "12.3",
    "isNds": true,
    "isSignRequested": false
  }
}

Описание параметров запроса на отправку документа приведены в таблице 2.7.

Таблица 2.7. Описание параметров запроса на отправку документа

Параметр Вложенные поля Формат значения Описание Обязательно в запросе
to String Идентификатор получателя да
docType Integer Тип документа да
content String Содержимое документа, закодированное с помощью алгоритма “Base 64” да
signature String Открепленная подпись в формате PKCS#7/CMS с публичной частью сертификата, закодированная с помощью алгоритма “Base 64” да
fileName String Имя файла документа да
parentDocId String Идентификатор документа, на основании которого был сгенерирован текущий документ нет
docAttrs Структура Содержит дополнительную информацию о документе нет
docName String Наименование документа нет
docNumber String Номер документа нет
docDate String Дата генерации документа нет
sumAll String Общая сумма по документу, указывается с использованием “.”, например “356.00” нет
sumNds String Общая сумма НДС по документу, указывается с использованием “.”, например “12.10” нет
isNds Boolean Признак необходимости расчета НДС нет
isSignRequested Boolean Признак необходимости подписания документа нет

Пример успешного ответа на запрос описан в разделе "Введение", при этом параметр «message» имеет значение «OK», а «result» имеет значение «null».

2.2.4. Получение списка документов для подписания

Для получения клиентом списка документов для подписания используется HTTP-метод “GET”, в ответ на запрос возвращается список документов, в соответствии с переданным токеном.
Запрос на получение списка документов на подписание имеет вид:

GET https://lk.edo.ru/api/edo/{version}/documents/for-signing?req-duplex-sign={REQ1}

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

GET https://lk.edo.ru/api/edo/v1/documents/for-signing?req-duplex-sign=false
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Описание параметров запроса приведены в таблице 2.8.

Таблица 2.8. Описание параметров запроса на получение списка документов для подписания

Параметр Заменяемая строка Описание Значение по умолчанию Обязательно в запросе
{version} Версия системы v1 1) да
req-duplex-sign {REQ1} Тип возвращаемых документов:
true — технологические (не требующие второй подписи) и прочие (требующие вторую подпись);
false — только технологические
false нет

Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": [
    {
      "docId": 4483,
      "fromOrgId": "252",
      "fromOrgName": "ООО ПС-СТ",
      "toOrgId": "1",
      "toOrgName": "ОФД.РУ",
      "edoIdFrom": "2PS-00324502599803245010010096511518",
      "edoIdTo": "2PS",
      "docTypeId": 3,
      "docTypeName": "Извещение о получении электронного документа",
      "docStateId": 0,
      "docStateName": "Ожидается извещение о получении",
      "sfStateName": "Ожидается извещение о получении",
      "sfStateId": 2,
      "content": "PD94bWwgdmVyc2lvbiA9IjEuMCIgZW5jb2R...",
      "signature": null,
      "fileName": "DP_IZVPOL_2PS_2PS-0032450259980324...",
      "certFingerprint": null,
      "docName": null,
      "docNumber": null,
      "docDate": null,
      "sumAll": null,
      "sumNds": null,
      "updated": "17.10.2018 11:15:01",
      "nds": false
    }
  ]
}

Описание параметров ответа на запрос приведены в таблице 2.9.

Таблица 2.9. Описание параметров ответа на запрос списка документов на подписание

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Список документов на подписание
docId Integer Идентификационный номер (индекс) документа
fromOrgId String Идентификатор документа, присвоенный организацией-отправителем
fromOrgName String Название документа, присвоенное организацией-отправителем
toOrgId String Идентификатор документа, присвоенный организацией-получателем
toOrgName String Название документа, присвоенное организацией-отправителем
edoIdFrom String Название системы ЭДО отправителя (в случае передачи документов между различными системами ЭДО)
edoIdTo String Название системы ЭДО получателя (в случае передачи документов между различными системами ЭДО)
docTypeId Integer Идентификатор типа документа
docTypeName String Название типа документа
docStateId Integer Идентификатор статуса (состояния) документа
docStateName String Статус документа
sfStateName String Статус подписи документа
sfStateId Integer Идентификатор статуса подписи документа
content String Содержимое документа, закодированное с помощью алгоритма “Base 64”
signature String Открепленная подпись в формате PKCS#7/CMS с публичной частью сертификата, закодированная с помощью алгоритма “Base 64”
fileName String Имя файла документа
certFingerprint String Отпечаток сертификата
docName String Наименование документа
docNumber String Номер документа
docDate String, описывающая момент времени (дату и время в формате ISO) Дата формирования документа
sumAll String Общая сумма по документу
sumNds String Общая сумма НДС по документу
updated String, описывающая момент времени (дату и время в формате ISO) Дата последнего изменения документа
nds Boolean Признак необходимости расчета НДС

2.2.5. Получение предварительно заполненного шаблона документа

В некоторых случаях необходимо, чтобы «ЭДО.Поток» возвращал предварительно заполненные шаблоны XML-документов для УПД-покупателя, УКД покупателя, либо уточняющего документа.
Данные документы могут быть частично сформированы на стороне оператора ЭДО по данным родительского документа (СФ, УПД, УКД).
Недостающая часть информации вводится пользователем ИС «ЭДО.Поток» на веб-странице вручную.
Запросить предварительно заполненные шаблоны XML-документов можно с помощью запроса на основе метода POST.
Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/documents/get-doc-template

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Параметры запроса располагаются в теле запроса и имеют вид следующей структуры (приведены примеры значений):

POST https://lk.edo.ru/api/edo/v1/documents/get-doc-template
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "docTypeId": 6,
  "parentDocId": 3972,
  "textRefinement": "Текстовый комментарий",
  "fingerprint": "4ff4214c64e8d8db2046defab0dAAAA"
}

Описание параметров запроса предварительно заполненной формы приведены в таблице 2.10.

Таблица 2.10. Описание параметров запроса предварительно заполненной формы

Параметр Формат значения Описание Обязательно в запросе
docTypeId Integer Идентификатор типа документа для частично заполняемого бланка да
parentDocId Integer Идентификатор документа, на основе которого производится частичное заполнение да
textRefinement String Текстовый комментарий да
fingerprint String Отпечаток сертификата да

Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNv..."
}

Описание параметров структуры ответа на запрос предварительно заполненной формы приведено в таблице 2.11.

Таблица 2.11. Описание параметров структуры ответа на запрос предварительно заполненной формы

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result String Содержимое предварительно заполненной формы, закодированное с помощью алгоритма “Base 64”

2.2.6. Подписание документа

Для отправки формализованного документа заданному получателю используется запрос на основе метода POST.
Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/documents/add-signature

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Параметры запроса располагаются в теле запроса и имеют вид следующей структуры (приведены примеры значений):

POST https://lk.edo.ru/api/edo/v1/documents/add-signature
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "docId": "2614",
  "signature": "MIIGGAYJKoZ…"
}

Описание параметров запроса на отправку документа приведены в таблице 2.12.

Таблица 2.12 . Описание параметров запроса на отправку документа

Параметр Формат значения Описание Обязательно в запросе
docId String Идентификатор подписываемого документа да
signature String Открепленная подпись в формате PKCS#7/CMS с публичной частью сертификата, закодированная с помощью алгоритма “Base 64” да

Пример успешного ответа на запрос описан в разделе "Введение", при этом параметр «message» имеет значение «OK», а «result» имеет значение «null».

2.2.7. Удаление документа

Для удаления документа используется запрос на основе метода POST.
Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/documents/remove-doc

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Параметры запроса располагаются в теле запроса и имеют вид следующей структуры (приведены примеры значений):

POST https://lk.edo.ru/api/edo/v1/documents/remove-doc
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "docId": "2604"
}

Параметр docId — идентификатор удаляемого документа.
Пример успешного ответа на запрос описан в разделе "Введение", при этом параметр «message» имеет значение «OK», а «result» имеет значение «null».

2.2.8. Восстановление документа

Для восстановления удаленного документа используется запрос на основе метода POST.
Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/documents/recover-doc

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Параметры запроса располагаются в теле запроса и имеют вид следующей структуры (приведены примеры значений):

POST https://lk.edo.ru/api/edo/v1/documents/recover-doc
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "docId": "2604"
}

Параметр docId — идентификатор удаляемого документа.
Пример успешного ответа на запрос описан в разделе "Введение", при этом параметр «message» имеет значение «OK», а «result» имеет значение «null».

2.2.9. Получение детализированной информации о документе

Для получения детализированной информации о документе используется запрос на основе метода GET; запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/documents/document?docId={ID1}

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {ID1} — идентификатор документа.

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

GET https://lk.edo.ru/api/edo/v1/documents/document?docId=878998
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "docId": 4483,
    "fromOrgId": "252",
    "fromOrgName": "ООО ПС-СТ",
    "toOrgId": "1",
    "toOrgName": "ОФД.РУ",
    "edoIdFrom": "2PS-00324502599803245010010096511518",
    "edoIdTo": "2PS",
    "docTypeId": 3,
    "docTypeName": "Извещение о получении электронного документа",
    "docStateId": 0,
    "docStateName": "Ожидается извещение о получении",
    "sfStateName": "Ожидается извещение о получении",
    "sfStateId": 2,
    "content": "PD94bWwgdmVyc2lvbj0iMTItLRIN...",
    "signature": null,
    "fileName": "DP_IZVPOL_2PS_2PS-0032450259980324...",
    "certFingerprint": null,
    "sumAll": null,
    "sumNds": null,
    "updated": "17.10.2018 11:15:01"
  }
}

Описание параметров ответа описаны в таблице 2.5., п. 2.1.3..

2.2.10. Получение комплекта документов

Запросить комплект связанных документов можно с помощью запроса на основе метода GET, при этом в ответе будут присутствовать все документы комплекта (СФ, ИСФ, КСФ, ИКСФ).
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/documents/doc-chain?docId={ID1}

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {ID1} — идентификатор документа.

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

GET https://lk.edo.ru/api/edo/v1/documents/doc-chain?docId=8789987
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос, приведён в п. 2.1.3.

2.2.11. Вывод справочника типов документов

Запросить справочник типов документов, определенных в системе, с указанием их названия, внутреннего идентификатора и признака формализованности можно с помощью запроса на основе метода GET.
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/dictionary/get-document-type

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

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

GET https://lk.edo.ru/api/edo/v1/dictionary/get-document-type
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Успешный ответ на запрос имеет следующий вид (приведены примеры значений):

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": [
    {
      "id": 1,
      "name": "Счёт-фактура",
      "formalized": true
      "technical": false,
      "primary": true,
      "pokTitle": false
    }
  ]
}

Описание параметров ответа на запрос справочника типов документов приведены в таблице 2.13.

Таблица 2.12. Описание параметров ответа на запрос справочника типов документов

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Список документов
id Integer Внутренний идентификатор типа документа
name String Название типа документа
formalized Boolean Признак формализованности шаблона документа
technical Boolean Признак технического документа
primary Boolean Признак первичного документа
pokTitle Boolean Признак вторичного документа

2.2.12. Загрузка документа

Запросить содержимое документа можно с помощью запроса на основе метода GET, при этом в ответе будут присутствовать все документы комплекта (СФ, ИСФ, КСФ, ИКСФ).
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/documents/download-doc?docId={ID1}&downloadType={TYPE1}

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

GET https://lk.edo.ru/api/edo/v1/documents/download-doc?docId=877678&downloadType=CURRENT
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Описание параметров запроса приведены в таблице 2.14.
Таблица 2.14. Описание параметров запроса загрузки документа

Параметр Заменяемая строка Описание Значение по умолчанию Обязательно в запросе
{version} Версия системы v1 2) да
docId {ID1} Идентификатор загружаемого документа да
downloadType {TYPE1} Тип загрузки:
CURRENT — загрузка только текущего документа с заданным идентификатором;
WITH_SERVICE — загрузка документа с дополнительными служебными документами в архивном файле (.zip)
CURRENT нет

В ответ на данный запрос начинается загрузка файла в двоичном виде. В заголовках ответа (response headers) указывается имя загружаемого файла.

2.2.13. Получение извещения на подтверждение оператора (для отправителя)

После того как организация отправила документ, Оператор ЭДО создает подтверждение оператора о дате получение документа, подписывает его и направляет организации. Затем, когда организация получила подтверждение оператора, она должна отправить в ответ подписанное извещение о получении данного подтверждения.

Для получения извещения о подтверждении оператора о дате получения документа используется запрос на основе метода GET.
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/documents/for-sync-signing?docId={ID1}

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {ID1} — идентификатор документа.


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

GET https://lk.edo.ru/api/edo/v1/documents/for-sync-signing?docId=67889999
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос (приведены примеры значений, многоточие означает многократно повторяющуюся структуру):

{
	"status":{
		"code":0,
		"message":"OK"
	},
	"result":{
		"direction":null,
		"docId":631777,
		"fromOrgId":"11801",
		"fromOrgName":"ООО Ромашка Тест",
		"toOrgId":"1",
		"toOrgName":"ОФД.РУ",
		"docTypeId":3,
		"docTypeName":"Извещение о получении электронного документа",
		"docStateId":0,
		"docStateName":null,
		"sfStateName":null,
		"sfStateId":0,
		"innFrom":null,
		"innTo":null,
		"kppFrom":null,
		"kppTo":null,
		"content":"PDiDI7P8  Строка...",
		"signature":null,
		"certificateSerialNumber":null,
		"fileName":"DP_IZVPOL_2PS_2PS-00258532876001890440310032687548_20201112_e3b65627-fa62-41f7-b621-dd546625f8c4.xml",
		"docName":null,
		"docNumber":null,
		"docDate":null,
		"sumAll":null,
		"sumNds":null,
		"updPokupatelyaId":null,
		"marking":false,
		"fingerprint":null,
		"mcDocState":"MC_NONE",
		"actions":[],
		"forDocument":[null],
		"guid":"e3b65627-fa62-41f7-b621-dd546625f8c4",
		"updated":"12.11.2020 17:15:57",
		"signRequested":false,
		"nds":false
	}
}

Параметры структуры ответа приведены в п. 2.2.1. в таблице 2.4.

2.2.14. Получение извещений на документ (для получателя)

После того как организация отправила документ, Оператор ЭДО создает подтверждение оператора о дате получение документа, подписывает его и направляет организации. Затем, когда организация получила подтверждение оператора, она должна отправить в ответ подписанное извещение о получении данного подтверждения.

Для получения извещений для получателя используется запрос на основе метода GET.
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/documents/for-finished?docId={ID1}

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {ID1} — идентификатор документа.

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

GET https://lk.edo.ru/api/edo/v1/documents/for-finished?docId=6778895
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос, в случае отсутствия извещений:

{
	"status":{
		"code":0,
		"message":"OK"
	},
	"result":{
		"parentDocPossibleFinished":true,
		"techDocument":null
	}
}

Пример успешного ответа на запрос, в случае наличия извещений, требующих подписания со стороны получателя:

{
	"status":{
		"code":0,
		"message":"OK"
	},
	"result":{
		"parentDocPossibleFinished":false,
		"techDocument":{
			"direction":null,
			"docId":631775,
			"fromOrgId":"11818",
			"fromOrgName":"ИП Иванов Иван Иванович",
			"toOrgId":"1",
            "edoIdFrom":null,
			"edoIdTo":null,
			"toOrgName":"ОФД.РУ",
			"docTypeId":3,
			"docTypeName":"Извещение о получении электронного документа",
			"docStateId":0,
			"docStateName":null,
			"sfStateName":null,
			"sfStateId":0,
			"innFrom":null,
			"innTo":null,
			"kppFrom":null,
			"kppTo":null,
			"content":"PD94bW  СТрока...",
			"signature":null,
			"certificateSerialNumber":null,
			"fileName":"DP_IZVPOL_2PS_2PS-64553144722100000000000054190308_20201112_636fe79f-f475-480d-a7a4-e87a650b9d05.xml",
			"docName":null,
			"docNumber":null,
			"docDate":null,
			"sumAll":null,
			"sumNds":null,
			"updPokupatelyaId":null,
			"marking":false,
			"fingerprint":null,
			"mcDocState":"MC_NONE",
			"actions":[],
			"forDocument":[null],
			"guid":"636fe79f-f475-480d-a7a4-e87a650b9d05",
			"updated":"12.11.2020 17:15:57",
			"signRequested":false,
            "nds":false
		}
	}
}

Параметры структуры ответа приведены в таблице 2.15.

Таблица 2.15. Параметры структуры ответа на запрос

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Содержащая список документов
parentDocPossibleFinished Логический тип Наличие извещений для подписания: false — есть извещения, true — нет извещений
techDocument Структура Данные списка документов
direction String Признак документа:
OUT — исходящий;
IN — входящий
docId Integer Идентификационный номер (индекс) документа
fromOrgId String Идентификатор организации-отправителя
fromOrgName String Название организации-отправителя
edoIdFrom String Идентификатор в ЭДО организации-отправителя
edoIdTo String Идентификатор в ЭДО организации-получателя
toOrgId String Идентификатор организации-получателя
docTypeId Integer Идентификатор типа документа
docTypeName String Название типа документа
docStateId Integer Идентификатор статуса (состояния) документа
sfStateName String Статус подписи документа
sfStateId Integer Идентификатор статуса подписи документа
innFrom String ИНН организации-отправителя
innTo String ИНН организации-получателя
kppFrom String КПП организации-отправителя
kppTo String КПП организации-получателя
content String Содержимое документа, закодированное с помощью алгоритма “Base 64”
signature String Открепленная подпись в формате PKCS#7/CMS с публичной частью сертификата, закодированная с помощью алгоритма “Base 64”
certificateSerialNumber String Серийный номер сертификата
fileName String Наименование файла
docName String Наименование документа
docNumber String Номер документа
docDate String Дата генерации документа
sumAll String Общая сумма по документу
sumNds String Общая сумма НДС по документу
updPokupatelyaId String Идентификатор УПД покупателя
marking Boolean Признак наличия маркировки
mcDocState String Стейт отправки документа в ЦРПТ
actions Структура Служебная информация о возможных действиях с документом
forDocument Структура Информация о родительском документе
guid String Уникальный идентификатор
updated String Дата и время последнего обновления, формат ISO, с указанием часов и минут (без секунд, дата и время разделены пробелом)
nds Boolean Признак необходимости расчета НДС
signRequested Boolean Признак необходимости подписания документа

2.2.15. Сформировать ИОП

Для того чтобы получить извещение о получении документа (далее ИОП) применяется запрос, построенный на HTTP-методе POST и имеет следующий вид:


POST https://lk.edo.ru/api/edo/{version}/documents/provisional/tech

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Запрос:


POST https://lk.edo.ru/api/edo/v1/documents/provisional/tech
Authorization: Token 8890ea5e-95f8-4d33-b4bc-7ace2339fc91

{
  "parentDocId": 1264334,
  "fingerprint": "264f3033bef7d64be7df8375eb0c4882df868f9e"
}

Описание параметров запроса ИОП, приведены в таблице 2.16.

Таблица 2.16. Описание параметров запроса ИОП

Параметр Формат значения Описание Обязательно в запросе
parentDocId Integer Идентификатор родительского документа да
fingerprint String Отпечаток сертификата да


Приведен пример ответа на запрос:

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "contentBase64": "PD94bWwgd...",
    "uuid": "64f81e54-3011-4e0e-b619-c102d34bdbae",
    "docTypeId": 3
  }
}

Таблица 2.17. Описание параметров ответа на запрос ИОП

Параметр Формат значения Описание
contentBase64 String Содержимое документа зашифрованное в формате Base64
uuid String Уникальный идентификатор черновика
docTypeId Integer Идентификатор типа документа черновика

2.2.16. Отправить ИОП

Для того чтобы отправить подписанный ИОП, применяется запрос построенный на HTTP-методе POST и имеет следующий вид:


POST https://lk.edo.ru/api/edo/{version}/documents/provisional/tech/sign

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Запрос:


POST https://dev-dev.edo.ru/api/edo/v1/documents/provisional/tech/sign
Authorization: Token 8890ea5e-95f8-4d33-b4bc-7ace2339fc91

{
  "uuid": "64f81e54-3011-4e0e-b619-c102d34bdbae",
  "signatureBase64": "MIINAwYJKoZIhvcNAQcCoIIM9DCCDPACAQExDjAMBggqhQMHAQECAgUAMAsGCSqGSIb3DQEHAaCC\r\nCLUwggixMIIIXqADAgECAhECLlrqAFetOolOub1QHxragDAKBggqhQMHAQEDAjCCAVsxIDAeBgkq\r\nhkiG9w0BCQEWEWluZm9AY3J5cHRvcHJvLnJ1MRgwFgYFKoUDZAESDTEwMzc3MDAwODU0NDQxGjAY\r\nBggqhQMDgQMBARIMMDA3NzE3MTA3OTkxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB\r\n0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLR\r\ngdC60LjQuSDQstCw0Lsg0LQuIDE4MSUwIwYDVQQKDBzQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg\r\n0J4iMWswaQYDVQQDDGLQotC10YHRgtC+0LLRi9C5INC/0L7QtNGH0LjQvdC10L3QvdGL0Lkg0KPQ\r\npiDQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg0J4iINCT0J7QodCiIDIwMTIgKNCj0KYgMi4wKTAe\r\nFw0yMTA2MzAxNDAzMTVaFw0yMTA5MzAxNDEzMTVaMIIBTjEZMBcGCSqGSIb3DQEJARYKb2ZkQG9m\r\nZC5ydTEaMBgGCCqFAwOBAwEBEgwwMDk3MjEwODM0NzIxGDAWBgUqhQNkARINMTE5Nzc0NjQyNTA4\r\nNDEZMBcGA1UEDAwQ0JTQuNGA0LXQutGC0L7RgDEgMB4GA1UECwwX0J7QntCeICLQmtCe0J3QotCV\r\n0JrQkCIxIDAeBgNVBAoMF9Ce0J7QniAi0JrQntCd0KLQldCa0JAiMRUwEwYDVQQJDAzQnNC+0YHQ\r\nutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEVMBMGA1UECAwM0JzQvtGB0LrQstCwMQswCQYD\r\nVQQGEwJSVTETMBEGA1UEKgwK0J/QsNCy0LXQuzETMBEGA1UEBAwK0J/QsNCy0LjQvTEgMB4GA1UE\r\nAwwX0J7QntCeICLQmtCe0J3QotCV0JrQkCIwZjAfBggqhQMHAQEBATATBgcqhQMCAiQABggqhQMH\r\nAQECAgNDAARAfo0WcdHwnUuzWcpe6USbOXzxwft+TiYiPwfJnQIOPoJaBacq+87FryQYF5G80Loh\r\nP1E1Zjc6yrGYjsAoOrA6/qOCBP0wggT5MA4GA1UdDwEB/wQEAwIE8DAfBgkrBgEEAYI3FQcEEjAQ\r\nBggqhQMCAi4ACAIBAQIBADAdBgNVHQ4EFgQUUyY8VlozO4v234cZtY8plE6Z8QUwJgYDVR0lBB8w\r\nHQYIKwYBBQUHAwQGCCsGAQUFBwMCBgcqhQMCAiIGMDIGCSsGAQQBgjcVCgQlMCMwCgYIKwYBBQUH\r\nAwQwCgYIKwYBBQUHAwIwCQYHKoUDAgIiBjCBpwYIKwYBBQUHAQEEgZowgZcwOAYIKwYBBQUHMAGG\r\nLGh0dHA6Ly90ZXN0Y2EyMDEyLmNyeXB0b3Byby5ydS9vY3NwL29jc3Auc3JmMFsGCCsGAQUFBzAC\r\nhk9odHRwOi8vdGVzdGNhMjAxMi5jcnlwdG9wcm8ucnUvYWlhLzA2NGI2MzI1MzM2NjJhMjQzODE4\r\nNzI0MzdhM2JiN2NiYjJjYWZjNzMuY3J0MB0GA1UdIAQWMBQwCAYGKoUDZHECMAgGBiqFA2RxATAr\r\nBgNVHRAEJDAigA8yMDIxMDYzMDE0MDMxNVqBDzIwMjEwOTMwMTQwMzE1WjCCARoGBSqFA2RwBIIB\r\nDzCCAQsMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQu\r\nMCkMMdCf0JDQmiAi0JrRgNC40L/RgtC+0J/RgNC+INCj0KYiINCy0LXRgNGB0LjQuCAyLjAMT9Ch\r\n0LXRgNGC0LjRhNC40LrQsNGCINGB0L7QvtGC0LLQtdGC0YHRgtCy0LjRjyDihJYg0KHQpC8xMjQt\r\nMzM4MCDQvtGCIDExLjA1LjIwMTgMT9Ch0LXRgNGC0LjRhNC40LrQsNGCINGB0L7QvtGC0LLQtdGC\r\n0YHRgtCy0LjRjyDihJYg0KHQpC8xMjgtMzU5MiDQvtGCIDE3LjEwLjIwMTgwLAYFKoUDZG8EIwwh\r\n0KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiMGAGA1UdHwRZMFcwVaBToFGGT2h0dHA6\r\nLy90ZXN0Y2EyMDEyLmNyeXB0b3Byby5ydS9jZHAvMDY0YjYzMjUzMzY2MmEyNDM4MTg3MjQzN2Ez\r\nYmI3Y2JiMmNhZmM3My5jcmwwDAYFKoUDZHIEAwIBAjCCAZcGA1UdIwSCAY4wggGKgBQGS2MlM2Yq\r\nJDgYckN6O7fLssr8c6GCAV2kggFZMIIBVTEgMB4GCSqGSIb3DQEJARYRaW5mb0BjcnlwdG9wcm8u\r\ncnUxGDAWBgUqhQNkARINMTAzNzcwMDA4NTQ0NDEaMBgGCCqFAwOBAwEBEgwwMDc3MTcxMDc5OTEx\r\nCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC6\r\n0LLQsDEvMC0GA1UECQwm0YPQuy4g0KHRg9GJ0ZHQstGB0LrQuNC5INCy0LDQuyDQtC4gMTgxJTAj\r\nBgNVBAoMHNCe0J7QniAi0JrQoNCY0J/QotCeLdCf0KDQniIxZTBjBgNVBAMMXNCi0LXRgdGC0L7Q\r\nstGL0Lkg0LPQvtC70L7QstC90L7QuSDQo9CmINCe0J7QniAi0JrQoNCY0J/QotCeLdCf0KDQniIg\r\n0JPQntCh0KIgMjAxMiAo0KPQpiAyLjApghECbc+0AK2rS4hGDZj53PwvLjAKBggqhQMHAQEDAgNB\r\nAFXgvsviPPKjAyTAiajg5hdHTgmydqONcit7YuvRi/uAUH6yYn0eSOEXhrGgLudLyGh+gWTz56Ze\r\np4CqiMGX+NkxggQTMIIEDwIBATCCAXIwggFbMSAwHgYJKoZIhvcNAQkBFhFpbmZvQGNyeXB0b3By\r\nby5ydTEYMBYGBSqFA2QBEg0xMDM3NzAwMDg1NDQ0MRowGAYIKoUDA4EDAQESDDAwNzcxNzEwNzk5\r\nMTELMAkGA1UEBhMCUlUxGDAWBgNVBAgMDzc3INCc0L7RgdC60LLQsDEVMBMGA1UEBwwM0JzQvtGB\r\n0LrQstCwMS8wLQYDVQQJDCbRg9C7LiDQodGD0YnRkdCy0YHQutC40Lkg0LLQsNC7INC0LiAxODEl\r\nMCMGA1UECgwc0J7QntCeICLQmtCg0JjQn9Ci0J4t0J/QoNCeIjFrMGkGA1UEAwxi0KLQtdGB0YLQ\r\nvtCy0YvQuSDQv9C+0LTRh9C40L3QtdC90L3Ri9C5INCj0KYg0J7QntCeICLQmtCg0JjQn9Ci0J4t\r\n0J/QoNCeIiDQk9Ce0KHQoiAyMDEyICjQo9CmIDIuMCkCEQIuWuoAV606iU65vVAfGtqAMAwGCCqF\r\nAwcBAQICBQCgggI2MBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIx\r\nMDkxNjE0MjYxMVowLwYJKoZIhvcNAQkEMSIEIHSBu7R2CPh9JcLZ/LPiBvxWAkV3Q/shz6ZLxopR\r\naAcOMIIByQYLKoZIhvcNAQkQAi8xggG4MIIBtDCCAbAwggGsMAoGCCqFAwcBAQICBCAxlEFcvdQd\r\nVhG7mX00qpHWj6fVmVGcNUF0bHeZK5ZfIzCCAXowggFjpIIBXzCCAVsxIDAeBgkqhkiG9w0BCQEW\r\nEWluZm9AY3J5cHRvcHJvLnJ1MRgwFgYFKoUDZAESDTEwMzc3MDAwODU0NDQxGjAYBggqhQMDgQMB\r\nARIMMDA3NzE3MTA3OTkxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUw\r\nEwYDVQQHDAzQnNC+0YHQutCy0LAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLRgdC60LjQuSDQ\r\nstCw0Lsg0LQuIDE4MSUwIwYDVQQKDBzQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg0J4iMWswaQYD\r\nVQQDDGLQotC10YHRgtC+0LLRi9C5INC/0L7QtNGH0LjQvdC10L3QvdGL0Lkg0KPQpiDQntCe0J4g\r\nItCa0KDQmNCf0KLQni3Qn9Cg0J4iINCT0J7QodCiIDIwMTIgKNCj0KYgMi4wKQIRAi5a6gBXrTqJ\r\nTrm9UB8a2oAwCgYIKoUDBwEBAQEEQKy8vj6dcIC274jtQKF3e3cbK0EH31uR/d9W+r1Wrgqbq31/\r\ndJU3FhOuadTj2gzqEA2+lVg+UmQe5UGjuGrfud0="
}

Описание параметров запроса на опубликование ИОП, приведены в таблице 2.18.

Таблица 2.18. Описание параметров запроса на опубликование ИОП

Параметр Формат значения Описание Обязательно в запросе
uuid String Идентификатор черновика документа (UUID) да
signatureBase64 String Открепленная подпись содержимого документа. (Строка зашифрованная в формате Base64) да


Приведен пример ответа на запрос:

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "docId": null,
    "docUuid": "64f81e54-3011-4e0e-b619-c102d34bdbae"
  }
}

Таблица 2.19. Описание параметров ответа на запрос опубликования ИОП

Параметр Формат значения Описание
docId Integer Идентификатор подписанного документа (Number)
docUuid String Идентификатор подписанного документа (UUID)

2.2.17. Получение любых извещений на документы

После того как организация отправила документ, Оператор ЭДО создает подтверждение оператора о дате получение документа, подписывает его и направляет организации. Затем, когда организация получила подтверждение оператора, она должна отправить в ответ подписанное извещение о получении данного подтверждения.

Для получения извещений по всем документам используется запрос на основе метода GET.
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/documents/for-signing

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

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

GET https://lk.edo.ru/api/edo/v1/documents/for-signing
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос, в случае наличия извещений, которые требуется подписать организации:

{
	"status":{
		"code":0,
		"message":"OK"
	},
	"result":[
		{
			"direction":null,
			"docId":631758,
			"fromOrgId":"11818",
			"fromOrgName":"ИП Иванов Иван Иванович",
			"toOrgId":"1",
			"toOrgName":"ОФД.РУ",
			"edoIdFrom":null,
			"edoIdTo":null,
			"docTypeId":3,
			"docTypeName":"Извещение о получении электронного документа",
			"docStateId":0,
			"docStateName":null,
			"sfStateName":null,"sfStateId":0,
			"innFrom":null,
			"innTo":null,
			"kppFrom":null,
			"kppTo":null,
			"content":"PD94b  Строка...",
			"signature":null,
			"certificateSerialNumber":null,
			"fileName":"DP_IZVPOL_2PS_2PS-64553144722100000000000054190308_20201112_c518df7a-d0ae-41c3-9ddf-500689254d32.xml",
			"docName":null,
			"docNumber":null,
			"docDate":null,
			"sumAll":null,
			"sumNds":null,
			"updPokupatelyaId":null,
			"marking":false,
			"fingerprint":null,
			"mcDocState":"MC_NONE",
			"actions":[],
			"forDocument":[null],
			"guid":"c518df7a-d0ae-41c3-9ddf-500689254d32",
			"updated":"12.11.2020 12:06:43",
			"nds":false,
			"signRequested":false
		},
		...
	]
}

Описание параметров структуры ответа приведены в  в разделе 2.2.14. в таблице 2.15.

Пример успешного ответа на запрос, в случае отсутствия извещений:

{
	"status":{
		"code":0,
		"message":"OK"
	},
	"result":[
	]
}

2.2.18. Получение PDF-представления формализованного документа

Документ в формате “Adobe PDF” удобен для просмотра и печати, возможность генерации такого документа присутствует в ИС «ЭДО.Поток», это действие возможно произвести с помощью запроса на основе HTTP-метода GET.
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/documents/show-doc-pdf?docId={ID1}

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {ID1} — идентификатор документа, на основе которого по запросу генерируется документ в формате “Adobe PDF”. Параметр обязателен.

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

GET https://lk.edo.ru/api/edo/v1/documents/show-doc-pdf?docId=87789999
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

В ответ на данный запрос начинается загрузка файла в двоичном виде. В заголовках ответа (response headers) указывается имя загружаемого файла.

2.3. Методы работы с черновиками

2.3.1 Метод загрузки черновика

Для загрузки черновика используется запрос на основе метода POST.
Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/drafts/add

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.
Таблица 2.20. Параметры запроса

Параметр Формат значения Описание Обязательно в запросе
content String Содержимое документа, закодированное с помощью алгоритма “Base 64”,
в одну строку (без переноса строк)
да
docType Integer Тип документа (параметр id в ответе на запрос) Вывод справочника типов документов. да
fileName String Наименование документа да
signRequested Boolean Запрос подписи у контрагента:
true — требуется подпись,
false — подпись не требуется.
Подпись контрагента запрашивается всегда по:
УПД, УКД, Накладная (формализованная), Акт (формализованный).
Подпись никогда не запрашивается по любым счет-фактурам.
да
to String Идентификатор клиента в ИС «ЭДО.Поток».
Можно получить используя метод Поиск контрагентов
да

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

POST https://lk.edo.ru/api/edo/v1/drafts/add
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "content": "UEsDBBQABgA...Строка",
  "docType": 7,
  "fileName": "С подписью. Подписание.docx",
  "signRequested": true,
  "to": "2PS-00784146519807841010010013609667"
}

Пример успешного ответа на запрос

{
    "status": {
        "code": 0,
        "message": "OK"
    },
    "result": {
        "errorCode": [],
        "data": {
            "draftId": 28027,
            "fromOrgId": "2",
            "fromOrgName": "ОФД.РУ",
            "toOrgId": "11818",
            "toOrgName": "ИП Иванов Иван Иванович",
            "edoIdFrom": "2PS-00784146519807841010010013609667",
            "edoIdTo": "2PS-64553144722100000000000054190308",
            "docTypeId": 8,
            "docTypeName": "УПД",
            "innFrom": "7841465198",
            "innTo": "645531447221",
            "kppFrom": "772501001",
            "kppTo": null,
            "content": "PD94bWwgdmVyc2l...Строка",
            "fileName": "ON_NSCHFDOPPRMARK_2PS-64553144722100000000000054190308_2PS-00784146519807841010010013609667_20201101_69bc52a0-39e6-4454-8328-6c98c74f0916",
            "docName": "Счет-фактура и документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг)",
            "docNumber": "9",
            "docDate": "02.06.2020 00:00:00",
            "sumAll": 14000,
            "sumNds": 2333.33,
            "statusId": 1,
            "statusName": "Готов",
            "nds": true,
            "signRequested": true,
            "updated": "29.04.2021 15:05:14"
        }
    }
}

Описание параметров структуры ответа приведены в таблице 2.21

Таблица 2.21. Описание параметров структуры ответа

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Содержащая список документов
data Структура Данные списка документов
draftId String Идентификатор черновика в системе «ЭДО.Поток»
fromOrgId String Идентификатор организации-отправителя
fromOrgName String Название организации-отправителя
edoIdFrom String Идентификатор в ЭДО организации-отправителя
edoIdTo String Идентификатор в ЭДО организации-получателя
toOrgId String Идентификатор организации-получателя
toOrgName String Название организации-получателя
docTypeId Integer Идентификатор типа документа
docTypeName String Название типа документа
innFrom String ИНН организации-отправителя
innTo String ИНН организации-получателя
kppFrom String КПП организации-отправителя
kppTo String КПП организации-получателя
content String Содержимое документа, закодированное с помощью алгоритма “Base 64”
fileName String Наименование файла
docName String Наименование документа
docNumber String Номер документа
docDate String Дата генерации документа
sumAll String Общая сумма по документу
sumNds String Общая сумма НДС по документу
statusId Integer Идентификатор статуса (состояния) документа:
0 — не готов, не заполнены параметры , обязательные для отправки;
1 — готов к отправке.
statusName String Наименование статуса (состояния) документа
nds Boolean Признак необходимости расчета НДС
signRequested Boolean Признак необходимости подписания документа
updated String Дата и время загрузки черновика
errorCode Массив Ошибки, которые могли возникнуть при загрузке черновика

2.3.2 Метод получения списка черновиков

Для получения списка черновиков используется запрос на основе метода POST.

GET https://lk.edo.ru/api/edo/{version}/drafts

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

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

GET https://lk.edo.ru/api/edo/v1/drafts
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Описание параметров запроса приведены в таблице 2.22.

Таблица 2.22. Описание параметров запроса

Параметр Формат значения Описание Обязательно в запросе
from String Начальная дата периода поиска черновиков в формате (dd.MM.yyyy HH:mm), где dd — день, mm — месяц, yyyy — год, HH — часы, mm — минуты. нет
to String Конечная дата периода поиска черновиков в формате (dd.MM.yyyy HH:mm), где dd — день, mm — месяц, yyyy — год, HH — часы, mm — минуты. нет
orgNameTo String Наименование компании получателя нет
orgInnTo String ИНН получателя нет
docTypeId Array[integer] Тип документа (параметр id в ответе на запрос) Вывод справочника типов документов. нет
status Array[integer] Статус черновика:
1 — «Готов», черновик готов к отправке;
0 — «Не готов», значит, что черновик не может быть отправлен, например ошибка: «Не найден предполагаемый получатель файла».
нет
pageIndex Integer Номер страницы выдачи (по умолчанию — 1) нет
pageRecords Integer Количество записей на странице (по умолчанию — 1000) нет
pageCount Integer Всего страниц нет
sortKey String Столбец для сортировки.
По умолчанию — docDate.
нет
sortDirection String Порядок сортировки. Возможные значения:
asc — восходящая (прямой порядок);
desc — нисходящая (обратный порядок).
По умолчанию — desc
нет

Пример ответа на запрос

{
    "status": {
        "code": 0,
        "message": "OK"
    },
    "result": {
        "data": [
            {
                "errorCode": [],
                "data": {
                    "draftId": 28027,
                    "fromOrgId": "2",
                    "fromOrgName": "ОФД.РУ",
                    "toOrgId": "11818",
                    "toOrgName": "ИП Иванов Иван Иванович",
                    "edoIdFrom": "2PS-00784146519807841010010013609667",
                    "edoIdTo": "2PS-64553144722100000000000054190308",
                    "docTypeId": 8,
                    "docTypeName": "УПД",
                    "innFrom": "7841465198",
                    "innTo": "645531447221",
                    "kppFrom": "772501001",
                    "kppTo": null,
                    "content": null,
                    "fileName": "ON_NSCHFDOPPRMARK_2PS-64553144722100000000000054190308_2PS-00784146519807841010010013609667_20201101_69bc52a0-39e6-4454-8328-6c98c74f0916.xml",
                    "docName": "Счет-фактура и документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг)",
                    "docNumber": "sign_send_9",
                    "docDate": "02.06.2020 00:00:00",
                    "sumAll": 14000,
                    "sumNds": 2333.33,
                    "statusId": 1,
                    "statusName": "Готов",
                    "nds": true,
                    "signRequested": false,
                    "updated": "29.04.2021 15:05:14"
                }
            }
        ],
        "pageInfo": {
            "pageIndex": 1,
            "pageRecords": 1000,
            "pageCount": 1,
            "sortKey": null,
            "sortDirection": "desc"
        }
    }
}

Описание параметров структуры ответа приведены в таблице 2.23.

Таблица 2.23. Описание параметров структуры ответа

Параметр Вложенные поля Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Содержащая список черновиков
data Структура Данные списка черновиков и страниц выдачи
data Структура Данные списка черновиков
draftId String Идентификатор черновика в системе «ЭДО.Поток»
fromOrgId String Идентификатор организации-отправителя
fromOrgName String Название организации-отправителя
edoIdFrom String Идентификатор в ЭДО организации-отправителя
edoIdTo String Идентификатор в ЭДО организации-получателя
toOrgId String Идентификатор организации-получателя
toOrgName String Название организации-получателя
docTypeId Integer Идентификатор типа документа
docTypeName String Название типа документа
innFrom String ИНН организации-отправителя
innTo String ИНН организации-получателя
kppFrom String КПП организации-отправителя
kppTo String КПП организации-получателя
content String Содержимое документа, закодированное с помощью алгоритма “Base 64”
fileName String Наименование файла
docName String Наименование документа
docNumber String Номер документа
docDate String Дата генерации документа
sumAll String Общая сумма по документу
sumNds String Общая сумма НДС по документу
statusId Integer Идентификатор статуса (состояния) документа:
0 — не готов, не заполнены параметры, обязательные для отправки;
1 — готов к отправке.
statusName String Наименование статуса (состояния) документа
nds Boolean Признак необходимости расчета НДС
signRequested Boolean Признак необходимости подписания документа
updated String Дата и время загрузки черновика
errorCode Массив Ошибки, которые могли возникнуть при загрузке черновика
pageInfo Структура Информация о делении списка на страницы и о передаваемой странице списка
pageIndex Integer Номер страницы выдачи
pageRecords Integer Количество записей на странице
pageCount Integer Всего страниц
sortKey String Столбец для сортировки.
По умолчанию — docDate.
sortDirection String Порядок сортировки. Возможные значения:
asc — восходящая (прямой порядок);
desc — нисходящая (обратный порядок).
По умолчанию — desc

2.3.3 Метод скачивания черновика

Для скачивания черновика используется запрос на основе метода POST.

GET https://lk.edo.ru/api/edo/{version}/drafts/download?draftId={DRAFT_ID}

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {DRAFT_ID} — Идентификатор черновика в системе «ЭДО.Поток».

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

GET https://lk.edo.ru/api/edo/v1/drafts/download?draftId=28027
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

В ответ на данный запрос начинается загрузка файла в двоичном виде.

2.3.6 Метод удаления черновика

Для удаления черновика используется запрос на основе метода POST.

POST https://lk.edo.ru/api/edo/{version}/drafts/remove

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Параметры запроса располагаются в теле запроса и имеют вид следующей структуры (приведены примеры значений):

POST https://lk.edo.ru/api/edo/v1/drafts/remove
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "draftId": "28027"
}

Параметр draftId — идентификатор удаляемого черновика в «ЭДО.Поток». Пример успешного ответа на запрос описан в разделе "Введение", при этом параметр «message» имеет значение «OK», а «result» имеет значение «null».

2.3.4. Сформировать титул покупателя УПД/УКД

Для того чтобы получить черновик титула УПД или черновика титула УКД, применяется запрос построенный на HTTP-методе POST и имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/documents/provisional/buyer/title

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Запрос:


POST https://lk.edo.ru/api/edo/v1/documents/provisional/buyer/title
Authorization: Token 8890ea5e-95f8-4d33-b4bc-7ace2339fc91

{
  "provisionalDocParams": {
    "parentDocId": 1264334,
    "fingerprint": "264f3033bef7d64be7df8375eb0c4882df868f9e"
  },
  "additionalParams": {
    "docTypeId": 11,
    "fingerprint": "264f3033bef7d64be7df8375eb0c4882df868f9e",
    "parentDocId": 1264334,
    "svPrinSodOper": "Принято без замечаний",
    "svPrinDataPrin": "16.09.2021"
  }
}

Описание параметров запроса для получения черновика титула УПД и УКД, приведены в таблице 2.24.

Таблица 2.24. Параметры запроса для получения черновика титула УПД и УКД

Параметр Вложенный параметр Формат значения Описание Обязательно в запросе
parentDocId Integer Идентификатор родительского документа да
fingerprint String Отпечаток сертификата. (Строка SHA1 hash) да
additionalParams Структура да
fingerprint String Отпечаток сертификата. (Строка SHA1 hash) да
parentDocId String Идентификатор родительского документа да
docTypeId String Для получения титула УПД покупателя (для УПД со значением Type 8 и УПД исправительный со значением Type 8) ставим значение 11,
Для получения титула УКД покупателя (для УПД со значением Type 12 и УПД исправительный со значением Type 31), ставим значение 13
да
svPrinSodOper String Указывается действия, например:
— «Товары принял без претензий»;
— «Результаты работ принял без претензий»;
— «Услуги получены, претензий нет»; или другое.
да
svPrinDataPrin String Дата принятия УПД. да
textRefinement String Текстовый комментарий. да


Приведен пример ответа на запрос:

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "contentBase64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIiBzdGFuZGFsb25lPSJ5ZXMiPz4KPNTg6esgyOTU4OnrPSJPTl9OU0NIRkRPUFBPS18yUFMtMzMyODA0MTc5OTEyMDAwMDAwMDAwMDAwOTUxNjg1MTJfMlBTLTAwOTcyMTA4MzQ3MjA3NzIxMDEwMDEwMDMwNjQwMzgxXzIwMjEwOTE2X2RjYjdkNDdlLTc4ZWMtNDA5NC04YmM1LWQxM2NkYmQyMzg1NSIgwuXw8dTu8Ow9IjUuMDEiIMLl8PHP8O7jPSLS0SDdxM4gMTAuMC4wLjAiPgogICAgPNHi0/fE7urO4e7wIMjkzvLv8D0iMlBTLTAwOTcyMTA4MzQ3MjA3NzIxMDEwMDEwMDMwNjQwMzgxIiDI5M/u6z0iMlBTLTMzMjgwNDE3OTkxMjAwMDAwMDAwMDAwMDk1MTY4NTEyIj4KICAgICAgICA80eLO3cTO8u/wIM3g6OzO8OM9Is7UxC7Q0yIgyM3N3ss9Ijc4NDE0NjUxOTgiIMjk3cTOPSIyUFMiLz4KICAgIDwv0eLT98Tu6s7h7vA+CiAgICA8yO30z+7qIMrNxD0iMTExNTEzMiIgxODy4Mjt9M/u6j0iMTYuMDkuMjAyMSIgwvDl7Mjt9M/u6j0iMTcuMjYuMTEiIM3g6Ozd6u7t0fPh0e7x8j0izs7OICZxdW90O8rOzdLFysAmcXVvdDsiPgogICAgICAgIDzI5Mjt9M/w7uQgyOTU4OnryO30z/A9Ik9OX05TQ0hGRE9QUFJfMlBTLTAwOTcyMTA4MzQ3MjA3NzIxMDEwMDEwMDMwNjQwMzgxXzJQUy0zMzI4MDQxNzk5MTIwMDAwMDAwMDAwMDA5NTE2ODUxMl8yMDIxMDkxNV9lNDc4Y2I1Yi0yYTE5LTRkMzUtYWZjNy1lMzViZTcyMGZjZDAiIMTg8uDU4OnryO30z/A9IjE1LjA5LjIwMjEiIMLw5ezU4OnryO30z/A9IjEyLjAxLjUzIj4KICAgICAgICAgICAgPN3PPk1JSVZOd1lKS29aSWh2Y05BUWNDb0lJVktEQ0NGU1FDQVFFeERqQU1CZ2dxaFFNSEFRRUNBZ1VBTUFzR0NTcUcNClNJYjNEUUVIQWFDQ0VQTXdnZ2hFTUlJSDhhQURBZ0VDQWhFRCtKaUZBSEd0NFl4TmUwdEd4WDhWUWpBS0JnZ3ENCmhRTUhBUUVEQWpDQ0FWQXhDekFKQmdOVkJBWVRBbEpWTVJVd0V3WUZLb1VEWkFRU0NqYzNNVGN4TURjNU9URXgNCklEQWVCZ2txaGtpRzl3MEJDUUVXRVdsdVptOUFZM0o1Y0hSdmNISnZMbkoxTVJnd0ZnWUZLb1VEWkFFU0RURXcNCk16YzNNREF3T0RVME5EUXhHREFXQmdOVkJBZ01EemMzSU5DYzBMN1JnZEM2MExMUXNERVZNQk1HQTFVRUJ3d00NCjBKelF2dEdCMExyUXN0Q3dNUzh3TFFZRFZRUUpEQ2JSZzlDN0xpRFFvZEdEMFluUmtkQ3kwWUhRdXRDNDBMa2cNCjBMTFFzTkM3SU5DMExpQXhPREVsTUNNR0ExVUVDZ3djMEo3UW50Q2VJQ0xRbXRDZzBKalFuOUNpMEo0dDBKL1ENCm9OQ2VJakZsTUdNR0ExVUVBd3hjMEtMUXRkR0IwWUxRdnRDeTBZdlF1U0RRczlDKzBMdlF2dEN5MEwzUXZ0QzUNCklOQ2owS1lnMEo3UW50Q2VJQ0xRbXRDZzBKalFuOUNpMEo0dDBKL1FvTkNlSWlEUWs5Q2UwS0hRb2lBeU1ERXkNCklDalFvOUNtSURJdU1Da3dIaGNOTWpFd056STJNRGMxTmpJMldoY05NekV3TnpJMk1EZ3dOakkyV2pDQ0FWWXgNCkZUQVRCZ1VxaFFOa0JCSUtOemN4TnpFd056azVNVEVnTUI0R0NTcUdTSWIzRFFFSkFSWVJhVzVtYjBCamNubHcNCmRHOXdjbTh1Y25VeEdEQVdCZ1VxaFFOa0FSSU5NVEF6Tnpjd01EQTROVFEwTkRFTE1Ba0dBMVVFQmhNQ1VsVXgNCkdEQVdCZ05WQkFnTUR6YzNJTkNjMEw3UmdkQzYwTExRc0RFVk1CTUdBMVVFQnd3TTBKelF2dEdCMExyUXN0Q3cNCk1TOHdMUVlEVlFRSkRDYlJnOUM3TGlEUW9kR0QwWW5Sa2RDeTBZSFF1dEM0MExrZzBMTFFzTkM3SU5DMExpQXgNCk9ERWxNQ01HQTFVRUNnd2MwSjdRbnRDZUlDTFFtdENnMEpqUW45Q2kwSjR0MEovUW9OQ2VJakZyTUdrR0ExVUUNCkF3eGkwS0xRdGRHQjBZTFF2dEN5MFl2UXVTRFF2OUMrMExUUmg5QzQwTDNRdGRDOTBMM1JpOUM1SU5DajBLWWcNCjBKN1FudENlSUNMUW10Q2cwSmpRbjlDaTBKNHQwSi9Rb05DZUlpRFFrOUNlMEtIUW9pQXlNREV5SUNqUW85Q20NCklESXVNQ2t3WmpBZkJnZ3FoUU1IQVFFQkFUQVRCZ2NxaFFNQ0FpTUJCZ2dxaFFNSEFRRUNBZ05EQUFSQVh3L3ANCmM2S3ovWk1LZ2lzb1IyMkpUUTVxOVdPV2puZVpsd0JIeTVTMTZud3BQeHJocTNVU1RHbVpUK3k0ZGRLMVllSEoNCkVFNVhCWXk0MDBIOUpqUWpIcU9DQkpNd2dnU1BNRjBHQlNxRkEyUnZCRlFNVXRDaDBKclFsOUNZSUNMUW10R0ENCjBMalF2OUdDMEw3UW45R0EwTDRnUTFOUUlpQW8wTExRdGRHQTBZSFF1TkdQSURRdU1Da2dLTkM0MFlIUXY5QysNCjBMdlF2ZEMxMEwzUXVOQzFJREl0UW1GelpTa3dFZ1lKS3dZQkJBR0NOeFVCQkFVQ0F3TUFBekFkQmdOVkhRNEUNCkZnUVVkWTBiOXpMUzBQSmZIZytlRTNuci9DRCtuaTh3RGdZRFZSMFBBUUgvQkFRREFnR0dNQklHQTFVZEV3RUINCi93UUlNQVlCQWY4Q0FRQXdKUVlEVlIwZ0JCNHdIREFHQmdSVkhTQUFNQWdHQmlxRkEyUnhBVEFJQmdZcWhRTmsNCmNRSXdhd1lJS3dZQkJRVUhBUUVFWHpCZE1Gc0dDQ3NHQVFVRkJ6QUNoazlvZEhSd09pOHZkR1Z6ZEdOaE1qQXgNCk1pNWpjbmx3ZEc5d2NtOHVjblV2WVdsaEx6ZzJPVFkzWmpnMU9HTXhZak14WVdFNU1tRTJPR1F4TkdZeU9HTmkNCllqRm1NakV5WmpWak0yRXVZM0owTUI4R0NTc0dBUVFCZ2pjVkJ3UVNNQkFHQ0NxRkF3SUNMZ0FCQWdFQkFnRUENCk1JSUJHZ1lGS29VRFpIQUVnZ0VQTUlJQkN3dzAwS0hRbXRDWDBKZ2dJdENhMFlEUXVOQy8wWUxRdnRDZjBZRFENCnZpQkRVMUFpSUNqUXN0QzEwWURSZ2RDNDBZOGdOQzR3S1F3eDBKL1FrTkNhSUNMUW10R0EwTGpRdjlHQzBMN1ENCm45R0EwTDRnMEtQUXBpSWcwTExRdGRHQTBZSFF1TkM0SURJdU1BeFAwS0hRdGRHQTBZTFF1TkdFMExqUXV0Q3cNCjBZSWcwWUhRdnRDKzBZTFFzdEMxMFlMUmdkR0MwTExRdU5HUElPS0VsaURRb2RDa0x6RXlOQzB6T1RjeElOQysNCjBZSWdNVFV1TURFdU1qQXlNUXhQMEtIUXRkR0EwWUxRdU5HRTBMalF1dEN3MFlJZzBZSFF2dEMrMFlMUXN0QzENCjBZTFJnZEdDMExMUXVOR1BJT0tFbGlEUW9kQ2tMekV5T0Mwek9EY3dJTkMrMFlJZ01qTXVNRGN1TWpBeU1EQmcNCkJnTlZIUjhFV1RCWE1GV2dVNkJSaGs5b2RIUndPaTh2ZEdWemRHTmhNakF4TWk1amNubHdkRzl3Y204dWNuVXYNClkyUndMemcyT1RZM1pqZzFPR014WWpNeFlXRTVNbUUyT0dReE5HWXlPR05pWWpGbU1qRXlaalZqTTJFdVkzSnMNCk1Bd0dCU3FGQTJSeUJBTUNBUUl3Z2dHU0JnTlZIU01FZ2dHSk1JSUJoWUFVaHBaL2hZd2JNYXFTcG8wVThveTcNCkh5RXZYRHFoZ2dGWXBJSUJWRENDQVZBeEN6QUpCZ05WQkFZVEFsSlZNUlV3RXdZRktvVURaQVFTQ2pjM01UY3gNCk1EYzVPVEV4SURBZUJna3Foa2lHOXcwQkNRRVdFV2x1Wm05QVkzSjVjSFJ2Y0hKdkxuSjFNUmd3RmdZRktvVUQNClpBRVNEVEV3TXpjM01EQXdPRFUwTkRReEdEQVdCZ05WQkFnTUR6YzNJTkNjMEw3UmdkQzYwTExRc0RFVk1CTUcNCkExVUVCd3dNMEp6UXZ0R0IwTHJRc3RDd01TOHdMUVlEVlFRSkRDYlJnOUM3TGlEUW9kR0QwWW5Sa2RDeTBZSFENCnV0QzQwTGtnMExMUXNOQzdJTkMwTGlBeE9ERWxNQ01HQTFVRUNnd2MwSjdRbnRDZUlDTFFtdENnMEpqUW45Q2kNCjBKNHQwSi9Rb05DZUlqRmxNR01HQTFVRUF3eGMwS0xRdGRHQjBZTFF2dEN5MFl2UXVTRFFzOUMrMEx2UXZ0Q3kNCjBMM1F2dEM1SU5DajBLWWcwSjdRbnRDZUlDTFFtdENnMEpqUW45Q2kwSjR0MEovUW9OQ2VJaURRazlDZTBLSFENCm9pQXlNREV5SUNqUW85Q21JREl1TUNtQ0VRTkZQSHNBY2EzWnEweGZ5S2hGSDVlbk1Bb0dDQ3FGQXdjQkFRTUMNCkEwRUFDRXIvVERRa2Zkc0xvSGhEaUJDNWNuSnp2OXBreXJYVnZHYXVkalptOVJ3aWJwZFkyZUtMcmhhNWVBVlMNCnVDUHRRb0lKS2hQUVd2ZjZ1TnZqZ2xRQUNEQ0NDS2N3Z2doVW9BTUNBUUlDRVFNM3N3QUJjYTJRcDBQMHpqNnMNCm93dXBNQW9HQ0NxRkF3Y0JBUU1DTUlJQlZqRVZNQk1HQlNxRkEyUUVFZ28zTnpFM01UQTNPVGt4TVNBd0hnWUoNCktvWklodmNOQVFrQkZoRnBibVp2UUdOeWVYQjBiM0J5Ynk1eWRURVlNQllHQlNxRkEyUUJFZzB4TURNM056QXcNCk1EZzFORFEwTVFzd0NRWURWUVFHRXdKU1ZURVlNQllHQTFVRUNBd1BOemNnMEp6UXZ0R0IwTHJRc3RDd01SVXcNCkV3WURWUVFIREF6UW5OQyswWUhRdXRDeTBMQXhMekF0QmdOVkJBa01KdEdEMExzdUlOQ2gwWVBSaWRHUjBMTFINCmdkQzYwTGpRdVNEUXN0Q3cwTHNnMExRdUlERTRNU1V3SXdZRFZRUUtEQnpRbnRDZTBKNGdJdENhMEtEUW1OQ2YNCjBLTFFuaTNRbjlDZzBKNGlNV3N3YVFZRFZRUURER0xRb3RDMTBZSFJndEMrMExMUmk5QzVJTkMvMEw3UXROR0gNCjBMalF2ZEMxMEwzUXZkR0wwTGtnMEtQUXBpRFFudENlMEo0Z0l0Q2EwS0RRbU5DZjBLTFFuaTNRbjlDZzBKNGkNCklOQ1QwSjdRb2RDaUlESXdNVElnS05DajBLWWdNaTR3S1RBZUZ3MHlNVEEzTWpZeE5USTBNemRhRncweU1URXcNCk1qWXhOVE0wTXpkYU1JSUJUVEVhTUJnR0JTcUZBMlFGRWc4ek1EUXpNekk0TXpFd01EQXhNakF4R1RBWEJna3ENCmhraUc5dzBCQ1FFV0NtVmtiMEJ2Wm1RdWNuVXhHakFZQmdncWhRTURnUU1CQVJJTU16TXlPREEwTVRjNU9URXkNCk1SWXdGQVlGS29VRFpBTVNDek16T0RrMU5EQTJORFUyTVIwd0d3WURWUVFIREJUUXN5NGcwSkxRdTlDdzBMVFENCnVOQzgwTGpSZ0RFd01DNEdBMVVFQ0F3bjBKTFF1OUN3MExUUXVOQzgwTGpSZ05HQjBMclFzTkdQSU5DKzBMSFENCnU5Q3cwWUhSZ3RHTU1Rc3dDUVlEVlFRR0V3SlNWVEVxTUNnR0ExVUVLZ3doMEtIUWxkQ2cwSlBRbGRDWklOQ1MNCjBKalFtdENpMEo3UW9OQ2UwSkxRbU5Dbk1Sa3dGd1lEVlFRRURCRFFtdENqMEpmUW5kQ1YwS2JRbnRDU01Uc3cNCk9RWURWUVFERERMUW10Q2owSmZRbmRDVjBLYlFudENTSU5DaDBKWFFvTkNUMEpYUW1TRFFrdENZMEpyUW90Q2UNCjBLRFFudENTMEpqUXB6Qm1NQjhHQ0NxRkF3Y0JBUUVCTUJNR0J5cUZBd0lDSkFBR0NDcUZBd2NCQVFJQ0EwTUENCkJFQzJjaXV5RG9JaTVrekIybllpNGxMc0QrcndsY2s0VnZHV1FtaGNnNjd4cTkrWlEwL2MyRWN2eUZqa1VtRG4NCnlOL3o3NGhVVmNoU2lQTno3TU11V2JiTm80SUUrVENDQlBVd0RnWURWUjBQQVFIL0JBUURBZ1R3TUI4R0NTc0cNCkFRUUJnamNWQndRU01CQUdDQ3FGQXdJQ0xnQUlBZ0VCQWdFQU1CMEdBMVVkRGdRV0JCVFkyaWNkU0RHbXRZYlUNClU0TzE2eStiTFFZWjNqQW1CZ05WSFNVRUh6QWRCZ2dyQmdFRkJRY0RCQVlJS3dZQkJRVUhBd0lHQnlxRkF3SUMNCklnWXdNZ1lKS3dZQkJBR0NOeFVLQkNVd0l6QUtCZ2dyQmdFRkJRY0RCREFLQmdnckJnRUZCUWNEQWpBSkJnY3ENCmhRTUNBaUlHTUlHb0JnZ3JCZ0VGQlFjQkFRU0JtekNCbURBNUJnZ3JCZ0VGQlFjd0FZWXRhSFIwY0RvdkwzUmwNCmMzUmpZVEl3TVRJdVkzSjVjSFJ2Y0hKdkxuSjFMMjlqYzNBeUwyOWpjM0F1YzNKbU1Gc0dDQ3NHQVFVRkJ6QUMNCmhrOW9kSFJ3T2k4dmRHVnpkR05oTWpBeE1pNWpjbmx3ZEc5d2NtOHVjblV2WVdsaEx6YzFPR1F4WW1ZM016SmsNCk1tUXdaakkxWmpGbE1HWTVaVEV6TnpsbFltWmpNakJtWlRsbE1tWXVZM0owTUIwR0ExVWRJQVFXTUJRd0NBWUcNCktvVURaSEVDTUFnR0JpcUZBMlJ4QVRBckJnTlZIUkFFSkRBaWdBOHlNREl4TURjeU5qRTFNalF6TjFxQkR6SXcNCk1qRXhNREkyTVRVeU5ETTNXakNDQVJvR0JTcUZBMlJ3QklJQkR6Q0NBUXNNTk5DaDBKclFsOUNZSUNMUW10R0ENCjBMalF2OUdDMEw3UW45R0EwTDRnUTFOUUlpQW8wTExRdGRHQTBZSFF1TkdQSURRdU1Da01NZENmMEpEUW1pQWkNCjBKclJnTkM0MEwvUmd0QyswSi9SZ05DK0lOQ2owS1lpSU5DeTBMWFJnTkdCMExqUXVDQXlMakFNVDlDaDBMWFINCmdOR0MwTGpSaE5DNDBMclFzTkdDSU5HQjBMN1F2dEdDMExMUXRkR0MwWUhSZ3RDeTBMalJqeURpaEpZZzBLSFENCnBDOHhNalF0TXprM01TRFF2dEdDSURFMUxqQXhMakl3TWpFTVQ5Q2gwTFhSZ05HQzBMalJoTkM0MExyUXNOR0MNCklOR0IwTDdRdnRHQzBMTFF0ZEdDMFlIUmd0Q3kwTGpSanlEaWhKWWcwS0hRcEM4eE1qZ3RNemczTUNEUXZ0R0MNCklESXpMakEzTGpJd01qQXdMQVlGS29VRFpHOEVJd3doMEtIUW10Q1gwSmdnSXRDYTBZRFF1TkMvMFlMUXZ0Q2YNCjBZRFF2aUJEVTFBaU1HQUdBMVVkSHdSWk1GY3dWYUJUb0ZHR1QyaDBkSEE2THk5MFpYTjBZMkV5TURFeUxtTnkNCmVYQjBiM0J5Ynk1eWRTOWpaSEF2TnpVNFpERmlaamN6TW1ReVpEQm1NalZtTVdVd1pqbGxNVE0zT1dWaVptTXkNCk1HWmxPV1V5Wmk1amNtd3dEQVlGS29VRFpISUVBd0lCQWpDQ0FaSUdBMVVkSXdTQ0FZa3dnZ0dGZ0JSMWpSdjMNCk10TFE4bDhlRDU0VGVldjhJUDZlTDZHQ0FWaWtnZ0ZVTUlJQlVERUxNQWtHQTFVRUJoTUNVbFV4RlRBVEJnVXENCmhRTmtCQklLTnpjeE56RXdOems1TVRFZ01CNEdDU3FHU0liM0RRRUpBUllSYVc1bWIwQmpjbmx3ZEc5d2NtOHUNCmNuVXhHREFXQmdVcWhRTmtBUklOTVRBek56Y3dNREE0TlRRME5ERVlNQllHQTFVRUNBd1BOemNnMEp6UXZ0R0INCjBMclFzdEN3TVJVd0V3WURWUVFIREF6UW5OQyswWUhRdXRDeTBMQXhMekF0QmdOVkJBa01KdEdEMExzdUlOQ2gNCjBZUFJpZEdSMExMUmdkQzYwTGpRdVNEUXN0Q3cwTHNnMExRdUlERTRNU1V3SXdZRFZRUUtEQnpRbnRDZTBKNGcNCkl0Q2EwS0RRbU5DZjBLTFFuaTNRbjlDZzBKNGlNV1V3WXdZRFZRUURERnpRb3RDMTBZSFJndEMrMExMUmk5QzUNCklOQ3owTDdRdTlDKzBMTFF2ZEMrMExrZzBLUFFwaURRbnRDZTBKNGdJdENhMEtEUW1OQ2YwS0xRbmkzUW45Q2cNCjBKNGlJTkNUMEo3UW9kQ2lJREl3TVRJZ0tOQ2owS1lnTWk0d0tZSVJBL2lZaFFCeHJlR01UWHRMUnNWL0ZVSXcNCkNnWUlLb1VEQndFQkF3SURRUUNON0Vrdnp2RmFmM3dkMUpkSUVZeUdWSzYwYS9IUGNuREFGcXoxdzNGVTR2N0gNCnRzRGNsa0diaENlKzFWNEJOMnFUcXNSZ2F1NzZxUldtbE9tcEdnNk9NWUlFQ1RDQ0JBVUNBUUV3Z2dGdE1JSUINClZqRVZNQk1HQlNxRkEyUUVFZ28zTnpFM01UQTNPVGt4TVNBd0hnWUpLb1pJaHZjTkFRa0JGaEZwYm1adlFHTnkNCmVYQjBiM0J5Ynk1eWRURVlNQllHQlNxRkEyUUJFZzB4TURNM056QXdNRGcxTkRRME1Rc3dDUVlEVlFRR0V3SlMNClZURVlNQllHQTFVRUNBd1BOemNnMEp6UXZ0R0IwTHJRc3RDd01SVXdFd1lEVlFRSERBelFuTkMrMFlIUXV0Q3kNCjBMQXhMekF0QmdOVkJBa01KdEdEMExzdUlOQ2gwWVBSaWRHUjBMTFJnZEM2MExqUXVTRFFzdEN3MExzZzBMUXUNCklERTRNU1V3SXdZRFZRUUtEQnpRbnRDZTBKNGdJdENhMEtEUW1OQ2YwS0xRbmkzUW45Q2cwSjRpTVdzd2FRWUQNClZRUURER0xRb3RDMTBZSFJndEMrMExMUmk5QzVJTkMvMEw3UXROR0gwTGpRdmRDMTBMM1F2ZEdMMExrZzBLUFENCnBpRFFudENlMEo0Z0l0Q2EwS0RRbU5DZjBLTFFuaTNRbjlDZzBKNGlJTkNUMEo3UW9kQ2lJREl3TVRJZ0tOQ2oNCjBLWWdNaTR3S1FJUkF6ZXpBQUZ4clpDblEvVE9QcXlqQzZrd0RBWUlLb1VEQndFQkFnSUZBS0NDQWpFd0dBWUoNCktvWklodmNOQVFrRE1Rc0dDU3FHU0liM0RRRUhBVEFjQmdrcWhraUc5dzBCQ1FVeER4Y05NakV3T1RFMU1Ea3cNCk1qSTVXakF2QmdrcWhraUc5dzBCQ1FReElnUWdWZmFUY1d0ZlJCYVR2Z0JwT1FoS2tWQzU2K016VHdTUndFeVENCjd5eHMvMGd3Z2dIRUJnc3Foa2lHOXcwQkNSQUNMekdDQWJNd2dnR3ZNSUlCcXpDQ0FhY3dDZ1lJS29VREJ3RUINCkFnSUVJQnBoUnRBTStNWTd4WmJJZzFUMFVhVWV0K0pFNzByUVo1SWxEc1FyS2dZZU1JSUJkVENDQVY2a2dnRmENCk1JSUJWakVWTUJNR0JTcUZBMlFFRWdvM056RTNNVEEzT1RreE1TQXdIZ1lKS29aSWh2Y05BUWtCRmhGcGJtWnYNClFHTnllWEIwYjNCeWJ5NXlkVEVZTUJZR0JTcUZBMlFCRWcweE1ETTNOekF3TURnMU5EUTBNUXN3Q1FZRFZRUUcNCkV3SlNWVEVZTUJZR0ExVUVDQXdQTnpjZzBKelF2dEdCMExyUXN0Q3dNUlV3RXdZRFZRUUhEQXpRbk5DKzBZSFENCnV0Q3kwTEF4THpBdEJnTlZCQWtNSnRHRDBMc3VJTkNoMFlQUmlkR1IwTExSZ2RDNjBMalF1U0RRc3RDdzBMc2cNCjBMUXVJREU0TVNVd0l3WURWUVFLREJ6UW50Q2UwSjRnSXRDYTBLRFFtTkNmMEtMUW5pM1FuOUNnMEo0aU1Xc3cNCmFRWURWUVFEREdMUW90QzEwWUhSZ3RDKzBMTFJpOUM1SU5DLzBMN1F0TkdIMExqUXZkQzEwTDNRdmRHTDBMa2cNCjBLUFFwaURRbnRDZTBKNGdJdENhMEtEUW1OQ2YwS0xRbmkzUW45Q2cwSjRpSU5DVDBKN1FvZENpSURJd01USWcNCktOQ2owS1lnTWk0d0tRSVJBemV6QUFGeHJaQ25RL1RPUHF5akM2a3dDZ1lJS29VREJ3RUJBUUVFUUs2N1VUSjgNCmRENWFvZklIL0thZDBPanh6cVdKVGNpU0hKWGZyOFNkSHZ1a3RCZEd0dG5OTjkrK2liNU9DbFZ3em1qSG1rZGMNClhudmhiTVFNQVJCV0Mwcz08L93PPgogICAgICAgIDwvyOTI7fTP8O7kPgogICAgICAgIDzR7uTU1cY0IM3g6OzE7urO7/DP8D0i0ffl8i304Ory8/DgIOgg5O7q8+zl7fIg7uEg7vLj8PPn6uUg8u7i4PDu4iAo4vvv7uvt5e3o6CDw4OHu8iksIO/l8OXk4PflIOjs8/nl8fLi5e3t+/Ug7/Dg4iAo5O7q8+zl7fIg7uEg7urg5+Dt6Ogg8/Hr8+MpIiDU8+3q9uj/PSLR19TEzs8iIM3u7NH31Mjt9M/wPSI5IiDE4PLg0ffUyO30z/A9IjEzLjA5LjIwMjEiPgogICAgICAgICAgICA80eLP8OjtINHu5M7v5fA9Is/w6O3/8u4g4eXnIOfg7OX34O3o6SIgxODy4M/w6O09IjE2LjA5LjIwMjEiLz4KICAgICAgICA8L9Hu5NTVxjQ+CiAgICAgICAgPM/u5O/o8eDt8iDO4evP7uvtPSIyIiDR8uDy8/E9IjUiIM7x7c/u6+09IsTu6+bt7vHy7fvlIO7h/+fg7e3u8fLoIj4KICAgICAgICAgICAgPN7LIMjNzd7LPSI5NzIxMDgzNDcyIiDN4OjszvDjPSLOzs4gJnF1b3Q7ys7N0sXKwCZxdW90OyIgxO7r5u09IsTo8OXq8u7wIj4KICAgICAgICAgICAgICAgIDzUyM4g1ODs6Ovo/z0iz+Di6O0iIMjs/z0iz+Di5esiLz4KICAgICAgICAgICAgPC/eyz4KICAgICAgICA8L8/u5O/o8eDt8j4KICAgIDwvyO30z+7qPgo8L9Tg6es+Cg==",
    "uuid": "17396e78-5464-4419-a2ef-18be3fc3ba4c",
    "docTypeId": 11
  }
}

Таблица 2.25. Описание параметров ответа на запрос получения черновика титула УПД-ПОК

Параметр Формат значения Описание
contentBase64 String Содержимое документа в формате Base64.
uuid String Уникальный идентификатор черновика(заготовки). (UUID)
id Integer Идентификатор типа документа черновика(заготовки). (Number)

2.3.5. Отправить титул покупателя УПД/УКД

Для того чтобы опубликовать подписанный черновик титула УПД или подписанный черновик титула УКД, применяется запрос построенный на HTTP-методе POST и имеет следующий вид:


POST https://lk.edo.ru/api/edo/{version}/documents/provisional/buyer/title/sign

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Запрос:


https://lk.edo.ru/api/edo/v1/documents/provisional/buyer/title/sign
Authorization: Token 8890ea5e-95f8-4d33-b4bc-7ace2339fc91

{
  "signatureBase64": "MIINAwYJKoZIhvcNAQcCoIIM9DCCDPACAQExDjAMBggqhQMHAQECAgUAMAsGCSqGSIb3DQEHAaCC\r\nCLUwggixMIIIXqADAgECAhECLlrqAFetOolOub1QHxragDAKBggqhQMHAQEDAjCCAVsxIDAeBgkq\r\nhkiG9w0BCQEWEWluZm9AY3J5cHRvcHJvLnJ1MRgwFgYFKoUDZAESDTEwMzc3MDAwODU0NDQxGjAY\r\nBggqhQMDgQMBARIMMDA3NzE3MTA3OTkxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB\r\n0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLR\r\ngdC60LjQuSDQstCw0Lsg0LQuIDE4MSUwIwYDVQQKDBzQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg\r\n0J4iMWswaQYDVQQDDGLQotC10YHRgtC+0LLRi9C5INC/0L7QtNGH0LjQvdC10L3QvdGL0Lkg0KPQ\r\npiDQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg0J4iINCT0J7QodCiIDIwMTIgKNCj0KYgMi4wKTAe\r\nFw0yMTA2MzAxNDAzMTVaFw0yMTA5MzAxNDEzMTVaMIIBTjEZMBcGCSqGSIb3DQEJARYKb2ZkQG9m\r\nZC5ydTEaMBgGCCqFAwOBAwEBEgwwMDk3MjEwODM0NzIxGDAWBgUqhQNkARINMTE5Nzc0NjQyNTA4\r\nNDEZMBcGA1UEDAwQ0JTQuNGA0LXQutGC0L7RgDEgMB4GA1UECwwX0J7QntCeICLQmtCe0J3QotCV\r\n0JrQkCIxIDAeBgNVBAoMF9Ce0J7QniAi0JrQntCd0KLQldCa0JAiMRUwEwYDVQQJDAzQnNC+0YHQ\r\nutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEVMBMGA1UECAwM0JzQvtGB0LrQstCwMQswCQYD\r\nVQQGEwJSVTETMBEGA1UEKgwK0J/QsNCy0LXQuzETMBEGA1UEBAwK0J/QsNCy0LjQvTEgMB4GA1UE\r\nAwwX0J7QntCeICLQmtCe0J3QotCV0JrQkCIwZjAfBggqhQMHAQEBATATBgcqhQMCAiQABggqhQMH\r\nAQECAgNDAARAfo0WcdHwnUuzWcpe6USbOXzxwft+TiYiPwfJnQIOPoJaBacq+87FryQYF5G80Loh\r\nP1E1Zjc6yrGYjsAoOrA6/qOCBP0wggT5MA4GA1UdDwEB/wQEAwIE8DAfBgkrBgEEAYI3FQcEEjAQ\r\nBggqhQMCAi4ACAIBAQIBADAdBgNVHQ4EFgQUUyY8VlozO4v234cZtY8plE6Z8QUwJgYDVR0lBB8w\r\nHQYIKwYBBQUHAwQGCCsGAQUFBwMCBgcqhQMCAiIGMDIGCSsGAQQBgjcVCgQlMCMwCgYIKwYBBQUH\r\nAwQwCgYIKwYBBQUHAwIwCQYHKoUDAgIiBjCBpwYIKwYBBQUHAQEEgZowgZcwOAYIKwYBBQUHMAGG\r\nLGh0dHA6Ly90ZXN0Y2EyMDEyLmNyeXB0b3Byby5ydS9vY3NwL29jc3Auc3JmMFsGCCsGAQUFBzAC\r\nhk9odHRwOi8vdGVzdGNhMjAxMi5jcnlwdG9wcm8ucnUvYWlhLzA2NGI2MzI1MzM2NjJhMjQzODE4\r\nNzI0MzdhM2JiN2NiYjJjYWZjNzMuY3J0MB0GA1UdIAQWMBQwCAYGKoUDZHECMAgGBiqFA2RxATAr\r\nBgNVHRAEJDAigA8yMDIxMDYzMDE0MDMxNVqBDzIwMjEwOTMwMTQwMzE1WjCCARoGBSqFA2RwBIIB\r\nDzCCAQsMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQu\r\nMCkMMdCf0JDQmiAi0JrRgNC40L/RgtC+0J/RgNC+INCj0KYiINCy0LXRgNGB0LjQuCAyLjAMT9Ch\r\n0LXRgNGC0LjRhNC40LrQsNGCINGB0L7QvtGC0LLQtdGC0YHRgtCy0LjRjyDihJYg0KHQpC8xMjQt\r\nMzM4MCDQvtGCIDExLjA1LjIwMTgMT9Ch0LXRgNGC0LjRhNC40LrQsNGCINGB0L7QvtGC0LLQtdGC\r\n0YHRgtCy0LjRjyDihJYg0KHQpC8xMjgtMzU5MiDQvtGCIDE3LjEwLjIwMTgwLAYFKoUDZG8EIwwh\r\n0KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiMGAGA1UdHwRZMFcwVaBToFGGT2h0dHA6\r\nLy90ZXN0Y2EyMDEyLmNyeXB0b3Byby5ydS9jZHAvMDY0YjYzMjUzMzY2MmEyNDM4MTg3MjQzN2Ez\r\nYmI3Y2JiMmNhZmM3My5jcmwwDAYFKoUDZHIEAwIBAjCCAZcGA1UdIwSCAY4wggGKgBQGS2MlM2Yq\r\nJDgYckN6O7fLssr8c6GCAV2kggFZMIIBVTEgMB4GCSqGSIb3DQEJARYRaW5mb0BjcnlwdG9wcm8u\r\ncnUxGDAWBgUqhQNkARINMTAzNzcwMDA4NTQ0NDEaMBgGCCqFAwOBAwEBEgwwMDc3MTcxMDc5OTEx\r\nCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC6\r\n0LLQsDEvMC0GA1UECQwm0YPQuy4g0KHRg9GJ0ZHQstGB0LrQuNC5INCy0LDQuyDQtC4gMTgxJTAj\r\nBgNVBAoMHNCe0J7QniAi0JrQoNCY0J/QotCeLdCf0KDQniIxZTBjBgNVBAMMXNCi0LXRgdGC0L7Q\r\nstGL0Lkg0LPQvtC70L7QstC90L7QuSDQo9CmINCe0J7QniAi0JrQoNCY0J/QotCeLdCf0KDQniIg\r\n0JPQntCh0KIgMjAxMiAo0KPQpiAyLjApghECbc+0AK2rS4hGDZj53PwvLjAKBggqhQMHAQEDAgNB\r\nAFXgvsviPPKjAyTAiajg5hdHTgmydqONcit7YuvRi/uAUH6yYn0eSOEXhrGgLudLyGh+gWTz56Ze\r\np4CqiMGX+NkxggQTMIIEDwIBATCCAXIwggFbMSAwHgYJKoZIhvcNAQkBFhFpbmZvQGNyeXB0b3By\r\nby5ydTEYMBYGBSqFA2QBEg0xMDM3NzAwMDg1NDQ0MRowGAYIKoUDA4EDAQESDDAwNzcxNzEwNzk5\r\nMTELMAkGA1UEBhMCUlUxGDAWBgNVBAgMDzc3INCc0L7RgdC60LLQsDEVMBMGA1UEBwwM0JzQvtGB\r\n0LrQstCwMS8wLQYDVQQJDCbRg9C7LiDQodGD0YnRkdCy0YHQutC40Lkg0LLQsNC7INC0LiAxODEl\r\nMCMGA1UECgwc0J7QntCeICLQmtCg0JjQn9Ci0J4t0J/QoNCeIjFrMGkGA1UEAwxi0KLQtdGB0YLQ\r\nvtCy0YvQuSDQv9C+0LTRh9C40L3QtdC90L3Ri9C5INCj0KYg0J7QntCeICLQmtCg0JjQn9Ci0J4t\r\n0J/QoNCeIiDQk9Ce0KHQoiAyMDEyICjQo9CmIDIuMCkCEQIuWuoAV606iU65vVAfGtqAMAwGCCqF\r\nAwcBAQICBQCgggI2MBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIx\r\nMDkxNjE0MjYxMlowLwYJKoZIhvcNAQkEMSIEIAA0vqKukX1vrx7znoeoWTp/y05JCQZahhP8SKYN\r\nUzh8MIIByQYLKoZIhvcNAQkQAi8xggG4MIIBtDCCAbAwggGsMAoGCCqFAwcBAQICBCAxlEFcvdQd\r\nVhG7mX00qpHWj6fVmVGcNUF0bHeZK5ZfIzCCAXowggFjpIIBXzCCAVsxIDAeBgkqhkiG9w0BCQEW\r\nEWluZm9AY3J5cHRvcHJvLnJ1MRgwFgYFKoUDZAESDTEwMzc3MDAwODU0NDQxGjAYBggqhQMDgQMB\r\nARIMMDA3NzE3MTA3OTkxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUw\r\nEwYDVQQHDAzQnNC+0YHQutCy0LAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLRgdC60LjQuSDQ\r\nstCw0Lsg0LQuIDE4MSUwIwYDVQQKDBzQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg0J4iMWswaQYD\r\nVQQDDGLQotC10YHRgtC+0LLRi9C5INC/0L7QtNGH0LjQvdC10L3QvdGL0Lkg0KPQpiDQntCe0J4g\r\nItCa0KDQmNCf0KLQni3Qn9Cg0J4iINCT0J7QodCiIDIwMTIgKNCj0KYgMi4wKQIRAi5a6gBXrTqJ\r\nTrm9UB8a2oAwCgYIKoUDBwEBAQEEQIJPmAsLGosMKYYwKwSOHB0fs54bJlHeOxRooDNxgVGgrG0y\r\na70CLd85FJ94ZGlUi13OANb2CtIm/vvWcpPHsag=",
  "uuid": "17396e78-5464-4419-a2ef-18be3fc3ba4c"
}

Описание параметров запроса опубликования подписанного черновика титула УПД или подписанного черновика титула УКД, приведены в таблице 2.26.

Таблица 2.26. Параметры запроса опубликования подписанного черновика титула УПД или подписанного черновика титула УКД

Параметр Формат значения Описание Обязательно в запросе
uuid String Идентификатор черновика(заготовки) документа. (UUID), да
signatureBase64 String Открепленная подпись содержимого документа в формате Base64) да


Приведен пример ответа на запрос:

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "docId": 1266165,
    "docUuid": null
  }
}

Таблица 2.27. Описание параметров ответа на запрос опубликования подписанного черновика титула УПД или подписанного черновика титула УКД

Параметр Формат значения Описание
docId Integer Идентификатор подписанного документа. (Number)
docUuid String Идентификатор подписанного документа. (UUID)

2.3.6. Сформировать УОУ

Для того чтобы получить черновик УОУ, применяется запрос построенный на HTTP-методе POST и имеющий следующий вид:


POST https://lk.edo.ru/api/edo/{version}/documents/provisional/reject

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Запрос:


POST https://lk.edo.ru/api/edo/v1/documents/provisional/reject
Authorization: Token 8890ea5e-95f8-4d33-b4bc-7ace2339fc91
{
  "provisionalDocParams": {
    "parentDocId": 1266167,
    "fingerprint": "264f3033bef7d64be7df8375eb0c4882df868f9e"
  },
  "additionalParams": {
    "fingerprint": "264f3033bef7d64be7df8375eb0c4882df868f9e",
    "parentDocId": 1266167,
    "textRefinement": "Не верно указан поставщик ",
    "docTypeId": 6
  }
}

Описание параметров запроса для получения черновик УОУ, приведены в таблице 2.28.

Таблица 2.28. Параметры запроса для получения черновика УОУ

Параметр Вложенный параметр Формат значения Описание Обязательно в запросе
parentDocId Integer Идентификатор родительского документа да
fingerprint String Отпечаток сертификата. (Строка SHA1 hash) да
additionalParams Структура да
fingerprint String Отпечаток сертификата. (Строка SHA1 hash) да
parentDocId String Идентификатор родительского документа да
docTypeId String 6 — это уведомление об уточнении. да
svPrinSodOper String Указывается действия, например:
— «Товары принял без претензий»;
— «Результаты работ принял без претензий»;
— «Услуги получены, претензий нет»; или другое.
да
svPrinDataPrin String Дата принятия УПД. да
textRefinement String Текстовый комментарий. да



Приведен пример ответа на запрос:

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "contentBase64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIiBzdGFuZGFsb25lPSJ5ZXMiPz4KPNTg6esgyOTU4OnrPSJEUF9VVlVUT0NIXzJQUy0zMzI4MDQxNzk5MTIwMDAwMDAwMDAwMDA5NTE2ODUxMl8yUFMtMDA5NzIxMDgzNDcyMDc3MjEwMTAwMTAwMzA2NDAzODFfMjAyMTA5MTZfNWJmNDk3YzMtZjY0ZS00NWFhLWEwMmEtZjI2MGUyNDc4NzJmIiDC5fDxz/Du4z0i0tEg3cTOIDEwLjAuMC4wIiDC5fDx1O7w7D0iMS4wMiI+CiAgICA8xO7q8+zl7fIgys3EPSIxMTE1MTEzIj4KICAgICAgICA80/fg8fLdxM4gyOTT9+Dx8t3Ezj0iMlBTLTAwOTcyMTA4MzQ3MjA3NzIxMDEwMDEwMDMwNjQwMzgxIj4KICAgICAgICAgICAgPN7LIM3g6OzO8OM9Is7OziAmcXVvdDvKzs3SxcrAJnF1b3Q7IiDIzc3eyz0iOTcyMTA4MzQ3MiIgys/PPSI3NzIxMDEwMDEiLz4KICAgICAgICA8L9P34PHy3cTOPgogICAgICAgIDzR4tPi5eTT8u73IMTg8uDP7us9IjE2LjA5LjIwMjEiIMLw5ez/z+7rPSIxNy41Mi4zNyI+CiAgICAgICAgICAgIDzR4uXkz+7r1ODp6yDI7P/P7vHy1ODp6+A9Ik9OX05TQ0hGRE9QUFJfMlBTLTAwOTcyMTA4MzQ3MjA3NzIxMDEwMDEwMDMwNjQwMzgxXzJQUy0zMzI4MDQxNzk5MTIwMDAwMDAwMDAwMDA5NTE2ODUxMl8yMDIxMDkxNl9mODFjNjZkMC02ZjkxLTRkNGMtOWE3MS1kY2Q4NTk0NjIwMDAueG1sIj4KICAgICAgICAgICAgICAgIDzd1s/P7uvU4OnrPk1JSVZOd1lKS29aSWh2Y05BUWNDb0lJVktEQ0NGU1FDQVFFeERqQU1CZ2dxaFFNSEFRRUNBZ1VBTUFzR0NTcUcNClNJYjNEUUVIQWFDQ0VQTXdnZ2hFTUlJSDhhQURBZ0VDQWhFRCtKaUZBSEd0NFl4TmUwdEd4WDhWUWpBS0JnZ3ENCmhRTUhBUUVEQWpDQ0FWQXhDekFKQmdOVkJBWVRBbEpWTVJVd0V3WUZLb1VEWkFRU0NqYzNNVGN4TURjNU9URXgNCklEQWVCZ2txaGtpRzl3MEJDUUVXRVdsdVptOUFZM0o1Y0hSdmNISnZMbkoxTVJnd0ZnWUZLb1VEWkFFU0RURXcNCk16YzNNREF3T0RVME5EUXhHREFXQmdOVkJBZ01EemMzSU5DYzBMN1JnZEM2MExMUXNERVZNQk1HQTFVRUJ3d00NCjBKelF2dEdCMExyUXN0Q3dNUzh3TFFZRFZRUUpEQ2JSZzlDN0xpRFFvZEdEMFluUmtkQ3kwWUhRdXRDNDBMa2cNCjBMTFFzTkM3SU5DMExpQXhPREVsTUNNR0ExVUVDZ3djMEo3UW50Q2VJQ0xRbXRDZzBKalFuOUNpMEo0dDBKL1ENCm9OQ2VJakZsTUdNR0ExVUVBd3hjMEtMUXRkR0IwWUxRdnRDeTBZdlF1U0RRczlDKzBMdlF2dEN5MEwzUXZ0QzUNCklOQ2owS1lnMEo3UW50Q2VJQ0xRbXRDZzBKalFuOUNpMEo0dDBKL1FvTkNlSWlEUWs5Q2UwS0hRb2lBeU1ERXkNCklDalFvOUNtSURJdU1Da3dIaGNOTWpFd056STJNRGMxTmpJMldoY05NekV3TnpJMk1EZ3dOakkyV2pDQ0FWWXgNCkZUQVRCZ1VxaFFOa0JCSUtOemN4TnpFd056azVNVEVnTUI0R0NTcUdTSWIzRFFFSkFSWVJhVzVtYjBCamNubHcNCmRHOXdjbTh1Y25VeEdEQVdCZ1VxaFFOa0FSSU5NVEF6Tnpjd01EQTROVFEwTkRFTE1Ba0dBMVVFQmhNQ1VsVXgNCkdEQVdCZ05WQkFnTUR6YzNJTkNjMEw3UmdkQzYwTExRc0RFVk1CTUdBMVVFQnd3TTBKelF2dEdCMExyUXN0Q3cNCk1TOHdMUVlEVlFRSkRDYlJnOUM3TGlEUW9kR0QwWW5Sa2RDeTBZSFF1dEM0MExrZzBMTFFzTkM3SU5DMExpQXgNCk9ERWxNQ01HQTFVRUNnd2MwSjdRbnRDZUlDTFFtdENnMEpqUW45Q2kwSjR0MEovUW9OQ2VJakZyTUdrR0ExVUUNCkF3eGkwS0xRdGRHQjBZTFF2dEN5MFl2UXVTRFF2OUMrMExUUmg5QzQwTDNRdGRDOTBMM1JpOUM1SU5DajBLWWcNCjBKN1FudENlSUNMUW10Q2cwSmpRbjlDaTBKNHQwSi9Rb05DZUlpRFFrOUNlMEtIUW9pQXlNREV5SUNqUW85Q20NCklESXVNQ2t3WmpBZkJnZ3FoUU1IQVFFQkFUQVRCZ2NxaFFNQ0FpTUJCZ2dxaFFNSEFRRUNBZ05EQUFSQVh3L3ANCmM2S3ovWk1LZ2lzb1IyMkpUUTVxOVdPV2puZVpsd0JIeTVTMTZud3BQeHJocTNVU1RHbVpUK3k0ZGRLMVllSEoNCkVFNVhCWXk0MDBIOUpqUWpIcU9DQkpNd2dnU1BNRjBHQlNxRkEyUnZCRlFNVXRDaDBKclFsOUNZSUNMUW10R0ENCjBMalF2OUdDMEw3UW45R0EwTDRnUTFOUUlpQW8wTExRdGRHQTBZSFF1TkdQSURRdU1Da2dLTkM0MFlIUXY5QysNCjBMdlF2ZEMxMEwzUXVOQzFJREl0UW1GelpTa3dFZ1lKS3dZQkJBR0NOeFVCQkFVQ0F3TUFBekFkQmdOVkhRNEUNCkZnUVVkWTBiOXpMUzBQSmZIZytlRTNuci9DRCtuaTh3RGdZRFZSMFBBUUgvQkFRREFnR0dNQklHQTFVZEV3RUINCi93UUlNQVlCQWY4Q0FRQXdKUVlEVlIwZ0JCNHdIREFHQmdSVkhTQUFNQWdHQmlxRkEyUnhBVEFJQmdZcWhRTmsNCmNRSXdhd1lJS3dZQkJRVUhBUUVFWHpCZE1Gc0dDQ3NHQVFVRkJ6QUNoazlvZEhSd09pOHZkR1Z6ZEdOaE1qQXgNCk1pNWpjbmx3ZEc5d2NtOHVjblV2WVdsaEx6ZzJPVFkzWmpnMU9HTXhZak14WVdFNU1tRTJPR1F4TkdZeU9HTmkNCllqRm1NakV5WmpWak0yRXVZM0owTUI4R0NTc0dBUVFCZ2pjVkJ3UVNNQkFHQ0NxRkF3SUNMZ0FCQWdFQkFnRUENCk1JSUJHZ1lGS29VRFpIQUVnZ0VQTUlJQkN3dzAwS0hRbXRDWDBKZ2dJdENhMFlEUXVOQy8wWUxRdnRDZjBZRFENCnZpQkRVMUFpSUNqUXN0QzEwWURSZ2RDNDBZOGdOQzR3S1F3eDBKL1FrTkNhSUNMUW10R0EwTGpRdjlHQzBMN1ENCm45R0EwTDRnMEtQUXBpSWcwTExRdGRHQTBZSFF1TkM0SURJdU1BeFAwS0hRdGRHQTBZTFF1TkdFMExqUXV0Q3cNCjBZSWcwWUhRdnRDKzBZTFFzdEMxMFlMUmdkR0MwTExRdU5HUElPS0VsaURRb2RDa0x6RXlOQzB6T1RjeElOQysNCjBZSWdNVFV1TURFdU1qQXlNUXhQMEtIUXRkR0EwWUxRdU5HRTBMalF1dEN3MFlJZzBZSFF2dEMrMFlMUXN0QzENCjBZTFJnZEdDMExMUXVOR1BJT0tFbGlEUW9kQ2tMekV5T0Mwek9EY3dJTkMrMFlJZ01qTXVNRGN1TWpBeU1EQmcNCkJnTlZIUjhFV1RCWE1GV2dVNkJSaGs5b2RIUndPaTh2ZEdWemRHTmhNakF4TWk1amNubHdkRzl3Y204dWNuVXYNClkyUndMemcyT1RZM1pqZzFPR014WWpNeFlXRTVNbUUyT0dReE5HWXlPR05pWWpGbU1qRXlaalZqTTJFdVkzSnMNCk1Bd0dCU3FGQTJSeUJBTUNBUUl3Z2dHU0JnTlZIU01FZ2dHSk1JSUJoWUFVaHBaL2hZd2JNYXFTcG8wVThveTcNCkh5RXZYRHFoZ2dGWXBJSUJWRENDQVZBeEN6QUpCZ05WQkFZVEFsSlZNUlV3RXdZRktvVURaQVFTQ2pjM01UY3gNCk1EYzVPVEV4SURBZUJna3Foa2lHOXcwQkNRRVdFV2x1Wm05QVkzSjVjSFJ2Y0hKdkxuSjFNUmd3RmdZRktvVUQNClpBRVNEVEV3TXpjM01EQXdPRFUwTkRReEdEQVdCZ05WQkFnTUR6YzNJTkNjMEw3UmdkQzYwTExRc0RFVk1CTUcNCkExVUVCd3dNMEp6UXZ0R0IwTHJRc3RDd01TOHdMUVlEVlFRSkRDYlJnOUM3TGlEUW9kR0QwWW5Sa2RDeTBZSFENCnV0QzQwTGtnMExMUXNOQzdJTkMwTGlBeE9ERWxNQ01HQTFVRUNnd2MwSjdRbnRDZUlDTFFtdENnMEpqUW45Q2kNCjBKNHQwSi9Rb05DZUlqRmxNR01HQTFVRUF3eGMwS0xRdGRHQjBZTFF2dEN5MFl2UXVTRFFzOUMrMEx2UXZ0Q3kNCjBMM1F2dEM1SU5DajBLWWcwSjdRbnRDZUlDTFFtdENnMEpqUW45Q2kwSjR0MEovUW9OQ2VJaURRazlDZTBLSFENCm9pQXlNREV5SUNqUW85Q21JREl1TUNtQ0VRTkZQSHNBY2EzWnEweGZ5S2hGSDVlbk1Bb0dDQ3FGQXdjQkFRTUMNCkEwRUFDRXIvVERRa2Zkc0xvSGhEaUJDNWNuSnp2OXBreXJYVnZHYXVkalptOVJ3aWJwZFkyZUtMcmhhNWVBVlMNCnVDUHRRb0lKS2hQUVd2ZjZ1TnZqZ2xRQUNEQ0NDS2N3Z2doVW9BTUNBUUlDRVFNM3N3QUJjYTJRcDBQMHpqNnMNCm93dXBNQW9HQ0NxRkF3Y0JBUU1DTUlJQlZqRVZNQk1HQlNxRkEyUUVFZ28zTnpFM01UQTNPVGt4TVNBd0hnWUoNCktvWklodmNOQVFrQkZoRnBibVp2UUdOeWVYQjBiM0J5Ynk1eWRURVlNQllHQlNxRkEyUUJFZzB4TURNM056QXcNCk1EZzFORFEwTVFzd0NRWURWUVFHRXdKU1ZURVlNQllHQTFVRUNBd1BOemNnMEp6UXZ0R0IwTHJRc3RDd01SVXcNCkV3WURWUVFIREF6UW5OQyswWUhRdXRDeTBMQXhMekF0QmdOVkJBa01KdEdEMExzdUlOQ2gwWVBSaWRHUjBMTFINCmdkQzYwTGpRdVNEUXN0Q3cwTHNnMExRdUlERTRNU1V3SXdZRFZRUUtEQnpRbnRDZTBKNGdJdENhMEtEUW1OQ2YNCjBLTFFuaTNRbjlDZzBKNGlNV3N3YVFZRFZRUURER0xRb3RDMTBZSFJndEMrMExMUmk5QzVJTkMvMEw3UXROR0gNCjBMalF2ZEMxMEwzUXZkR0wwTGtnMEtQUXBpRFFudENlMEo0Z0l0Q2EwS0RRbU5DZjBLTFFuaTNRbjlDZzBKNGkNCklOQ1QwSjdRb2RDaUlESXdNVElnS05DajBLWWdNaTR3S1RBZUZ3MHlNVEEzTWpZeE5USTBNemRhRncweU1URXcNCk1qWXhOVE0wTXpkYU1JSUJUVEVhTUJnR0JTcUZBMlFGRWc4ek1EUXpNekk0TXpFd01EQXhNakF4R1RBWEJna3ENCmhraUc5dzBCQ1FFV0NtVmtiMEJ2Wm1RdWNuVXhHakFZQmdncWhRTURnUU1CQVJJTU16TXlPREEwTVRjNU9URXkNCk1SWXdGQVlGS29VRFpBTVNDek16T0RrMU5EQTJORFUyTVIwd0d3WURWUVFIREJUUXN5NGcwSkxRdTlDdzBMVFENCnVOQzgwTGpSZ0RFd01DNEdBMVVFQ0F3bjBKTFF1OUN3MExUUXVOQzgwTGpSZ05HQjBMclFzTkdQSU5DKzBMSFENCnU5Q3cwWUhSZ3RHTU1Rc3dDUVlEVlFRR0V3SlNWVEVxTUNnR0ExVUVLZ3doMEtIUWxkQ2cwSlBRbGRDWklOQ1MNCjBKalFtdENpMEo3UW9OQ2UwSkxRbU5Dbk1Sa3dGd1lEVlFRRURCRFFtdENqMEpmUW5kQ1YwS2JRbnRDU01Uc3cNCk9RWURWUVFERERMUW10Q2owSmZRbmRDVjBLYlFudENTSU5DaDBKWFFvTkNUMEpYUW1TRFFrdENZMEpyUW90Q2UNCjBLRFFudENTMEpqUXB6Qm1NQjhHQ0NxRkF3Y0JBUUVCTUJNR0J5cUZBd0lDSkFBR0NDcUZBd2NCQVFJQ0EwTUENCkJFQzJjaXV5RG9JaTVrekIybllpNGxMc0QrcndsY2s0VnZHV1FtaGNnNjd4cTkrWlEwL2MyRWN2eUZqa1VtRG4NCnlOL3o3NGhVVmNoU2lQTno3TU11V2JiTm80SUUrVENDQlBVd0RnWURWUjBQQVFIL0JBUURBZ1R3TUI4R0NTc0cNCkFRUUJnamNWQndRU01CQUdDQ3FGQXdJQ0xnQUlBZ0VCQWdFQU1CMEdBMVVkRGdRV0JCVFkyaWNkU0RHbXRZYlUNClU0TzE2eStiTFFZWjNqQW1CZ05WSFNVRUh6QWRCZ2dyQmdFRkJRY0RCQVlJS3dZQkJRVUhBd0lHQnlxRkF3SUMNCklnWXdNZ1lKS3dZQkJBR0NOeFVLQkNVd0l6QUtCZ2dyQmdFRkJRY0RCREFLQmdnckJnRUZCUWNEQWpBSkJnY3ENCmhRTUNBaUlHTUlHb0JnZ3JCZ0VGQlFjQkFRU0JtekNCbURBNUJnZ3JCZ0VGQlFjd0FZWXRhSFIwY0RvdkwzUmwNCmMzUmpZVEl3TVRJdVkzSjVjSFJ2Y0hKdkxuSjFMMjlqYzNBeUwyOWpjM0F1YzNKbU1Gc0dDQ3NHQVFVRkJ6QUMNCmhrOW9kSFJ3T2k4dmRHVnpkR05oTWpBeE1pNWpjbmx3ZEc5d2NtOHVjblV2WVdsaEx6YzFPR1F4WW1ZM016SmsNCk1tUXdaakkxWmpGbE1HWTVaVEV6TnpsbFltWmpNakJtWlRsbE1tWXVZM0owTUIwR0ExVWRJQVFXTUJRd0NBWUcNCktvVURaSEVDTUFnR0JpcUZBMlJ4QVRBckJnTlZIUkFFSkRBaWdBOHlNREl4TURjeU5qRTFNalF6TjFxQkR6SXcNCk1qRXhNREkyTVRVeU5ETTNXakNDQVJvR0JTcUZBMlJ3QklJQkR6Q0NBUXNNTk5DaDBKclFsOUNZSUNMUW10R0ENCjBMalF2OUdDMEw3UW45R0EwTDRnUTFOUUlpQW8wTExRdGRHQTBZSFF1TkdQSURRdU1Da01NZENmMEpEUW1pQWkNCjBKclJnTkM0MEwvUmd0QyswSi9SZ05DK0lOQ2owS1lpSU5DeTBMWFJnTkdCMExqUXVDQXlMakFNVDlDaDBMWFINCmdOR0MwTGpSaE5DNDBMclFzTkdDSU5HQjBMN1F2dEdDMExMUXRkR0MwWUhSZ3RDeTBMalJqeURpaEpZZzBLSFENCnBDOHhNalF0TXprM01TRFF2dEdDSURFMUxqQXhMakl3TWpFTVQ5Q2gwTFhSZ05HQzBMalJoTkM0MExyUXNOR0MNCklOR0IwTDdRdnRHQzBMTFF0ZEdDMFlIUmd0Q3kwTGpSanlEaWhKWWcwS0hRcEM4eE1qZ3RNemczTUNEUXZ0R0MNCklESXpMakEzTGpJd01qQXdMQVlGS29VRFpHOEVJd3doMEtIUW10Q1gwSmdnSXRDYTBZRFF1TkMvMFlMUXZ0Q2YNCjBZRFF2aUJEVTFBaU1HQUdBMVVkSHdSWk1GY3dWYUJUb0ZHR1QyaDBkSEE2THk5MFpYTjBZMkV5TURFeUxtTnkNCmVYQjBiM0J5Ynk1eWRTOWpaSEF2TnpVNFpERmlaamN6TW1ReVpEQm1NalZtTVdVd1pqbGxNVE0zT1dWaVptTXkNCk1HWmxPV1V5Wmk1amNtd3dEQVlGS29VRFpISUVBd0lCQWpDQ0FaSUdBMVVkSXdTQ0FZa3dnZ0dGZ0JSMWpSdjMNCk10TFE4bDhlRDU0VGVldjhJUDZlTDZHQ0FWaWtnZ0ZVTUlJQlVERUxNQWtHQTFVRUJoTUNVbFV4RlRBVEJnVXENCmhRTmtCQklLTnpjeE56RXdOems1TVRFZ01CNEdDU3FHU0liM0RRRUpBUllSYVc1bWIwQmpjbmx3ZEc5d2NtOHUNCmNuVXhHREFXQmdVcWhRTmtBUklOTVRBek56Y3dNREE0TlRRME5ERVlNQllHQTFVRUNBd1BOemNnMEp6UXZ0R0INCjBMclFzdEN3TVJVd0V3WURWUVFIREF6UW5OQyswWUhRdXRDeTBMQXhMekF0QmdOVkJBa01KdEdEMExzdUlOQ2gNCjBZUFJpZEdSMExMUmdkQzYwTGpRdVNEUXN0Q3cwTHNnMExRdUlERTRNU1V3SXdZRFZRUUtEQnpRbnRDZTBKNGcNCkl0Q2EwS0RRbU5DZjBLTFFuaTNRbjlDZzBKNGlNV1V3WXdZRFZRUURERnpRb3RDMTBZSFJndEMrMExMUmk5QzUNCklOQ3owTDdRdTlDKzBMTFF2ZEMrMExrZzBLUFFwaURRbnRDZTBKNGdJdENhMEtEUW1OQ2YwS0xRbmkzUW45Q2cNCjBKNGlJTkNUMEo3UW9kQ2lJREl3TVRJZ0tOQ2owS1lnTWk0d0tZSVJBL2lZaFFCeHJlR01UWHRMUnNWL0ZVSXcNCkNnWUlLb1VEQndFQkF3SURRUUNON0Vrdnp2RmFmM3dkMUpkSUVZeUdWSzYwYS9IUGNuREFGcXoxdzNGVTR2N0gNCnRzRGNsa0diaENlKzFWNEJOMnFUcXNSZ2F1NzZxUldtbE9tcEdnNk9NWUlFQ1RDQ0JBVUNBUUV3Z2dGdE1JSUINClZqRVZNQk1HQlNxRkEyUUVFZ28zTnpFM01UQTNPVGt4TVNBd0hnWUpLb1pJaHZjTkFRa0JGaEZwYm1adlFHTnkNCmVYQjBiM0J5Ynk1eWRURVlNQllHQlNxRkEyUUJFZzB4TURNM056QXdNRGcxTkRRME1Rc3dDUVlEVlFRR0V3SlMNClZURVlNQllHQTFVRUNBd1BOemNnMEp6UXZ0R0IwTHJRc3RDd01SVXdFd1lEVlFRSERBelFuTkMrMFlIUXV0Q3kNCjBMQXhMekF0QmdOVkJBa01KdEdEMExzdUlOQ2gwWVBSaWRHUjBMTFJnZEM2MExqUXVTRFFzdEN3MExzZzBMUXUNCklERTRNU1V3SXdZRFZRUUtEQnpRbnRDZTBKNGdJdENhMEtEUW1OQ2YwS0xRbmkzUW45Q2cwSjRpTVdzd2FRWUQNClZRUURER0xRb3RDMTBZSFJndEMrMExMUmk5QzVJTkMvMEw3UXROR0gwTGpRdmRDMTBMM1F2ZEdMMExrZzBLUFENCnBpRFFudENlMEo0Z0l0Q2EwS0RRbU5DZjBLTFFuaTNRbjlDZzBKNGlJTkNUMEo3UW9kQ2lJREl3TVRJZ0tOQ2oNCjBLWWdNaTR3S1FJUkF6ZXpBQUZ4clpDblEvVE9QcXlqQzZrd0RBWUlLb1VEQndFQkFnSUZBS0NDQWpFd0dBWUoNCktvWklodmNOQVFrRE1Rc0dDU3FHU0liM0RRRUhBVEFjQmdrcWhraUc5dzBCQ1FVeER4Y05NakV3T1RFMk1UUTENCk1UTTRXakF2QmdrcWhraUc5dzBCQ1FReElnUWdhSHk4Mm5qcUtrUUlFTzRUZkc5TnVOQ240aERrZUI2dkc5L3ENCm1ldEhxM2d3Z2dIRUJnc3Foa2lHOXcwQkNSQUNMekdDQWJNd2dnR3ZNSUlCcXpDQ0FhY3dDZ1lJS29VREJ3RUINCkFnSUVJQnBoUnRBTStNWTd4WmJJZzFUMFVhVWV0K0pFNzByUVo1SWxEc1FyS2dZZU1JSUJkVENDQVY2a2dnRmENCk1JSUJWakVWTUJNR0JTcUZBMlFFRWdvM056RTNNVEEzT1RreE1TQXdIZ1lKS29aSWh2Y05BUWtCRmhGcGJtWnYNClFHTnllWEIwYjNCeWJ5NXlkVEVZTUJZR0JTcUZBMlFCRWcweE1ETTNOekF3TURnMU5EUTBNUXN3Q1FZRFZRUUcNCkV3SlNWVEVZTUJZR0ExVUVDQXdQTnpjZzBKelF2dEdCMExyUXN0Q3dNUlV3RXdZRFZRUUhEQXpRbk5DKzBZSFENCnV0Q3kwTEF4THpBdEJnTlZCQWtNSnRHRDBMc3VJTkNoMFlQUmlkR1IwTExSZ2RDNjBMalF1U0RRc3RDdzBMc2cNCjBMUXVJREU0TVNVd0l3WURWUVFLREJ6UW50Q2UwSjRnSXRDYTBLRFFtTkNmMEtMUW5pM1FuOUNnMEo0aU1Xc3cNCmFRWURWUVFEREdMUW90QzEwWUhSZ3RDKzBMTFJpOUM1SU5DLzBMN1F0TkdIMExqUXZkQzEwTDNRdmRHTDBMa2cNCjBLUFFwaURRbnRDZTBKNGdJdENhMEtEUW1OQ2YwS0xRbmkzUW45Q2cwSjRpSU5DVDBKN1FvZENpSURJd01USWcNCktOQ2owS1lnTWk0d0tRSVJBemV6QUFGeHJaQ25RL1RPUHF5akM2a3dDZ1lJS29VREJ3RUJBUUVFUUVreUJBa0UNCkx1cEgzWlZiWmJzRXNpZzVBa0FNcTZwSjJYY3E5TkExTndQNWVEM29CcFkrK3BYQ0dVOXJDWVZQU2RIUnBEdFcNCmt6ZEZwU1ZXVXFVc2gwTT08L93Wz8/u69Tg6es+CiAgICAgICAgICAgIDwv0eLl5M/u69Tg6es+CiAgICAgICAgICAgIDzS5erx8tPi5eTT8u73Ps3lIOLl8O3uIPPq4Ofg7SDv7vHy4OL56OogPC/S5erx8tPi5eTT8u73PgogICAgICAgIDwv0eLT4uXk0/Lu9z4KICAgICAgICA8zvLv8MTu6iDI5NP34PHy3cTOPSIyUFMtMzMyODA0MTc5OTEyMDAwMDAwMDAwMDAwOTUxNjg1MTIiPgogICAgICAgICAgICA8yM8gyM3N1Ms9IjMzMjgwNDE3OTkxMiI+CiAgICAgICAgICAgICAgICA81MjOINTg7Ojr6P89IsrTx83F1s7CIiDI7P89ItHF0MPFySIgzvL35fHy4u49IsLIytLO0M7CyNciLz4KICAgICAgICAgICAgPC/Izz4KICAgICAgICA8L87y7/DE7uo+CiAgICAgICAgPM/u5O/o8eDt8iDE7uvm7e7x8vw9IsTo8OXq8u7wIj4KICAgICAgICAgICAgPNTIziDU4Ozo6+j/PSLP4OLo7SIgyOz/PSLP4OLl6yIvPgogICAgICAgIDwvz+7k7+jx4O3yPgogICAgPC/E7urz7OXt8j4KPC/U4OnrPgo=",
    "uuid": "596c50af-d65a-4cb8-b404-fc27bf805215",
    "docTypeId": 6
  }
}

Таблица 2.29. Описание параметров ответа на запрос получения черновика УОУ

Параметр Формат значения Описание
contentBase64 String Содержимое документа в формате Base64. (Подписывать требуется данные после снятия base64)
uuid String Уникальный идентификатор черновика(заготовки). (UUID)
id String Идентификатор типа документа черновика(заготовки). (Number)

2.3.7. Отправить УОУ

Для того чтобы опубликовать подписанный черновик для УОУ, применяется запрос построенный на HTTP-методе POST и имеющий следующий вид:


POST https://lk.edo.ru/api/edo/{version}/provisional/rejected/sign

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Запрос:


POST https://lk.edo.ru/api/edo/v1/provisional/rejected/sign
Authorization: Token 8890ea5e-95f8-4d33-b4bc-7ace2339fc91

{
  "signatureBase64": "MIINAwYJKoZIhvcNAQcCoIIM9DCCDPACAQExDjAMBggqhQMHAQECAgUAMAsGCSqGSIb3DQEHAaCC\r\nCLUwggixMIIIXqADAgECAhECLlrqAFetOolOub1QHxragDAKBggqhQMHAQEDAjCCAVsxIDAeBgkq\r\nhkiG9w0BCQEWEWluZm9AY3J5cHRvcHJvLnJ1MRgwFgYFKoUDZAESDTEwMzc3MDAwODU0NDQxGjAY\r\nBggqhQMDgQMBARIMMDA3NzE3MTA3OTkxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB\r\n0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLR\r\ngdC60LjQuSDQstCw0Lsg0LQuIDE4MSUwIwYDVQQKDBzQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg\r\n0J4iMWswaQYDVQQDDGLQotC10YHRgtC+0LLRi9C5INC/0L7QtNGH0LjQvdC10L3QvdGL0Lkg0KPQ\r\npiDQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg0J4iINCT0J7QodCiIDIwMTIgKNCj0KYgMi4wKTAe\r\nFw0yMTA2MzAxNDAzMTVaFw0yMTA5MzAxNDEzMTVaMIIBTjEZMBcGCSqGSIb3DQEJARYKb2ZkQG9m\r\nZC5ydTEaMBgGCCqFAwOBAwEBEgwwMDk3MjEwODM0NzIxGDAWBgUqhQNkARINMTE5Nzc0NjQyNTA4\r\nNDEZMBcGA1UEDAwQ0JTQuNGA0LXQutGC0L7RgDEgMB4GA1UECwwX0J7QntCeICLQmtCe0J3QotCV\r\n0JrQkCIxIDAeBgNVBAoMF9Ce0J7QniAi0JrQntCd0KLQldCa0JAiMRUwEwYDVQQJDAzQnNC+0YHQ\r\nutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEVMBMGA1UECAwM0JzQvtGB0LrQstCwMQswCQYD\r\nVQQGEwJSVTETMBEGA1UEKgwK0J/QsNCy0LXQuzETMBEGA1UEBAwK0J/QsNCy0LjQvTEgMB4GA1UE\r\nAwwX0J7QntCeICLQmtCe0J3QotCV0JrQkCIwZjAfBggqhQMHAQEBATATBgcqhQMCAiQABggqhQMH\r\nAQECAgNDAARAfo0WcdHwnUuzWcpe6USbOXzxwft+TiYiPwfJnQIOPoJaBacq+87FryQYF5G80Loh\r\nP1E1Zjc6yrGYjsAoOrA6/qOCBP0wggT5MA4GA1UdDwEB/wQEAwIE8DAfBgkrBgEEAYI3FQcEEjAQ\r\nBggqhQMCAi4ACAIBAQIBADAdBgNVHQ4EFgQUUyY8VlozO4v234cZtY8plE6Z8QUwJgYDVR0lBB8w\r\nHQYIKwYBBQUHAwQGCCsGAQUFBwMCBgcqhQMCAiIGMDIGCSsGAQQBgjcVCgQlMCMwCgYIKwYBBQUH\r\nAwQwCgYIKwYBBQUHAwIwCQYHKoUDAgIiBjCBpwYIKwYBBQUHAQEEgZowgZcwOAYIKwYBBQUHMAGG\r\nLGh0dHA6Ly90ZXN0Y2EyMDEyLmNyeXB0b3Byby5ydS9vY3NwL29jc3Auc3JmMFsGCCsGAQUFBzAC\r\nhk9odHRwOi8vdGVzdGNhMjAxMi5jcnlwdG9wcm8ucnUvYWlhLzA2NGI2MzI1MzM2NjJhMjQzODE4\r\nNzI0MzdhM2JiN2NiYjJjYWZjNzMuY3J0MB0GA1UdIAQWMBQwCAYGKoUDZHECMAgGBiqFA2RxATAr\r\nBgNVHRAEJDAigA8yMDIxMDYzMDE0MDMxNVqBDzIwMjEwOTMwMTQwMzE1WjCCARoGBSqFA2RwBIIB\r\nDzCCAQsMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQu\r\nMCkMMdCf0JDQmiAi0JrRgNC40L/RgtC+0J/RgNC+INCj0KYiINCy0LXRgNGB0LjQuCAyLjAMT9Ch\r\n0LXRgNGC0LjRhNC40LrQsNGCINGB0L7QvtGC0LLQtdGC0YHRgtCy0LjRjyDihJYg0KHQpC8xMjQt\r\nMzM4MCDQvtGCIDExLjA1LjIwMTgMT9Ch0LXRgNGC0LjRhNC40LrQsNGCINGB0L7QvtGC0LLQtdGC\r\n0YHRgtCy0LjRjyDihJYg0KHQpC8xMjgtMzU5MiDQvtGCIDE3LjEwLjIwMTgwLAYFKoUDZG8EIwwh\r\n0KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiMGAGA1UdHwRZMFcwVaBToFGGT2h0dHA6\r\nLy90ZXN0Y2EyMDEyLmNyeXB0b3Byby5ydS9jZHAvMDY0YjYzMjUzMzY2MmEyNDM4MTg3MjQzN2Ez\r\nYmI3Y2JiMmNhZmM3My5jcmwwDAYFKoUDZHIEAwIBAjCCAZcGA1UdIwSCAY4wggGKgBQGS2MlM2Yq\r\nJDgYckN6O7fLssr8c6GCAV2kggFZMIIBVTEgMB4GCSqGSIb3DQEJARYRaW5mb0BjcnlwdG9wcm8u\r\ncnUxGDAWBgUqhQNkARINMTAzNzcwMDA4NTQ0NDEaMBgGCCqFAwOBAwEBEgwwMDc3MTcxMDc5OTEx\r\nCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC6\r\n0LLQsDEvMC0GA1UECQwm0YPQuy4g0KHRg9GJ0ZHQstGB0LrQuNC5INCy0LDQuyDQtC4gMTgxJTAj\r\nBgNVBAoMHNCe0J7QniAi0JrQoNCY0J/QotCeLdCf0KDQniIxZTBjBgNVBAMMXNCi0LXRgdGC0L7Q\r\nstGL0Lkg0LPQvtC70L7QstC90L7QuSDQo9CmINCe0J7QniAi0JrQoNCY0J/QotCeLdCf0KDQniIg\r\n0JPQntCh0KIgMjAxMiAo0KPQpiAyLjApghECbc+0AK2rS4hGDZj53PwvLjAKBggqhQMHAQEDAgNB\r\nAFXgvsviPPKjAyTAiajg5hdHTgmydqONcit7YuvRi/uAUH6yYn0eSOEXhrGgLudLyGh+gWTz56Ze\r\np4CqiMGX+NkxggQTMIIEDwIBATCCAXIwggFbMSAwHgYJKoZIhvcNAQkBFhFpbmZvQGNyeXB0b3By\r\nby5ydTEYMBYGBSqFA2QBEg0xMDM3NzAwMDg1NDQ0MRowGAYIKoUDA4EDAQESDDAwNzcxNzEwNzk5\r\nMTELMAkGA1UEBhMCUlUxGDAWBgNVBAgMDzc3INCc0L7RgdC60LLQsDEVMBMGA1UEBwwM0JzQvtGB\r\n0LrQstCwMS8wLQYDVQQJDCbRg9C7LiDQodGD0YnRkdCy0YHQutC40Lkg0LLQsNC7INC0LiAxODEl\r\nMCMGA1UECgwc0J7QntCeICLQmtCg0JjQn9Ci0J4t0J/QoNCeIjFrMGkGA1UEAwxi0KLQtdGB0YLQ\r\nvtCy0YvQuSDQv9C+0LTRh9C40L3QtdC90L3Ri9C5INCj0KYg0J7QntCeICLQmtCg0JjQn9Ci0J4t\r\n0J/QoNCeIiDQk9Ce0KHQoiAyMDEyICjQo9CmIDIuMCkCEQIuWuoAV606iU65vVAfGtqAMAwGCCqF\r\nAwcBAQICBQCgggI2MBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIx\r\nMDkxNjE0NTIzOFowLwYJKoZIhvcNAQkEMSIEIKk9XLYR2q/oBeMKEA39mkcty/NW264+e84dkc5s\r\nFHazMIIByQYLKoZIhvcNAQkQAi8xggG4MIIBtDCCAbAwggGsMAoGCCqFAwcBAQICBCAxlEFcvdQd\r\nVhG7mX00qpHWj6fVmVGcNUF0bHeZK5ZfIzCCAXowggFjpIIBXzCCAVsxIDAeBgkqhkiG9w0BCQEW\r\nEWluZm9AY3J5cHRvcHJvLnJ1MRgwFgYFKoUDZAESDTEwMzc3MDAwODU0NDQxGjAYBggqhQMDgQMB\r\nARIMMDA3NzE3MTA3OTkxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUw\r\nEwYDVQQHDAzQnNC+0YHQutCy0LAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLRgdC60LjQuSDQ\r\nstCw0Lsg0LQuIDE4MSUwIwYDVQQKDBzQntCe0J4gItCa0KDQmNCf0KLQni3Qn9Cg0J4iMWswaQYD\r\nVQQDDGLQotC10YHRgtC+0LLRi9C5INC/0L7QtNGH0LjQvdC10L3QvdGL0Lkg0KPQpiDQntCe0J4g\r\nItCa0KDQmNCf0KLQni3Qn9Cg0J4iINCT0J7QodCiIDIwMTIgKNCj0KYgMi4wKQIRAi5a6gBXrTqJ\r\nTrm9UB8a2oAwCgYIKoUDBwEBAQEEQLNY+mv9acw5Ar4zTnr63ITO0AoX9SAMcRj8haWwytFEStLN\r\ne9t72a4lA5Nww7ptXZ+efhNcAds18887+hGDBKQ=",
  "uuid": "596c50af-d65a-4cb8-b404-fc27bf805215"
}

Описание параметров запроса опубликование подписанного черновика для УОУ, приведены в таблице 2.30.

Таблица 2.30. Параметры запроса опубликование подписанного черновика для УОУ

Параметр Формат значения Описание Обязательно в запросе
uuid String Идентификатор черновика(заготовки) документа. (UUID) да
signatureBase64 String Открепленная подпись содержимого документа. (Строка в формате Base64) да


Приведен пример ответа на запрос:

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "docId": 1266172,
    "docUuid": null
  }
}

Таблица 2.31. Описание параметров ответа на запрос опубликования подписанного черновика для УОУ

Параметр Формат значения Описание
docId Integer Идентификатор подписанного документа. (Number)
docUuid String Идентификатор подписанного документа. (UUID)

2.4. Работа с контрагентами

Перед началом работы с контрагентами, проверьте возможность обмена документами с организациями. Для этого используйте метод "Поиск контрагентов". Если ваш контрагент зарегистрирован в ЭДО.Поток, то вы можете сразу обмениваться с ним электронными документами. Если организация еще не пользуется сервисом ЭДО.Поток, вы можете отправить ей приглашение на почту, методом "Отправка контрагенту на почту ссылку с приглашением в ЭДО.Поток". Если контрагент пользуется другим оператором ЭДО — вам понадобится разово настроить роуминг с ним.

Роуминг можно настроить несколькими способами:

  1. Ручная настройка.

Для настройки роуминга с использованием приглашений необходимо:

  1. Отправить приглашение в роуминг своему контрагенту методом "Отправка приглашения контрагенту".
  2. Контрагент получит приглашение на настройку роуминга в системе своего оператора ЭДО.
  3. Контрагент или соглашается на настройку роуминга и отправляет ответное приглашение, или отклоняет запрос на настройку.
  4. Обновленный статус роуминга отслеживайте методом "Получение списка роуминговых контрагентов и их статуса".
  5. Для получения списка контрагентов используйте метод "Получение списка контрагентов с заданным статусом".

2.4.1. Поиск контрагентов

Метод позволяет искать контрагентов, с которыми можно сразу начать обмен документами: контрагент или зарегистрирован и работает в ЭДО.Поток или с контрагентом успешно настроен роуминг через стороннего оператора ЭДО.

Поиск контрагентов в ИС «ЭДО.Поток» осуществляется HTTP-метода GET и имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/contractors/search-contractors?query={inf01}

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

GET https://lk.edo.ru/api/edo/v1/contractors/search-contractors?query=7841465198
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Описание параметров запроса на поиск контрагента приведены в таблице 2.32.

Таблица 2.32. Описание параметров запроса на поиск контрагента

Параметр Заменяемая строка Описание
{version} Версия системы, текущая версия равна v1. В дальнейшем версия может измениться
query {inf01} ИНН клиента, КПП клиента или последовательность символов, искомая в полном названии контрагента 3)

Успешный ответ на запрос имеет следующий вид:

{
  "status": {
    "code": 0,
    "message": "OK"
  },
  "result": {
    "data": [
      {
        "clientId": "2PS-00278567668300483440610014472643",
        "fullName": "ООО \"Рога и копыта\"",
        "phone": "79103333412",
        "email": "RogaIKopyta@rk.ru",
        "mailAddress": null,
        "fullLegalAddress": "Брянск г Брянской Пролетарской Дивизии ул. 9",
        "kpp": "048344061",
        "inn": "2785676683",
        "ogrn": "5097571958996",
        "ifns": null,
        "certificate": null,
        "stateName": null,
        "legalAddress": {
          "postalCode": null,
          "region": null,
          "area": null,
          "city": null,
          "settlement": null,
          "street": null,
          "houseNumber": null,
          "building": null,
          "office": null,
        }
      },
      "status": "NEW",
      "operatorMnemo": "ТЕНЗОР"
    ],
    "pageInfo": {
      "pageIndex": 1,
      "pageRecords": 1,
      "pageCount": 239,
      "sortKey": NULL,
      "sortDirection": "desc"
    }
  }
}

Описание параметров ответа на запрос на поиск контрагента приведены в таблице 2.33.

Таблица 2.33. Описание параметров ответа на запрос поиска контрагента

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Информацию по клиенту
data Структура Записи о контрагентах. Параметры элементов структуры data приведены в таблице 2.20
pageInfo Структура Информация о делении списка на страницы и о передаваемой странице списка
pageIndex Integer Номер передаваемой страницы
pageRecords Integer Количество строк списка на странице
pageCount Integer Количество страниц в списке
sortKey String Имя поля ключа сортировки
sortDirection String Направление сортировки (см. п. 2.2.1., таблица 2.3)


Таблица 2.34. Описание параметров структуры «data»

Параметр Вложенные поля Формат значения Описание
clientId String Идентификатор клиента в ИС «ЭДО.Поток»
fullName String Полное название клиента
phone String Телефонный номер клиента
email String Адрес электронной почты клиента
mailAddress String Фактический почтовый адрес клиента одной строкой
fullLegalAddress String Юридический адрес клиента одной строкой
kpp String КПП клиента
inn String ИНН клиента
ogrn String ОГРН клиента
ifns String Идентификационный номер ФНС, за которой закреплен клиент
certificate String Открытая часть сертификата электронной подписи клиента
stateName String Название государства, к которому относится клиент
legalAddress Структура Информация о юридическом адресе клиента
postalCode String Почтовый индекс
region String Область
area String Район области (если используется)
city String Город
settlement String Населенный пункт
street String Улица
houseNumber String Номер дома
building String Номер корпуса или здания
office String Номер офиса
status String Состояние контрагента
operatorMnemo String Оператор ЭДО контрагента

2.4.2. Получение списка контрагентов с заданным статусом

Для получения списка контрагентов с фильтрацией по статусу применяется запрос, построенный на HTTP-методе GET и имеющий следующий вид:

GET https://lk.edo.ru/api/edo/{version}/contractors?status={status1}

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

GET https://lk.edo.ru/api/edo/v1/contractors?status=ARE_CONTRACTORS
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Описание параметров запроса на поиск контрагента с заданным статусом приведены в таблице 2.35.

Таблица 2.35. Параметры запроса на поиск контрагента с заданным статусом

Параметр Заменяемая строка Описание
{version} Версия системы, текущая версия равна v1. В дальнейшем версия может измениться
status {status1} Состояние (статус) контрагента. Возможные значения:
REQUEST_SENT — Отправлена заявка на роуминг ,
REQUEST_RECEIVED — заявка на роуминг получена,
CONFIRMED — роуминг настроен,
NEW — заявка на роуминг сформирована,
BLOCKED — роуминг отключен,
ERROR — Ошибка настройки роуминга

Пример успешного ответа на запрос приведен в разделе. 2.4.1. Структура ответа описана в таблицах 2.33. и 2.34.

2.4.3. Получение списка роуминговых контрагентов и их статуса

Для получения списка роуминговых контрагентов и статусом работы с ними применяется запрос, построенный на HTTP-методе GET и имеющий следующий вид:

GET https://lk.edo.ru/api/edo/{version}/contractors/invitations

Заменяемый параметр {version} — обозначение текущей версии системы, по умолчанию равен v1. Пример запроса:

GET https://lk.edo.ru/api/edo/v1/contractors/invitations
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef


Приведен пример ответа на запрос:

{
    "status": {
        "code": 0,
        "message": "OK"
    },
    "result": {
        "data": [
            {
                "clientId": "2AL-264906832440",
                "fullName": "ЗАО \"Тест\"",
                "operatorName": "ТАКСКОМ",
                "kpp": null,
                "inn": "264906832440",
                "modifyTime": "17.06.2021 03:00:00",
                "statusType": "RC_INVITE_CONTRACTORS",
                "actions":
                [
                    "0": "ACCEPT"
                ]
            },
            {
                "clientId": "2BE-6678069434",
                "fullName": "ООО \"АВТОБЛЕСК\"",
                "operatorName": "ТЕНЗОР",
                "kpp": "667801001",
                "inn": "6678069434",
                "modifyTime": "10.06.2021 03:00:00",
                "statusType": "NEW_CONTRACTORS",
                "actions": []
            },
            {
                "clientId": "2AL1699100125",
                "fullName": "1699100125",
                "operatorName": "ТАКСКОМ",
                "kpp": "169910012",
                "inn": "1699100125",
                "modifyTime": "30.04.2021 03:00:00",
                "statusType": "RC_ERROR",
                "invitationErrorDescription":
                {
                    "errorDescription": "ИНН получателя в приглашении отличается от ИНН в online.sbis.ru",
                    "messageId": "587bf47d3c214f2588582375882c10ea",
                    "packageId": "a4b4db43fd9848d58e3b392a3b0f597e"
                },
                "actions": []

            }
        ],
        "pageInfo": {
            "pageIndex": 1,
            "pageRecords": 1000,
            "pageCount": 1,
            "sortKey": null,
            "sortDirection": "desc"
        }
    }
}

Таблица 2.36. Описание параметров ответа на запрос роуминговых контрагентов и их статуса

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Информацию по клиенту
data Структура Записи о контрагентах. Параметры элементов структуры data приведены в таблице 2.37
pageInfo Структура Информация о делении списка на страницы и о передаваемой странице списка
pageIndex Integer Номер передаваемой страницы
pageRecords Integer Количество строк списка на странице
pageCount Integer Количество страниц в списке
sortKey String Имя поля ключа сортировки
sortDirection String Направление сортировки (см. п. 2.2.1., таблица 2.3.)

Таблица 2.37. Описание параметров структуры «data»

Параметр Вложенные поля Формат значения Описание
clientId String Идентификатор клиента в ИС «ЭДО.Поток»
fullName String Полное название клиента
phone String Телефонный номер клиента
operatorName String Названия оператора ЭДО
kpp String КПП клиента
inn String ИНН клиента
modifyTime String Дата и время заключения договора с контрагентом, формат ISO
statusType String Статус роуминга:
NEW_CONTRACTORS — «Отправляет заявку», приглашение в процессе отправки,
ARE_CONTRACTORS — «Роуминг настроен»,
ARE_BLOCKED_CONTRACTORS — «Отклонено», роуминг отключен или пришел отказ от контрагента,
RC_INVITE_CONTRACTORS — «Приглашают вас», пришло приглашение на настройку роуминга
RC_REQUEST_CONTRACTORS — «Ожидается ответ», вы отправили приглашение в роуминг, ожидается ответ от контрагента,
RC_ERROR — «Ошибка», настройки роуминга, описание ошибки в errorDescription,
NO_CONNECTION — Нет соединения,
RC_WAITING_FINISH — «В обработке», ожидание окончания настройки роуминга.
invitationErrorDescription Структура Данные об ошибке
errorDescription String Описание ошибки, текст сформирован сторонним оператором ЭДО
messageId String Технический идентификатор ЛС
packageId String Технический идентификатор ТП
actions String мм

2.4.4. Настройка роуминга с контрагентом через ЭДО Лайт

Для настройки роуминга с контрагентом через ЭДО Лайт применяется запрос, построенный на HTTP-методе POST и имеющий следующий вид:

POST https://lk.edo.ru/api/edo/{version}/contractors/add-rc-contractor/edo-lite


Заменяемый параметр {version} — обозначение текущей версии системы, по умолчанию равен v1.

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

POST https://lk.edo.ru/api/edo/v1/contractors/add-rc-contractor/edo-lite
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json
{
  "fullName": "_ТЕСТ_9614000538",
  "inn":"9614000538",
  "kpp":""
}


Описание параметров запроса настройка роуминга с контрагентом приведены в таблице 2.38.

Таблица 2.38. Описание параметров запроса настройки роуминга с контрагентом

Параметр Формат значения Описание Обязательно в запросе
fullName String название контрагента нет
inn String ИНН контрагента да
kpp String КПП контрагента нет


Приведен пример успешного ответа на запрос:

{
    "status: {
        code: 0,
	    message: "OK"
    },
    "result: "5c9354ef-1dfe-4d7e-b044-706138c8de71"
}

Таблица 2.39. Описание параметров ответа на запрос настройки роуминга с контрагентом

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result String Информация по настройке роуминга с контрагентом

Таблица 2.40. Описания кодов ответа на запрос

Код ответа на запрос Сообщение Описание кода
400 Bad Request неправильный, некорректный запрос
50001 Clients already contractors С клиентом уже настроен роуминг
50002 Contractor not found in EDO LITE Клиент не найден в системе EDO Lite

2.4.5. Отправка приглашения контрагенту

Для отправки приглашения контрагенту применяется запрос, построенный на HTTP-методе POST и имеющий следующий вид:

POST https://lk.edo.ru/api/edo/{version}/contractors/add-rc-contractor


Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

POST https://lk.edo.ru/api/edo/v1/contractors/add-rc-contractor
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json
{
  "clientId":"2AL-264906832440",
  "fullName":"ЗАО \"Тест\"",
  "inn":"264906832440",
  "kpp": ""
}


Описание параметров запроса отправка приглашения контрагенту приведены в таблице 2.41.
Таблица 2.41. Описание параметров запроса списка контрагентов выбранного клиента

Параметр Формат значения Описание Обязательно в запросе
clientId String Идентификатор участника ЭДО, в сторонней системе документооборота да
fullName String название организации нет
inn String ИНН контрагента да
kpp String КПП контрагента нет


Приведен пример ответа на запрос:

{
    "status": {
        "code": 0,
        "message": "OK"
    },
    "result": "OK"
}

Таблица 2.42. Описание параметров ответа на запрос списка контрагентов, выбранного клиентам

Параметр Вложенные поля Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result String Статус отправленного приглашения

2.4.6. Отправка контрагенту на почту ссылку с приглашением в ЭДО.Поток

Для отправки приглашения контрагенту на почту ссылку с приглашением в ЭДО.Поток применяется запрос, построенный на HTTP-методе POST и имеющий следующий вид:

POST https://lk.edo.ru/api/edo/{version}/contractors/invite-contractor 


Заменяемый параметр {version} — обозначение текущей версии системы, по умолчанию равен v1.

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

POST https://lk.edo.ru/api/edo/v1/contractors/invite-contractor
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json
{
    email: "ofd@ofd.ru"
}


Описание параметров запроса отправки контрагенту на почту ссылки с приглашением в ЭДО.Поток, приведены в таблице 2.43.

Таблица 2.43. Описание параметров запроса отправки контрагенту на почту ссылки с приглашением в ЭДО.Поток

Параметр Формат значения Описание Обязательно в запросе
email String Адрес электронной почты контрагента да


Приведен пример ответа на запрос:

{
    "status": {
        "code": 0,
        "message": "OK"
    },
    "result": "b7995598-cb5c-43b2-b047-bec4d9ceeb48"
}

Таблица 2.44. Описание параметров ответа на запрос отправки контрагенту на почту ссылки с приглашением в ЭДО.Поток

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result String Информация по отправки контрагенту на почту ссылки с приглашением в ЭДО.Поток

3. Маркировка

3.1. Авторизация для работы с маркировкой

Для работы с системой маркировки: отправки заказа на эмиссию кодов маркировки, документа ввода в оборот или для обновления статуса обработки этих документов в системе маркировки необходима авторизация со стороны клиента.

  • Ключ сессии, полученный при авторизации действует в течение 10 часов.

Для авторизации потребуется:

  1. Методом "Запросить авторизацию при единой аутентификации" получить данные для авторизации. В запросе указать тип авторизации: emission — для работы со Станцией управления заказами (СУЗ), например для заказа новых кодов маркировки; introduction — для работы с «Честным ЗНАКом» (TrueApi) по остальным процессам маркировки, например, для ввода в оборот.
  2. Сформировать прикрепленную подпись для данных, полученных на предыдущем методе.
  3. Передать подписанные данные с помощью метода "Получить ключ сессии при единой аутентификации".
  4. Текущий статус авторизации можно получить с помощью метода "Получить состояние авторизации".

3.1.1 Запрос авторизации при единой аутентификации

Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/{authType}/auth/data-for-sign

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {authType} — тип авторизации: emission — для работы со станцией управления заказами (СУЗ), например для заказа новых кодов маркировки; introduction — для работы с «Честным ЗНАКом» (TrueApi) по остальным процессам маркировки, например, для ввода в оборот.

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

GET https://lk.edo.ru/api/edo/v1/emission/auth/data-for-sign
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример ответа на запрос:

{
  "contentsToSign": [
    {
      "contents": [
        {
          "content": "YmEtYTU1ZC1kNjIzMGM2NGIzMzIiCn0K",
          "id": "df08122e-30b5-11eb-adc1-02411c120123"
        }
      ],
      "providerId": "4f770978-abae-49dd-a2c7-9329b61556e9"
    }
  ]
}

Таблица 3.1. Описание параметров ответа на запрос

Параметр Формат значения Описание
Структура Содержащая контейнеры для подписания
content String Строка на подпись пользователю
id String Уникальный идентификатор запроса на аутентификацию
providerId String Идентификатор провайдера авторизации

3.1.2 Получение ключа сессии при единой аутентификации

Чтобы получить ключ сессии при единой аутентификации, используется метод POST следующего вида:

POST https://lk.edo.ru/api/edo/{version}/{authType}/auth/sign

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {authType} — тип авторизации: emission — для работы со станцией управления заказами (СУЗ), например для заказа новых кодов маркировки; introduction — для работы с «Честным ЗНАКом» (TrueApi) по остальным процессам маркировки, например, для ввода в оборот.

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

POST https://lk.edo.ru/api/edo/v1/emission/auth/sign
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "signedContents": [
    {
      "contents": [
        {
          "content": "YmEtYTU1ZC1kNjIzMGM2NGIzMzIiCn0K....",
          "id": "df08122e-30b5-11eb-adc1-02411c120123"
        }
      ],
      "providerId": "4f770978-abae-49dd-a2c7-9329b61556e9"
    }
  ]
}

Таблица 3.2. Описание параметров структуры ответа

Параметр Формат значения Описание
Структура Содержащая контейнеры для подписания
content String Сформированная прикрепленную подпись для контента, полученного ранее: параметр «content» из ответа за запрос метода «Запрос авторизации при единой аутентификации»
id String Уникальный идентификатор запроса на аутентификацию, полученный в методе «Запрос авторизации при единой аутентификации»
providerId String Идентификатор провайдера авторизации, полученный в методе «Запрос авторизации при единой аутентификации»

Пример ответа на запрос:


{
  "actualStates": [
    {
      "inn": "5250030906",
      "profiles": [
        {
          "providerId": "4f770978-abae-49dd-a2c7-9329b61556e9",
          "tokenTtl": "2018-01-01T12:13:14Z"
        }
      ]
    }
  ]
}

Таблица 3.3. Описание параметров структуры ответа на запрос

Параметр Формат значения Описание
inn String ИНН клиента
legalAddress Массив данных Профили авторизации
providerId String Идентификатор провайдера авторизации
tokenTtl String Время инвалидации токена (UTC).

3.1.3 Получение состояния авторизации

Чтобы получить состояние авторизации, используется метод GET следующего вида:

GET https://lk.edo.ru/api/edo/{version}/{authType}/auth/state

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {authType} — тип авторизации: emission — для работы со станцией управления заказами (СУЗ), например для заказа новых кодов маркировки; introduction — для работы с «Честным ЗНАКом» (TrueApi) по остальным процессам маркировки, например, для ввода в оборот.

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

GET https://lk.edo.ru/api/edo/v1/emission/auth/state
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример ответа на запрос:

{
  "actualStates": [
    {
      "inn": "5250030906",
      "profiles": [
        {
          "providerId": "4f770978-abae-49dd-a2c7-9329b61556e9",
          "tokenTtl": "2018-01-01T12:13:14Z"
        }
      ]
    }
  ]
}

Таблица 3.4. Описание параметров структуры ответа на запрос состояния авторизации

Параметр Формат значения Описание
inn String ИНН пользователя
legalAddress Массив данных Профили авторизации
providerId String Идентификатор провайдера авторизации. Параметр будет отсутствовать, если токена авторизации нет или закончился срок его действия
tokenTtl String Время инвалидации токена (UTC). Параметр будет отсутствовать, если токена авторизации нет или закончился срок его действия

3.2. Заказ кодов маркировки

Прежде чем создать и отправить первый заказ в «Честный ЗНАК», настройте работу с заказами. Для этого вам понадобится указать параметр OMS ID — уникальный идентификатор клиента в Станции управления заказами (СУЗ) и получить OmsConnection — уникальный идентификатор соединения.

Шаги по первичной настройке работы с заказами:

  1. Узнать ваш OMS ID — уникальный идентификатор клиента в Станции управления заказами (СУЗ) (Как найти этот параметр?).
  2. Методом "3.2.9 Сохранение OMS ID " сохранить OMS ID;
  3. Методом "3.2.10 Получить данные для подписи в рамках получения omsConnection" получить сроку для подписания в параметре ответа «contentForSignBase64».
  4. Подписать полученную на предыдущем шаге строку. Для подписания требуется взять данные из параметра «contentForSignBase64» запроса "3.2.10 Получить данные для подписи в рамках получения omsConnection", перевести эти данные из формата base64 в бинарные данные и поместить в файл для подписания, после чего сформировать открепленную однострочную (без знаков переноса) подпись.
  5. Методом "3.2.11 Отправка подписанных данных в рамках получения omsConnection" передать бинарный контент подписи (в Base64) и строку для подписания, для которой сформирована подпись.

Текущие параметры OMS ID и OmsConnection можно получить с помощью метода "Получение параметров OMS ID и OmsConnection".

Порядок действий при заказе кодов маркировки:

  1. Проверьте, что вы авторизованы в системе маркировки с помощью метода "Получить состояние авторизации", указав в запросе в параметре authType значение emission. В ответе вы получите Время инвалидации токена (параметр tokenTtl). Если время больше текущего, значит вы авторизованы в системе. Если в ответе параметр отсутствует или время меньше текущего, то требуется авторизоваться для работы с маркировкой. Как это сделать читайте в разделе "3.1. Авторизация для работы с маркировкой". При авторизации в запросах в параметре authType указывайте значение emission.
  2. Методом "3.2.1 Создание заказа на коды маркировки" создать заказ на коды маркировки.
  3. Методом "3.2.2 Получить контенты заказа для подписания" получить один или несколько бинарных контентов заказа (Base64) и идентификаторов контента.
  4. Подписать полученные контенты. Для подписания контента требуется взять данные из параметра «content» запроса "3.2.2 Получить контенты заказа для подписания", перевести эти данные из формата base64 в бинарные данные и поместить в файл для подписания, после чего сформировать открепленную однострочную (без знаков переноса) подпись.
  5. Методом "3.2.3 Отправка подписанных контентов заказа" передать бинарный контент подписи (в Base64) и идентификатор контента, для которого сформирована подпись.
  6. Проверять статус заказа с помощью метода "3.2.4 Получить статус заказа", пока статус не изменится на success или partialFailure.
  7. Получить коды методом "3.2.6 Получение кодов маркировки".

Так же существуют методы:

  1. "3.2.5 Список заказов и их статусы" — на получение списка заказов;
  2. "3.2.8 Получение информации об общих параметрах заказа" — на получение полной информации по конкретному заказу.



3.2.1 Создание заказа на коды маркировки

Для создания заказа используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/marking-codes/orders/create

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Описание параметров запроса на создание заказа приведены в таблице 3.5.

Таблица 3.5. Описание параметров запроса на создание заказа

Параметр Вложенные поля Формат значения Описание Обязательно в запросе
orderName String Наименование заказа Да
number String Номер заказа (должен быть уникальным) Да
comment String Комментарий к заказу Нет
positions Структура Список товаров Да
gtin String (14) [0-9] {14} Код товара (GTIN) Да
name String Наименование товара Да
quantity Integer ($int32) Количество КМ Да
serialNumberType String Способ генерации серийных номеров:
SELF_MADE — самостоятельно;
OPERATOR — оператором ГИС МТ.
Да
serialNumbers JSON Array of String Массив серийных номеров. Это
поле указывается в случае, если
значение «serialNumber = SELF_MADE»
Нет
Условно
обязательное
templateId Integer ($int32) Идентификатор шаблона товарной группы:
1 — обувные товары;
10 — предметы одежды, белье постельное, столовое, туалетное и кухонное;
7 — шины и покрышки пневматические резиновые новые;
8 — фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки;
9 — Духи и туалетная вода;
11 — велосипеды и велосипедные рамы;
12 — кресла коляски.
Да
cisType String Тип кода маркировки:
UNIT — единица товара;
BUNDLE — комплект;
SET — набор;
GROUP — групповая потребительская упаковка.
Используется только для ТГ «Одежда», «Фото» и «Духи», обязательно для данной ТГ.
Нет
Условно
обязательное
exporterTaxpayerId String ИНН/УНБ (или аналог) экспортера.
Используется только для ТГ «Одежда», «Фото», «Шины», «Духи» и «Обувь».
Становится обязательным для этих ТГ, только если в поле releaseMethod
(способ выпуска товара в оборот) было выбрано
значение «CROSSBORDER» (Ввезен в РФ из стран ЕАЭС)
Нет
Условно
обязательное
productGroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары;
perfumery — Духи и туалетная вода;
tires — Шины и покрышки пневматические резиновые новые;
electronics — Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки;
bicycle –Велосипеды и велосипедные рамы;
wheelchairs — Кресла коляски.
Да
clientToken String Да
omsId String Да
createMethodType String Способ изготовления:
SELF_MADE — Самостоятельно;
CEM — ЦЭМ;
CM — Контрактное производство;
CL — Логистический склад;
CA — Комиссионная площадка.
Используется только для ТГ «Одежда», «Фото», «Кресла-коляски», «Велосипеды», «Шины», «Духи» и «Обувь», обязательно для данных ТГ.
Нет
Условно
обязательное
releaseMethodType String Способ выпуска товаров:
PRODUCTION — производство РФ;
IMPORT — ввезен в РФ (импорт);
REMAINS — маркировка остатков (доступно только для ТГ «Духи и туалетная вода»);
COMMISSION — Принят на комиссию от физического лица (доступно для ТГ «Одежда», «Обувь»).
Используется только для ТГ «Одежда» и «Обувь», обязательно для данных ТГ.
Нет
Условно
обязательное
contactPerson String Контактное лицо.
Используется только для ТГ «Одежда», «Велосипеды», «Кресла-коляски», «Шины», «Фото», «Духи» и «Обувь».
Нет
productionOrderId String Идентификатор производственного заказа.
Используется только для ТГ «Одежда», «Велосипеды», «Кресла-коляски», «Фото», «Шины», «Духи» и «Обувь».
Нет
serviceProviderId String (36) UUID Идентификатор сервис-провайдера.
Используется только при наличии сервис-провайдера
в ЛК Честного знака.
Нет

Пример содержимого заказа кодов по товарной группе «Предметы одежды, белье постельное, столовое, туалетное и кухонное»

POST https://lk.edo.ru/api/edo/v1/marking-codes/orders/create
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "orderName": "Заказ Краснодар №41",
  "number": "NUMBER_1",
  "comment": "Comment",
  "positions": [
    {
      "gtin": "04636332455049",
      "name": "ПАЛЬТО ЗИМНЕЕ ЛЁГКОЕ КОРИЧНЕВОЕ .ВОРОТНИК-ПЕСЕЦ",
      "quantity": 125,
      "serialNumberType": "OPERATOR",
      "templateId": 10,
      "cisType": "BUNDLE"
    },
    {
      "gtin": "04636332455041",
      "name": "Наволочки белые 40х30х60 артикул 8786347879",
      "quantity": 125,
      "serialNumberType": "OPERATOR",
      "templateId": 10,
      "cisType": "UNIT
    }
  ],
  "productGroup": "lp",
  "clientToken": "d1d15b74-e56a-45d9-aaa9-9ad25f5108e8",
  "omsId": "79871fbf-c16d-4213-868a-462f5fcacc19",
  "createMethodType": "SELF_MADE",
  "releaseMethodType": "PRODUCTION",
  "contactPerson": "Иванов П.А."
}

Пример содержимого заказа кодов по товарной группе «Обувные товары»

{
  "orderName": "Заказ Уфа №41 от 01.02.2021",
  "number": "NUMBER_DRAFT_2",
  "comment": "Comment",
  "positions": [
    {
      "gtin": "04636332455067",
      "name": "Галоши резиновые мужские, 56 размер",
      "quantity": 100,
      "serialNumberType": "OPERATOR",
      "templateId": 1
    }
  ],
  "productGroup": "SHOES",
  "clientToken": "d1d15b74-e56a-45d9-aaa9-9ad25f5108e8",
  "omsId": "79871fbf-c16d-4213-868a-462f5fcacc19",
  "createMethodType": "SELF_MADE",
  "releaseMethodType": "IMPORT"
}

В случае успешной отправки возвращается идентификатор заказа (draftId). Пример успешного ответа на запрос:

  "df08122e-30b5-11eb-adc1-0242ac120016"


Пример неуспешного ответа с кодом ошибки 40032:

{
  "status": {
    "code": 40032,
    "message": "Request contains duplicate gtins: [aaaaaa, bbbb]"
    },
  "result": null
}

В запросе создание заказа на коды маркировки присутствуют элементы совпадающие с GTIN.

3.2.2 Получить контенты заказа для подписания

Для получения контентов заказа для подписания используется запрос на основе метода GET. Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/marking-codes/orders/{draftId}/contents

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {draftId} — идентификатор заказа, полученный на предыдущем шаге (содержится в успешном ответе на запрос POST /marking-codes/orders/create).

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

GET https://lk.edo.ru/api/edo/v1/marking-codes/orders/df08122e-30b5-11eb-adc1-0242ac120016/contents
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос:

[
  {
    "content": "ewogICAgInByb2R1Y3...",
    "id": "6f9619ff-8b86-d011-b42d-00cf4fc964f2"
  },
  {
    "content": "CAgICAgICAgImAgImA...",
    "id": "6cbf8302-25f6-4139-834e-b857143cbd8f"
  }
]

Описание параметров ответа приведены в таблице 3.6.

Таблица 3.6. Описание параметров структуры ответа на запрос

Параметр Формат значения Описание
Структура Содержащая контейнеры для подписания
content String Контент документа в формате base64
id String Идентификатор контента документа

После получения контентов для подписания, нужно подписать их. Для этого требуется перевести данные из формата base64 в бинарные данные и поместить в файл для подписания, после чего создать открепленную однострочную (без знаков переноса) подпись и отправляем ее, используя метод "2.1.3 Отправка подписанных контентов заказа".

3.2.3 Отправка подписанных контентов заказа

Метод позволяет отправить заказ на обработку в «Честный ЗНАК». Используется после получения контентов из метода "3.1.2 Получить контенты заказа для подписания" и их подписания. Для подписания контента требуется перевести данные параметра «content» из формата base64 в бинарные данные и поместить в файл для подписания, после чего создать открепленную однострочную (без знаков переноса) подпись и отправить ее в параметре «content» запроса "3.1.3 Отправка подписанных контентов заказа".

Для отправки подписанных контентов заказа используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/marking-codes/orders/{draftId}/contents/sign

Заменяемые параметры:

Описание параметров запроса на отправку заказа в «Честный ЗНАК» представлены в таблице 3.7.


Таблица 3.7. Описание параметров структуры запроса

Параметр Формат значения Описание
Структура Содержащая подписанные контейнеры
content String Подписанный контент заказа
id String Идентификатор контента заказа

Пример содержимого метода отправки заказа:

POST https://lk.edo.ru/api/edo/v1/marking-codes/orders/df08122e-30b5-11eb-adc1-0242ac120016/contents/sign
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json
{
  "contents": [
    {
      "content": "MIIMuAYJKoInByb2R1Y3RzIjogWwogICA...",
      "id": "6f9619ff-8b86-d011-b42d-00cf4fc964f2"
    },
    {
      "content": "MIIMuAYJKoZIhvcNAQcCoIIMqTCCDKUCA...",
      "id": "6cbf8302-25f6-4139-834e-b857143cbd8f"
    }
  ]
}

В случае успешной отправки возвращается Response Messages: 200 ОК.

Пример неуспешного ответа с кодом ошибки 40031:

{
  "status": {
    "code": 40031,
    "message": "Requested contents for order '0835504b-c325-4119-ad3e-16e6c7c72e70' are not available for sign: [fce4c600-a834-4d02-913c-5ab2d032ac6f]"
    },
  "result": null
}

Подписанные контейнеры не прошли проверку, подписанные контейнеры не входят в состав заказа.

3.2.4 Получить статус заказа

Метод позволяет получить статус конкретного заказа, используется запрос на основе метода GET. Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/marking-codes/orders/{draftId}/status

Заменяемые параметры:

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

GET https://lk.edo.ru/api/edo/v1/marking-codes/orders/df08122e-30b5-11eb-adc1-0242ac120016/status
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос:

    IN_PROC

Описание параметров ответа представлены в таблице 3.8.

Таблица 3.8. Описание параметров структуры ответа на запрос

Формат значения Описание
String Статус заказа:
DRAFT — Черновик,
INPROC — Заказ в обработке,
SUCCESS — Заказа обработан без ошибок,
FAILURE — Заказ обработан: ошибка по всем позициям,
PARTIALFAILURE — Заказ обработан: часть позиций с ошибками.



3.2.5 Список заказов и их статусы

Для получения списка заказов и их статусов используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/marking-codes/orders/list

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Описание параметров запроса приведены в таблице 3.9.
Таблица 3.9.Описание параметров запроса на получение списка заказа

Параметр Формат значения Описание Значение по умолчанию Обязательность в запросе
creationTimeFromIncl String Начальная дата периода поиска документов в формате (yyyy-MM-ddTHH:mm:ssZ), где yyyy — год, mm — месяц, dd — день, T — это долговременный паттерн (константа), HH — часы, mm — минуты, ss — секунды, Z — часовой пояс. Примеры даты: «2021-02-15T18:46:25+03:00» — UTC+03 часа, по Московскому времени, «2021-02-15T18:46:25Z» — UTC. нет
creationTimeToExcl String Конечная дата периода поиска документов в формате (yyyy-MM-ddTHH:mm:ssZ), где yyyy — год, mm — месяц, dd — день, T — это долговременный паттерн (константа), HH — часы, mm — минуты, ss — секунды, Z — часовой пояс. Текущая дата нет
orderName String Наименование заказа нет
draftId String Идентификатор заказа нет
pageSize NUM Количество записей на странице. В виде десятичного целого числа 1000 нет
pageIndex INDEX Номер запрашиваемой страницы списка документов; в виде десятичного целого числа 1 нет

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

POST https://lk.edo.ru/api/edo/v1/marking-codes/orders/list
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json
{
  "creationTimeFromIncl": "2021-02-15T18:46:25+03:00",
  "creationTimeToExcl": "2021-02-16T18:46:25+03:00",
  "pageSize": 1000,
  "pageIndex": 1
}

Пример запроса без фильтров:

POST https://lk.edo.ru/api/edo/v1/marking-codes/orders/list
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json
{

}

Пример успешного ответа на запрос:

{
  "result": {
    "data": [
      [
        {
          "draftId": "3cf0b5ce-447d-4fb9-86dd-c982362aa754",
          "productGroup": "lp",
          "creationTime": "2021-03-22T11:18:56.174Z",
          "status": "Success",
          "requestedQuantity": 9,
          "actualQuantity": 9,
          "gtinCount": 3,
          "orderName": "Тестирование 1 ",
          "number": "1616411464201",
          "releaseMethodType": "IMPORT"
        }
      ]
    ],
    "pageInfo": {
      "pageCount": 0,
      "pageIndex": 0,
      "pageRecords": 0,
      "sortDirection": "string",
      "sortKey": {
        "present": true
      }
    }
  },
  "status": {
    "code": 0,
    "message": "string"
  }
}

Описание параметров ответа представлены в таблице 3.10.

Таблица 3.10. Описание параметров структуры ответа на запрос

Параметр Вложенные поля Вложенные поля Формат значения Описание
result Структура Параметры авторизации
data Структура Данные списка заказов
creationtime String Дата создания заказа
draftId String Идентификатор заказа, полученный в ответе на метод «Создание заказа на коды маркировки»
orderName String Наименование заказа
number String Идентификатор заказа, полученный от пользователя
gtincount String Ваш идентификатор участника ЭДО
productgroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары;
perfumery — Духи и туалетная вода;
tires — Шины и покрышки пневматические резиновые новые;
electronics — Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки;
bicycle –Велосипеды и велосипедные рамы;
wheelchairs — Кресла коляски.
gtinCounty Integer Количество кодов товара/GTIN в заказе
requestedQuantity Integer Заказанное количество кодов маркировки
actualQuantity Integer Фактически полученное количество кодов маркировки
status String Статус заказа:
DRAFT — Черновик,
INPROC — Заказ в обработке,
SUCCESS — Заказа обработан без ошибок,
FAILURE — Заказ обработан: ошибка по всем позициям,
PARTIALFAILURE — Заказ обработан: часть позиций с ошибками
pageInfo Структура Информация о делении списка на страницы и о передаваемой странице списка
pageCount Integer Количество страниц в списке
pageIndex Integer Номер передаваемой страницы
pageRecords Integer Количество строк списка на странице
sortDirection String Порядок сортировки.
Возможные значения: asc — восходящая (прямой порядок);
desc — нисходящая (обратный порядок).
Значение по умолчанию — desc.
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос



3.2.6 Получение кодов маркировки

Метод используется для получения кодов маркировки по заказу. Заказ должен иметь статус Success или PartialFailure. Метод позволяет забрать все доступные коды по заказу или по конкретному коду товара (gtin).
Для получения кодов маркировки используется запрос на основе метода GET.
Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/marking-codes/orders/{draftId}/codes?gtin={gtin}

Описание параметров запроса приведены в таблице 3.11.

Таблица 3.11. Описание параметров запроса на получение списка документов

Параметр Заменяемая строка Описание Обязательно в запросе
{version} Обозначение версии системы, текущая версия равна v1 да
draftId {draftId} Идентификатор заказа да
gtin {gtin} Код товара нет

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

GET https://lk.edo.ru/api/edo/v1/marking-codes/orders/df08122e-30b5-11eb-adc1-0242ac120016/codes?gtin=04636332455032
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Структура успешного ответа на запрос:

{
  "draftId": "string",
  "markingCodes": [
    "string"
  ]
}

Описание параметров ответа представлены в таблице 3.12.

Таблица 3.12. Описание параметров структуры ответа на запрос

Параметр Формат значения Описание
draftId String Идентификатор заказа
markingCodes Массив кодов маркировки

3.2.7 Получение подробной информации о статусе каждого кода товара/GTIN в заказе

Метод позволяет получить информацию о товарных позициях конкретного заказа кодов маркировки, используется запрос на основе метода GET. Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/marking-codes/orders/{orderId}/positions

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {orderId} — Id заказа.

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

GET https://lk.edo.ru/api/edo/v1/marking-codes/orders/df08122e-30b5-11eb-adc1-0242ac120016/positions
Authorization:Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос:

{
  "result": {
    "data": [
      {
        "name": "04636332455032",
        "gtin": "04636332455032",
        "requestedCodesCnt": 2,
        "obtainedCodesCnt": 0,
        "status": "Failure",
        "details": "Проверка учетных данных УОТ не пройдена. Маркер безопасности b9b248ec-ea14-2f4f-7372-37e80892a1ae не найден"
      }
    ],
    "pageInfo": {
      "pageCount": 1,
      "pageIndex": 1,
      "pageRecords": 1,
      "sortDirection": "desc",
      "sortKey": "someKey"
    }
  },
  "status": {
    "code": 0,
    "message": "some message here"
  }
}

Описание параметров ответа представлены в таблице 3.13.

Таблица 3.13. Описание параметров структуры ответа на запрос

Параметр Вложенные поля Вложенные поля Формат значения Описание
result Структура Содержимое ответа
data Структура Данные контейнера
gtin String Номер gtin
name String Наименование
requestedCodesCnt Integer Количество запрошенных кодов
obtainedCodesCnt Целое число Количество полученных кодов
status Integer Статус заказа по конкретному коду товара/GTIN:
Success — коды получены,
PartialFailure,
Failure — отклонено,
InProс — в обработке,
AwaitingSign — заказ создан, ожидает подписания для отправки в «Честный ЗНАК»
details String Причина ошибки
pageInfo Структура Информация о делении списка на страницы и о передаваемой странице списка
pageCount Integer Количество страниц в списке
pageIndex Integer Номер передаваемой страницы
pageRecords Integer Количество записей на странице.
sortDirection Integer Направление сортировки
sortKey String Порядок сортировки.
Возможные значения:
asc — восходящая (прямой порядок);
desc — нисходящая (обратный порядок).
Значение по умолчанию — desc
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос



3.2.8 Получение информации об общих параметрах заказа

Метод позволяет получить параметры конкретного заказа, используется запрос на основе метода GET. Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/marking-codes/orders/{orderId}?include=mc-orig-req&include=mc&include=intro

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {orderId} — Id заказа

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

GET https://lk.edo.ru/api/edo/v1/marking-codes/orders/df08122e-30b5-11eb-adc1-0242ac120016?include=mc-orig-req&include=mc&include=intro
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос:

{
    "result": {
        "originalRequest": {
            "number": "938a9a02-f203-4694-9165-8326a22f9f38",
            "comment": "комментарий",
            "omsId": "79871fbf-c16d-4213-868a-462f5fcacc14",
            "clientToken": "d1d15b74-e56a-45d9-aaa9-9ad25f5108e9",
            "positions": [
                {
                    "gtin": "04636332455094",
                    "name": "Куртка зеленая мужская, 54 размер",
                    "quantity": 98,
                    "serialNumberType": "OPERATOR",
                    "templateId": "10",
                    "cisType": "UNIT"
                }
            ],
            "releaseMethodType": "IMPORT",
            "productGroup": "lp",
            "contactPerson": "Иванов И.А.",
            "createMethodType": "SELF_MADE",
            "orderName": "531313"
        },
        "mcOrderInfo": {
            "comment": "комментарий к заказу",
            "creationTime": "2021-02-15T10:51:55.457Z",
            "finishedProcessingTime": "2021-02-15T10:51:55.457Z",
            "orderName": "Наименование заказа",
            "startProcessingTime": "2021-02-15T10:51:55.457Z",
            "status": "InProc",
            "totalObtainedCodesCnt": 8,
            "totalRequestedCodesCnt": 10
        }
  },
  "status": {
    "code": 0,
    "message": "ОК"
  }
}

Описание параметров ответа представлены в таблице 3.14.

Таблица 3.14. Описание параметров структуры ответа на запрос

Параметр Вложенные поля Вложенные поля Вложенные поля Формат значения Описание
result Структура Параметры авторизации
originalRequest Структура Параметры заказа, полученные при его формировании
number String Номер заказа, указанный клиентом в методе «Создание заказа на коды маркировки»
comment String Комментарий
omsId String Идентификатор клиента в ЧЗ, указанный при создании заказа
clientToken String Токен авторизации, указанный при создании заказа
positions Структура Список товаров
gtin String (14) [0-9] {14} Код товара (GTIN)
name String Наименование товара
quantity Integer($int32) Количество КМ
serialNumberType String Способ генерации серийных номеров:
SELF_MADE — самостоятельно;
OPERATOR — оператором ГИС МТ.
serialNumbers JSON Array of String Массив серийных номеров. Это
поле указывается в случае, если
значение «serialNumber = SELF_MADE»
templateId Integer ($int32) Идентификатор шаблона товарной группы:
1 — обувные товары;
10 — предметы одежды, белье постельное, столовое, туалетное и кухонное;
7 — шины и покрышки пневматические резиновые новые;
8 — фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки;
9 — Духи и туалетная вода;
11 — велосипеды и велосипедные рамы;
12 — кресла коляски.
cisType String Тип кода маркировки:
UNIT — единица товара;
BUNDLE — комплект;
SET — набор;
GROUP — групповая потребительская упаковка.
Используется только для ТГ «Одежда», обязательно для данной ТГ.
exporterTaxpayerId String ИНН/УНБ (или аналог) экспортера.
Используется только для ТГ «Одежда» и «Обувь».
Становится обязательным для этих ТГ, только если в поле releaseMethod
(способ выпуска товара в оборот) было выбрано
значение «CROSSBORDER» (Ввезен в РФ из стран ЕАЭС)
productGroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары;
perfumery — Духи и туалетная вода;
tires — Шины и покрышки пневматические резиновые новые;
electronics — Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки;
bicycle –Велосипеды и велосипедные рамы;
wheelchairs — Кресла коляски.
clientToken String
omsId String
createMethodType String Способ изготовления:
SELF_MADE — Самостоятельно;
CEM — ЦЭМ;
CM — Контрактное производство;
CL — Логистический склад;
CA — Комиссионная площадка.
Используется только для ТГ «Одежда» и «Обувь», обязательно для данных ТГ.
releaseMethodType String Способ выпуска товаров:
PRODUCTION — производство РФ;
IMPORT — ввезен в РФ (импорт);
REMAINS — маркировка остатков (доступно только для ТГ «Духи и туалетная вода»);
COMMISSION — Принят на комиссию от физического лица (доступно для ТГ «Одежда», «Обувь»).
Используется только для ТГ «Одежда» и «Обувь», обязательно для данных ТГ.
contactPerson String Контактное лицо.
Используется только для ТГ «Одежда» и «Обувь»
productionOrderId String Идентификатор производственного заказа.
Используется только для ТГ «Одежда» и «Обувь»
serviceProviderId String(36) UUID Идентификатор сервис-провайдера.
Используется только при наличии сервис-провайдера
в ЛК Честного знака.
orderName String Наименование заказа
mcOrderInfo Структура Информация об обработке заказа в ЧЗ
comment String Пользовательский комментарий
creationTime String Время создания заказа
finishedProcessingTime String Время получения итогового ответа от ЧЗ по каждому коду товара/GTIN в заказе
orderName String Наименование заказа
startProcessingTime String Время подписания заказа и отправки в ЧЗ
status String Статус заказа:
DRAFT — Черновик,
INPROC — Заказ в обработке,
SUCCESS — Заказа обработан без ошибок,
FAILURE — Заказ обработан: ошибка по всем позициям,
PARTIALFAILURE — Заказ обработан: часть позиций с ошибками
totalObtainedCodesCnt Integer Общее количество полученных КМ для заказа
totalRequestedCodesCnt Integer Общее количество заказанных КМ для заказа
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос



3.2.9 Сохранение OMS ID

Метод позволяет сохранить параметр OMS ID — уникальный идентификатор клиента в Станции управления заказами (СУЗ) Честного ЗНАКа. Как найти этот параметр?
При повторном успешном вызове метода параметр OMS ID пересохраняется.
Используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/crpt/org/oms-info/edit

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

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

Параметр Формат значения Описание Обязательно в запросе
omsId String OMS ID — уникальный идентификатор в СУЗ Да

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

POST https://lk.edo.ru/api/edo/v1/crpt/org/oms-info/edit
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  omsId: "79871fbf-c16d-4213-868a-462f5fcacc14"
}

Пример успешного ответа на запрос имеет следующий вид

{
  "result": {
    "omsId": "79871fbf-c16d-4213-868a-462f5fcacc14"
  },
  "status": {
    "code": 0,
    "message": "ОК"
  }
}

Описание параметров ответа на запрос авторизации приведено в таблице 3.15.
Таблица 3.15. Описание параметров структуры ответа на запрос авторизации

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Параметры
omsId String OMS ID — уникальный идентификатор в СУЗ

3.2.10 Получить данные для подписи в рамках получения omsConnection

Для получения данных для подписания используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/crpt/org/oms-info/oms-connection/for-sign

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

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

POST https://lk.edo.ru/api/edo/v1/crpt/org/oms-info/oms-connection/for-sign
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Структура успешного ответа на запрос:

{
  "result": {
    "contentForSignBase64": "contentForSignBase64"
  },
  "status": {
    "code": 0,
    "message": "some message here"
  }
}

Описание параметров ответа приведены в таблице 3.16.

Таблица 3.16. Описание параметров структуры ответа на запрос

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура Параметры
contentForSignBase64 String Строка для подписания

После получения строки для подписания, нужно подписать ее. Для этого требуется перевести данные из формата base64 в бинарные данные и поместить в файл для подписания, после чего создать открепленную однострочную (без знаков переноса) подпись и отправить ее, используя метод «5.2.11 Отправка подписанных данных в рамках получения omsConnection».

3.2.11 Отправка подписанных данных в рамках получения omsConnection

Метод позволяет отправить заказ на обработку в «Честный ЗНАК». Используется после получения строки из метода "3.2.10 Получить данные для подписи в рамках получения omsConnection" и ее подписания. Для подписания строки требуется перевести данные из формата base64 в бинарные данные и поместить в файл для подписания, после чего создать открепленную однострочную (без знаков переноса) подпись и отправить ее в параметре «contentSignedBase64» запроса [#3.2.10 Получить данные для подписи в рамках получения omsConnection|»3.2.10 Получить данные для подписи в рамках получения omsConnection»]].

Для отправки подписанных данных используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/crpt/org/oms-info/oms-connection/sign

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Описание параметров запроса на отправку данных представлены в таблице 3.17.

Таблица 3.17. Описание параметров структуры запроса

Параметр Формат значения Описание
contentBase64 String Строка для подписания, полученная в параметре «contentForSignBase64» метода "Отправка подписанных данных в рамках получения omsConnection"
contentSignedBase64 String Результат подписания строки: открепленная подпись в формате PKCS#7/CMS, закодированная с помощью алгоритма “Base 64”, без переноса строк.

Пример структуры содержимого метода:

POST https://lk.edo.ru/api/edo/v1/crpt/org/oms-info/oms-connection/sign
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "contentBase64": "ceyJhZGRyZXNzIjo....Строка",
  "contentSignedBase64": "MIIMuAYJKoZIhvc.....Строка"
}

Пример успешного ответа на запрос:

{
  "result": {},
  },
  "status": {
    "code": 0,
    "message": "OK"
  }
}

Описание параметров ответа приведены в таблице 3.18.

Таблица 3.18. Описание параметров структуры ответа на запрос

Параметр Вложенные поля Формат значения Описание
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос
result Структура



3.2.12 Получение параметров OMS ID и OmsConnection

Метод позволяет получить информацию о сохраненных параметрах OMS ID (уникальный идентификатор клиента в Станции управления заказами (СУЗ) Честного ЗНАКа) и OmsConnection (уникальный идентификатор соединения), используется запрос на основе метода GET. Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/crpt/org/oms-info

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

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

GET https://lk.edo.ru/api/edo/v1/crpt/org/oms-info
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример успешного ответа на запрос:

{
  "result": {
    "omsConnection": "a35c80bb-9af3-4478-8d91-a07ce3be6c43",
    "omsId": "79871fbf-c16d-4213-868a-462f5fcacc14"
  },
  "status": {
    "code": 0,
    "message": "OK"
  }
}

Описание параметров ответа представлены в таблице 3.19.

Таблица 3.19. Параметры структуры ответа на запрос

Параметр Вложенные поля Формат значения Описание
result Структура Содержимое ответа
omsConnection String Уникальный идентификатор соединения
omsId String Уникальный идентификатор клиента в СУЗ
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос



3.3. Ввод в оборот

Порядок действий при вводе в оборот:

  1. Проверьте, что вы авторизованы в системе маркировки с помощью метода "Получить состояние авторизации", указав в запросе в параметре authType значение introduction. В ответе вы получите Время инвалидации токена (параметр tokenTtl). Если время больше текущего, значит вы авторизованы в системе. Если в ответе параметр отсутствует или время меньше текущего, то требуется авторизоваться для работы с маркировкой. Как это сделать читайте в разделе "3.1. Авторизация для работы с маркировкой". При авторизации в запросах в параметре authType указывайте значение introduction.
  2. методом (Создание заявки "Вывод из оборота" создать документ ввода в оборот;
  3. методом "3.3.4 Получить данные документа ввода в оборот для подписания" получить бинарный контент документа (Base64) и идентификатор контента;
  4. Сформировать прикреплённую подпись для бинарного контента документа;
  5. Передать бинарный контент подписи (в Base64) методом "3.3.5 Отправить подписанный документ ввода в оборот в «Честный ЗНАК»";
  6. Проверять статус обработки документа ввода с помощью метода "3.3.6 Получить статус документа ввода в оборот".

3.3.1 Создать документ ввода в оборот (Импорт ФТС)

Данный метод позволяет создать документ «Ввод в оборот. Импорт ФТС». В случае успешной отправки возвращается идентификатор документа (documentId).

Для создания заказа используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/marking-codes/introduction/import-fts


Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Описание параметров запроса на создание заказа приведены в таблице 3.20.

Таблица 3.20. Параметры запроса на создание заказа

Параметр Вложенные поля Формат значения Описание Обязательно в запросе
documentNumber String Номер документа ввода в оборот (должно быть уникальным) Да
declarationDate String Дата декларации имеет вид «YYYY-MM-DD». Пример «2020-02-22» Да
declarationNumber String Номер декларации.
Пример номера декларации: «05100000/220220/0002233», где
«220220» — это дата декларации, которая должна совпадать с датой,
указанной в параметре declarationDate.
Да
comment String Комментарий к документу Нет
positions Структура Список товаров Да
cis String Код маркировки Да
packtype String Тип упаковки:
UNIT — КИ;
LEVEL1-99 — КИТУ.
Да
productGroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары.
Да

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

POST https://lk.edo.ru/api/edo/v1/marking-codes/introduction/import-fts
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "documentNumber": "6f9619ff-8b86-d011-b42d-00cf4fc964f2",
  "declarationNumber": "05100000/110121/0002233",
  "declarationDate": "2021-01-11",
  "comment": "комментарий к документу",
  "positions": [
    {
      "cis": "010463633245506321VKCCw)HEmmMog",
      "packType": "UNIT"
    }
  ],
  "productGroup": "lp"
}

В случае успешной отправки возвращается идентификатор документа (documentId).
Пример успешного ответа на запрос:


   df08122e-30b5-11eb-adc1-0242ac120016
   

3.3.2 Создать документ ввода в оборот (Полученных от физических лиц)

Данный метод позволяет создать документ «Ввод в оборот. Полученных от физических лиц». В случае успешной отправки возвращается идентификатор документа (documentId).

Для создания заказа используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/marking-codes/introduction/individual

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Описание параметров запроса на создание заказа приведены в таблице 3.21.

Таблица 3.21. Описание параметров запроса на создание заказа

Параметр Вложенные поля Формат значения Описание Обязательно в запросе
documentnumber String Номер документа ввода в оборот (должно быть уникальным) Да
comment String Комментарий к документу Нет
positions Структура Список товаров Да
uit String Код маркировки. Обязательный, если не указан «uitu» Условно обязательное
uitu String Уникальный идентификатор транспортной упаковки.
Обязательный, если не указан «uit»
Условно обязательное
product_receiving_date date Дата получения товара. Параметр присутствует в запросе, если его
значение отличается от значения параметра «product_receiving_date».
Задается в формате yyyy-MMddTHH:mm:ss.SSS’Z
Нет
productgroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары.
Да
productReceivingDate String (date-time) Дата получения товара. Задается в формате yyyy-MMddTHH:mm:ss.SSS’Z,
например, «2021-01-19T21:00:00.000Z»
Да

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

POST https://lk.edo.ru/api/edo/v1/marking-codes/introduction/individual
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "documentNumber": "6f9619ff-8b86-d011-b42d-00cf4fc964f2",
  "comment": "комментарий к документу",
  "positions": [
    {
      "uit": "010463633245506321VKCCw)HEmmMog"
    }
  ],
  "productgroup": "lp",
  "productReceivingDate: "2021-01-19T21:00:00.000Z"
}

В случае успешной отправки возвращается идентификатор документа (documentId).
Пример успешного ответа на запрос:

   df08122e-30b5-11eb-adc1-0242ac120016

3.3.3 Создать документ ввода в оборот (Производство РФ)

Данный метод позволяет создать документ «Ввод в оборот. Производство РФ». В случае успешной отправки возвращается идентификатор документа (documentId).

Для создания заказа используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/marking-codes/introduction/production

Заменяемый параметр {version} — обозначение версии системы, по умолчанию равен v1.

Описание параметров запроса на создание заказа приведены в таблице 3.22.

Таблица 3.22. Описание параметров запроса на создание заказа

Параметр Вложенные поля Формат значения Описание Обязательно в запросе
documentnumber String Номер документа ввода в оборот (должно быть уникальным) Да
comment String Комментарий к документу Нет
positions Структура Список товаров Да
productGroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары.
Да
productionDate date Дата создания продукции. Задается в формате yyyy-MM-dd Да
uit String Код маркировки. Обязательный, если не указан «uitu» Условно обязательное
uitu String Уникальный идентификатор транспортной упаковки.
Обязательный, если не указан «uit»
Условно обязательное
tnved_code String Код товарной номенклатуры (10 знаков) Нет
certificate_document String Код вида документа обязательной сертификации \\Возможные значения:
CONFORMITY_CERTIFICATE — сертификат соответствия;
CONFORMITY_DECLARATION –декларация соответствия
Нет
certificate_document_number String Номер документа обязательной сертификации Нет
certificate_document_date String (date-time) Дата документа обязательной сертификации. Задается в формате yyyy-MM-dd. Диапазон даты, начиная с 2000-01-01 по дату создания документа Да
vsd_number string Номер ВСД, указывается для ТГ «Молочная продукция», обязательный, если в карточке НК «veterinaryControl» = true Да
POST https://lk.edo.ru/api/edo/v1/marking-codes/introduction/production
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "comment": "Some comment",
  "documentNumber": "6f9619ff-8b86-d011-b42d-00cf4fc964f2",
  "positions": [
   {     "production_date": "2019-01-01",
         "uit_code": "0104630033880100211AREwAwLETM7g240ffd0",
         "uitu_code": 111111111111111111,
         "tnved_code": "6401921000",
          "certificate_document": "CONFORMITY_CERTIFICATE",
          "certificate_document_number": "123",
          "certificate_document_date": "2019-01-01",
           "vsd_number": "9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091" }
           ],
  "productGroup": "lp",
  "productionDate": "2019-01-01"
}

В случае успешной отправки возвращается идентификатор документа (documentId).
Пример успешного ответа на запрос:

   df08122e-30b5-11eb-adc1-0242ac120016

3.3.4 Получить данные документа ввода в оборот для подписания

Данный метод позволяет получить данные документа для подписания.

Используется запрос на основе метода GET. Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/marking-codes/introduction/{documentId}/contents

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {documentId} — Id документа.

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

GET https://lk.edo.ru/api/edo/v1/marking-codes/introduction/df08122e-30b5-11eb-adc1-0242ac120016/contents
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример ответа

{
  "content": "ewogICAgInB...",
  "id": "6f9619ff-8b86-d011-b42d-00cf4fc964f2"
}

Таблица 3.23. Описание параметров ответа на запрос

Параметр Формат значения Описание
content string Идентификатор контента документа
id String Контент документа в формате base64

3.3.5 Отправить подписанный документ ввода в оборот в «Честный ЗНАК»

Метод позволяет отправить документ ввода в оборот в «Честный ЗНАК». Используется после получения контента из метода «Получение данных документа ввода в оборот для подписания» и их подписания. Для подписания контента требуется перевести данные параметра «content» из формата base64 в бинарные данные и поместить в файл для подписания, после чего создать прикрепленную однострочную (без знаков переноса) подпись и отправить ее в параметре «content» запроса «Отправка подписанного документа ввода в оборот в «Честный ЗНАК».

Для отправки документа используется запрос на основе метода POST. Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/marking-codes/introduction/{documentId}/send

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {documentId} — Id документа.

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

POST https://lk.edo.ru/api/edo/v1/marking-codes/introduction/df08122e-30b5-11eb-adc1-0242ac120016/send
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef
Content-Type: application/json

{
  "content": "ewogICAgInB..."
}

Таблица 3.24. Коды ответа на запрос

Статус кода HTTP Причина ответа
200 Запрос выполнен успешно
401 Ошибка аутентификации/авторизации

3.3.6 Получить статус документа ввода в оборот

Данный метод позволяет получить статус документа ввода в оборот.

Используется запрос на основе метода GET. Запрос имеет следующий вид:

GET https://lk.edo.ru/api/edo/{version}/marking-codes/introduction/{documentId}/status

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;
  • {documentId} — Id документа.

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

GET https://lk.edo.ru/api/edo/v1/marking-codes/introduction/df08122e-30b5-11eb-adc1-0242ac120016/status
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

Пример ответа

{
  "codesIntroductionType": "LP_FTS_INTRODUCE",
  "comment": "some comment",
  "documentId": "cf9619ff-8b76-d211-b42d-00cf4fc964f5",
  "documentNumber": "6f9619ff-8b86-d011-b42d-00cf4fc964f2",
  "documentStatus": "Created",
  "errors": "\"errors\":\"{\"errors\": [\"parse_error\", \"parse_error_2\"]\"}\"",
  "productGroup": "lp"
}

Таблица 3.25. Описание параметров ответа на запрос создание заказа

Параметр Формат значения Описание Обязательно в запросе
codesIntroductionType string Тип документа на ввод в оборот:
LP_FTS_INTRODUCE — Ввод в оборот. Импорт с ФТС;
LP_INTRODUCE_GOODS — Ввод в оборот. Производство;
LK_INDI_COMMISSIONING — Ввод в оборот. Полученных от физических лиц.
Да
comment String Комментарий к документу Нет
documentId String Уникальный идентификатор документа в ГИС МТ. Да
documentNumber String Уникальный идентификатор запроса пользователя, задается пользователем Да
documentStatus string Статус документа:
Created — «Требуется подпись», документ ввода создан, требуется подписать документ для отправки его в Честный ЗНАК«;
Sending — «Отправляется»
SentForIntroduction — «Отправлен в ЧЗ»
IntroductionFailed — «Ошибка ввода»
SendingError — «Ошибка отправки документа»
Introduced — «Введено в оборот».
Да
errors string Ошибки документа по вводу в оборот КМ Нет
productgroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары.
Да

3.4. Проверка кодов маркировки

Метод возвращает подробную информацию о запрашиваемом списке кодов идентификации товара: в одном запросе указывается как один КИ, так и несколько КИ (не более 1000 КИ). Коды товарной группы «Табачная продукция» и «Альтернативная табачная продукция» по блокам можно указывать в запросах как со скобками, так и без скобок. В ответе код всегда будет со скобками.

Перед вызовом метода рекомендуем проверить, что вы авторизованы в системе маркировки с помощью метода "Получить состояние авторизации", указав в запросе в параметре authType значение introduction. В ответе вы получите Время инвалидации токена (параметр tokenTtl). Если время больше текущего, значит вы авторизованы в системе. Если в ответе параметр отсутствует или время меньше текущего, то требуется авторизоваться для работы с маркировкой. Как это сделать читайте в разделе "3.1. Авторизация для работы с маркировкой". При авторизации в запросах в параметре authType указывайте значение introduction.

Запрос имеет следующий вид:

POST https://lk.edo.ru/api/edo/{version}/cises/info

Заменяемые параметры:

  • {version} — обозначение версии системы, по умолчанию равен v1;

Таблица 3.26. Описание параметров запроса, проверки кода маркировки

Параметр Формат значения Описание Обязательно в запросе
cisList Array[string] Список КИ для получения по ним информации Да
productgroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары;
clothes — Предметы одежды, белье постельное, столовое, туалетное и кухонное;
tobacco — Табачные изделия;
perfumery — Духи и туалетная вода;
tires — Шины и покрышки пневматические резиновые новые;
electronics — Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки;
pharma — Лекарственные препараты для медицинского применения;
milk — Молочная продукция;
bicycle — Велосипеды и велосипедные рамы;
wheelchairs — Кресла-коляски;
alternativeTobacco — Альтернативная табачная продукция;
water — Питьевая вода.
Нет

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

POST https://lk.edo.ru/api/edo/v1/cises/info
Authorization: Token 416b5600-3e36-4418-9604-e0c9843d2eef

{
  "cisList": [
    "010087879823112021fIYV1Gs-pFVYn",
    "010087879823112021>Qie.6lpQt!h!"
  ],
  "productGroup": "lp"
}

Пример положительного ответа (Код 200):

{
    "status": {
        "code": 0,
        "message": "OK"
    },
    "result": [
        {
            "cisInfo": {
                "requestedCis": "010088579823682021>Qie.6lpQt!h!",
                "cis": "010088579823682021>Qie.6lpQt!h!",
                "gtin": "00885798236820",
                "productName": "MWX0340OL71, КУРТКА МУЖСКАЯ, РАЗМЕР M",
                "productGroupId": 1,
                "productGroup": "lp",
                "brand": "BARBOUR",
                "emissionDate": "2020-12-01T09:13:34.492+0000",
                "emissionType": "FOREIGN",
                "packageType": "UNIT",
                "ownerInn": "323401346147",
                "ownerName": "ИП Каменцов Денис Анатольевич",
                "status": "RETIRED",
                "statusEx": "EMPTY",
                "producerInn": "7729491871",
                "producerName": "АО \"ЛАЙТ ХАУЗ\"",
                "markWithdraw": false,
                "certDoc": [
                    {
                        "number": "ЕАЭС N RU Д-GB.АБ43.В.01347",
                        "date": "2018-08-08"
                    }
                ],
                "withdrawReason": "RETAIL"
            }
        }
    ]
}

Пример ошибки (Код 400):

{
    "status": {
        "code": 40033,
        "message": "Invalid client token"
    },
    "result": null
}

Требуется проверить авторизацию в честном знаке, методом "Получение состояния авторизации" или пройти повторную авторизацию в честном знаке. Описание авторизации в честном знаке описаны в разделах 3.1.1, 3.1.2.

Таблица 3.27. Параметры ответа на запрос проверки кода маркировки

Параметр Вложенные поля Вложенные поля Вложенные поля Формат значения Описание
result Структура Array
cisInfo Структура Информация по коду маркировки
agentInn String ИНН агента
child Array[string] Список дочерних кодов маркировки
expirationDate String Срок годности
exporterName String Наименование экспортера
markWithdraw Boolean Состояние кода маркировки
maxRetailPricew Integer Максимальная цена розничной продажи
parent String Родительский код
prVetDocument String Идентификатор производственного или транспортного ветеринарного сопроводительного документа (ВСД)
producedDate String Дата ввода товара в оборот
requestedCis String Код маркировки в запросе
cis String Код маркировки в найденный в базе данных «Честный Знак»
gtin String Код товара (GTIN)
productName String Название товара
productGroupId integer Идентификатор товара
productGroup String Товарная группа:
lp — легкая промышленность;
shoes — обувные товары;
clothes — Предметы одежды, белье постельное, столовое, туалетное и кухонное;
tobacco — Табачные изделия;
perfumery — Духи и туалетная вода;
tires — Шины и покрышки пневматические резиновые новые;
electronics — Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки;
pharma — Лекарственные препараты для медицинского применения;
milk — Молочная продукция;
bicycle — Велосипеды и велосипедные рамы;
wheelchairs — Кресла-коляски;
alternativeTobacco — Альтернативная табачная продукция;
water — Питьевая вода.
brand String Марка товара
emissionDate String Дата ввода в оборот кода маркировки
emissionType String Тип кода маркировки может принимать следующие значения:
LOCAL — производство РФ;
FOREIGN — ввезён в РФ;
REMAINS — маркировка остатков;
CROSSBORDER — ввезён из странЕАЭС/
packageType String Тип упаковки может принимать следующие значения:
UNIT — Единица товара;
GROUP — Групповая упаковка;
LEVEL1 — Упаковка 1-го уровня;
LEVEL2 — Упаковка 2-го уровня;
LEVEL3 — Упаковка 3-го уровня;
LEVEL4 — Упаковка 4-го уровня;
LEVEL5 — Упаковка 5-го уровня;
BUNDLE — Комплект;
ATK — Агрегированный таможенный код;
SET — Набор.
ownerInn String ИНН организации владельца кода маркировки
ownerName String Название организации владельца кода маркировки
status String Статус кода маркировки может принимать следующие значения:
EMITTED — Эмитирован. Выпущен;
APPLIED — Эмитирован. Получен;
INTRODUCED — В обороте;
WRITTEN_OFF — Списан;
RETIRED — Выбыл;
WITHDRAWN — Выбыл (только для ТГ «Табачная продукция» и «Альтернативная табачная продукция»);
INTRODUCED_RETURNED — Возвращён в оборот (только для ТГ «Табачная продукция» и «Альтернативная табачная продукция»);
DISAGGREGATION — Расформирован (только для КИТУ, АТК и набора всех ТГ, кроме «Табачная продукция» и «Альтернативная табачная продукция»);
DISAGGREGATED — Расформирован (только для КИТУ и АТК ТГ «Табачная продукция» и «Альтернативная табачная продукция»).
statusEx String Параметр может принимать значения из таблицы «Актуальные особые состояния».
tnVedEaes String Код ТНВЭД
tnVedEaesGroup String Код группы ТНВЭД
withdrawReasonOther String Друга причина вывода из оборота
producerInn String ИНН организации производителя товара
producerName String Название организации производителя товара
markWithdraw boolean Состояния кода маркировки
certDoc Структура Array Данные по документу обязательной сертификации
number String Номер документа
date String Дата проведения сертификации
type String Тип сертификатов имеет следующие значения:
CONFORMITY_CERTIFICATE — сертификат соответствия;
CONFORMITY_DECLARATION — декларация соответствия.
withdrawReason String Причина вывода из оборота, см. «Справочник причин вывода из оборота»
status Структура Состояние запроса
code Integer Код ответа на запрос (0 — OK)
message String Сообщение в ответе на запрос


Таблица 3.28. «Актуальные особые состояния».

Код Описание Актуальный
EMPTY Значение отсутствует
RESERVED_NOT_USED Зарезервировано. Не использовать INTRODUCED
INDIVIDUAL КиЗ индивидуализирован (только для ТГ»Товары из натурального меха«) EMITTED, APPLIED
NON_INDIVIDUAL КиЗ не индивидуализирован (только для ТГ «Товары из натурального меха») EMITTED, APPLIED
WAIT_SHIPMENT Ожидает подтверждения приёмки INTRODUCED
EXPORTED Используется для документов экспорта
LOAN_RETIRED Выведен из оборота по договору рассрочки RETIRED
REMARK_RETIRED Выведен из оборота при перемаркировке WRITTEN-OFF
WAIT_TRANSFER_TO_OWNER Ожидает передачу собственнику (контрактное производство) INTRODUCED
WAIT_REMARK Товар ожидает перемаркировку или КИ списан после нанесения на товар WRITTEN_OFF
RETIRED_CANCELLATION Списание WRITTEN_OFF
RETIRED_DONATION Безвозмездная передача, применяется в документе «Отгрузка» RETIRED
RETIRED_STATE_ENTERPRISE Приобретение государственным предприятием, применяется в документе «Отгрузка» RETIRED
RETIRED_NO_RETAIL_USE Использование для собственных нужд покупателем, применяется в документе «Отгрузка» RETIRED
RETIRED_BEYOND_EEC_EXPORT Экспорт за пределы стран ЕАЭС, применяется в документе Вывод из оборота RETIRED
RETIRED_REMOTE_SALE Продажа по образцам, дистанционный способ продажи, применяется в документе «Вывод из оборота» RETIRED
RETIRED_EEC_EXPORT Экспорт в страны ЕАЭС, применяется в документе «Вывод из оборота» RETIRED
RETIRED_RETURN Возврат физическому лицу, применяется в документе «Вывод из оборота» RETIRED
RETIRED_DAMAGE_LOSS Утрата или повреждение, применяется в документе «Вывод из оборота» RETIRED
RETIRED_DESTRUCTION Уничтожение, применяется в документе «Вывод из оборота» RETIRED
RETIRED_CONFISCATION Конфискация, применяется в документе «Вывод из оборота» RETIRED
RETIRED_LIQUIDATION Ликвидация предприятия, применяется в документе «Вывод из оборота» RETIRED
RETIRED_ENTERPRISE_USE Использование для собственных нужд RETIRED
FTS_RESPOND_NOT_OK Отрицательное решение ФТС APPLIED
FTS_RESPOND_WAITING Ожидает подтверждение ФТС APPLIED
FTS_CONTROL На контроле ФТС APPLIED
IN_GRAY_ZONE Находится в Серой зоне APPLIED

Таблица 3.29. «Справочник причин вывода из оборота».

Причина Описание
KM_SPOILED испорчен КМ
KM_LOST утерян КМ
KM_DESTROYED уничтожен КМ
DESCRIPTION_ERRORS выявлены ошибки описания товара
RETAIL розничная реализация
EEC_EXPORT экспорт в страны ЕАЭС
BEYOND_EEC_EXPORT экспорт за пределы ЕАЭС
RETURN возврат от физ.лица
REMOTE_SALE продажа по образцам, дистанционный способ продажи
DAMAGE_LOSS утрата или повреждение
DESTRUCTION утилизация или уничтожение
CONFISCATION конфискация
LIQUIDATION ликвидация
DONATION безвозмездная передача
STATE_ENTERPRISE приобретение гос.предприятием
NO_RETAIL_USE использование для собственных нужд покупателем
ENTERPRISE_USE использование для собственных нужд предприятия
KM_SPOILED_OR_LOST испорчено либо утеряно СИ с КМ
KM_CANCELLATION аннулирование не преобразованных в СИ с КИ по истечении срока
RETAIL_RETURN возврат от розничного покупателя
REMOTE_SALE_RETURN возврат в случае дистанционной продажи
KMCANCELATION списание при трансформации
OTHER другая причина

4. Порядок тестирования

4.1. Описание

Раздел описывает способ тестирования услуги «ЭДО.Поток». Для тестирования используется демонстрационный личный кабинет клиента (ЛКК), подключенный к тестовой информационной системе «ЭДО.Поток».

4.2. Вход в демо ЛКК

Чтобы войти в личный кабинет клиента (демо), выполнить следующие действия:

  1. Переходим по ссылке;
  2. Автоматически подставленные данные в полях «Электронная почта» и «Пароль» удаляем.
  3. Вводим данные:
    1. электронная почта: edotest1@ofd.ru
    2. пароль: 1231
  4. Нажимаем кнопку «Войти»;
  5. Вы оказались в демо личном кабинете.

Теперь вы можете проверить работоспособность функционала ИС «ЭДО.Поток»

История изменений

Версия 2.0
Выпущена 11 января 2019 г.
Первая регистрируемая версия документа.

Версия 2.1
Выпущена 10 апреля 2019 г.
Исправлены ошибки в тексте и в ответах получаемые при выполнении запросов.

Версия 2.2
Выпущена 24 апреля 2020 г.
Изменен адрес сервера, на который необходимо отправлять API-запросы.

Версия 2.3
Выпущена 11 сентября 2020 г.
Исправлена ошибка в методе авторизации в ИС «ЭДО.Поток».

Версия 2.4
Выпущена 25 сентября 2020 г.

  • Исправлена нумерация таблиц;
  • Устранены мелкие недочеты по всему объему документа.

Версия 2.5
Выпущена 09 октября 2020 г.

  • Переработаны таблицы для большей наглядности информации о вложенных полях в структурах;
  • Исправлены названия таблиц по всему объему документа;
  • Исправлены ошибки в тексте и в ответах получаемые при выполнении запросов;
  • Добавлены параметры в таблицу 4;
  • Исправлена ошибка в методе авторизации через AuthToken.

Версия 2.6
Выпущена 12 октября 2020 г.

  • Исправлена ошибка в методе 3.1.10 Вывод справочника типов документов;
  • Исправлены ошибка в методе 3.3.1 Поиск контрагентов;
  • Добавлен метод 3.3.2. Получение списка контрагентов по статусу.

Версия 2.7
Выпущена 15 октября 2020 г.
Убран блок информации 3.2. Запросы, связанные с клиентами.

Версия 2.8
Выпущена 18 ноября 2020 г.

  • Изменен адрес запросов с edmapi.ofd.ru на lk.edo.ru;
  • Временно убран раздел «Авторизация с помощью имени пользователя (логина) и пароля»;
  • Добавлен раздел 3.1.13. Получение извещения на подтверждение оператора (для отправителя);
  • Добавлен раздел 3.1.14. Получение извещений на документ (для получателя);
  • Добавлен раздел 3.1.15. Получение любых извещений на документы.

Версия 2.9
Выпущена 23 декабря 2020 г.

  • Добавлен раздел 3.1 Отправка заказа кодов маркировки в «Честный ЗНАК»
  • Добавлен раздел 3.2 Получение статуса заказа и кодов маркировки

Версия 3.0
Выпущена 03 марта 2021 г.
Добавлен раздел 4. Маркировка

Версия 3.1
Выпущена 04 марта 2021 г.

  • Добавлен раздел 4.2.3 Создание документа ввода в оборот (Производство РФ)
  • Добавлен раздел 4.2.4 Получение данных документа для подписания
  • Добавлен раздел 4.2.5 Сохранение подписанных данных заказа на ввод кодов в оборот для последующей отправки в ГИС МТ
  • Добавлен раздел 4.2.6 Получение статуса документа ввода в оборот КМ

Версия 3.2
Выпущена 10 марта 2021 г.
Добавлен раздел 2 — Метод регистрации в ИС «ЭДО.Поток»

Версия 3.3
Выпущена 23 марта 2021 г.
Добавлены методы получение информации о товарных позициях заказа КМ, получение информации о параметрах заказа КМ

Версия 3.4
Выпущена 27 апреля 2021 г.
Добавлены разделы:

  • 4.2.1. Метод загрузки черновика
  • 4.2.2. Метод получения списка черновиков
  • 4.2.3. Метод скачивания черновика
  • 4.2.4. Метод удаления черновика
  • 4.2.5. Метод отправки черновика
  • 4.2.6. Метод получения печатной формы черновика в PDF

Версия 3.5
Выпущена 30 июня 2021 г.
Добавлены разделы:

  • 4.3. Работа с контрагентами;
  • 6. Порядок тестирования.

Версия 3.6
Выпущена 16 сентября 2021 г.
Добавлены разделы:

  • 4.1.2. Получение списка документов со статусом документооборота клиента
  • 4.4. Описание методов, порядка документооборота клиента по 14н

Версия 3.7
Выпущена 22 октября 2021 г.

  • Измена структура документа
  • Добавлены схемы порядок обмена по приказу 14Н

Версия 3.8
Выпущена 09 декабря 2021 г.

  • Добавлен раздел 3.4. Проверка кодов маркировки
1)
Зависит от текущей или используемой версии системы, может изменяться.
2)
Зависит от текущей или используемой версии системы, может изменяться
3)
Задается по правилам написания адресов URL и URI: недопустимые символы заменяются служебными последовательностями в соответствии с RFC 3986, см. https://ru.wikipedia.org/wiki/URL, https://www.ietf.org/rfc/rfc3986.txt и http://www.protocols.ru/WP/rfc3986/.