SelSup Developers

Грамадскае API · API Падпісанне

Дастаўка

Канчатковыя пункты для дастаўкі, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

18 канчатковыя пункты/api/deliveryСтабільныМашыначытна чытае апісанне ↗
{ }

Гэты старонка падтрымліваецца рэдагаваць самастойны кантракт.

/api/delivery

Готовыя да выкарыстання працоўныя патокі

Готовыя да выкарыстання працоўныя патокі

01

Пачніце выкарыстоўваць дастаўку

Выкарыстоўвайце адмысловы токен API і пацвердзіце аперацыі чытання з дадзенымі тэсту спачатку.

  1. Захоўвайце знак з боку сервера і адправіце яго ў заголоўку Authorization.
  2. Праверце патрабаваныя параметры і пашырыць схему запыту або адказу.
  3. Выкарыстоўвайце стан HTTP і стабільнае поле error ў памылках прыкладання.

Мадэль дадзеных

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

Мадэлі пералічаныя тут адзін раз і могуць быць пашыраныя непасрэдна з канчатковых пунктаў, якія іх выкарыстоўваюць.

AdditionalDeliveryServiceDto3 палёў
codestring

Code.

namestring

Назва.

descriptionstring

Апісанне.

Address15 палёў
idinteger · int32

Id.

postCodestring

Паштовы код.

countryCountry

Краіна.

regionRegion

Рэгіён.

regionIdinteger · int32

Рэгіён ID.

streetstring

Вуліца.

housestring

Дом.

districtstring

Раён.

citystring

Горад.

localitystring

Мясцовасць.

buildingstring

Будынак.

flatstring

Плыта.

shortstring

Кратка.

addressIdAddress

Адрас ID.

fullstring

Поўны.

Country6 палёў
countryIdinteger · int32

Падпісанне краіны.

namestring

Назва.

code2string

Код 2.

code3string

Код3.

namesobject

Імена.

printNamestring

Назва аддруку.

DeliveryTariff13 палёў
deliverySumnumber · float

Сума дастаўкі.

periodMininteger · int32

Перыяд Min.

periodMaxinteger · int32

Перыяд Макс.

calendarMininteger · int32

Каляндар Min.

calendarMaxinteger · int32

Калядар Макс.

tariffIdinteger · int32

Падатковы пазнак.

shippingServicestring

Шэрыфэйскі сэрвіс.

tariffCodeinteger · int32

Падатковы кодэкс.

externalTariffCodestring

Знешні тарыфны кодэкс.

tariffNamestring

Пастаўная назва.

tariffDescriptionstring

Апісанне тарыфаў.

deliveryModeinteger · int32

Рэзервовы рэжым дастаўкі.

additionalServicesAdditionalDeliveryServiceDto[]

Дадатковыя паслугі.

Organization33 палёў
idinteger · int64

Id.

read-only
namestring

Назва.

Абавязкова
shortNamestring

Краткае імя.

taxTypestring

Падатковы тып.

taxRateinteger · int32

Падатковая стаўка.

taxNdsinteger · int32

Падатковыя НД.

inputTaxNdsinteger · int32

Падаткі на ўезд.

outputTaxNdsinteger · int32

Падаткі на вытворчасць.

enableNewTaxCalculationboolean

Уключыце новыя падатковыя разлікі.

useNdsCostPriceboolean

Выкарыстоўвайце Nds Кошт Прэс.

innstring

Гасцініца.

Абавязкова
kppstring

Кпп.

bankstring

Банка.

bikstring

Бялізна.

corrBillstring

Корр Біл.

billNumberstring

Лічба рахунку.

stampPathstring

Штамп Пад.

read-only
stampUrlstring

Стамп Url.

read-only
stampSizeinteger · int32

Памер маркі.

read-only
stampWidthinteger · int32

Штамп шырыню.

read-only
stampHeightinteger · int32

Стамп Вышыня.

read-only
signaturePathstring

Падпісная сцежка.

read-only
signatureUrlstring

Url падпіскі.

read-only
signatureSizeinteger · int32

Памер подпісу.

read-only
signatureWidthinteger · int32

Шырыня подпісу.

read-only
signatureHeightinteger · int32

Вышыня подпісу.

read-only
ipPersonPerson

IP-асоба.

formstring

Форма.

Абавязкова
ipboolean

ІП.

clientIdinteger · int64

Ідэнтыфікатар кліента.

read-only
addressAddress

Адрас.

phoneNumberstring

Нумар тэлефона.

addressFullstring

Адрас поўны.

read-only
Person14 палёў
personIdinteger · int64

Пазнак асобы.

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

У яго ёсць змены.

fullNamestring

Поўнае імя.

read-only
shortNamestring

Краткае імя.

read-only
PersonPosition7 палёў
idinteger · int64

Id.

read-only
namestring

Назва.

Абавязкова
deletedboolean

Здарэнне.

read-only
clientIdinteger · int64

Ідэнтыфікатар кліента.

read-only
defaultJobIdinteger · int64

Падуманая пазнака працы.

createdUserstring

Створаны карыстальнік.

read-only
createdDatestring · date-time

Стварыўся Дата.

read-only
Region4 палёў
regionIdinteger · int32

Рэгіён ID.

countryIdinteger · int32

Падпісанне краіны.

namestring

Назва.

regionSynonymsRegionSynonym[]

Сінонімы рэгіёнаў.

RegionSynonym4 палёў
idinteger · int64

Id.

regionIdinteger · int64

Рэгіён ID.

synonymstring

Сінянім.

servicestring

Паслуга.

WarehouseDelivery15 палёў
warehouseDeliveryIdinteger · int64

Пазнак пастаўкі ў склад.

pointstring

Пераклад.

servicestring

Паслуга.

warehouseIdinteger · int64

Ід склада.

organizationIdinteger · int64

Ід арганізацыі.

tariffPrioritystring

Падатковы прыярытэт.

prioritiesobject

Перавагі.

priorityByModeboolean

Прыярытэт па рэжыме.

additionalServicesstring

Дадатковыя паслугі.

sendZeroPriceboolean

Пашляце нулявы кошт.

fakeNamestring

Фальшывае імя.

hideOrganizationboolean

Схавайце арганізацыю.

sellerOrganizationIdinteger · int64

Ід арганізацыі прадаўца.

organizationOrganization

Арганізацыя.

additionalServiceForTariffDeliveryTariff

Дадатковы паслуг па тарыфах.

FileExportColumn5 палёў
idinteger · int64

Id.

fileExportIdinteger · int64

Файл экстраднай пазнакі.

columnNamestring

Назва колонкі.

columnOrderinteger · int32

Колонна ордэн.

isEnabledboolean

Здаецца.

TmsTask25 палёў
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Назва.

clientIdinteger · int64

Ідэнтыфікатар кліента.

entityIdinteger · int64

Ід суб'екта.

progressinteger · int32

Прагрэс.

processedQuantityinteger · int32

Працаванае колькасць.

organizationIdinteger · int64

Ід арганізацыі.

priorityinteger · int32

Пераважнасць.

propertiesstring

Маёмасці.

messagestring

Паведамленне.

messageParamsstring

Паведамленне Params.

createdDatestring · date-time

Стварыўся Дата.

startDatestring · date-time

Пачатак дата.

finishDatestring · date-time

Дата заканчэння.

urlstring

Ураль.

inputFileUrlstring

Уклад файла URL.

retryNumberinteger · int32

Перапрабаваць нумар.

userIdinteger · int32

Пазнак карыстальніка.

retryDatestring · date-time

Перапрабаваць дату.

debugboolean

Адладкаванне.

forcedStartboolean

Насілле пачатак.

servicestring

Паслуга.

langstring

Lang.

CalculatedDeliveryTariff11 палёў
deliverySumnumber · float

Сума дастаўкі.

periodMininteger · int32

Перыяд Min.

periodMaxinteger · int32

Перыяд Макс.

calendarMininteger · int32

Каляндар Min.

calendarMaxinteger · int32

Калядар Макс.

servicesobject

Паслугі.

locationToCodestring

Месцазнаходжанне да кода.

locationFromCodestring

Месцазнаходжанне з Кода.

tariffCodeinteger · int32

Падатковы кодэкс.

deliveryModeToOrderCreateinteger · int32

Рэдагаваць рэжым для заказа стварыць.

deliveryModeListinteger[]

Спіс рэжыму дастаўкі.

DeliveryServiceData10 палёў
idinteger · int64

Id.

tokenExpiredDatestring · date-time

Знак Дата заканчэння тэрміну.

servicestring

Паслуга.

serviceClientIdstring

Паслугі кліента ID.

serviceSecretDeliveryServiceData

Цэнтральны таямніцы.

clientIdinteger · int64

Ідэнтыфікатар кліента.

organizationIdinteger · int64

Ід арганізацыі.

updateTokenboolean

Абноўленне Токен.

hasTokenboolean

У яго ёсць Токен.

hasSecretboolean

У яго ёсць сакрэт.

DeliveryRegion2 палёў
namestring

Назва.

idstring

Id.

DeliveryPoint11 палёў
namestring

Назва.

locationDeliveryPointsLocation

Месцазнаходжанне.

addressstring

Адрас.

addressCommentstring

Адрас Каментара.

notestring

Запіс.

workTimestring

Працоўны час.

phonesPhone[]

Тэлефоны.

zipCodestring

Паштовы код.

codestring

Code.

emailstring

Па электроннай пошце.

sitestring

Сайт.

DeliveryPointsLocation12 палёў
addressstring

Адрас.

codeinteger · int32

Code.

postal_codestring

Паштовы код.

country_codestring

Код краіны.

citystring

Горад.

fias_guidstring

Фіяс Гід.

longitudenumber · float

Далёгія.

latitudenumber · float

Шчыльнасць.

regionstring

Рэгіён.

region_codeinteger · int32

Код рэгіёну.

address_fullstring

Адрас поўны.

city_codestring

Горадскі код.

Phone2 палёў
numberstring

Нумар.

additionalstring

Дадаткова.

DeliveryCity2 палёў
namestring

Назва.

idstring

Id.

AddressDto8 палёў
addressstring

Адрас.

postalCodestring

Паштовы код.

regionstring

Рэгіён.

localitystring

Мясцовасць.

streetstring

Вуліца.

housestring

Дом.

longitudenumber · double

Далёгія.

latitudenumber · double

Шчыльнасць.

Памылка дагавор

Як вяртаюць памылкі прыкладання

Код error аднолькавы ў кожным лакелі, у той час як паведамленне, якое з'яўляецца карыстальнікам, перакладаецца серверам.

error

Стабільны машыначытай код для інтэграцыйнай логікі.

localMessage

Паведамленне гатовае да адлюстравання на мове карыстальніка токены API.

params

Значэнні, якія інтэрполююцца серверам у лакалізаваным шаблоне паведамленняў.

localMessage выкарыстоўвае поле lang карыстальніка, які валодае токеном API. Мова дакументацыі і загаловак Accept-Language не змяняюць яго; руская выкарыстоўваецца, калі карыстацкая мова не канфігуруецца.

RUМясцовасць карыстальніка ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
BEБеларуская (be)
{
  "error": "error_brand_already_exists",
  "localMessage": "Брэнд Base ужо існуе",
  "params": {
    "name": "Base"
  }
}

Канчатковыя пункты

Канчатковыя пункты

POST

Абноўленне парадку дастаўкі

/api/delivery/updateDeliveryOrder
Знак з пісьмовым доступам

Абноўленне Заказу дастаўкі з дапамогай POST /api/delivery/updateDeliveryOrder.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
orderId integer · int64 Так Падпісанне па заказ.
curl --request POST 'https://api.selsup.ru/api/delivery/updateDeliveryOrder?orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200

Адказ не мае цела.

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Дастаўка ў склад

/api/delivery/storeWarehouseDelivery
Знак з пісьмовым доступам

Дастаўка ў склад магазіна з дапамогай POST /api/delivery/storeWarehouseDelivery.

Запытвальны орган

application/json
Палі аб'ектаўWarehouseDelivery
ПолеТыпАбавязковаАпісанне
warehouseDeliveryId integer · int64 Не Пазнак пастаўкі ў склад.
point string Не Пераклад.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Паслуга.
warehouseId integer · int64 Не Ід склада.
organizationId integer · int64 Не Ід арганізацыі.
tariffPriority string Не Падатковы прыярытэт.
priorities object Не Перавагі.
priorityByMode boolean Не Прыярытэт па рэжыме.
additionalServices string Не Дадатковыя паслугі.
sendZeroPrice boolean Не Пашляце нулявы кошт.
fakeName string Не Фальшывае імя.
hideOrganization boolean Не Схавайце арганізацыю.
sellerOrganizationId integer · int64 Не Ід арганізацыі прадаўца.
organization Organization Не Арганізацыя.
Палі аб'ектаў Organization
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
name string Так Назва.
shortName string Не Краткае імя.
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 Не Выкарыстоўвайце Nds Кошт Прэс.
inn string Так Гасцініца.
kpp string Не Кпп.
bank string Не Банка.
bik string Не Бялізна.
corrBill string Не Корр Біл.
billNumber string Не Лічба рахунку.
stampPath string Не Штамп Пад.
stampUrl string Не Стамп Url.
stampSize integer · int32 Не Памер маркі.
stampWidth integer · int32 Не Штамп шырыню.
stampHeight integer · int32 Не Стамп Вышыня.
signaturePath string Не Падпісная сцежка.
signatureUrl string Не Url падпіскі.
signatureSize integer · int32 Не Памер подпісу.
signatureWidth integer · int32 Не Шырыня подпісу.
signatureHeight integer · int32 Не Вышыня подпісу.
ipPerson Person Не IP-асоба.
Палі аб'ектаў Person
ПолеТыпАбавязковаАпісанне
personId integer · int64 Не Пазнак асобы.
firstName string Так Першае імя.
lastName string Так Фамілія.
surName string Не Сур імя.
clientId integer · int64 Не Ідэнтыфікатар кліента.
position PersonPosition Так Пазіцыя.
versionId integer · int64 Не Ід версіі.
createdUser string Не Створаны карыстальнік.
createdDate string · date-time Не Стварыўся Дата.
deleted boolean Не Здарэнне.
userId integer · int32 Не Пазнак карыстальніка.
hasChanges boolean Не У яго ёсць змены.
fullName string Не Поўнае імя.
shortName string Не Краткае імя.
form stringOOO, IP, SELF_EMPLOYED Так Форма.
ip boolean Не ІП.
clientId integer · int64 Не Ідэнтыфікатар кліента.
address Address Не Адрас.
Палі аб'ектаў Address
ПолеТыпАбавязковаАпісанне
id integer · int32 Не Id.
postCode string Не Паштовы код.
country Country Не Краіна.
region Region Не Рэгіён.
regionId integer · int32 Не Рэгіён ID.
street string Не Вуліца.
house string Не Дом.
district string Не Раён.
city string Не Горад.
locality string Не Мясцовасць.
building string Не Будынак.
flat string Не Плыта.
short string Не Кратка.
addressId Address Не Адрас ID.
full string Не Поўны.
phoneNumber string Не Нумар тэлефона.
addressFull string Не Адрас поўны.
additionalServiceForTariff DeliveryTariff Не Дадатковы паслуг па тарыфах.
Палі аб'ектаў DeliveryTariff
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
tariffId integer · int32 Не Падатковы пазнак.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Шэрыфэйскі сэрвіс.
tariffCode integer · int32 Не Падатковы кодэкс.
externalTariffCode string Не Знешні тарыфны кодэкс.
tariffName string Не Пастаўная назва.
tariffDescription string Не Апісанне тарыфаў.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэзервовы рэжым дастаўкі.
additionalServices AdditionalDeliveryServiceDto[] Не Дадатковыя паслугі.
Структура элементаў масіва AdditionalDeliveryServiceDto
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
curl --request POST 'https://api.selsup.ru/api/delivery/storeWarehouseDelivery' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "warehouseDeliveryId": 1001,
  "point": "string",
  "service": "CDEK",
  "warehouseId": 1001,
  "organizationId": 1001,
  "tariffPriority": "string"
}'

Удалы адказ

200
Палі аб'ектаў WarehouseDelivery
ПолеТыпАбавязковаАпісанне
warehouseDeliveryId integer · int64 Не Пазнак пастаўкі ў склад.
point string Не Пераклад.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Паслуга.
warehouseId integer · int64 Не Ід склада.
organizationId integer · int64 Не Ід арганізацыі.
tariffPriority string Не Падатковы прыярытэт.
priorities object Не Перавагі.
priorityByMode boolean Не Прыярытэт па рэжыме.
additionalServices string Не Дадатковыя паслугі.
sendZeroPrice boolean Не Пашляце нулявы кошт.
fakeName string Не Фальшывае імя.
hideOrganization boolean Не Схавайце арганізацыю.
sellerOrganizationId integer · int64 Не Ід арганізацыі прадаўца.
organization Organization Не Арганізацыя.
Палі аб'ектаў Organization
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
name string Так Назва.
shortName string Не Краткае імя.
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 Не Выкарыстоўвайце Nds Кошт Прэс.
inn string Так Гасцініца.
kpp string Не Кпп.
bank string Не Банка.
bik string Не Бялізна.
corrBill string Не Корр Біл.
billNumber string Не Лічба рахунку.
stampPath string Не Штамп Пад.
stampUrl string Не Стамп Url.
stampSize integer · int32 Не Памер маркі.
stampWidth integer · int32 Не Штамп шырыню.
stampHeight integer · int32 Не Стамп Вышыня.
signaturePath string Не Падпісная сцежка.
signatureUrl string Не Url падпіскі.
signatureSize integer · int32 Не Памер подпісу.
signatureWidth integer · int32 Не Шырыня подпісу.
signatureHeight integer · int32 Не Вышыня подпісу.
ipPerson Person Не IP-асоба.
Палі аб'ектаў Person
ПолеТыпАбавязковаАпісанне
personId integer · int64 Не Пазнак асобы.
firstName string Так Першае імя.
lastName string Так Фамілія.
surName string Не Сур імя.
clientId integer · int64 Не Ідэнтыфікатар кліента.
position PersonPosition Так Пазіцыя.
versionId integer · int64 Не Ід версіі.
createdUser string Не Створаны карыстальнік.
createdDate string · date-time Не Стварыўся Дата.
deleted boolean Не Здарэнне.
userId integer · int32 Не Пазнак карыстальніка.
hasChanges boolean Не У яго ёсць змены.
fullName string Не Поўнае імя.
shortName string Не Краткае імя.
form stringOOO, IP, SELF_EMPLOYED Так Форма.
ip boolean Не ІП.
clientId integer · int64 Не Ідэнтыфікатар кліента.
address Address Не Адрас.
Палі аб'ектаў Address
ПолеТыпАбавязковаАпісанне
id integer · int32 Не Id.
postCode string Не Паштовы код.
country Country Не Краіна.
region Region Не Рэгіён.
regionId integer · int32 Не Рэгіён ID.
street string Не Вуліца.
house string Не Дом.
district string Не Раён.
city string Не Горад.
locality string Не Мясцовасць.
building string Не Будынак.
flat string Не Плыта.
short string Не Кратка.
addressId Address Не Адрас ID.
full string Не Поўны.
phoneNumber string Не Нумар тэлефона.
addressFull string Не Адрас поўны.
additionalServiceForTariff DeliveryTariff Не Дадатковы паслуг па тарыфах.
Палі аб'ектаў DeliveryTariff
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
tariffId integer · int32 Не Падатковы пазнак.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Шэрыфэйскі сэрвіс.
tariffCode integer · int32 Не Падатковы кодэкс.
externalTariffCode string Не Знешні тарыфны кодэкс.
tariffName string Не Пастаўная назва.
tariffDescription string Не Апісанне тарыфаў.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэзервовы рэжым дастаўкі.
additionalServices AdditionalDeliveryServiceDto[] Не Дадатковыя паслугі.
Структура элементаў масіва AdditionalDeliveryServiceDto
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
{
  "warehouseDeliveryId": 1001,
  "point": "string",
  "service": "CDEK",
  "warehouseId": 1001,
  "organizationId": 1001,
  "tariffPriority": "string"
}
Памылкі11

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_duplicate_warehouse_delivery_for_warehouse
Налады службы дастаўкі не могуць дублявацца для склада

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_duplicate_warehouse_delivery_for_warehouse ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_shipping_point
Не пазначаны адрас адпраўкі адпраўленняў

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_shipping_point ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_shipping_service
Не пазначана служба дастаўкі

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_shipping_service ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_tariff_priority
Не пазначаны прыярытэт для тарыфа

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_tariff_priority ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_warehouse_delivery
Не пазначаны пункт адпраўлення для транспартнай кампаніі

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_warehouse_delivery ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_subscription_expired
У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_subscription_expired ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

POST

Вывесці пастаўкі ў склад

/api/delivery/removeWarehouseDelivery
Знак з пісьмовым доступам

Выключыць пастаўку ў склад з дапамогай POST /api/delivery/removeWarehouseDelivery.

Запытвальны орган

application/json
Палі аб'ектаўWarehouseDelivery
ПолеТыпАбавязковаАпісанне
warehouseDeliveryId integer · int64 Не Пазнак пастаўкі ў склад.
point string Не Пераклад.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Паслуга.
warehouseId integer · int64 Не Ід склада.
organizationId integer · int64 Не Ід арганізацыі.
tariffPriority string Не Падатковы прыярытэт.
priorities object Не Перавагі.
priorityByMode boolean Не Прыярытэт па рэжыме.
additionalServices string Не Дадатковыя паслугі.
sendZeroPrice boolean Не Пашляце нулявы кошт.
fakeName string Не Фальшывае імя.
hideOrganization boolean Не Схавайце арганізацыю.
sellerOrganizationId integer · int64 Не Ід арганізацыі прадаўца.
organization Organization Не Арганізацыя.
Палі аб'ектаў Organization
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
name string Так Назва.
shortName string Не Краткае імя.
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 Не Выкарыстоўвайце Nds Кошт Прэс.
inn string Так Гасцініца.
kpp string Не Кпп.
bank string Не Банка.
bik string Не Бялізна.
corrBill string Не Корр Біл.
billNumber string Не Лічба рахунку.
stampPath string Не Штамп Пад.
stampUrl string Не Стамп Url.
stampSize integer · int32 Не Памер маркі.
stampWidth integer · int32 Не Штамп шырыню.
stampHeight integer · int32 Не Стамп Вышыня.
signaturePath string Не Падпісная сцежка.
signatureUrl string Не Url падпіскі.
signatureSize integer · int32 Не Памер подпісу.
signatureWidth integer · int32 Не Шырыня подпісу.
signatureHeight integer · int32 Не Вышыня подпісу.
ipPerson Person Не IP-асоба.
Палі аб'ектаў Person
ПолеТыпАбавязковаАпісанне
personId integer · int64 Не Пазнак асобы.
firstName string Так Першае імя.
lastName string Так Фамілія.
surName string Не Сур імя.
clientId integer · int64 Не Ідэнтыфікатар кліента.
position PersonPosition Так Пазіцыя.
versionId integer · int64 Не Ід версіі.
createdUser string Не Створаны карыстальнік.
createdDate string · date-time Не Стварыўся Дата.
deleted boolean Не Здарэнне.
userId integer · int32 Не Пазнак карыстальніка.
hasChanges boolean Не У яго ёсць змены.
fullName string Не Поўнае імя.
shortName string Не Краткае імя.
form stringOOO, IP, SELF_EMPLOYED Так Форма.
ip boolean Не ІП.
clientId integer · int64 Не Ідэнтыфікатар кліента.
address Address Не Адрас.
Палі аб'ектаў Address
ПолеТыпАбавязковаАпісанне
id integer · int32 Не Id.
postCode string Не Паштовы код.
country Country Не Краіна.
region Region Не Рэгіён.
regionId integer · int32 Не Рэгіён ID.
street string Не Вуліца.
house string Не Дом.
district string Не Раён.
city string Не Горад.
locality string Не Мясцовасць.
building string Не Будынак.
flat string Не Плыта.
short string Не Кратка.
addressId Address Не Адрас ID.
full string Не Поўны.
phoneNumber string Не Нумар тэлефона.
addressFull string Не Адрас поўны.
additionalServiceForTariff DeliveryTariff Не Дадатковы паслуг па тарыфах.
Палі аб'ектаў DeliveryTariff
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
tariffId integer · int32 Не Падатковы пазнак.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Шэрыфэйскі сэрвіс.
tariffCode integer · int32 Не Падатковы кодэкс.
externalTariffCode string Не Знешні тарыфны кодэкс.
tariffName string Не Пастаўная назва.
tariffDescription string Не Апісанне тарыфаў.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэзервовы рэжым дастаўкі.
additionalServices AdditionalDeliveryServiceDto[] Не Дадатковыя паслугі.
Структура элементаў масіва AdditionalDeliveryServiceDto
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
curl --request POST 'https://api.selsup.ru/api/delivery/removeWarehouseDelivery' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "warehouseDeliveryId": 1001,
  "point": "string",
  "service": "CDEK",
  "warehouseId": 1001,
  "organizationId": 1001,
  "tariffPriority": "string"
}'

Удалы адказ

200

Адказ не мае цела.

Памылкі6

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_subscription_expired
У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_subscription_expired ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

POST

Парадак

/api/delivery/order/{orderId}
Знак з пісьмовым доступам

Замовіць з дапамогай POST /api/delivery/order/{orderId}.

Параметры шляху

ПолеТыпАбавязковаАпісанне
orderId integer · int64 Так Падпісанне па заказ.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Паслуга.

Запытвальны орган

application/json
Палі аб'ектаўDeliveryTariff
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
tariffId integer · int32 Не Падатковы пазнак.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Шэрыфэйскі сэрвіс.
tariffCode integer · int32 Не Падатковы кодэкс.
externalTariffCode string Не Знешні тарыфны кодэкс.
tariffName string Не Пастаўная назва.
tariffDescription string Не Апісанне тарыфаў.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэзервовы рэжым дастаўкі.
additionalServices AdditionalDeliveryServiceDto[] Не Дадатковыя паслугі.
Структура элементаў масіва AdditionalDeliveryServiceDto
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
curl --request POST 'https://api.selsup.ru/api/delivery/order/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "deliverySum": 1,
  "periodMin": 1,
  "periodMax": 1,
  "calendarMin": 1,
  "calendarMax": 1,
  "tariffId": 1001
}'

Удалы адказ

200

Адказ не мае цела.

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Атрымаць тарыфы

/api/delivery/getTariffs
Знак з пісьмовым доступам

Атрымаць тарыфы з дапамогай POST /api/delivery/getTariffs.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
orderId integer · int64 Так Падпісанне па заказ.
curl --request POST 'https://api.selsup.ru/api/delivery/getTariffs?service=CDEK&orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва DeliveryTariff[]
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
tariffId integer · int32 Не Падатковы пазнак.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Шэрыфэйскі сэрвіс.
tariffCode integer · int32 Не Падатковы кодэкс.
externalTariffCode string Не Знешні тарыфны кодэкс.
tariffName string Не Пастаўная назва.
tariffDescription string Не Апісанне тарыфаў.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэзервовы рэжым дастаўкі.
additionalServices AdditionalDeliveryServiceDto[] Не Дадатковыя паслугі.
Структура элементаў масіва AdditionalDeliveryServiceDto
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
[
  "string"
]
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Скарыстайце лагітэты дастаўкі

/api/delivery/downloadDeliveryLabels
Знак з пісьмовым доступам

Скарыстайце лагітэкі дастаўкі з дапамогай POST /api/delivery/downloadDeliveryLabels.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
columns FileExportColumn[] Не Коланы.
Структура элементаў масіва FileExportColumn
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
fileExportId integer · int64 Не Файл экстраднай пазнакі.
columnName string Не Назва колонкі.
columnOrder integer · int32 Не Колонна ордэн.
isEnabled boolean Не Здаецца.
actual boolean Не Праўда.
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Не Type.
serviceWarehouseId string Не Паслугі Акадэміі Акадомі.
externalOrderId string Не Ід знешняга парадку.
invoiceNumber integer · int64 Не Нумар рахунку.
article string Не Артыкул.
containsArticle string Не Змяшчае артыкул.
product string Не Прадукт.
barcode string Не Бар-код.
organizations integer[] Не Арганізацыі.
query string Не Запытваючы.
userId integer · int32 Не Пазнак карыстальніка.
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 Не Паслуга.
services 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 Не Status.
statuses string[] Не Статусы.
withoutSupply boolean Не Без пастаўкі.
orderProductId integer · int64 Не Заказ ID прадукту.
productId integer · int64 Не Ід прадукту.
brandId integer · int32 Не Ід брэнда.
supplierId integer · int64 Не Ід пастаўшчыка.
hasCollectTask boolean Не Ён мае Задача збору.
organizationId integer · int64 Не Ід арганізацыі.
clientOrganizationIds integer[] Не Пазнакі арганізацыі кліентаў.
updateInService boolean Не Абноўленне ў службе.
hasServiceError boolean Не Памылка службы.
noLabel boolean Не Без лагера.
isLegal boolean Не Гэта законна.
noMsOrder boolean Не Ні місіс ордэн.
noMsDemand boolean Не Не місіс Дамоў.
ids integer[] Не Пазнакі.
supplyId integer · int64 Не Падказчыка паставак.
notCollected boolean Не Не сабраны.
dbs boolean Не ДБС.
express boolean Не Вырашыць.
fbs boolean Не ФБС.
noWarehouse boolean Не Няма Аховы.
closeDate string Не Завяршыць дату.
modifiedDate string · date-time Не Падробленыя даты.
modifiedDateTo string · date-time Не Падведзеная дата да.
incomeId integer · int64 Не Падпісанне даходу.
bindingOrderId integer · int64 Не Звязлівая пазнака зарад.
closeDateFrom string · date-time Не Збліжаецца дата ад.
closeDateTo string · date-time Не Дата блізка да.
orderDate string Не Дата замовы.
deliveryDate string Не Дата дастаўкі.
deliveryDateFrom string Не Дата дастаўкі з.
deliveryDateTo string Не Дата дастаўкі да.
createdDateFrom string Не Ствараецца дата ад.
createdDateTo string Не Ствараецца дата да.
forMoySklad boolean Не Для Мой Склад.
withMoySkladOrder boolean Не З ордэнам Мой Склад.
warehouseId integer · int64 Не Ід склада.
warehouseIds integer[] Не Пазнакі склада.
dateFrom string · date-time Не Дата ад.
dateTo string · date-time Не Дата да.
timeZone integer · int32 Не Часная зона.
markingStatus stringUNKNOWN, CARDS_SEND, CARDS_CREATED, SUZ_ORDERS_CREATED, MARKS_RECEIVED, CARDS_SIGNED, DOCUMENT_CREATED, SUCCESS, NO_NEED_MARKING Не Статус адзнакі.
deleted boolean Не Здарэнне.
collectLabel boolean Не Збірайце Лэблі.
sortOrdersByDate boolean Не Рэагулюйце па парадку па даце.
sortBySku boolean Не Сортаваны па Ску.
notGroupByOrganization boolean Не Не група па арганізацыі.
notGroupByService boolean Не Не група па службе.
productLabel boolean Не Маркаванне прадукту.
productCodeLabel boolean Не Маркер кода прадукту.
servicesForLabel string[] Не Паслугі для лагера.
infoLabel boolean Не Інфармацыйная лабараторыя.
grouped boolean Не Групаваны.
replaceSetByComponent boolean Не Замяніць па наборы па кампаненце.
replaceSetsByComponentsIncome boolean Не Замяніць наборы па кампанентах даход.
collectDeliveryLabel boolean Не Збірайце марку па дастаўцы.
shippingServicesForLabel string[] Не Паслугі па адпраўцы для лабараторнай.
orderId integer · int64 Не Падпісанне па заказ.
hasVideoFixation boolean Не У яго ёсць відэафіксацыя.
withProducts boolean Не З прадуктамі.
passageIds integer[] Не Падарожжа ID.
withContractor boolean Не З кантрактарам.
boxId integer · int64 Не Падпісанне.
hasMarkedProducts boolean Не Пазначыў прадукты.
withAnalytics boolean Не З Аналітыкай.
limit integer · int32 Не Межа.
page integer · int32 Не Праз старонку.
count boolean Не Граф.
sortBy stringID, CREATEDDATE, ORDERCREATED, CREATED, CREATEDUSER, STATUS, SERVICE, TYPE, BOXTYPE, NAME, ORGANIZATIONID, WAREHOUSE, INVOICENUMBER, EXTERNALORDERID, QUEUE, SUPPLYID, CLOSEDATE, STARTCOLLECTDATE, CLOSEUSERID, USERID, PRICE, PRODUCT, COLLECTORDERTASKID, DELIVERYDATE, MARKINGSTATUS, QUANTITY, DATE, SERVICEWAREHOUSEID Не Пасля.
ascending boolean Не Падыходзіць.
curl --request POST 'https://api.selsup.ru/api/delivery/downloadDeliveryLabels?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Палі аб'ектаў TmsTask
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Не Status.
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 Не Type.
name string Не Назва.
clientId integer · int64 Не Ідэнтыфікатар кліента.
entityId integer · int64 Не Ід суб'екта.
progress integer · int32 Не Прагрэс.
processedQuantity integer · int32 Не Працаванае колькасць.
organizationId integer · int64 Не Ід арганізацыі.
priority integer · int32 Не Пераважнасць.
properties string Не Маёмасці.
message string Не Паведамленне.
messageParams string Не Паведамленне Params.
createdDate string · date-time Не Стварыўся Дата.
startDate string · date-time Не Пачатак дата.
finishDate string · date-time Не Дата заканчэння.
url string Не Ураль.
inputFileUrl string Не Уклад файла URL.
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 Не Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Адмяніць заказ па дастаўцы

/api/delivery/cancelDeliveryOrder
Знак з пісьмовым доступам

Адмяніць заказ па дастаўцы з дапамогай POST /api/delivery/cancelDeliveryOrder.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
orderId integer · int64 Так Падпісанне па заказ.
curl --request POST 'https://api.selsup.ru/api/delivery/cancelDeliveryOrder?orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200

Адказ не мае цела.

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Вылічыць тарыф

/api/delivery/calculateTariff
Знак з пісьмовым доступам

Вылічыць тарыф з дапамогай POST /api/delivery/calculateTariff.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
tariffCode integer · int32 Так Падатковы кодэкс.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
orderId integer · int64 Так Падпісанне па заказ.
curl --request POST 'https://api.selsup.ru/api/delivery/calculateTariff?tariffCode=1&service=CDEK&orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Палі аб'ектаў CalculatedDeliveryTariff
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
services object Не Паслугі.
locationToCode string Не Месцазнаходжанне да кода.
locationFromCode string Не Месцазнаходжанне з Кода.
tariffCode integer · int32 Не Падатковы кодэкс.
deliveryModeToOrderCreate integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэдагаваць рэжым для заказа стварыць.
deliveryModeList integer[] Не Спіс рэжыму дастаўкі.
{
  "deliverySum": 1,
  "periodMin": 1,
  "periodMax": 1,
  "calendarMin": 1,
  "calendarMax": 1,
  "services": "string"
}
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Дадаць інтэграцыю паслуг па дастаўцы

/api/delivery/addDeliveryServiceIntegration
Знак з пісьмовым доступам

Дадаць Інтэграцыю паслуг дастаўкі з дапамогай POST /api/delivery/addDeliveryServiceIntegration.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
serviceClientId string Так Паслугі кліента ID.
serviceSecret string Не Цэнтральны таямніцы.
token string Не Знак.
organizationId integer · int64 Так Ід арганізацыі.
curl --request POST 'https://api.selsup.ru/api/delivery/addDeliveryServiceIntegration?service=CDEK&serviceClientId=string&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200

Адказ не мае цела.

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

GET

З'явяцца з імі

/api/delivery/integration/{organizationId}/{service}
Значок з чытальным доступам

Атрымаць інтэграцыю з дапамогай GET /api/delivery/integration/{organizationId}/{service}.

Параметры шляху

ПолеТыпАбавязковаАпісанне
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
organizationId integer · int64 Так Ід арганізацыі.
curl --request GET 'https://api.selsup.ru/api/delivery/integration/1001/CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Палі аб'ектаў DeliveryServiceData
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
tokenExpiredDate string · date-time Не Знак Дата заканчэння тэрміну.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Паслуга.
serviceClientId string Не Паслугі кліента ID.
serviceSecret DeliveryServiceData Не Цэнтральны таямніцы.
clientId integer · int64 Не Ідэнтыфікатар кліента.
organizationId integer · int64 Не Ід арганізацыі.
updateToken boolean Не Абноўленне Токен.
hasToken boolean Не У яго ёсць Токен.
hasSecret boolean Не У яго ёсць сакрэт.
{
  "id": 1001,
  "tokenExpiredDate": "2026-01-15T12:00:00Z",
  "service": "CDEK",
  "serviceClientId": "string",
  "serviceSecret": "string",
  "clientId": 1001
}
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

GET

Атрымаць пастаўку ў склад

/api/delivery/getWarehouseDelivery
Значок з чытальным доступам

Атрымаць пастаўку ў склад з дапамогай GET /api/delivery/getWarehouseDelivery.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
organizationId integer · int64 Так Ід арганізацыі.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
curl --request GET 'https://api.selsup.ru/api/delivery/getWarehouseDelivery?organizationId=1001&service=CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва WarehouseDelivery[]
ПолеТыпАбавязковаАпісанне
warehouseDeliveryId integer · int64 Не Пазнак пастаўкі ў склад.
point string Не Пераклад.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Паслуга.
warehouseId integer · int64 Не Ід склада.
organizationId integer · int64 Не Ід арганізацыі.
tariffPriority string Не Падатковы прыярытэт.
priorities object Не Перавагі.
priorityByMode boolean Не Прыярытэт па рэжыме.
additionalServices string Не Дадатковыя паслугі.
sendZeroPrice boolean Не Пашляце нулявы кошт.
fakeName string Не Фальшывае імя.
hideOrganization boolean Не Схавайце арганізацыю.
sellerOrganizationId integer · int64 Не Ід арганізацыі прадаўца.
organization Organization Не Арганізацыя.
Палі аб'ектаў Organization
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
name string Так Назва.
shortName string Не Краткае імя.
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 Не Выкарыстоўвайце Nds Кошт Прэс.
inn string Так Гасцініца.
kpp string Не Кпп.
bank string Не Банка.
bik string Не Бялізна.
corrBill string Не Корр Біл.
billNumber string Не Лічба рахунку.
stampPath string Не Штамп Пад.
stampUrl string Не Стамп Url.
stampSize integer · int32 Не Памер маркі.
stampWidth integer · int32 Не Штамп шырыню.
stampHeight integer · int32 Не Стамп Вышыня.
signaturePath string Не Падпісная сцежка.
signatureUrl string Не Url падпіскі.
signatureSize integer · int32 Не Памер подпісу.
signatureWidth integer · int32 Не Шырыня подпісу.
signatureHeight integer · int32 Не Вышыня подпісу.
ipPerson Person Не IP-асоба.
Палі аб'ектаў Person
ПолеТыпАбавязковаАпісанне
personId integer · int64 Не Пазнак асобы.
firstName string Так Першае імя.
lastName string Так Фамілія.
surName string Не Сур імя.
clientId integer · int64 Не Ідэнтыфікатар кліента.
position PersonPosition Так Пазіцыя.
versionId integer · int64 Не Ід версіі.
createdUser string Не Створаны карыстальнік.
createdDate string · date-time Не Стварыўся Дата.
deleted boolean Не Здарэнне.
userId integer · int32 Не Пазнак карыстальніка.
hasChanges boolean Не У яго ёсць змены.
fullName string Не Поўнае імя.
shortName string Не Краткае імя.
form stringOOO, IP, SELF_EMPLOYED Так Форма.
ip boolean Не ІП.
clientId integer · int64 Не Ідэнтыфікатар кліента.
address Address Не Адрас.
Палі аб'ектаў Address
ПолеТыпАбавязковаАпісанне
id integer · int32 Не Id.
postCode string Не Паштовы код.
country Country Не Краіна.
region Region Не Рэгіён.
regionId integer · int32 Не Рэгіён ID.
street string Не Вуліца.
house string Не Дом.
district string Не Раён.
city string Не Горад.
locality string Не Мясцовасць.
building string Не Будынак.
flat string Не Плыта.
short string Не Кратка.
addressId Address Не Адрас ID.
full string Не Поўны.
phoneNumber string Не Нумар тэлефона.
addressFull string Не Адрас поўны.
additionalServiceForTariff DeliveryTariff Не Дадатковы паслуг па тарыфах.
Палі аб'ектаў DeliveryTariff
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
tariffId integer · int32 Не Падатковы пазнак.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Шэрыфэйскі сэрвіс.
tariffCode integer · int32 Не Падатковы кодэкс.
externalTariffCode string Не Знешні тарыфны кодэкс.
tariffName string Не Пастаўная назва.
tariffDescription string Не Апісанне тарыфаў.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэзервовы рэжым дастаўкі.
additionalServices AdditionalDeliveryServiceDto[] Не Дадатковыя паслугі.
Структура элементаў масіва AdditionalDeliveryServiceDto
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
[
  "string"
]
Памылкі7

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_warehouse_delivery
Не пазначаны пункт адпраўлення для транспартнай кампаніі

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_warehouse_delivery ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_subscription_expired
У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_subscription_expired ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Знайсці рэгіёны

/api/delivery/getRegions
Значок з чытальным доступам

Атрымаць рэгіёны з дапамогай GET /api/delivery/getRegions.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
query string Так Запытваючы.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
organizationId integer · int64 Так Ід арганізацыі.
curl --request GET 'https://api.selsup.ru/api/delivery/getRegions?query=string&service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва DeliveryRegion[]
ПолеТыпАбавязковаАпісанне
name string Не Назва.
id string Не Id.
[
  "string"
]
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

GET

Атрымаць Пункты

/api/delivery/getPoints
Значок з чытальным доступам

Атрымаць Пункты з дапамогай GET /api/delivery/getPoints.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
postCode string Не Паштовы код.
country string Не Краіна.
region string Не Рэгіён.
city string Не Горад.
query string Не Запытваючы.
forSupply boolean Не Для пастаўкі.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
organizationId integer · int64 Так Ід арганізацыі.
curl --request GET 'https://api.selsup.ru/api/delivery/getPoints?service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва DeliveryPoint[]
ПолеТыпАбавязковаАпісанне
name string Не Назва.
location DeliveryPointsLocation Не Месцазнаходжанне.
Палі аб'ектаў DeliveryPointsLocation
ПолеТыпАбавязковаАпісанне
address string Не Адрас.
code integer · int32 Не Code.
postal_code string Не Паштовы код.
country_code string Не Код краіны.
city string Не Горад.
fias_guid string Не Фіяс Гід.
longitude number · float Не Далёгія.
latitude number · float Не Шчыльнасць.
region string Не Рэгіён.
region_code integer · int32 Не Код рэгіёну.
address_full string Не Адрас поўны.
city_code string Не Горадскі код.
address string Не Адрас.
addressComment string Не Адрас Каментара.
note string Не Запіс.
workTime string Не Працоўны час.
phones Phone[] Не Тэлефоны.
Структура элементаў масіва Phone
ПолеТыпАбавязковаАпісанне
number string Не Нумар.
additional string Не Дадаткова.
zipCode string Не Паштовы код.
code string Не Code.
email string Не Па электроннай пошце.
site string Не Сайт.
[
  "string"
]
Памылкі9

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_empty_delivery_service
Не пазначана служба дастаўкі

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_delivery_service ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_delivery_integration
Не настроена інтэграцыя з дадзенай службай дастаўкі

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_delivery_integration ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_subscription_expired
У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_subscription_expired ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_unsupported_delivery_service
служба дастаўкі не падтрымліваецца

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_unsupported_delivery_service ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Атрымаць тарыфы па дастаўцы

/api/delivery/getDeliveryTariffs
Значок з чытальным доступам

Атрымаць тарыфы па дастаўцы з дапамогай GET /api/delivery/getDeliveryTariffs.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
query string Так Запытваючы.
curl --request GET 'https://api.selsup.ru/api/delivery/getDeliveryTariffs?service=CDEK&query=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва DeliveryTariff[]
ПолеТыпАбавязковаАпісанне
deliverySum number · float Не Сума дастаўкі.
periodMin integer · int32 Не Перыяд Min.
periodMax integer · int32 Не Перыяд Макс.
calendarMin integer · int32 Не Каляндар Min.
calendarMax integer · int32 Не Калядар Макс.
tariffId integer · int32 Не Падатковы пазнак.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Не Шэрыфэйскі сэрвіс.
tariffCode integer · int32 Не Падатковы кодэкс.
externalTariffCode string Не Знешні тарыфны кодэкс.
tariffName string Не Пастаўная назва.
tariffDescription string Не Апісанне тарыфаў.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Не Рэзервовы рэжым дастаўкі.
additionalServices AdditionalDeliveryServiceDto[] Не Дадатковыя паслугі.
Структура элементаў масіва AdditionalDeliveryServiceDto
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
[
  "string"
]
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

GET

Знайдзіце гарады

/api/delivery/getCities
Значок з чытальным доступам

Атрымаць гарады з дапамогай GET /api/delivery/getCities.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
query string Так Запытваючы.
region string Так Рэгіён.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
organizationId integer · int64 Так Ід арганізацыі.
curl --request GET 'https://api.selsup.ru/api/delivery/getCities?query=string&region=string&service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва DeliveryCity[]
ПолеТыпАбавязковаАпісанне
name string Не Назва.
id string Не Id.
[
  "string"
]
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

GET

Атрымаць адрас

/api/delivery/getAddress
Значок з чытальным доступам

Атрымаць адрас з дапамогай GET /api/delivery/getAddress.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
postCode string Не Паштовы код.
country string Не Краіна.
region string Не Рэгіён.
city string Не Горад.
query string Не Запытваючы.
forSupply boolean Не Для пастаўкі.
curl --request GET 'https://api.selsup.ru/api/delivery/getAddress' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва AddressDto[]
ПолеТыпАбавязковаАпісанне
address string Не Адрас.
postalCode string Не Паштовы код.
region string Не Рэгіён.
locality string Не Мясцовасць.
street string Не Вуліца.
house string Не Дом.
longitude number · double Не Далёгія.
latitude number · double Не Шчыльнасць.
[
  "string"
]
Памылкі4

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_cant_get_address
Не атрымоўваецца атрымаць адрас дастаўкі

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_cant_get_address ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Дадатковыя паслугі па дастаўцы

/api/delivery/fetchDeliveryServiceAdditionalServices
Значок з чытальным доступам

Прыняць дадатковыя паслугі дастаўкі з дапамогай GET /api/delivery/fetchDeliveryServiceAdditionalServices.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
tariffCode integer · int32 Не Падатковы кодэкс.
curl --request GET 'https://api.selsup.ru/api/delivery/fetchDeliveryServiceAdditionalServices?service=CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Структура элементаў масіва AdditionalDeliveryServiceDto[]
ПолеТыпАбавязковаАпісанне
code string Не Code.
name string Не Назва.
description string Не Апісанне.
[
  "string"
]
Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

DELETE

Зніжэнне інтэграцыі паслуг па дастаўцы

/api/delivery/{service}/{organizationId}
Знак з пісьмовым доступам

Знішце інтэграцыю паслуг дастаўкі з дапамогай DELETE /api/delivery/{service}/{organizationId}.

Параметры шляху

ПолеТыпАбавязковаАпісанне
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Так Паслуга.
organizationId integer · int64 Так Ід арганізацыі.
curl --request DELETE 'https://api.selsup.ru/api/delivery/CDEK/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200

Адказ не мае цела.

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

Authorization

Знак для запытаў на выпрабаванне

Токен застаецца ў лакальным сховішчы гэтага браўзэра і адпраўляецца толькі ў заголоўцы Authorization запытаў на api.selsup.ru.

Паспрабаваць

Рэальныя параметры запыту

Жывы адказ API

Пашляце запыт, каб убачыць адказ SelSup.