SelSup Developers

Public API · API Reference

Delivery

Endpoints for Delivery, including exact routes, parameters, request bodies, and expandable response schemas.

18 endpoints/api/deliveryStableMachine-readable description ↗
{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/delivery

Ready-to-use workflows

Ready-to-use workflows

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

AdditionalDeliveryServiceDto3 fields
codestring

Code.

namestring

Name.

descriptionstring

Description.

Address15 fields
idinteger · int32

Id.

postCodestring

Post Code.

countryCountry

Country.

regionRegion

Region.

regionIdinteger · int32

Region Id.

streetstring

Street.

housestring

House.

districtstring

District.

citystring

City.

localitystring

Locality.

buildingstring

Building.

flatstring

Flat.

shortstring

Short.

addressIdAddress

Address Id.

fullstring

Full.

Country6 fields
countryIdinteger · int32

Country Id.

namestring

Name.

code2string

Code2.

code3string

Code3.

namesobject

Names.

printNamestring

Print Name.

DeliveryTariff13 fields
deliverySumnumber · float

Delivery Sum.

periodMininteger · int32

Period Min.

periodMaxinteger · int32

Period Max.

calendarMininteger · int32

Calendar Min.

calendarMaxinteger · int32

Calendar Max.

tariffIdinteger · int32

Tariff Id.

shippingServicestring

Shipping Service.

tariffCodeinteger · int32

Tariff Code.

externalTariffCodestring

External Tariff Code.

tariffNamestring

Tariff Name.

tariffDescriptionstring

Tariff Description.

deliveryModeinteger · int32

Delivery Mode.

additionalServicesAdditionalDeliveryServiceDto[]

Additional Services.

Organization33 fields
idinteger · int64

Id.

read-only
namestring

Name.

Required
shortNamestring

Short Name.

taxTypestring

Tax Type.

taxRateinteger · int32

Tax Rate.

taxNdsinteger · int32

Tax Nds.

inputTaxNdsinteger · int32

Input Tax Nds.

outputTaxNdsinteger · int32

Output Tax Nds.

enableNewTaxCalculationboolean

Enable New Tax Calculation.

useNdsCostPriceboolean

Use Nds Cost Price.

innstring

Inn.

Required
kppstring

Kpp.

bankstring

Bank.

bikstring

Bik.

corrBillstring

Corr Bill.

billNumberstring

Bill Number.

stampPathstring

Stamp Path.

read-only
stampUrlstring

Stamp Url.

read-only
stampSizeinteger · int32

Stamp Size.

read-only
stampWidthinteger · int32

Stamp Width.

read-only
stampHeightinteger · int32

Stamp Height.

read-only
signaturePathstring

Signature Path.

read-only
signatureUrlstring

Signature Url.

read-only
signatureSizeinteger · int32

Signature Size.

read-only
signatureWidthinteger · int32

Signature Width.

read-only
signatureHeightinteger · int32

Signature Height.

read-only
ipPersonPerson

Ip Person.

formstring

Form.

Required
ipboolean

Ip.

clientIdinteger · int64

Client Id.

read-only
addressAddress

Address.

phoneNumberstring

Phone Number.

addressFullstring

Address Full.

read-only
Person14 fields
personIdinteger · int64

Person Id.

read-only
firstNamestring

First Name.

Required
lastNamestring

Last Name.

Required
surNamestring

Sur Name.

clientIdinteger · int64

Client Id.

read-only
positionPersonPosition

Position.

Required
versionIdinteger · int64

Version Id.

read-only
createdUserstring

Created User.

read-only
createdDatestring · date-time

Created Date.

read-only
deletedboolean

Deleted.

read-only
userIdinteger · int32

User Id.

read-only
hasChangesboolean

Has Changes.

fullNamestring

Full Name.

read-only
shortNamestring

Short Name.

read-only
PersonPosition7 fields
idinteger · int64

Id.

read-only
namestring

Name.

Required
deletedboolean

Deleted.

read-only
clientIdinteger · int64

Client Id.

read-only
defaultJobIdinteger · int64

Default Job Id.

createdUserstring

Created User.

read-only
createdDatestring · date-time

Created Date.

read-only
Region4 fields
regionIdinteger · int32

Region Id.

countryIdinteger · int32

Country Id.

namestring

Name.

regionSynonymsRegionSynonym[]

Region Synonyms.

RegionSynonym4 fields
idinteger · int64

Id.

regionIdinteger · int64

Region Id.

synonymstring

Synonym.

servicestring

Service.

WarehouseDelivery15 fields
warehouseDeliveryIdinteger · int64

Warehouse Delivery Id.

pointstring

Point.

servicestring

Service.

warehouseIdinteger · int64

Warehouse Id.

organizationIdinteger · int64

Organization Id.

tariffPrioritystring

Tariff Priority.

prioritiesobject

Priorities.

priorityByModeboolean

Priority By Mode.

additionalServicesstring

Additional Services.

sendZeroPriceboolean

Send Zero Price.

fakeNamestring

Fake Name.

hideOrganizationboolean

Hide Organization.

sellerOrganizationIdinteger · int64

Seller Organization Id.

organizationOrganization

Organization.

additionalServiceForTariffDeliveryTariff

Additional Service For Tariff.

FileExportColumn5 fields
idinteger · int64

Id.

fileExportIdinteger · int64

File Export Id.

columnNamestring

Column Name.

columnOrderinteger · int32

Column Order.

isEnabledboolean

Is Enabled.

TmsTask25 fields
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Name.

clientIdinteger · int64

Client Id.

entityIdinteger · int64

Entity Id.

progressinteger · int32

Progress.

processedQuantityinteger · int32

Processed Quantity.

organizationIdinteger · int64

Organization Id.

priorityinteger · int32

Priority.

propertiesstring

Properties.

messagestring

Message.

messageParamsstring

Message Params.

createdDatestring · date-time

Created Date.

startDatestring · date-time

Start Date.

finishDatestring · date-time

Finish Date.

urlstring

Url.

inputFileUrlstring

Input File Url.

retryNumberinteger · int32

Retry Number.

userIdinteger · int32

User Id.

retryDatestring · date-time

Retry Date.

debugboolean

Debug.

forcedStartboolean

Forced Start.

servicestring

Service.

langstring

Lang.

CalculatedDeliveryTariff11 fields
deliverySumnumber · float

Delivery Sum.

periodMininteger · int32

Period Min.

periodMaxinteger · int32

Period Max.

calendarMininteger · int32

Calendar Min.

calendarMaxinteger · int32

Calendar Max.

servicesobject

Services.

locationToCodestring

Location To Code.

locationFromCodestring

Location From Code.

tariffCodeinteger · int32

Tariff Code.

deliveryModeToOrderCreateinteger · int32

Delivery Mode To Order Create.

deliveryModeListinteger[]

Delivery Mode List.

DeliveryServiceData10 fields
idinteger · int64

Id.

tokenExpiredDatestring · date-time

Token Expired Date.

servicestring

Service.

serviceClientIdstring

Service Client Id.

serviceSecretDeliveryServiceData

Service Secret.

clientIdinteger · int64

Client Id.

organizationIdinteger · int64

Organization Id.

updateTokenboolean

Update Token.

hasTokenboolean

Has Token.

hasSecretboolean

Has Secret.

DeliveryRegion2 fields
namestring

Name.

idstring

Id.

DeliveryPoint11 fields
namestring

Name.

locationDeliveryPointsLocation

Location.

addressstring

Address.

addressCommentstring

Address Comment.

notestring

Note.

workTimestring

Work Time.

phonesPhone[]

Phones.

zipCodestring

Zip Code.

codestring

Code.

emailstring

Email.

sitestring

Site.

DeliveryPointsLocation12 fields
addressstring

Address.

codeinteger · int32

Code.

postal_codestring

Postal code.

country_codestring

Country code.

citystring

City.

fias_guidstring

Fias guid.

longitudenumber · float

Longitude.

latitudenumber · float

Latitude.

regionstring

Region.

region_codeinteger · int32

Region code.

address_fullstring

Address full.

city_codestring

City code.

Phone2 fields
numberstring

Number.

additionalstring

Additional.

DeliveryCity2 fields
namestring

Name.

idstring

Id.

AddressDto8 fields
addressstring

Address.

postalCodestring

Postal Code.

regionstring

Region.

localitystring

Locality.

streetstring

Street.

housestring

House.

longitudenumber · double

Longitude.

latitudenumber · double

Latitude.

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENUser locale is en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

Endpoints

POST

Update Delivery Order

/api/delivery/updateDeliveryOrder
Token with write access

Update Delivery Order using POST /api/delivery/updateDeliveryOrder.

Query parameters

FieldTypeRequiredDescription
orderId integer · int64 Yes Order Id.
curl --request POST 'https://api.selsup.ru/api/delivery/updateDeliveryOrder?orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Store Warehouse Delivery

/api/delivery/storeWarehouseDelivery
Token with write access

Store Warehouse Delivery using POST /api/delivery/storeWarehouseDelivery.

Request body

application/json
Object fieldsWarehouseDelivery
FieldTypeRequiredDescription
warehouseDeliveryId integer · int64 No Warehouse Delivery Id.
point string No Point.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Service.
warehouseId integer · int64 No Warehouse Id.
organizationId integer · int64 No Organization Id.
tariffPriority string No Tariff Priority.
priorities object No Priorities.
priorityByMode boolean No Priority By Mode.
additionalServices string No Additional Services.
sendZeroPrice boolean No Send Zero Price.
fakeName string No Fake Name.
hideOrganization boolean No Hide Organization.
sellerOrganizationId integer · int64 No Seller Organization Id.
organization Organization No Organization.
Object fields Organization
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
shortName string No Short Name.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED No Tax Type.
taxRate integer · int32 No Tax Rate.
taxNds integer · int32 No Tax Nds.
inputTaxNds integer · int32 No Input Tax Nds.
outputTaxNds integer · int32 No Output Tax Nds.
enableNewTaxCalculation boolean No Enable New Tax Calculation.
useNdsCostPrice boolean No Use Nds Cost Price.
inn string Yes Inn.
kpp string No Kpp.
bank string No Bank.
bik string No Bik.
corrBill string No Corr Bill.
billNumber string No Bill Number.
stampPath string No Stamp Path.
stampUrl string No Stamp Url.
stampSize integer · int32 No Stamp Size.
stampWidth integer · int32 No Stamp Width.
stampHeight integer · int32 No Stamp Height.
signaturePath string No Signature Path.
signatureUrl string No Signature Url.
signatureSize integer · int32 No Signature Size.
signatureWidth integer · int32 No Signature Width.
signatureHeight integer · int32 No Signature Height.
ipPerson Person No Ip Person.
Object fields Person
FieldTypeRequiredDescription
personId integer · int64 No Person Id.
firstName string Yes First Name.
lastName string Yes Last Name.
surName string No Sur Name.
clientId integer · int64 No Client Id.
position PersonPosition Yes Position.
versionId integer · int64 No Version Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
deleted boolean No Deleted.
userId integer · int32 No User Id.
hasChanges boolean No Has Changes.
fullName string No Full Name.
shortName string No Short Name.
form stringOOO, IP, SELF_EMPLOYED Yes Form.
ip boolean No Ip.
clientId integer · int64 No Client Id.
address Address No Address.
Object fields Address
FieldTypeRequiredDescription
id integer · int32 No Id.
postCode string No Post Code.
country Country No Country.
region Region No Region.
regionId integer · int32 No Region Id.
street string No Street.
house string No House.
district string No District.
city string No City.
locality string No Locality.
building string No Building.
flat string No Flat.
short string No Short.
addressId Address No Address Id.
full string No Full.
phoneNumber string No Phone Number.
addressFull string No Address Full.
additionalServiceForTariff DeliveryTariff No Additional Service For Tariff.
Object fields DeliveryTariff
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
tariffId integer · int32 No Tariff Id.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Shipping Service.
tariffCode integer · int32 No Tariff Code.
externalTariffCode string No External Tariff Code.
tariffName string No Tariff Name.
tariffDescription string No Tariff Description.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode.
additionalServices AdditionalDeliveryServiceDto[] No Additional Services.
Array item structure AdditionalDeliveryServiceDto
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
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"
}'

Success response

200
Object fields WarehouseDelivery
FieldTypeRequiredDescription
warehouseDeliveryId integer · int64 No Warehouse Delivery Id.
point string No Point.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Service.
warehouseId integer · int64 No Warehouse Id.
organizationId integer · int64 No Organization Id.
tariffPriority string No Tariff Priority.
priorities object No Priorities.
priorityByMode boolean No Priority By Mode.
additionalServices string No Additional Services.
sendZeroPrice boolean No Send Zero Price.
fakeName string No Fake Name.
hideOrganization boolean No Hide Organization.
sellerOrganizationId integer · int64 No Seller Organization Id.
organization Organization No Organization.
Object fields Organization
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
shortName string No Short Name.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED No Tax Type.
taxRate integer · int32 No Tax Rate.
taxNds integer · int32 No Tax Nds.
inputTaxNds integer · int32 No Input Tax Nds.
outputTaxNds integer · int32 No Output Tax Nds.
enableNewTaxCalculation boolean No Enable New Tax Calculation.
useNdsCostPrice boolean No Use Nds Cost Price.
inn string Yes Inn.
kpp string No Kpp.
bank string No Bank.
bik string No Bik.
corrBill string No Corr Bill.
billNumber string No Bill Number.
stampPath string No Stamp Path.
stampUrl string No Stamp Url.
stampSize integer · int32 No Stamp Size.
stampWidth integer · int32 No Stamp Width.
stampHeight integer · int32 No Stamp Height.
signaturePath string No Signature Path.
signatureUrl string No Signature Url.
signatureSize integer · int32 No Signature Size.
signatureWidth integer · int32 No Signature Width.
signatureHeight integer · int32 No Signature Height.
ipPerson Person No Ip Person.
Object fields Person
FieldTypeRequiredDescription
personId integer · int64 No Person Id.
firstName string Yes First Name.
lastName string Yes Last Name.
surName string No Sur Name.
clientId integer · int64 No Client Id.
position PersonPosition Yes Position.
versionId integer · int64 No Version Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
deleted boolean No Deleted.
userId integer · int32 No User Id.
hasChanges boolean No Has Changes.
fullName string No Full Name.
shortName string No Short Name.
form stringOOO, IP, SELF_EMPLOYED Yes Form.
ip boolean No Ip.
clientId integer · int64 No Client Id.
address Address No Address.
Object fields Address
FieldTypeRequiredDescription
id integer · int32 No Id.
postCode string No Post Code.
country Country No Country.
region Region No Region.
regionId integer · int32 No Region Id.
street string No Street.
house string No House.
district string No District.
city string No City.
locality string No Locality.
building string No Building.
flat string No Flat.
short string No Short.
addressId Address No Address Id.
full string No Full.
phoneNumber string No Phone Number.
addressFull string No Address Full.
additionalServiceForTariff DeliveryTariff No Additional Service For Tariff.
Object fields DeliveryTariff
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
tariffId integer · int32 No Tariff Id.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Shipping Service.
tariffCode integer · int32 No Tariff Code.
externalTariffCode string No External Tariff Code.
tariffName string No Tariff Name.
tariffDescription string No Tariff Description.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode.
additionalServices AdditionalDeliveryServiceDto[] No Additional Services.
Array item structure AdditionalDeliveryServiceDto
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
{
  "warehouseDeliveryId": 1001,
  "point": "string",
  "service": "CDEK",
  "warehouseId": 1001,
  "organizationId": 1001,
  "tariffPriority": "string"
}
Errors11

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_duplicate_warehouse_delivery_for_warehouse
Delivery service settings cannot be duplicated for the warehouse

Endpoint-specific error. Use the stable error_duplicate_warehouse_delivery_for_warehouse code in application logic; localMessage contains the translation shown above.

400error_empty_shipping_point
The address of dispatch of shipments is not specified

Endpoint-specific error. Use the stable error_empty_shipping_point code in application logic; localMessage contains the translation shown above.

400error_empty_shipping_service
Delivery service not specified

Endpoint-specific error. Use the stable error_empty_shipping_service code in application logic; localMessage contains the translation shown above.

400error_empty_tariff_priority
No priority specified for tariff No.{position}

Endpoint-specific error. Use the stable error_empty_tariff_priority code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_no_warehouse_delivery
The point of departure for the transport company is not specified

Endpoint-specific error. Use the stable error_no_warehouse_delivery code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

POST

Remove Warehouse Delivery

/api/delivery/removeWarehouseDelivery
Token with write access

Remove Warehouse Delivery using POST /api/delivery/removeWarehouseDelivery.

Request body

application/json
Object fieldsWarehouseDelivery
FieldTypeRequiredDescription
warehouseDeliveryId integer · int64 No Warehouse Delivery Id.
point string No Point.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Service.
warehouseId integer · int64 No Warehouse Id.
organizationId integer · int64 No Organization Id.
tariffPriority string No Tariff Priority.
priorities object No Priorities.
priorityByMode boolean No Priority By Mode.
additionalServices string No Additional Services.
sendZeroPrice boolean No Send Zero Price.
fakeName string No Fake Name.
hideOrganization boolean No Hide Organization.
sellerOrganizationId integer · int64 No Seller Organization Id.
organization Organization No Organization.
Object fields Organization
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
shortName string No Short Name.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED No Tax Type.
taxRate integer · int32 No Tax Rate.
taxNds integer · int32 No Tax Nds.
inputTaxNds integer · int32 No Input Tax Nds.
outputTaxNds integer · int32 No Output Tax Nds.
enableNewTaxCalculation boolean No Enable New Tax Calculation.
useNdsCostPrice boolean No Use Nds Cost Price.
inn string Yes Inn.
kpp string No Kpp.
bank string No Bank.
bik string No Bik.
corrBill string No Corr Bill.
billNumber string No Bill Number.
stampPath string No Stamp Path.
stampUrl string No Stamp Url.
stampSize integer · int32 No Stamp Size.
stampWidth integer · int32 No Stamp Width.
stampHeight integer · int32 No Stamp Height.
signaturePath string No Signature Path.
signatureUrl string No Signature Url.
signatureSize integer · int32 No Signature Size.
signatureWidth integer · int32 No Signature Width.
signatureHeight integer · int32 No Signature Height.
ipPerson Person No Ip Person.
Object fields Person
FieldTypeRequiredDescription
personId integer · int64 No Person Id.
firstName string Yes First Name.
lastName string Yes Last Name.
surName string No Sur Name.
clientId integer · int64 No Client Id.
position PersonPosition Yes Position.
versionId integer · int64 No Version Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
deleted boolean No Deleted.
userId integer · int32 No User Id.
hasChanges boolean No Has Changes.
fullName string No Full Name.
shortName string No Short Name.
form stringOOO, IP, SELF_EMPLOYED Yes Form.
ip boolean No Ip.
clientId integer · int64 No Client Id.
address Address No Address.
Object fields Address
FieldTypeRequiredDescription
id integer · int32 No Id.
postCode string No Post Code.
country Country No Country.
region Region No Region.
regionId integer · int32 No Region Id.
street string No Street.
house string No House.
district string No District.
city string No City.
locality string No Locality.
building string No Building.
flat string No Flat.
short string No Short.
addressId Address No Address Id.
full string No Full.
phoneNumber string No Phone Number.
addressFull string No Address Full.
additionalServiceForTariff DeliveryTariff No Additional Service For Tariff.
Object fields DeliveryTariff
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
tariffId integer · int32 No Tariff Id.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Shipping Service.
tariffCode integer · int32 No Tariff Code.
externalTariffCode string No External Tariff Code.
tariffName string No Tariff Name.
tariffDescription string No Tariff Description.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode.
additionalServices AdditionalDeliveryServiceDto[] No Additional Services.
Array item structure AdditionalDeliveryServiceDto
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
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"
}'

Success response

200

The response has no body.

Errors6

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

POST

Order

/api/delivery/order/{orderId}
Token with write access

Order using POST /api/delivery/order/{orderId}.

Path parameters

FieldTypeRequiredDescription
orderId integer · int64 Yes Order Id.

Query parameters

FieldTypeRequiredDescription
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Service.

Request body

application/json
Object fieldsDeliveryTariff
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
tariffId integer · int32 No Tariff Id.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Shipping Service.
tariffCode integer · int32 No Tariff Code.
externalTariffCode string No External Tariff Code.
tariffName string No Tariff Name.
tariffDescription string No Tariff Description.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode.
additionalServices AdditionalDeliveryServiceDto[] No Additional Services.
Array item structure AdditionalDeliveryServiceDto
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
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
}'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Get Tariffs

/api/delivery/getTariffs
Token with write access

Get Tariffs using POST /api/delivery/getTariffs.

Query parameters

FieldTypeRequiredDescription
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
orderId integer · int64 Yes Order Id.
curl --request POST 'https://api.selsup.ru/api/delivery/getTariffs?service=CDEK&orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure DeliveryTariff[]
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
tariffId integer · int32 No Tariff Id.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Shipping Service.
tariffCode integer · int32 No Tariff Code.
externalTariffCode string No External Tariff Code.
tariffName string No Tariff Name.
tariffDescription string No Tariff Description.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode.
additionalServices AdditionalDeliveryServiceDto[] No Additional Services.
Array item structure AdditionalDeliveryServiceDto
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Download Delivery Labels

/api/delivery/downloadDeliveryLabels
Token with write access

Download Delivery Labels using POST /api/delivery/downloadDeliveryLabels.

Query parameters

FieldTypeRequiredDescription
columns FileExportColumn[] No Columns.
Array item structure FileExportColumn
FieldTypeRequiredDescription
id integer · int64 No Id.
fileExportId integer · int64 No File Export Id.
columnName string No Column Name.
columnOrder integer · int32 No Column Order.
isEnabled boolean No Is Enabled.
actual boolean No Actual.
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION No Type.
serviceWarehouseId string No Service Warehouse Id.
externalOrderId string No External Order Id.
invoiceNumber integer · int64 No Invoice Number.
article string No Article.
containsArticle string No Contains Article.
product string No Product.
barcode string No Barcode.
organizations integer[] No Organizations.
query string No Query.
userId integer · int32 No User Id.
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 No Service.
services string[] No Services.
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 No Status.
statuses string[] No Statuses.
withoutSupply boolean No Without Supply.
orderProductId integer · int64 No Order Product Id.
productId integer · int64 No Product Id.
brandId integer · int32 No Brand Id.
supplierId integer · int64 No Supplier Id.
hasCollectTask boolean No Has Collect Task.
organizationId integer · int64 No Organization Id.
clientOrganizationIds integer[] No Client Organization Ids.
updateInService boolean No Update In Service.
hasServiceError boolean No Has Service Error.
noLabel boolean No No Label.
isLegal boolean No Is Legal.
noMsOrder boolean No No Ms Order.
noMsDemand boolean No No Ms Demand.
ids integer[] No Ids.
supplyId integer · int64 No Supply Id.
notCollected boolean No Not Collected.
dbs boolean No Dbs.
express boolean No Express.
fbs boolean No Fbs.
noWarehouse boolean No No Warehouse.
closeDate string No Close Date.
modifiedDate string · date-time No Modified Date.
modifiedDateTo string · date-time No Modified Date To.
incomeId integer · int64 No Income Id.
bindingOrderId integer · int64 No Binding Order Id.
closeDateFrom string · date-time No Close Date From.
closeDateTo string · date-time No Close Date To.
orderDate string No Order Date.
deliveryDate string No Delivery Date.
deliveryDateFrom string No Delivery Date From.
deliveryDateTo string No Delivery Date To.
createdDateFrom string No Created Date From.
createdDateTo string No Created Date To.
forMoySklad boolean No For Moy Sklad.
withMoySkladOrder boolean No With Moy Sklad Order.
warehouseId integer · int64 No Warehouse Id.
warehouseIds integer[] No Warehouse Ids.
dateFrom string · date-time No Date From.
dateTo string · date-time No Date To.
timeZone integer · int32 No Time Zone.
markingStatus stringUNKNOWN, CARDS_SEND, CARDS_CREATED, SUZ_ORDERS_CREATED, MARKS_RECEIVED, CARDS_SIGNED, DOCUMENT_CREATED, SUCCESS, NO_NEED_MARKING No Marking Status.
deleted boolean No Deleted.
collectLabel boolean No Collect Label.
sortOrdersByDate boolean No Sort Orders By Date.
sortBySku boolean No Sort By Sku.
notGroupByOrganization boolean No Not Group By Organization.
notGroupByService boolean No Not Group By Service.
productLabel boolean No Product Label.
productCodeLabel boolean No Product Code Label.
servicesForLabel string[] No Services For Label.
infoLabel boolean No Info Label.
grouped boolean No Grouped.
replaceSetByComponent boolean No Replace Set By Component.
replaceSetsByComponentsIncome boolean No Replace Sets By Components Income.
collectDeliveryLabel boolean No Collect Delivery Label.
shippingServicesForLabel string[] No Shipping Services For Label.
orderId integer · int64 No Order Id.
hasVideoFixation boolean No Has Video Fixation.
withProducts boolean No With Products.
passageIds integer[] No Passage Ids.
withContractor boolean No With Contractor.
boxId integer · int64 No Box Id.
hasMarkedProducts boolean No Has Marked Products.
withAnalytics boolean No With Analytics.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
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 No Sort By.
ascending boolean No Ascending.
curl --request POST 'https://api.selsup.ru/api/delivery/downloadDeliveryLabels?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields TmsTask
FieldTypeRequiredDescription
id integer · int64 No Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION No 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 No Type.
name string No Name.
clientId integer · int64 No Client Id.
entityId integer · int64 No Entity Id.
progress integer · int32 No Progress.
processedQuantity integer · int32 No Processed Quantity.
organizationId integer · int64 No Organization Id.
priority integer · int32 No Priority.
properties string No Properties.
message string No Message.
messageParams string No Message Params.
createdDate string · date-time No Created Date.
startDate string · date-time No Start Date.
finishDate string · date-time No Finish Date.
url string No Url.
inputFileUrl string No Input File Url.
retryNumber integer · int32 No Retry Number.
userId integer · int32 No User Id.
retryDate string · date-time No Retry Date.
debug boolean No Debug.
forcedStart boolean No Forced Start.
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 No Service.
lang string No Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Cancel Delivery Order

/api/delivery/cancelDeliveryOrder
Token with write access

Cancel Delivery Order using POST /api/delivery/cancelDeliveryOrder.

Query parameters

FieldTypeRequiredDescription
orderId integer · int64 Yes Order Id.
curl --request POST 'https://api.selsup.ru/api/delivery/cancelDeliveryOrder?orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Calculate Tariff

/api/delivery/calculateTariff
Token with write access

Calculate Tariff using POST /api/delivery/calculateTariff.

Query parameters

FieldTypeRequiredDescription
tariffCode integer · int32 Yes Tariff Code.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
orderId integer · int64 Yes Order Id.
curl --request POST 'https://api.selsup.ru/api/delivery/calculateTariff?tariffCode=1&service=CDEK&orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields CalculatedDeliveryTariff
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
services object No Services.
locationToCode string No Location To Code.
locationFromCode string No Location From Code.
tariffCode integer · int32 No Tariff Code.
deliveryModeToOrderCreate integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode To Order Create.
deliveryModeList integer[] No Delivery Mode List.
{
  "deliverySum": 1,
  "periodMin": 1,
  "periodMax": 1,
  "calendarMin": 1,
  "calendarMax": 1,
  "services": "string"
}
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Add Delivery Service Integration

/api/delivery/addDeliveryServiceIntegration
Token with write access

Add Delivery Service Integration using POST /api/delivery/addDeliveryServiceIntegration.

Query parameters

FieldTypeRequiredDescription
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
serviceClientId string Yes Service Client Id.
serviceSecret string No Service Secret.
token string No Token.
organizationId integer · int64 Yes Organization Id.
curl --request POST 'https://api.selsup.ru/api/delivery/addDeliveryServiceIntegration?service=CDEK&serviceClientId=string&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Integration

/api/delivery/integration/{organizationId}/{service}
Token with read access

Get Integration using GET /api/delivery/integration/{organizationId}/{service}.

Path parameters

FieldTypeRequiredDescription
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
organizationId integer · int64 Yes Organization Id.
curl --request GET 'https://api.selsup.ru/api/delivery/integration/1001/CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields DeliveryServiceData
FieldTypeRequiredDescription
id integer · int64 No Id.
tokenExpiredDate string · date-time No Token Expired Date.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Service.
serviceClientId string No Service Client Id.
serviceSecret DeliveryServiceData No Service Secret.
clientId integer · int64 No Client Id.
organizationId integer · int64 No Organization Id.
updateToken boolean No Update Token.
hasToken boolean No Has Token.
hasSecret boolean No Has Secret.
{
  "id": 1001,
  "tokenExpiredDate": "2026-01-15T12:00:00Z",
  "service": "CDEK",
  "serviceClientId": "string",
  "serviceSecret": "string",
  "clientId": 1001
}
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Warehouse Delivery

/api/delivery/getWarehouseDelivery
Token with read access

Get Warehouse Delivery using GET /api/delivery/getWarehouseDelivery.

Query parameters

FieldTypeRequiredDescription
organizationId integer · int64 Yes Organization Id.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
curl --request GET 'https://api.selsup.ru/api/delivery/getWarehouseDelivery?organizationId=1001&service=CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure WarehouseDelivery[]
FieldTypeRequiredDescription
warehouseDeliveryId integer · int64 No Warehouse Delivery Id.
point string No Point.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Service.
warehouseId integer · int64 No Warehouse Id.
organizationId integer · int64 No Organization Id.
tariffPriority string No Tariff Priority.
priorities object No Priorities.
priorityByMode boolean No Priority By Mode.
additionalServices string No Additional Services.
sendZeroPrice boolean No Send Zero Price.
fakeName string No Fake Name.
hideOrganization boolean No Hide Organization.
sellerOrganizationId integer · int64 No Seller Organization Id.
organization Organization No Organization.
Object fields Organization
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
shortName string No Short Name.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED No Tax Type.
taxRate integer · int32 No Tax Rate.
taxNds integer · int32 No Tax Nds.
inputTaxNds integer · int32 No Input Tax Nds.
outputTaxNds integer · int32 No Output Tax Nds.
enableNewTaxCalculation boolean No Enable New Tax Calculation.
useNdsCostPrice boolean No Use Nds Cost Price.
inn string Yes Inn.
kpp string No Kpp.
bank string No Bank.
bik string No Bik.
corrBill string No Corr Bill.
billNumber string No Bill Number.
stampPath string No Stamp Path.
stampUrl string No Stamp Url.
stampSize integer · int32 No Stamp Size.
stampWidth integer · int32 No Stamp Width.
stampHeight integer · int32 No Stamp Height.
signaturePath string No Signature Path.
signatureUrl string No Signature Url.
signatureSize integer · int32 No Signature Size.
signatureWidth integer · int32 No Signature Width.
signatureHeight integer · int32 No Signature Height.
ipPerson Person No Ip Person.
Object fields Person
FieldTypeRequiredDescription
personId integer · int64 No Person Id.
firstName string Yes First Name.
lastName string Yes Last Name.
surName string No Sur Name.
clientId integer · int64 No Client Id.
position PersonPosition Yes Position.
versionId integer · int64 No Version Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
deleted boolean No Deleted.
userId integer · int32 No User Id.
hasChanges boolean No Has Changes.
fullName string No Full Name.
shortName string No Short Name.
form stringOOO, IP, SELF_EMPLOYED Yes Form.
ip boolean No Ip.
clientId integer · int64 No Client Id.
address Address No Address.
Object fields Address
FieldTypeRequiredDescription
id integer · int32 No Id.
postCode string No Post Code.
country Country No Country.
region Region No Region.
regionId integer · int32 No Region Id.
street string No Street.
house string No House.
district string No District.
city string No City.
locality string No Locality.
building string No Building.
flat string No Flat.
short string No Short.
addressId Address No Address Id.
full string No Full.
phoneNumber string No Phone Number.
addressFull string No Address Full.
additionalServiceForTariff DeliveryTariff No Additional Service For Tariff.
Object fields DeliveryTariff
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
tariffId integer · int32 No Tariff Id.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Shipping Service.
tariffCode integer · int32 No Tariff Code.
externalTariffCode string No External Tariff Code.
tariffName string No Tariff Name.
tariffDescription string No Tariff Description.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode.
additionalServices AdditionalDeliveryServiceDto[] No Additional Services.
Array item structure AdditionalDeliveryServiceDto
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
[
  "string"
]
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_no_warehouse_delivery
The point of departure for the transport company is not specified

Endpoint-specific error. Use the stable error_no_warehouse_delivery code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

GET

Get Regions

/api/delivery/getRegions
Token with read access

Get Regions using GET /api/delivery/getRegions.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
organizationId integer · int64 Yes Organization Id.
curl --request GET 'https://api.selsup.ru/api/delivery/getRegions?query=string&service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure DeliveryRegion[]
FieldTypeRequiredDescription
name string No Name.
id string No Id.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Points

/api/delivery/getPoints
Token with read access

Get Points using GET /api/delivery/getPoints.

Query parameters

FieldTypeRequiredDescription
postCode string No Post Code.
country string No Country.
region string No Region.
city string No City.
query string No Query.
forSupply boolean No For Supply.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
organizationId integer · int64 Yes Organization Id.
curl --request GET 'https://api.selsup.ru/api/delivery/getPoints?service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure DeliveryPoint[]
FieldTypeRequiredDescription
name string No Name.
location DeliveryPointsLocation No Location.
Object fields DeliveryPointsLocation
FieldTypeRequiredDescription
address string No Address.
code integer · int32 No Code.
postal_code string No Postal code.
country_code string No Country code.
city string No City.
fias_guid string No Fias guid.
longitude number · float No Longitude.
latitude number · float No Latitude.
region string No Region.
region_code integer · int32 No Region code.
address_full string No Address full.
city_code string No City code.
address string No Address.
addressComment string No Address Comment.
note string No Note.
workTime string No Work Time.
phones Phone[] No Phones.
Array item structure Phone
FieldTypeRequiredDescription
number string No Number.
additional string No Additional.
zipCode string No Zip Code.
code string No Code.
email string No Email.
site string No Site.
[
  "string"
]
Errors9

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_empty_delivery_service
No delivery service specified

Endpoint-specific error. Use the stable error_empty_delivery_service code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_no_delivery_integration
No integration with delivery service

Endpoint-specific error. Use the stable error_no_delivery_integration code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

400error_unsupported_delivery_service
delivery service is not supported

Endpoint-specific error. Use the stable error_unsupported_delivery_service code in application logic; localMessage contains the translation shown above.

GET

Get Delivery Tariffs

/api/delivery/getDeliveryTariffs
Token with read access

Get Delivery Tariffs using GET /api/delivery/getDeliveryTariffs.

Query parameters

FieldTypeRequiredDescription
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
query string Yes Query.
curl --request GET 'https://api.selsup.ru/api/delivery/getDeliveryTariffs?service=CDEK&query=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure DeliveryTariff[]
FieldTypeRequiredDescription
deliverySum number · float No Delivery Sum.
periodMin integer · int32 No Period Min.
periodMax integer · int32 No Period Max.
calendarMin integer · int32 No Calendar Min.
calendarMax integer · int32 No Calendar Max.
tariffId integer · int32 No Tariff Id.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST No Shipping Service.
tariffCode integer · int32 No Tariff Code.
externalTariffCode string No External Tariff Code.
tariffName string No Tariff Name.
tariffDescription string No Tariff Description.
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 No Delivery Mode.
additionalServices AdditionalDeliveryServiceDto[] No Additional Services.
Array item structure AdditionalDeliveryServiceDto
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Cities

/api/delivery/getCities
Token with read access

Get Cities using GET /api/delivery/getCities.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
region string Yes Region.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
organizationId integer · int64 Yes Organization Id.
curl --request GET 'https://api.selsup.ru/api/delivery/getCities?query=string&region=string&service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure DeliveryCity[]
FieldTypeRequiredDescription
name string No Name.
id string No Id.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Address

/api/delivery/getAddress
Token with read access

Get Address using GET /api/delivery/getAddress.

Query parameters

FieldTypeRequiredDescription
postCode string No Post Code.
country string No Country.
region string No Region.
city string No City.
query string No Query.
forSupply boolean No For Supply.
curl --request GET 'https://api.selsup.ru/api/delivery/getAddress' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure AddressDto[]
FieldTypeRequiredDescription
address string No Address.
postalCode string No Postal Code.
region string No Region.
locality string No Locality.
street string No Street.
house string No House.
longitude number · double No Longitude.
latitude number · double No Latitude.
[
  "string"
]
Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_cant_get_address
Unable to retrieve the delivery address

Endpoint-specific error. Use the stable error_cant_get_address code in application logic; localMessage contains the translation shown above.

GET

Fetch Delivery Additional Services

/api/delivery/fetchDeliveryServiceAdditionalServices
Token with read access

Fetch Delivery Additional Services using GET /api/delivery/fetchDeliveryServiceAdditionalServices.

Query parameters

FieldTypeRequiredDescription
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
tariffCode integer · int32 No Tariff Code.
curl --request GET 'https://api.selsup.ru/api/delivery/fetchDeliveryServiceAdditionalServices?service=CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure AdditionalDeliveryServiceDto[]
FieldTypeRequiredDescription
code string No Code.
name string No Name.
description string No Description.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

DELETE

Delete Delivery Service Integration

/api/delivery/{service}/{organizationId}
Token with write access

Delete Delivery Service Integration using DELETE /api/delivery/{service}/{organizationId}.

Path parameters

FieldTypeRequiredDescription
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Yes Service.
organizationId integer · int64 Yes Organization Id.
curl --request DELETE 'https://api.selsup.ru/api/delivery/CDEK/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

Authorization

Token for test requests

The token stays in this browser's localStorage and is sent only in the Authorization header of requests to api.selsup.ru.

Try it

Real request parameters

Live API response

Send a request to see the SelSup response.