SelSup Developers

Публичный API · API Reference

Финансы

Методы раздела «Финансы»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

25 методов/api/financeСтабильныйМашинное описание ↗
{ }

Страница собрана в отдельный редактируемый контракт. Перед операциями записи проверяйте примеры на тестовых данных.

/api/finance

Готовые сценарии

Готовые сценарии

01

Начать работу с разделом «Финансы»

Используйте отдельный API-токен и сначала проверяйте операции чтения на тестовых данных.

  1. Сохраните токен на серверной стороне и передавайте его в заголовке Authorization.
  2. Проверьте обязательные параметры и раскройте структуру запроса или ответа.
  3. Обрабатывайте HTTP-статус и стабильное поле error в прикладных ошибках.

Модель данных

Структуры данных раздела

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

Account8 полей
accountIdinteger · int64

Поле accountId.

namestring

Поле name.

numberstring

Поле number.

clientIdinteger · int64

Поле clientId.

organizationIdinteger · int64

Поле organizationId.

bankBank

Поле bank.

accountNumberAccount

Поле accountNumber.

accountNameAccount

Поле accountName.

Address15 полей
idinteger · int32

Поле id.

postCodestring

Поле postCode.

countryCountry

Поле country.

regionRegion

Поле region.

regionIdinteger · int32

Поле regionId.

streetstring

Поле street.

housestring

Поле house.

districtstring

Поле district.

citystring

Поле city.

localitystring

Поле locality.

buildingstring

Поле building.

flatstring

Поле flat.

shortstring

Поле short.

addressIdAddress

Поле addressId.

fullstring

Поле full.

Bank11 полей
bikstring

Поле bik.

namestring

Поле name.

addressstring

Поле address.

isBankboolean

Поле isBank.

accountstring

Поле account.

integrationstring

Поле integration.

bankBikBank

Поле bankBik.

bankNameBank

Поле bankName.

bankAddressBank

Поле bankAddress.

bankAccountBank

Поле bankAccount.

bankIntegrationBank

Поле bankIntegration.

Contractor14 полей
idinteger · int64

Идентификатор контрагента. Проставляется автоматически

namestring

Наименование контрагента

Обязательно
versionIdinteger · int64

Поле нужно передавать при изменении,для предотвращения одновременной перезаписи

clientIdinteger · int64

Идентификатор клиента

read-only
createdUserstring

Логин пользователя, который создал контрагента

read-only
lastIncomeDatestring · date-time

Дата последнего поступления для этого контрагента для сортировки

read-only
deletedboolean

Признак удаления контрагента

read-only
organizationIdinteger · int64

Организация для реквизитов контрагента

phoneNumberstring

Номер телефона

emailstring

Адрес электронной почты

contactNamestring

Имя контакта

moySkladIdstring

Идентификатор в сервисе МойСклад

urlstring

Ссылка на сайт

organizationOrganization

Организация для документов. Можно передать как сам объект, так и просто organizationId

read-only
Country6 полей
countryIdinteger · int32

Идентификатор страны

namestring

Название страны

code2string

Двухбуквенный код страны

code3string

Трехбуквенный код страны

namesobject

Поле names.

printNamestring

Поле printName.

ExpenditureObject7 полей
expenditureIdinteger · int64

Поле expenditureId.

namestring

Поле name.

typestring

Поле type.

clientIdinteger · int64

Поле clientId.

isCommonboolean

Поле isCommon.

expenditureNameExpenditureObject

Поле expenditureName.

expenditureTypeExpenditureObject

Поле expenditureType.

Organization33 полей
idinteger · int64

Идентификатор организации. Проставляется автоматически

read-only
namestring

Полное наименование организации

Обязательно
shortNamestring

Поле shortName.

taxTypestring

Система налогооблажения

taxRateinteger · int32

Ставка налога, если она отличается от стандартной

taxNdsinteger · int32

Ставка налога, если она отличается от стандартной

inputTaxNdsinteger · int32

Ставка входящего НДС

outputTaxNdsinteger · int32

Ставка исходящего НДС

enableNewTaxCalculationboolean

Включить расчет налогов по новым правилам

useNdsCostPriceboolean

Учитывать входящий НДС в себестоимости

innstring

ИНН

Обязательно
kppstring

КПП. Проставляется только для ООО

bankstring

Название банка

bikstring

БИК счета организации

corrBillstring

Номер корреспондентского счета

billNumberstring

Номер счета организации

stampPathstring

Ссылка на изображение печати организации

read-only
stampUrlstring

Ссылка на изображение печати организации

read-only
stampSizeinteger · int32

Размер в байтах изображения печати организации

read-only
stampWidthinteger · int32

Ширина изображения печати организации

read-only
stampHeightinteger · int32

Высота изображения печати организации

read-only
signaturePathstring

Фото подписи директора организации

read-only
signatureUrlstring

Фото подписи директора организации

read-only
signatureSizeinteger · int32

Размер файла в байтах подписи директора организации

read-only
signatureWidthinteger · int32

Ширина изображения подписи директора

read-only
signatureHeightinteger · int32

Высота изображения подписи директора

read-only
ipPersonPerson

Руководитель организации или ИП

formstring

Организационно правовая форма

Обязательно
ipboolean

Поле ip.

clientIdinteger · int64

Идентификатор клиента

read-only
addressAddress

Адресс организации

phoneNumberstring

Номер телефона

addressFullstring

Полный адрес

read-only
Person14 полей
personIdinteger · int64

Поле personId.

read-only
firstNamestring

Имя сотрудника

Обязательно
lastNamestring

Фамилия сотрудника

Обязательно
surNamestring

Отчество сотрудника

clientIdinteger · int64

Идентификатор клиента

read-only
positionPersonPosition

Должность сотрудника

Обязательно
versionIdinteger · int64

Поле нужно передавать при изменении,для предотвращения одновременной перезаписи

read-only
createdUserstring

Проставляется автоматически. Пользователь создавший сотрудника

read-only
createdDatestring · date-time

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

read-only
deletedboolean

Признак удаления сотрудника

read-only
userIdinteger · int32

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

read-only
hasChangesboolean

Поле hasChanges.

fullNamestring

Полные ФИО

read-only
shortNamestring

Фамилия и инициалы

read-only
PersonPosition7 полей
idinteger · int64

Идентификатор должности. Проставляется автоматически

read-only
namestring

Название должности

Обязательно
deletedboolean

Признак удаления должности

read-only
clientIdinteger · int64

Идентификатор клиента

read-only
defaultJobIdinteger · int64

Работа по умолчанию для должности

createdUserstring

Пользователь, который создал должность

read-only
createdDatestring · date-time

Дата создания должности

read-only
Region4 полей
regionIdinteger · int32

Поле regionId.

countryIdinteger · int32

Поле countryId.

namestring

Поле name.

regionSynonymsRegionSynonym[]

Поле regionSynonyms.

RegionSynonym4 полей
idinteger · int64

Поле id.

regionIdinteger · int64

Поле regionId.

synonymstring

Поле synonym.

servicestring

Поле service.

Transaction42 полей
transactionIdinteger · int64

Поле transactionId.

clientIdinteger · int64

Поле clientId.

expenditureIdinteger · int64

идентификатор статьи расходов

expenditureExpenditureObject

Поле expenditure.

directionstring

тип операции

scheduleIdinteger · int64

идентификатор расписания

commentstring

Комментарий

contractorIdinteger · int64

Идентификатор контрагента(организации)

contractorContractor

Поле contractor.

recipientKppinteger · int64

КПП получателя

recipientInninteger · int64

ИНН получателя

recipientAccountstring

Номер лицевого счета получателя

recipientNamestring

Нименование получателя

payerKppinteger · int64

КПП плательщика

payerInninteger · int64

ИНН плательщика

payerAccountstring

Номер лицевого счета плательщика

payerNamestring

Нименование плательщика

kbkstring

КБК

recipientAgentBikinteger · int64

БИК агента получателя

recipientAgentAccountstring

Счет агента получателя

recipientAgentNamestring

Нименование агента получателя

payerAgentBikinteger · int64

БИК агента плательщика

payerAgentAccountstring

Счет агента плательщика

payerAgentNamestring

Нименование агента плательщика

accountCurrencystring

Валюта счета

paymentAmountRubnumber · double

Сумма в рублях

paymentAmountnumber · double

Сумма в валюте счета

paymentPurposestring

Цель платежа

paymentDocumentCodestring

Код платежного документа

paymentDocumentNumberinteger · int64

Номер платежного документа

datestring · date-time

Дата документа

accountIdinteger · int64

Идентификатор счета в бд

accountAccount

Поле account.

organizationIdinteger · int64

Поле organizationId.

deletedboolean

Признак поставлена на удаление или нет транзакция

includeInPnlboolean

Учитывать транзакцию в отчете P&L

incomeIdinteger · int64

Идентификатор закупки.

expenditureOperationTypestring

Тип транзакции

isSuppliersPurchaseTransactionboolean

Идентификатор, если true, то требуется заполнить транзакцию как, пришедшую от взаиморасчетов поставщиков.

productIdinteger · int64

Идентификатор товара

articlestring

Артикул товара

barcodestring

ШК товара

TransactionSchedule18 полей
scheduleIdinteger · int64

Поле scheduleId.

directionstring

Поле direction.

commentstring

Поле comment.

accountIdinteger · int64

Поле accountId.

accountAccount

Поле account.

datestring · date-time

Поле date.

paymentAmountnumber · double

Поле paymentAmount.

frequencystring

Поле frequency.

contractorIdinteger · int64

Поле contractorId.

expenditureIdinteger · int64

Поле expenditureId.

expenditureExpenditureObject

Поле expenditure.

contractorContractor

Поле contractor.

clientIdinteger · int64

Поле clientId.

organizationIdinteger · int64

Поле organizationId.

creatorstring

Поле creator.

createdDatestring · date-time

Поле createdDate.

contractorInnstring

Поле contractorInn.

includeInPnlboolean

Поле includeInPnl.

TmsTask25 полей
idinteger · int64

Идентификатор задачи

read-only
statusstring

Текущий статус задачи

read-only
typestring

Тип задачи

read-only
namestring

Данные задачи в json - могут быть пустыми

clientIdinteger · int64

Поле clientId.

entityIdinteger · int64

Сущность, к которой относится задача

progressinteger · int32

Прогресс выполнения задачи в процентах

processedQuantityinteger · int32

Количество обработанных записей задачи

organizationIdinteger · int64

Организация задачи, может быть 0, если не зависит от организации

priorityinteger · int32

Приоритет задачи - чем выше тем быстрее задача запустится

propertiesstring

Параметры задачи

messagestring

Сообщение с результатом выполнения задачи

messageParamsstring

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

createdDatestring · date-time

Дата добавления задачи в очередь

startDatestring · date-time

Дата запуска задачи

finishDatestring · date-time

Дата завершения задачи

urlstring

Ссылка на скачивание файла с результатом задачи

inputFileUrlstring

Ссылка на загруженный файл

retryNumberinteger · int32

Счётчик перезапуска задачи.

userIdinteger · int32

Пользователь запустивший задачу

retryDatestring · date-time

Запланированная дата перезапуска

debugboolean

Запуск задачи в режиме отладки с большим логированием

forcedStartboolean

Ручной запуск задачи

servicestring

Сервис в рамках которого выполняется задача

langstring

Язык на котором сейчас запущена таска

TransactionFilter17 полей
limitinteger · int32

Ограничение на количество записей. Максимальное значение - 500

pageinteger · int32

Номер страницы начиная с 1

countboolean

Возвратить в ответе общее количество записей

sortBystring

Поле сортировки записей. Работает только при получении списка.

ascendingboolean

Порядок сортировки - по возрастанию?. Работает только при получении списка.

querystring

Поисковый запрос для платежей

dateFromstring · date-time

Фильтр по дате операции - от

dateTostring · date-time

Фильтр по дате операции - до

organizationIdinteger · int64

Идентификатор организации. (Теперь используем organizationIds)

organizationIdsinteger[]

Идентификаторы организаций

servicesstring[]

Идентификатор сервисов

directionstring

Идентификатор расход/доход

incomeIdinteger · int64

Идентификатор транзакции

contractorIdinteger · int64

Идентификатор контрагента

timeZoneinteger · int32

Часовой пояс клиента по UTC

showIncomesboolean

Включать взаиморасчеты с поставщиками

accountIdinteger · int64

Поле accountId.

PeriodTransactionResponse5 полей
startDatestring · date-time

Дата начала периода (в формате ISO 8601)

Обязательно
endDatestring · date-time

Дата окончания периода (в формате ISO 8601)

Обязательно
transactionsTransactionStructure[]

Список транзакций за период

Обязательно
totalCostnumber · double

Суммарная стоимость всех транзакций за период

percentDiffnumber · double

Процентное изменение общей суммы (используется только для разницы)

TransactionStructure10 полей
idinteger · int32

Поле id.

namestring

Поле name.

costnumber · double

Поле cost.

totalSalesnumber · double

Поле totalSales.

percentnumber · double

Поле percent.

absPercentnumber · double

Поле absPercent.

costWithoutSppnumber · double

Поле costWithoutSpp.

totalSalesWithoutSppnumber · double

Поле totalSalesWithoutSpp.

percentWithoutSppnumber · double

Поле percentWithoutSpp.

directionstring

Направление транзакции (доход или расход)

Обязательно
TransactionStructureResponse3 полей
currentPeriodPeriodTransactionResponse

Данные за текущий период

Обязательно
previousPeriodPeriodTransactionResponse

Данные за предыдущий период. Может быть null, если предыдущий период не запрошен

differencePeriodTransactionResponse

Разница между текущим и предыдущим периодами. Может быть null, если предыдущий период не запрошен

FindResponseTransaction1 полей
rowsTransaction[]

Строки с результатом поиска

TransactionSchedulerFilter6 полей
limitinteger · int32

Ограничение на количество записей. Максимальное значение - 500

pageinteger · int32

Номер страницы начиная с 1

countboolean

Возвратить в ответе общее количество записей

sortBystring

Поле сортировки записей. Работает только при получении списка.

ascendingboolean

Порядок сортировки - по возрастанию?. Работает только при получении списка.

querystring

Поле query.

FindResponseTransactionSchedule1 полей
rowsTransactionSchedule[]

Строки с результатом поиска

AnalyticsRequest74 полей
periodstring

Период агрегации

dateFromstring · date-time

Дата начала отчета

Обязательно
dateTostring · date-time

Дата окончания отчета

Обязательно
servicesstring[]

Список маркетплейсов для которых отдать данные

categoriesinteger[]

Фильтр категорий для которых отдать данные

brandsinteger[]

Фильтр брендов для которых отдать данные

clientOrganizationIdinteger · int64

Идентификатор организации, для которой отдать данные

organizationsinteger[]

Идентификаторы организаций клиента

idsinteger[]

Список идентификаторов

typestring

Тип заказа

typesstring[]

Типы заказа

statusstring

Фильтр по статусу заказа

timeZoneinteger · int32

Часовой пояс клиента по UTC

previousDateFromstring · date-time

Дата начала периода для сравнения

clientOrganizationIdsinteger[]

Идентификаторы организаций, для которых отдать данные

ignoreCreditboolean

Не учитывать кредит в прочих удержаниях

productAnalyticFieldstring

Агрегировать данные по сущности

Обязательно
querystring

Поисковый запрос для фильтрации аналитики

withDuplicateboolean

Отдавать аналитику по дубликатам товаров

withBonusboolean

Вычитать бонусы Ozon и Яндекс Маркета, а также СПП Wildberries из выручки и расходов

byOrgAndServiceboolean

Для Excel финансового отчёта: true — колонки по паре организация + маркетплейс, false/null — агрегировать по организации как раньше

byOrderTypeboolean

Разбивать финансовый отчёт по типу заказа: отдельные строки для маркетплейсов, розницы и опта

limitinteger · int32

Количество записей в ответе

pageinteger · int32

Страница для навигации по страницам, начиная с 1

sortBystring

Поле сортировки

ascendingboolean

Сортировать по возрастанию по полю sortBy

idinteger · int64

Поле id.

isMarketPlaceStructureboolean

Идентификатор, получать данные только по маркетплейсу или по всем.

isDashboardboolean

Идентификатор, запрос с дашборда или нет.

analyticsFieldstring

Агрегировать данные по model/product/view

planDayCountinteger · int32

Кол-во дней для отчетов

daysToSupplyinteger · int32

Через сколько дней ожидается поставка

plannedSupplyDatestring · date-time

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

groupByViewboolean

Сгруппировать по цвету

warehousesinteger[]

Список идентификаторов складов

salesModelsstring[]

Модели продаж для отчёта экономики складов

aggregationstring

Уровень агрегации отчёта экономики складов

columnsFileExportColumn[]

Настроенные пользователем колонки Excel

regionsstring[]

Список регионов

groupboolean

Сгруппировать данные

calculationByOrdersboolean

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

sourceReportstring

Операция по которой выводить данные

skipDayWithoutStocksboolean

Пропускать дни без остатков

replaceSetsByComponentsboolean

Раскрывать комплекты по компонентам

distributeFbsByWarehouseboolean

Распределять FBS по складам пропорционально FBO

distributeFbsStockboolean

Распределять остатки FBS между маркетплейсами/складами

ignoreDumpingboolean

Игнорировать слив товара (продажи по заниженной цене)

isSaleStructureboolean

Идентификатор, что нужно получить структуру по продажам

isAveragePerOneUnitboolean

Идентификатор, получить среднее за 1 единицу

updateDateboolean

Обновлять даты

useWeightedGroupboolean

Использовать группы по весу

isFindirRequestboolean

Является ли запрос - запросом для Задачника

brandIdsinteger[]

Фильтр по идентификаторам брендов (список)

categoryIdsinteger[]

Фильтр по идентификаторам категорий (список)

articlesstring[]

Фильтр по артикулу (список)

colorsstring[]

Фильтр по цвету (список)

sizesstring[]

Фильтр по размеру (список)

barcodesstring[]

Фильтр по штрих-коду (список)

tagIdsinteger[]

Фильтр по идентификаторам тегов товаров (список)

penaltyFromnumber · double

Фильтр по штрафам (от)

penaltyTonumber · double

Фильтр по штрафам (до)

logisticsFromnumber · double

Фильтр по логистике (от)

logisticsTonumber · double

Фильтр по логистике (до)

marginFromnumber · double

Фильтр по маржинальности (от)

marginTonumber · double

Фильтр по маржинальности (до)

salesAmountFromnumber · double

Фильтр по сумме продаж (от)

salesAmountTonumber · double

Фильтр по сумме продаж (до)

totalSalesAmountFromnumber · double

Фильтр по выручке (от)

totalSalesAmountTonumber · double

Фильтр по выручке (до)

grossProfitFromnumber · double

Фильтр по валовой прибыли (от)

grossProfitTonumber · double

Фильтр по валовой прибыли (до)

taxNdsinteger · int32

Налог ндс

useOsnoboolean

Тип налогообложения осно

unmatchboolean

Поле unmatch.

FileExportColumn5 полей
idinteger · int64

ID записи

fileExportIdinteger · int64

ID конфигурации экспорта

columnNamestring

Название столбца

columnOrderinteger · int32

Порядок столбца в файле

isEnabledboolean

Включен ли столбец для экспорта

Контракт ошибок

Как API возвращает прикладные ошибки

Код ошибки одинаков для всех локалей, а текст для пользователя переводится сервером. Поэтому бизнес-логику стройте по error, а localMessage используйте только для отображения.

error

Стабильный машинный код ошибки для логики интеграции.

localMessage

Готовое сообщение на языке пользователя API-токена.

params

Значения

Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.

RUПользователь с локалью ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENПользователь с локалью en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Методы

Методы

PUT

Изменить платеж

/api/finance/transaction/{id}
Токен с правами записи

Изменить платеж.

Параметры пути

ПолеТипОбязательноОписание
id integer · int64 Да Поле id.

Тело запроса

application/json
Поля объектаTransaction
ПолеТипОбязательноОписание
transactionId integer · int64 Нет Поле transactionId.
clientId integer · int64 Нет Поле clientId.
expenditureId integer · int64 Нет идентификатор статьи расходов
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
direction stringDEBIT, CREDIT Нет тип операции
scheduleId integer · int64 Нет идентификатор расписания
comment string Нет Комментарий
contractorId integer · int64 Нет Идентификатор контрагента(организации)
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
recipientKpp integer · int64 Нет КПП получателя
recipientInn integer · int64 Нет ИНН получателя
recipientAccount string Нет Номер лицевого счета получателя
recipientName string Нет Нименование получателя
payerKpp integer · int64 Нет КПП плательщика
payerInn integer · int64 Нет ИНН плательщика
payerAccount string Нет Номер лицевого счета плательщика
payerName string Нет Нименование плательщика
kbk string Нет КБК
recipientAgentBik integer · int64 Нет БИК агента получателя
recipientAgentAccount string Нет Счет агента получателя
recipientAgentName string Нет Нименование агента получателя
payerAgentBik integer · int64 Нет БИК агента плательщика
payerAgentAccount string Нет Счет агента плательщика
payerAgentName string Нет Нименование агента плательщика
accountCurrency string Нет Валюта счета
paymentAmountRub number · double Нет Сумма в рублях
paymentAmount number · double Нет Сумма в валюте счета
paymentPurpose string Нет Цель платежа
paymentDocumentCode string Нет Код платежного документа
paymentDocumentNumber integer · int64 Нет Номер платежного документа
date string · date-time Нет Дата документа
accountId integer · int64 Нет Идентификатор счета в бд
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
organizationId integer · int64 Нет Поле organizationId.
deleted boolean Нет Признак поставлена на удаление или нет транзакция
includeInPnl boolean Нет Учитывать транзакцию в отчете P&L
incomeId integer · int64 Нет Идентификатор закупки.
expenditureOperationType stringWILDBERRIES_PAYMENT, OZON_PAYMENT, YANDEX_MARKET_PAYMENT, OTHER_INCOME, OTHER_EXPENSES, PAYMENT_TO_SUPPLIER, PURCHASE Нет Тип транзакции
isSuppliersPurchaseTransaction boolean Нет Идентификатор, если true, то требуется заполнить транзакцию как, пришедшую от взаиморасчетов поставщиков.
productId integer · int64 Нет Идентификатор товара
article string Нет Артикул товара
barcode string Нет ШК товара
curl --request PUT 'https://api.selsup.ru/api/finance/transaction/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "transactionId": 1001,
  "clientId": 1001,
  "expenditureId": 1001,
  "expenditure": "string",
  "direction": "DEBIT",
  "scheduleId": 1001
}'

Успешный ответ

200
Поля объекта Transaction
ПолеТипОбязательноОписание
transactionId integer · int64 Нет Поле transactionId.
clientId integer · int64 Нет Поле clientId.
expenditureId integer · int64 Нет идентификатор статьи расходов
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
direction stringDEBIT, CREDIT Нет тип операции
scheduleId integer · int64 Нет идентификатор расписания
comment string Нет Комментарий
contractorId integer · int64 Нет Идентификатор контрагента(организации)
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
recipientKpp integer · int64 Нет КПП получателя
recipientInn integer · int64 Нет ИНН получателя
recipientAccount string Нет Номер лицевого счета получателя
recipientName string Нет Нименование получателя
payerKpp integer · int64 Нет КПП плательщика
payerInn integer · int64 Нет ИНН плательщика
payerAccount string Нет Номер лицевого счета плательщика
payerName string Нет Нименование плательщика
kbk string Нет КБК
recipientAgentBik integer · int64 Нет БИК агента получателя
recipientAgentAccount string Нет Счет агента получателя
recipientAgentName string Нет Нименование агента получателя
payerAgentBik integer · int64 Нет БИК агента плательщика
payerAgentAccount string Нет Счет агента плательщика
payerAgentName string Нет Нименование агента плательщика
accountCurrency string Нет Валюта счета
paymentAmountRub number · double Нет Сумма в рублях
paymentAmount number · double Нет Сумма в валюте счета
paymentPurpose string Нет Цель платежа
paymentDocumentCode string Нет Код платежного документа
paymentDocumentNumber integer · int64 Нет Номер платежного документа
date string · date-time Нет Дата документа
accountId integer · int64 Нет Идентификатор счета в бд
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
organizationId integer · int64 Нет Поле organizationId.
deleted boolean Нет Признак поставлена на удаление или нет транзакция
includeInPnl boolean Нет Учитывать транзакцию в отчете P&L
incomeId integer · int64 Нет Идентификатор закупки.
expenditureOperationType stringWILDBERRIES_PAYMENT, OZON_PAYMENT, YANDEX_MARKET_PAYMENT, OTHER_INCOME, OTHER_EXPENSES, PAYMENT_TO_SUPPLIER, PURCHASE Нет Тип транзакции
isSuppliersPurchaseTransaction boolean Нет Идентификатор, если true, то требуется заполнить транзакцию как, пришедшую от взаиморасчетов поставщиков.
productId integer · int64 Нет Идентификатор товара
article string Нет Артикул товара
barcode string Нет ШК товара
{
  "transactionId": 1001,
  "clientId": 1001,
  "expenditureId": 1001,
  "expenditure": "string",
  "direction": "DEBIT",
  "scheduleId": 1001
}
Ошибки16

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_comment_max_length
Максимальная длина назначения платежа не больше 250 символов

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_comment_max_length; localMessage содержит приведённый выше перевод.

400error_contractor_not_found
Не найден поставщик

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_contractor_not_found; localMessage содержит приведённый выше перевод.

400error_date_not_found
дата не найдена

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_date_not_found; localMessage содержит приведённый выше перевод.

400error_empty_direction
Не указан тип платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_direction; localMessage содержит приведённый выше перевод.

400error_empty_sum
Не указана сумма

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_sum; localMessage содержит приведённый выше перевод.

400error_expenditure_type_not_found
Тип расхода не найден

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_expenditure_type_not_found; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_no_correct_sum
Некорректная сумма

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_correct_sum; localMessage содержит приведённый выше перевод.

400error_no_correct_sum_rub
Некорректная сумма в рублях

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_correct_sum_rub; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_product_not_found
Товар не найден

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_product_not_found; localMessage содержит приведённый выше перевод.

400error_transaction_id_not_found
ID транзакции не найден

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_transaction_id_not_found; localMessage содержит приведённый выше перевод.

400error_wrong_sum
Сумма должна быть положительным числом

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wrong_sum; localMessage содержит приведённый выше перевод.

POST

Изменить раписание платежа

/api/finance/updateSchedule
Токен с правами записи

Изменяет расписание платежей. Изменение не влияет на уже добавленные платежи этим расписанием

Тело запроса

application/json
Поля объектаTransactionSchedule
ПолеТипОбязательноОписание
scheduleId integer · int64 Нет Поле scheduleId.
direction stringDEBIT, CREDIT Нет Поле direction.
comment string Нет Поле comment.
accountId integer · int64 Нет Поле accountId.
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
date string · date-time Нет Поле date.
paymentAmount number · double Нет Поле paymentAmount.
frequency stringWEEK, MONTH, QUARTER, YEAR Нет Поле frequency.
contractorId integer · int64 Нет Поле contractorId.
expenditureId integer · int64 Нет Поле expenditureId.
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
creator string Нет Поле creator.
createdDate string · date-time Нет Поле createdDate.
contractorInn string Нет Поле contractorInn.
includeInPnl boolean Нет Поле includeInPnl.
curl --request POST 'https://api.selsup.ru/api/finance/updateSchedule' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduleId": 1001,
  "direction": "DEBIT",
  "comment": "string",
  "accountId": 1001,
  "account": "string",
  "date": "2026-01-15T12:00:00Z"
}'

Успешный ответ

200
Поля объекта TransactionSchedule
ПолеТипОбязательноОписание
scheduleId integer · int64 Нет Поле scheduleId.
direction stringDEBIT, CREDIT Нет Поле direction.
comment string Нет Поле comment.
accountId integer · int64 Нет Поле accountId.
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
date string · date-time Нет Поле date.
paymentAmount number · double Нет Поле paymentAmount.
frequency stringWEEK, MONTH, QUARTER, YEAR Нет Поле frequency.
contractorId integer · int64 Нет Поле contractorId.
expenditureId integer · int64 Нет Поле expenditureId.
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
creator string Нет Поле creator.
createdDate string · date-time Нет Поле createdDate.
contractorInn string Нет Поле contractorInn.
includeInPnl boolean Нет Поле includeInPnl.
{
  "scheduleId": 1001,
  "direction": "DEBIT",
  "comment": "string",
  "accountId": 1001,
  "account": "string",
  "date": "2026-01-15T12:00:00Z"
}
Ошибки13

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_comment_max_length
Максимальная длина назначения платежа не больше 250 символов

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_comment_max_length; localMessage содержит приведённый выше перевод.

400error_empty_direction
Не указан тип платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_direction; localMessage содержит приведённый выше перевод.

400error_empty_expenditure
Не указана статья расходов

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_expenditure; localMessage содержит приведённый выше перевод.

400error_empty_frequency
Не указана регулярность платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_frequency; localMessage содержит приведённый выше перевод.

400error_empty_sum
Не указана сумма

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_sum; localMessage содержит приведённый выше перевод.

400error_empty_transaction_comment
Не указано назначение платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_transaction_comment; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_wrong_date
Неверная дата

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wrong_date; localMessage содержит приведённый выше перевод.

400error_wrong_sum
Сумма должна быть положительным числом

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wrong_sum; localMessage содержит приведённый выше перевод.

POST

Изменить статью расходов

/api/finance/updateExpenditure
Токен с правами записи

Позволяет изменить статью расходов

Тело запроса

application/json
Поля объектаExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
curl --request POST 'https://api.selsup.ru/api/finance/updateExpenditure' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "expenditureId": 1001,
  "name": "Example",
  "type": "DEBIT",
  "clientId": 1001,
  "isCommon": false,
  "expenditureName": "Example"
}'

Успешный ответ

200
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
{
  "expenditureId": 1001,
  "name": "Example",
  "type": "DEBIT",
  "clientId": 1001,
  "isCommon": false,
  "expenditureName": "Example"
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_empty_direction
Не указан тип платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_direction; localMessage содержит приведённый выше перевод.

400error_empty_name
Не указано название

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_name; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_not_uniq_expenditure
Статья расходов, с таким названием, уже существует

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_not_uniq_expenditure; localMessage содержит приведённый выше перевод.

POST

Изменить счет

/api/finance/updateAccount
Токен с правами записи

Изменить счет.

Тело запроса

application/json
Поля объектаAccount
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
curl --request POST 'https://api.selsup.ru/api/finance/updateAccount' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "accountId": 1001,
  "name": "Example",
  "number": "string",
  "clientId": 1001,
  "organizationId": 1001,
  "bank": "string"
}'

Успешный ответ

200
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
{
  "accountId": 1001,
  "name": "Example",
  "number": "string",
  "clientId": 1001,
  "organizationId": 1001,
  "bank": "string"
}
Ошибки8

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_empty_account_name
Не указан название счета

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_account_name; localMessage содержит приведённый выше перевод.

400error_empty_account_number
пустой номер счёта

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_account_number; localMessage содержит приведённый выше перевод.

400error_empty_bank
Не указан банк

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_bank; localMessage содержит приведённый выше перевод.

400error_empty_organization
Не выбрана организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_organization; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

POST

Добавить платеж

/api/finance/transaction
Токен с правами записи

Добавить платеж.

Тело запроса

application/json
Поля объектаTransaction
ПолеТипОбязательноОписание
transactionId integer · int64 Нет Поле transactionId.
clientId integer · int64 Нет Поле clientId.
expenditureId integer · int64 Нет идентификатор статьи расходов
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
direction stringDEBIT, CREDIT Нет тип операции
scheduleId integer · int64 Нет идентификатор расписания
comment string Нет Комментарий
contractorId integer · int64 Нет Идентификатор контрагента(организации)
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
recipientKpp integer · int64 Нет КПП получателя
recipientInn integer · int64 Нет ИНН получателя
recipientAccount string Нет Номер лицевого счета получателя
recipientName string Нет Нименование получателя
payerKpp integer · int64 Нет КПП плательщика
payerInn integer · int64 Нет ИНН плательщика
payerAccount string Нет Номер лицевого счета плательщика
payerName string Нет Нименование плательщика
kbk string Нет КБК
recipientAgentBik integer · int64 Нет БИК агента получателя
recipientAgentAccount string Нет Счет агента получателя
recipientAgentName string Нет Нименование агента получателя
payerAgentBik integer · int64 Нет БИК агента плательщика
payerAgentAccount string Нет Счет агента плательщика
payerAgentName string Нет Нименование агента плательщика
accountCurrency string Нет Валюта счета
paymentAmountRub number · double Нет Сумма в рублях
paymentAmount number · double Нет Сумма в валюте счета
paymentPurpose string Нет Цель платежа
paymentDocumentCode string Нет Код платежного документа
paymentDocumentNumber integer · int64 Нет Номер платежного документа
date string · date-time Нет Дата документа
accountId integer · int64 Нет Идентификатор счета в бд
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
organizationId integer · int64 Нет Поле organizationId.
deleted boolean Нет Признак поставлена на удаление или нет транзакция
includeInPnl boolean Нет Учитывать транзакцию в отчете P&L
incomeId integer · int64 Нет Идентификатор закупки.
expenditureOperationType stringWILDBERRIES_PAYMENT, OZON_PAYMENT, YANDEX_MARKET_PAYMENT, OTHER_INCOME, OTHER_EXPENSES, PAYMENT_TO_SUPPLIER, PURCHASE Нет Тип транзакции
isSuppliersPurchaseTransaction boolean Нет Идентификатор, если true, то требуется заполнить транзакцию как, пришедшую от взаиморасчетов поставщиков.
productId integer · int64 Нет Идентификатор товара
article string Нет Артикул товара
barcode string Нет ШК товара
curl --request POST 'https://api.selsup.ru/api/finance/transaction' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "transactionId": 1001,
  "clientId": 1001,
  "expenditureId": 1001,
  "expenditure": "string",
  "direction": "DEBIT",
  "scheduleId": 1001
}'

Успешный ответ

200
Поля объекта Transaction
ПолеТипОбязательноОписание
transactionId integer · int64 Нет Поле transactionId.
clientId integer · int64 Нет Поле clientId.
expenditureId integer · int64 Нет идентификатор статьи расходов
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
direction stringDEBIT, CREDIT Нет тип операции
scheduleId integer · int64 Нет идентификатор расписания
comment string Нет Комментарий
contractorId integer · int64 Нет Идентификатор контрагента(организации)
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
recipientKpp integer · int64 Нет КПП получателя
recipientInn integer · int64 Нет ИНН получателя
recipientAccount string Нет Номер лицевого счета получателя
recipientName string Нет Нименование получателя
payerKpp integer · int64 Нет КПП плательщика
payerInn integer · int64 Нет ИНН плательщика
payerAccount string Нет Номер лицевого счета плательщика
payerName string Нет Нименование плательщика
kbk string Нет КБК
recipientAgentBik integer · int64 Нет БИК агента получателя
recipientAgentAccount string Нет Счет агента получателя
recipientAgentName string Нет Нименование агента получателя
payerAgentBik integer · int64 Нет БИК агента плательщика
payerAgentAccount string Нет Счет агента плательщика
payerAgentName string Нет Нименование агента плательщика
accountCurrency string Нет Валюта счета
paymentAmountRub number · double Нет Сумма в рублях
paymentAmount number · double Нет Сумма в валюте счета
paymentPurpose string Нет Цель платежа
paymentDocumentCode string Нет Код платежного документа
paymentDocumentNumber integer · int64 Нет Номер платежного документа
date string · date-time Нет Дата документа
accountId integer · int64 Нет Идентификатор счета в бд
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
organizationId integer · int64 Нет Поле organizationId.
deleted boolean Нет Признак поставлена на удаление или нет транзакция
includeInPnl boolean Нет Учитывать транзакцию в отчете P&L
incomeId integer · int64 Нет Идентификатор закупки.
expenditureOperationType stringWILDBERRIES_PAYMENT, OZON_PAYMENT, YANDEX_MARKET_PAYMENT, OTHER_INCOME, OTHER_EXPENSES, PAYMENT_TO_SUPPLIER, PURCHASE Нет Тип транзакции
isSuppliersPurchaseTransaction boolean Нет Идентификатор, если true, то требуется заполнить транзакцию как, пришедшую от взаиморасчетов поставщиков.
productId integer · int64 Нет Идентификатор товара
article string Нет Артикул товара
barcode string Нет ШК товара
{
  "transactionId": 1001,
  "clientId": 1001,
  "expenditureId": 1001,
  "expenditure": "string",
  "direction": "DEBIT",
  "scheduleId": 1001
}
Ошибки12

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_comment_max_length
Максимальная длина назначения платежа не больше 250 символов

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_comment_max_length; localMessage содержит приведённый выше перевод.

400error_empty_direction
Не указан тип платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_direction; localMessage содержит приведённый выше перевод.

400error_empty_sum
Не указана сумма

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_sum; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_no_correct_sum
Некорректная сумма

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_correct_sum; localMessage содержит приведённый выше перевод.

400error_no_correct_sum_rub
Некорректная сумма в рублях

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_correct_sum_rub; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_product_not_found
Товар не найден

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_product_not_found; localMessage содержит приведённый выше перевод.

400error_wrong_sum
Сумма должна быть положительным числом

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wrong_sum; localMessage содержит приведённый выше перевод.

DELETE

Удалить платежи

/api/finance/transaction
Токен с правами записи

Удалить платежи.

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

ПолеТипОбязательноОписание
id integer[] Да Поле id.
curl --request DELETE 'https://api.selsup.ru/api/finance/transaction?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

POST

Удалить расписание платежей

/api/finance/removeSchedule
Токен с правами записи

Позволяет удалить расписание платежей. Удаление не влияет на уже добавленные платежи этим расписанием

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

ПолеТипОбязательноОписание
scheduleId integer · int64 Да Поле scheduleId.
curl --request POST 'https://api.selsup.ru/api/finance/removeSchedule?scheduleId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

POST

Удалить статью расходов

/api/finance/removeExpenditure
Токен с правами записи

Позволяет удалить свою статью расходов

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

ПолеТипОбязательноОписание
expenditureId integer · int64 Да Поле expenditureId.
curl --request POST 'https://api.selsup.ru/api/finance/removeExpenditure?expenditureId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_can`t_remove_object_of_expenditure
Нельзя удалить использующуюся статью

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_can`t_remove_object_of_expenditure; localMessage содержит приведённый выше перевод.

400error_expenditure_not_has_been_remove
Данную статью расходов удалить нельзя

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_expenditure_not_has_been_remove; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

POST

Удалить счет

/api/finance/removeAccount
Токен с правами записи

Удалить счет.

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

ПолеТипОбязательноОписание
accountId integer · int64 Да Поле accountId.
curl --request POST 'https://api.selsup.ru/api/finance/removeAccount?accountId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

POST

Импорт транзакий из банков клиента по указанным счетам

/api/finance/importTransactions
Токен с правами записи

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

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

ПолеТипОбязательноОписание
accountId integer · int64 Да Поле accountId.
startDate string Нет Поле startDate.
curl --request POST 'https://api.selsup.ru/api/finance/importTransactions?accountId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта TmsTask
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор задачи
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Нет Текущий статус задачи
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Нет Тип задачи
name string Нет Данные задачи в json - могут быть пустыми
clientId integer · int64 Нет Поле clientId.
entityId integer · int64 Нет Сущность, к которой относится задача
progress integer · int32 Нет Прогресс выполнения задачи в процентах
processedQuantity integer · int32 Нет Количество обработанных записей задачи
organizationId integer · int64 Нет Организация задачи, может быть 0, если не зависит от организации
priority integer · int32 Нет Приоритет задачи - чем выше тем быстрее задача запустится
properties string Нет Параметры задачи
message string Нет Сообщение с результатом выполнения задачи
messageParams string Нет Параметры сообщения с результатом выполнения задачи
createdDate string · date-time Нет Дата добавления задачи в очередь
startDate string · date-time Нет Дата запуска задачи
finishDate string · date-time Нет Дата завершения задачи
url string Нет Ссылка на скачивание файла с результатом задачи
inputFileUrl string Нет Ссылка на загруженный файл
retryNumber integer · int32 Нет Счётчик перезапуска задачи.
userId integer · int32 Нет Пользователь запустивший задачу
retryDate string · date-time Нет Запланированная дата перезапуска
debug boolean Нет Запуск задачи в режиме отладки с большим логированием
forcedStart boolean Нет Ручной запуск задачи
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Импорт платежей из Excel файл

/api/finance/importTransactionFromExcelFile
Токен с правами записи

Метод ставит задачу по импорту платежей из Excel файла.

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

ПолеТипОбязательноОписание
clientOrganizationId integer · int64 Да Поле clientOrganizationId.

Тело запроса

multipart/form-data
ПолеТипОбязательноОписание
file string · binary Да Поле file.
curl --request POST 'https://api.selsup.ru/api/finance/importTransactionFromExcelFile?clientOrganizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

Успешный ответ

200
Поля объекта TmsTask
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор задачи
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Нет Текущий статус задачи
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Нет Тип задачи
name string Нет Данные задачи в json - могут быть пустыми
clientId integer · int64 Нет Поле clientId.
entityId integer · int64 Нет Сущность, к которой относится задача
progress integer · int32 Нет Прогресс выполнения задачи в процентах
processedQuantity integer · int32 Нет Количество обработанных записей задачи
organizationId integer · int64 Нет Организация задачи, может быть 0, если не зависит от организации
priority integer · int32 Нет Приоритет задачи - чем выше тем быстрее задача запустится
properties string Нет Параметры задачи
message string Нет Сообщение с результатом выполнения задачи
messageParams string Нет Параметры сообщения с результатом выполнения задачи
createdDate string · date-time Нет Дата добавления задачи в очередь
startDate string · date-time Нет Дата запуска задачи
finishDate string · date-time Нет Дата завершения задачи
url string Нет Ссылка на скачивание файла с результатом задачи
inputFileUrl string Нет Ссылка на загруженный файл
retryNumber integer · int32 Нет Счётчик перезапуска задачи.
userId integer · int32 Нет Пользователь запустивший задачу
retryDate string · date-time Нет Запланированная дата перезапуска
debug boolean Нет Запуск задачи в режиме отладки с большим логированием
forcedStart boolean Нет Ручной запуск задачи
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_file_is_empty
Загруженный файл пуст

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_file_is_empty; localMessage содержит приведённый выше перевод.

400error_max_upload_size_exceeded
Допустимый размер файла превышен

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_max_upload_size_exceeded; localMessage содержит приведённый выше перевод.

400error_wrong_excel
Некорректный формат Excel файла

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wrong_excel; localMessage содержит приведённый выше перевод.

POST

Получить счета в банках

/api/finance/getAccountList
Токен с правами записи

Позволяет получить список всех счетов в банках

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

ПолеТипОбязательноОписание
bank stringSBER, TOCHKA, TBANK, ALFA_BANK Да Поле bank.
curl --request POST 'https://api.selsup.ru/api/finance/getAccountList?bank=SBER' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива Account[]
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
[
  "string"
]
Ошибки12

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_bank_integration
Нет интеграции с банком

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_bank_integration; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_remote_error
{message}

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_remote_error; localMessage содержит приведённый выше перевод.

400error_sberbank_api
Ошибка Сбербанка: {message}

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_sberbank_api; localMessage содержит приведённый выше перевод.

400error_service_not_supported
Сервис не поддерживается

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_service_not_supported; localMessage содержит приведённый выше перевод.

400error_tbank
ошибка интеграции с T-Bank Business

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_tbank; localMessage содержит приведённый выше перевод.

400error_tbank_request
ошибка запроса к T-Bank Business

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_tbank_request; localMessage содержит приведённый выше перевод.

400error_tochka_request
ошибка запроса к Точке

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_tochka_request; localMessage содержит приведённый выше перевод.

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_token_expired_or_revoked; localMessage содержит приведённый выше перевод.

POST

Добавить раписание платежей

/api/finance/addSchedule
Токен с правами записи

Добавляет регулярные платежи, которые добавляются по расписанию

Тело запроса

application/json
Поля объектаTransactionSchedule
ПолеТипОбязательноОписание
scheduleId integer · int64 Нет Поле scheduleId.
direction stringDEBIT, CREDIT Нет Поле direction.
comment string Нет Поле comment.
accountId integer · int64 Нет Поле accountId.
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
date string · date-time Нет Поле date.
paymentAmount number · double Нет Поле paymentAmount.
frequency stringWEEK, MONTH, QUARTER, YEAR Нет Поле frequency.
contractorId integer · int64 Нет Поле contractorId.
expenditureId integer · int64 Нет Поле expenditureId.
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
creator string Нет Поле creator.
createdDate string · date-time Нет Поле createdDate.
contractorInn string Нет Поле contractorInn.
includeInPnl boolean Нет Поле includeInPnl.
curl --request POST 'https://api.selsup.ru/api/finance/addSchedule' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduleId": 1001,
  "direction": "DEBIT",
  "comment": "string",
  "accountId": 1001,
  "account": "string",
  "date": "2026-01-15T12:00:00Z"
}'

Успешный ответ

200
Поля объекта TransactionSchedule
ПолеТипОбязательноОписание
scheduleId integer · int64 Нет Поле scheduleId.
direction stringDEBIT, CREDIT Нет Поле direction.
comment string Нет Поле comment.
accountId integer · int64 Нет Поле accountId.
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
date string · date-time Нет Поле date.
paymentAmount number · double Нет Поле paymentAmount.
frequency stringWEEK, MONTH, QUARTER, YEAR Нет Поле frequency.
contractorId integer · int64 Нет Поле contractorId.
expenditureId integer · int64 Нет Поле expenditureId.
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
creator string Нет Поле creator.
createdDate string · date-time Нет Поле createdDate.
contractorInn string Нет Поле contractorInn.
includeInPnl boolean Нет Поле includeInPnl.
{
  "scheduleId": 1001,
  "direction": "DEBIT",
  "comment": "string",
  "accountId": 1001,
  "account": "string",
  "date": "2026-01-15T12:00:00Z"
}
Ошибки16

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_comment_max_length
Максимальная длина назначения платежа не больше 250 символов

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_comment_max_length; localMessage содержит приведённый выше перевод.

400error_empty_direction
Не указан тип платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_direction; localMessage содержит приведённый выше перевод.

400error_empty_expenditure
Не указана статья расходов

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_expenditure; localMessage содержит приведённый выше перевод.

400error_empty_frequency
Не указана регулярность платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_frequency; localMessage содержит приведённый выше перевод.

400error_empty_sum
Не указана сумма

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_sum; localMessage содержит приведённый выше перевод.

400error_empty_transaction_comment
Не указано назначение платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_transaction_comment; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_no_correct_sum
Некорректная сумма

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_correct_sum; localMessage содержит приведённый выше перевод.

400error_no_correct_sum_rub
Некорректная сумма в рублях

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_correct_sum_rub; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_wrong_date
Неверная дата

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wrong_date; localMessage содержит приведённый выше перевод.

400error_wrong_sum
Сумма должна быть положительным числом

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wrong_sum; localMessage содержит приведённый выше перевод.

POST

Добавить статью расходов

/api/finance/addExpenditure
Токен с правами записи

Позволяет добавить свою статью расходов

Тело запроса

application/json
Поля объектаExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
curl --request POST 'https://api.selsup.ru/api/finance/addExpenditure' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "expenditureId": 1001,
  "name": "Example",
  "type": "DEBIT",
  "clientId": 1001,
  "isCommon": false,
  "expenditureName": "Example"
}'

Успешный ответ

200
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
{
  "expenditureId": 1001,
  "name": "Example",
  "type": "DEBIT",
  "clientId": 1001,
  "isCommon": false,
  "expenditureName": "Example"
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_empty_direction
Не указан тип платежа

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_direction; localMessage содержит приведённый выше перевод.

400error_empty_name
Не указано название

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_name; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_not_uniq_expenditure
Статья расходов, с таким названием, уже существует

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_not_uniq_expenditure; localMessage содержит приведённый выше перевод.

POST

Добавить счет

/api/finance/addAccount
Токен с правами записи

Добавить счет.

Тело запроса

application/json
Поля объектаAccount
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
curl --request POST 'https://api.selsup.ru/api/finance/addAccount' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "accountId": 1001,
  "name": "Example",
  "number": "string",
  "clientId": 1001,
  "organizationId": 1001,
  "bank": "string"
}'

Успешный ответ

200
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
{
  "accountId": 1001,
  "name": "Example",
  "number": "string",
  "clientId": 1001,
  "organizationId": 1001,
  "bank": "string"
}
Ошибки9

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_empty_account_name
Не указан название счета

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_account_name; localMessage содержит приведённый выше перевод.

400error_empty_account_number
пустой номер счёта

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_account_number; localMessage содержит приведённый выше перевод.

400error_empty_bank
Не указан банк

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_bank; localMessage содержит приведённый выше перевод.

400error_empty_organization
Не выбрана организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_organization; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

GET

Скачивание шаблона Excel файла для импорта платежей

/api/finance/transaction/template
Токен с правами чтения

Метод возвращает шаблон Excel файла, необходимый для импорта платежей.

curl --request GET 'https://api.selsup.ru/api/finance/transaction/template' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
"string"
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Структура платежей за текущий и предыдущий периоды

/api/finance/transaction/structure
Токен с правами чтения

Возвращает список платежей за текущий и (опционально) предыдущий периоды по фильтру

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

ПолеТипОбязательноОписание
filter TransactionFilter Да Поле filter.
Поля объекта TransactionFilter
ПолеТипОбязательноОписание
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
query string Нет Поисковый запрос для платежей
dateFrom string · date-time Нет Фильтр по дате операции - от
dateTo string · date-time Нет Фильтр по дате операции - до
organizationId integer · int64 Нет Идентификатор организации. (Теперь используем organizationIds)
organizationIds integer[] Нет Идентификаторы организаций
services string[] Нет Идентификатор сервисов
direction stringDEBIT, CREDIT Нет Идентификатор расход/доход
incomeId integer · int64 Нет Идентификатор транзакции
contractorId integer · int64 Нет Идентификатор контрагента
timeZone integer · int32 Нет Часовой пояс клиента по UTC
showIncomes boolean Нет Включать взаиморасчеты с поставщиками
accountId integer · int64 Нет Поле accountId.
includePreviousPeriodПо умолчанию: false boolean Нет Поле includePreviousPeriod.
curl --request GET 'https://api.selsup.ru/api/finance/transaction/structure?filter=%5Bobject+Object%5D' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта TransactionStructureResponse
ПолеТипОбязательноОписание
currentPeriod PeriodTransactionResponse Да Данные за текущий период
Поля объекта PeriodTransactionResponse
ПолеТипОбязательноОписание
startDate string · date-time Да Дата начала периода (в формате ISO 8601)
endDate string · date-time Да Дата окончания периода (в формате ISO 8601)
transactions TransactionStructure[] Да Список транзакций за период
Структура элемента массива TransactionStructure
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
direction stringDEBIT, CREDIT Да Направление транзакции (доход или расход)
totalCost number · double Нет Суммарная стоимость всех транзакций за период
percentDiff number · double Нет Процентное изменение общей суммы (используется только для разницы)
previousPeriod PeriodTransactionResponse Нет Данные за предыдущий период. Может быть null, если предыдущий период не запрошен
Поля объекта PeriodTransactionResponse
ПолеТипОбязательноОписание
startDate string · date-time Да Дата начала периода (в формате ISO 8601)
endDate string · date-time Да Дата окончания периода (в формате ISO 8601)
transactions TransactionStructure[] Да Список транзакций за период
Структура элемента массива TransactionStructure
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
direction stringDEBIT, CREDIT Да Направление транзакции (доход или расход)
totalCost number · double Нет Суммарная стоимость всех транзакций за период
percentDiff number · double Нет Процентное изменение общей суммы (используется только для разницы)
difference PeriodTransactionResponse Нет Разница между текущим и предыдущим периодами. Может быть null, если предыдущий период не запрошен
Поля объекта PeriodTransactionResponse
ПолеТипОбязательноОписание
startDate string · date-time Да Дата начала периода (в формате ISO 8601)
endDate string · date-time Да Дата окончания периода (в формате ISO 8601)
transactions TransactionStructure[] Да Список транзакций за период
Структура элемента массива TransactionStructure
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
direction stringDEBIT, CREDIT Да Направление транзакции (доход или расход)
totalCost number · double Нет Суммарная стоимость всех транзакций за период
percentDiff number · double Нет Процентное изменение общей суммы (используется только для разницы)
{
  "currentPeriod": "string",
  "previousPeriod": "string",
  "difference": "string"
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск платежей

/api/finance/transaction/find
Токен с правами чтения

Возвращает список платежей по фильтру

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

ПолеТипОбязательноОписание
filter TransactionFilter Да Поле filter.
Поля объекта TransactionFilter
ПолеТипОбязательноОписание
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
query string Нет Поисковый запрос для платежей
dateFrom string · date-time Нет Фильтр по дате операции - от
dateTo string · date-time Нет Фильтр по дате операции - до
organizationId integer · int64 Нет Идентификатор организации. (Теперь используем organizationIds)
organizationIds integer[] Нет Идентификаторы организаций
services string[] Нет Идентификатор сервисов
direction stringDEBIT, CREDIT Нет Идентификатор расход/доход
incomeId integer · int64 Нет Идентификатор транзакции
contractorId integer · int64 Нет Идентификатор контрагента
timeZone integer · int32 Нет Часовой пояс клиента по UTC
showIncomes boolean Нет Включать взаиморасчеты с поставщиками
accountId integer · int64 Нет Поле accountId.
curl --request GET 'https://api.selsup.ru/api/finance/transaction/find?filter=%5Bobject+Object%5D' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта FindResponseTransaction
ПолеТипОбязательноОписание
rows Transaction[] Нет Строки с результатом поиска
Структура элемента массива Transaction
ПолеТипОбязательноОписание
transactionId integer · int64 Нет Поле transactionId.
clientId integer · int64 Нет Поле clientId.
expenditureId integer · int64 Нет идентификатор статьи расходов
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
direction stringDEBIT, CREDIT Нет тип операции
scheduleId integer · int64 Нет идентификатор расписания
comment string Нет Комментарий
contractorId integer · int64 Нет Идентификатор контрагента(организации)
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
recipientKpp integer · int64 Нет КПП получателя
recipientInn integer · int64 Нет ИНН получателя
recipientAccount string Нет Номер лицевого счета получателя
recipientName string Нет Нименование получателя
payerKpp integer · int64 Нет КПП плательщика
payerInn integer · int64 Нет ИНН плательщика
payerAccount string Нет Номер лицевого счета плательщика
payerName string Нет Нименование плательщика
kbk string Нет КБК
recipientAgentBik integer · int64 Нет БИК агента получателя
recipientAgentAccount string Нет Счет агента получателя
recipientAgentName string Нет Нименование агента получателя
payerAgentBik integer · int64 Нет БИК агента плательщика
payerAgentAccount string Нет Счет агента плательщика
payerAgentName string Нет Нименование агента плательщика
accountCurrency string Нет Валюта счета
paymentAmountRub number · double Нет Сумма в рублях
paymentAmount number · double Нет Сумма в валюте счета
paymentPurpose string Нет Цель платежа
paymentDocumentCode string Нет Код платежного документа
paymentDocumentNumber integer · int64 Нет Номер платежного документа
date string · date-time Нет Дата документа
accountId integer · int64 Нет Идентификатор счета в бд
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
organizationId integer · int64 Нет Поле organizationId.
deleted boolean Нет Признак поставлена на удаление или нет транзакция
includeInPnl boolean Нет Учитывать транзакцию в отчете P&L
incomeId integer · int64 Нет Идентификатор закупки.
expenditureOperationType stringWILDBERRIES_PAYMENT, OZON_PAYMENT, YANDEX_MARKET_PAYMENT, OTHER_INCOME, OTHER_EXPENSES, PAYMENT_TO_SUPPLIER, PURCHASE Нет Тип транзакции
isSuppliersPurchaseTransaction boolean Нет Идентификатор, если true, то требуется заполнить транзакцию как, пришедшую от взаиморасчетов поставщиков.
productId integer · int64 Нет Идентификатор товара
article string Нет Артикул товара
barcode string Нет ШК товара
{
  "rows": "string"
}
Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_max_page
Номер страницы не может быть больше 100 000

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_max_page; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Структура платежей

/api/finance/getTransactionStructureByDirection
Токен с правами чтения

Возвращает список платежей по фильтру

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

ПолеТипОбязательноОписание
query string Нет Поисковый запрос для платежей
dateFrom string · date-time Нет Фильтр по дате операции - от
dateTo string · date-time Нет Фильтр по дате операции - до
organizationId integer · int64 Нет Идентификатор организации. (Теперь используем organizationIds)
organizationIds integer[] Нет Идентификаторы организаций
services string[] Нет Идентификатор сервисов
direction stringDEBIT, CREDIT Нет Идентификатор расход/доход
incomeId integer · int64 Нет Идентификатор транзакции
contractorId integer · int64 Нет Идентификатор контрагента
timeZone integer · int32 Нет Часовой пояс клиента по UTC
showIncomes boolean Нет Включать взаиморасчеты с поставщиками
accountId integer · int64 Нет Поле accountId.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/finance/getTransactionStructureByDirection?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива TransactionStructure[]
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
direction stringDEBIT, CREDIT Да Направление транзакции (доход или расход)
[
  "string"
]
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_direction_cant_find
направление не найдено

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_direction_cant_find; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Получить список счетов

/api/finance/getAccounts
Токен с правами чтения

Получить список счетов.

curl --request GET 'https://api.selsup.ru/api/finance/getAccounts' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива Account[]
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
[
  "string"
]
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Получить счет по идентификатору

/api/finance/getAccountById
Токен с правами чтения

Получить счет по идентификатору.

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

ПолеТипОбязательноОписание
id integer · int64 Да Поле id.
curl --request GET 'https://api.selsup.ru/api/finance/getAccountById?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
Поля объекта Bank
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
{
  "accountId": 1001,
  "name": "Example",
  "number": "string",
  "clientId": 1001,
  "organizationId": 1001,
  "bank": "string"
}
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Поиск регулярных платежей

/api/finance/findSchedule
Токен с правами чтения

Позволяет найти регулярные платежи, которые по расписанию добавляют обычные платежи

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

ПолеТипОбязательноОписание
filter TransactionSchedulerFilter Да Поле filter.
Поля объекта TransactionSchedulerFilter
ПолеТипОбязательноОписание
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
query string Нет Поле query.
curl --request GET 'https://api.selsup.ru/api/finance/findSchedule?filter=%5Bobject+Object%5D' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта FindResponseTransactionSchedule
ПолеТипОбязательноОписание
rows TransactionSchedule[] Нет Строки с результатом поиска
Структура элемента массива TransactionSchedule
ПолеТипОбязательноОписание
scheduleId integer · int64 Нет Поле scheduleId.
direction stringDEBIT, CREDIT Нет Поле direction.
comment string Нет Поле comment.
accountId integer · int64 Нет Поле accountId.
account Account Нет Поле account.
Поля объекта Account
ПолеТипОбязательноОписание
accountId integer · int64 Нет Поле accountId.
name string Нет Поле name.
number string Нет Поле number.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
bank Bank Нет Поле bank.
accountNumber Account Нет Поле accountNumber.
accountName Account Нет Поле accountName.
date string · date-time Нет Поле date.
paymentAmount number · double Нет Поле paymentAmount.
frequency stringWEEK, MONTH, QUARTER, YEAR Нет Поле frequency.
contractorId integer · int64 Нет Поле contractorId.
expenditureId integer · int64 Нет Поле expenditureId.
expenditure ExpenditureObject Нет Поле expenditure.
Поля объекта ExpenditureObject
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
contractor Contractor Нет Поле contractor.
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Поле organizationId.
creator string Нет Поле creator.
createdDate string · date-time Нет Поле createdDate.
contractorInn string Нет Поле contractorInn.
includeInPnl boolean Нет Поле includeInPnl.
{
  "rows": "string"
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Получить список статей расходов

/api/finance/fetchExpenditure
Токен с правами чтения

Получить список статей расходов.

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

ПолеТипОбязательноОписание
query string Да Поле query.
direction stringDEBIT, CREDIT Нет Поле direction.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/finance/fetchExpenditure?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива ExpenditureObject[]
ПолеТипОбязательноОписание
expenditureId integer · int64 Нет Поле expenditureId.
name string Нет Поле name.
type stringDEBIT, CREDIT Нет Поле type.
clientId integer · int64 Нет Поле clientId.
isCommon boolean Нет Поле isCommon.
expenditureName ExpenditureObject Нет Поле expenditureName.
expenditureType ExpenditureObject Нет Поле expenditureType.
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск банков

/api/finance/fetchBank
Токен с правами чтения

Производит поиск банков по БИК, названию

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

ПолеТипОбязательноОписание
query string Нет Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/finance/fetchBank?limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива Bank[]
ПолеТипОбязательноОписание
bik string Нет Поле bik.
name string Нет Поле name.
address string Нет Поле address.
isBank boolean Нет Поле isBank.
account string Нет Поле account.
integration stringSBER, TOCHKA, TBANK, ALFA_BANK Нет Поле integration.
bankBik Bank Нет Поле bankBik.
bankName Bank Нет Поле bankName.
bankAddress Bank Нет Поле bankAddress.
bankAccount Bank Нет Поле bankAccount.
bankIntegration Bank Нет Поле bankIntegration.
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Экспорт платежей в Excel файл

/api/finance/exportTransactionInExcelFile
Токен с правами чтения

Метод ставит задачу по экспорту платежей в файл.

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

ПолеТипОбязательноОписание
request AnalyticsRequest Да Поле request.
Поля объекта AnalyticsRequest
ПолеТипОбязательноОписание
period stringDAY, WEEK, MONTH, QUARTER, YEAR, MONTH_3, MONTH_6, END_OF_TARIFF, MONTH_7, MONTH_14, YEAR_2 Нет Период агрегации
dateFrom string · date-time Да Дата начала отчета
dateTo string · date-time Да Дата окончания отчета
services string[] Нет Список маркетплейсов для которых отдать данные
categories integer[] Нет Фильтр категорий для которых отдать данные
brands integer[] Нет Фильтр брендов для которых отдать данные
clientOrganizationId integer · int64 Нет Идентификатор организации, для которой отдать данные
organizations integer[] Нет Идентификаторы организаций клиента
ids integer[] Нет Список идентификаторов
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа
types string[] Нет Типы заказа
status stringCREATED, REVOKING, REVOKED, ORDER_CREATED, CARDS_CREATED, BOX_BARCODES, IMAGES_UPLOADED, INVOICE_UPLOADED, READY_TO_SUPPLY, SUPPLIED, FINISHED, COLLECTED, SEND, DELIVERY, REFUND, COLLECTING, PACKING, PAYMENT_REQUIRED, CANCELED, CONTROVERSIAL, OVERDUE, READY_FOR_PICKUP, WAITING_SUPPLY, PICK_UP_REFUND, REFUND_RECEIVED, DELETED, RESTORE, PRODUCTION_CONFIRMED Нет Фильтр по статусу заказа
timeZone integer · int32 Нет Часовой пояс клиента по UTC
previousDateFrom string · date-time Нет Дата начала периода для сравнения
clientOrganizationIds integer[] Нет Идентификаторы организаций, для которых отдать данные
ignoreCredit boolean Нет Не учитывать кредит в прочих удержаниях
productAnalyticField stringBARCODE, COLOR, ARTICLE, BRAND, CATEGORY Да Агрегировать данные по сущности
query string Нет Поисковый запрос для фильтрации аналитики
withDuplicate boolean Нет Отдавать аналитику по дубликатам товаров
withBonus boolean Нет Вычитать бонусы Ozon и Яндекс Маркета, а также СПП Wildberries из выручки и расходов
byOrgAndService boolean Нет Для Excel финансового отчёта: true — колонки по паре организация + маркетплейс, false/null — агрегировать по организации как раньше
byOrderType boolean Нет Разбивать финансовый отчёт по типу заказа: отдельные строки для маркетплейсов, розницы и опта
limit integer · int32 Нет Количество записей в ответе
page integer · int32 Нет Страница для навигации по страницам, начиная с 1
sortBy string Нет Поле сортировки
ascending boolean Нет Сортировать по возрастанию по полю sortBy
id integer · int64 Нет Поле id.
isMarketPlaceStructure boolean Нет Идентификатор, получать данные только по маркетплейсу или по всем.
isDashboard boolean Нет Идентификатор, запрос с дашборда или нет.
analyticsField stringPRODUCT, MODEL, GROUP, ORGANIZATION, CLIENT, CATEGORY, PRODUCT_VIEW, BRAND, REGION, WAREHOUSE Нет Агрегировать данные по model/product/view
planDayCount integer · int32 Нет Кол-во дней для отчетов
daysToSupply integer · int32 Нет Через сколько дней ожидается поставка
plannedSupplyDate string · date-time Нет Планируемая дата поставки
groupByView boolean Нет Сгруппировать по цвету
warehouses integer[] Нет Список идентификаторов складов
salesModels string[] Нет Модели продаж для отчёта экономики складов
aggregation stringWAREHOUSE, WAREHOUSE_PRODUCT Нет Уровень агрегации отчёта экономики складов
columns FileExportColumn[] Нет Настроенные пользователем колонки Excel
Структура элемента массива FileExportColumn
ПолеТипОбязательноОписание
id integer · int64 Нет ID записи
fileExportId integer · int64 Нет ID конфигурации экспорта
columnName string Нет Название столбца
columnOrder integer · int32 Нет Порядок столбца в файле
isEnabled boolean Нет Включен ли столбец для экспорта
regions string[] Нет Список регионов
group boolean Нет Сгруппировать данные
calculationByOrders boolean Нет Делать расчет по заказанному количеству
sourceReport stringDEFAULT, ORDER, SALES, PROFIT, OZON, YANDEX_MARKET, WB_REALIZATION_FILE, WB_DETAILED_REPORT_FILE, OZON_REALIZATION_FILE, OZON_REALIZATION_FILE_NEW, OZON_COMPENSATIONS_FILE, OZON_SERVICES_FILE, OZON_CASH_FLOW_STATEMENT, WB_CAMPAIGN, SBER_MEGA_MARKET_FILES, YANDEX_MARKET_FILE_DETAILS, WB_RETURNS_REPORT, OWN_DELIVERY, OZON_CAMPAIGN_SKU_REPORT, WB_PAID_STORAGE, YANDEX_MARKET_NETTING, OZON_CPO_SKU_REPORT, UZUM, UZUM_EXPENSES, DEFECT_WRITE_OFF, LOCAL_ORDER, EXTERNAL_CAMPAIGN Нет Операция по которой выводить данные
skipDayWithoutStocks boolean Нет Пропускать дни без остатков
replaceSetsByComponents boolean Нет Раскрывать комплекты по компонентам
distributeFbsByWarehouse boolean Нет Распределять FBS по складам пропорционально FBO
distributeFbsStock boolean Нет Распределять остатки FBS между маркетплейсами/складами
ignoreDumping boolean Нет Игнорировать слив товара (продажи по заниженной цене)
isSaleStructure boolean Нет Идентификатор, что нужно получить структуру по продажам
isAveragePerOneUnit boolean Нет Идентификатор, получить среднее за 1 единицу
updateDate boolean Нет Обновлять даты
useWeightedGroup boolean Нет Использовать группы по весу
isFindirRequest boolean Нет Является ли запрос - запросом для Задачника
brandIds integer[] Нет Фильтр по идентификаторам брендов (список)
categoryIds integer[] Нет Фильтр по идентификаторам категорий (список)
articles string[] Нет Фильтр по артикулу (список)
colors string[] Нет Фильтр по цвету (список)
sizes string[] Нет Фильтр по размеру (список)
barcodes string[] Нет Фильтр по штрих-коду (список)
tagIds integer[] Нет Фильтр по идентификаторам тегов товаров (список)
penaltyFrom number · double Нет Фильтр по штрафам (от)
penaltyTo number · double Нет Фильтр по штрафам (до)
logisticsFrom number · double Нет Фильтр по логистике (от)
logisticsTo number · double Нет Фильтр по логистике (до)
marginFrom number · double Нет Фильтр по маржинальности (от)
marginTo number · double Нет Фильтр по маржинальности (до)
salesAmountFrom number · double Нет Фильтр по сумме продаж (от)
salesAmountTo number · double Нет Фильтр по сумме продаж (до)
totalSalesAmountFrom number · double Нет Фильтр по выручке (от)
totalSalesAmountTo number · double Нет Фильтр по выручке (до)
grossProfitFrom number · double Нет Фильтр по валовой прибыли (от)
grossProfitTo number · double Нет Фильтр по валовой прибыли (до)
taxNds integer · int32 Нет Налог ндс
useOsno boolean Нет Тип налогообложения осно
unmatch boolean Нет Поле unmatch.
curl --request GET 'https://api.selsup.ru/api/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта TmsTask
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор задачи
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Нет Текущий статус задачи
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Нет Тип задачи
name string Нет Данные задачи в json - могут быть пустыми
clientId integer · int64 Нет Поле clientId.
entityId integer · int64 Нет Сущность, к которой относится задача
progress integer · int32 Нет Прогресс выполнения задачи в процентах
processedQuantity integer · int32 Нет Количество обработанных записей задачи
organizationId integer · int64 Нет Организация задачи, может быть 0, если не зависит от организации
priority integer · int32 Нет Приоритет задачи - чем выше тем быстрее задача запустится
properties string Нет Параметры задачи
message string Нет Сообщение с результатом выполнения задачи
messageParams string Нет Параметры сообщения с результатом выполнения задачи
createdDate string · date-time Нет Дата добавления задачи в очередь
startDate string · date-time Нет Дата запуска задачи
finishDate string · date-time Нет Дата завершения задачи
url string Нет Ссылка на скачивание файла с результатом задачи
inputFileUrl string Нет Ссылка на загруженный файл
retryNumber integer · int32 Нет Счётчик перезапуска задачи.
userId integer · int32 Нет Пользователь запустивший задачу
retryDate string · date-time Нет Запланированная дата перезапуска
debug boolean Нет Запуск задачи в режиме отладки с большим логированием
forcedStart boolean Нет Ручной запуск задачи
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

Authorization

Токен для тестовых запросов

Токен хранится только в localStorage этого браузера и отправляется исключительно в заголовке Authorization запросов к api.selsup.ru.

Попробовать

Параметры реального запроса

Реальный ответ API

Выполните запрос, чтобы увидеть ответ SelSup.