Создание электронной препроводительной ведомости

Обновлено 12 марта 2026

Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис ENCASHMENTS_REQUEST.

Дайджест

Дайджест это текстовый документ, содержащий перечень и значения полей запроса, к которому он относится и предназначенный для подписания ЭЦП. Сохраняйте порядок и количество полей дайджеста, как показано в примере ниже, иначе подписать его не получится.

Наименование поля в дайджесте	Описание поля (информационно)	Пример
contactPhone	Телефон контактного лица
creatorPerson	ФИО создателя
date	Дата препроводительной ведомости
externalId	Внешний идентификатор описи (UUID)
fromName	От кого
number	Номер сумки
objectCode	Код объекта (ИНК)
payeeInn	ИНН получателя
payeeName	Наименование получателя
payerBankBic	БИК банка вносителя
payerBankName	Наименование банка вносителя
sourceOfIncome	Источник поступления
transKind	Шифр документа (Вид операции)
TABLES
Table=currencyNominalValues	Опись содержимого сумки по валютам и номиналам	currencyNominalValues
cashType	Тип валюты
currencyCode	Цифровой код валюты
nominal	Номинал
quantity	Количество
Table=sumByAccounts	Разбивка суммы сумки по лицевым счетам и символам	sumByAccounts
account	Номер лицевого счета зачисления
bankName	Наименование банка зачисления
bic	БИК банка зачисления
Table=sumBySymbols	Сумма для зачисления на данный счет в разбивке по символам	sumBySymbols
sum	Сумма
symbol	Кассовый символ
	# Разделитель

Пример:

contactPhone=+79991234567
creatorPerson=Петрова Мария Ивановна
date=2025-10-30
externalId=f57cf751-0dd0-4844-9f4a-f441452fc66e
fromName=ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ РОГА И КОПЫТА
number=64
objectCode=859707561048848759521282
payeeInn=5438603379
payeeName=ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ РОГА И КОПЫТА; Адрес:1_Адрес объекта по заявке 7245172782510899201; ИНК: 7245172782510899201
payerBankBic=047501602
payerBankName=Челябинское отделение №8597
sourceOfIncome=02 - Поступления от продажи товаров; 32 - Прочие поступления;
transKind=04
TABLES
Table=currencyNominalValues
cashType=BANKNOTES
currencyCode=810
nominal=5000.00
quantity=123456
#
cashType=BANKNOTES
currencyCode=810
nominal=1000.00
quantity=123456
#
cashType=BANKNOTES
currencyCode=810
nominal=2000.00
quantity=123456
#
cashType=COINS
currencyCode=810
nominal=5.00
quantity=123456
#
Table=sumByAccounts
account=40702810738000083369
bankName=ПАО Сбербанк
bic=044525225
Table=sumBySymbols
sum=617280000.00
symbol=02
#
sum=123456000.00
symbol=32
#
#
account=40702810738000083367
bankName=ПАО Сбербанк
bic=044525225
Table=sumBySymbols
sum=246912000.00
symbol=02
#
sum=617280.00
symbol=32
#
#

Рекомендации по тестированию в песочнице

При тестировании создания электронной препроводительной ведомости в Песочнице соблюдайте правила:

• Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (certificateUuid).
• Все остальные поля запроса заполняйте произвольными данными (реквизиты, суммы) в соответствии с требованиями в документации.

Сценарии тестирования

Для тестирования сценариев используйте фиксированные значения certificateUuid. При использовании любых других значений certificateUuid вернется ошибка WORKFLOW_FAULT.

1. Чтобы создать неподписанную ведомость (черновик), отправьте запрос без объекта digestSignatures.

---

2. Для отправки документа с единственной или двумя подписями передайте в объекте digestSignatures тестовые certificateUuid.

Параметры:

• bb014b5d-8159-40be-97c1-eafeed4a8c3d (единственная подпись)
• d5d4f811-f4d4-4205-a70f-58f772eeab72 (первая подпись)
• 4f29c8ef-b55d-43c7-a321-f2b1303a29cd (вторая подпись)

Статус в ответе: bankStatus: "SUCCESS"

Пример:

#Единственная подпись
  "digestSignatures": [
    \{
      "certificateUuid": "bb014b5d-8159-40be-97c1-eafeed4a8c3d",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],


#Первая и вторая подпись
  "digestSignatures": [
    \{
      "certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \},
    \{
      "certificateUuid": "4f29c8ef-b55d-43c7-a321-f2b1303a29cd",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],

---

3. Чтобы получить ошибку при создании ведомости необходимо в поле base64Encoded передать значение INVALIDEDS, а certificateUuid заполнить произвольно.

Статус в ответе: bankStatus: "WORKFLOW_FAULT"

Пример:

    "digestSignatures": [
      {
        "certificateUuid": "bb014b5d-8159-40be-97c1-eafeed4a8c33",
        "base64Encoded": "INVALIDEDS"
      }
    ],

---

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

Передаваемое значение externalId	Возвращаемое значение bankStatus
bb014b5d-8159-40be-97c1-eafeed4a8c3d	UNAVAILABLE_RESOURCE_EXCEPTION
2dddbfbe-d24a-498f-8e43-2d70b940e95f	WORKFLOW_FAULT

Запрос

Ответы

Успешный код возврата

Ошибка в запросе или его жизненном цикле

Не авторизован

Запрещено

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

Внутренняя ошибка сервера

Сервис временно недоступен

Loading...