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

联系方式

fullstring

满满.

Country6 字段
countryIdinteger · int32

国家的身份证.

namestring

姓名.

code2string

代码2

code3string

代码3

namesobject

他们的名字.

printNamestring

打印名字.

DeliveryTariff13 字段
deliverySumnumber · float

交货总额

periodMininteger · int32

时间时间为

periodMaxinteger · int32

时间马克斯.

calendarMininteger · int32

时间表 Min.

calendarMaxinteger · int32

时间表Max.

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

个人.

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

版本ID.

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

消息帕拉姆.

createdDatestring · date-time

创造日期.

startDatestring · date-time

开始日期.

finishDatestring · date-time

终结日期.

urlstring

查看一个URL.

inputFileUrlstring

输入文件URL.

retryNumberinteger · int32

复试号码.

userIdinteger · int32

用户身份证

retryDatestring · date-time

试一次.

debugboolean

调试.

forcedStartboolean

强迫开始.

servicestring

服务.

langstring

Lang.

CalculatedDeliveryTariff11 字段
deliverySumnumber · float

交货总额

periodMininteger · int32

时间时间为

periodMaxinteger · int32

时间马克斯.

calendarMininteger · int32

时间表 Min.

calendarMaxinteger · int32

时间表Max.

servicesobject

服务.

locationToCodestring

位置到代码.

locationFromCodestring

位置从代码.

tariffCodeinteger · int32

关税法

deliveryModeToOrderCreateinteger · int32

交付方式 订单创建.

deliveryModeListinteger[]

交付方式列表

DeliveryServiceData10 字段
idinteger · int64

Id.

tokenExpiredDatestring · date-time

标志的到期日期.

servicestring

服务.

serviceClientIdstring

服务客户身份证.

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周围的应用逻辑,仅用于显示.

鱼类

稳定机器可读的代码用于集成逻辑.

鱼类

在API代币用户语言中显示准备的消息.

鱼类

服务器在本地化消息模板中插入的值.

localMessage使用了 API代币的用户的lang字段.文档语言和 Accept-Language标题不会改变它;当用户没有语言配置时,使用俄语.

RU用户位置是 ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
CN中文 (cn)
{
  "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
具有写入的标志

存储库使用POSTX/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 个人.
对象场 Person
字段类型必填描述
personId integer · int64 个人身份证.
firstName string 姓名
lastName string 姓名
surName string 苏尔名
clientId integer · int64 客户身份证.
position PersonPosition 位置.
versionId integer · int64 版本ID.
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 联系方式
full string 满满.
phoneNumber string 电话号码.
addressFull string 地址是完整的.
additionalServiceForTariff DeliveryTariff 额外的关税服务.
对象场 DeliveryTariff
字段类型必填描述
deliverySum number · float 交货总额
periodMin integer · int32 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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 个人.
对象场 Person
字段类型必填描述
personId integer · int64 个人身份证.
firstName string 姓名
lastName string 姓名
surName string 苏尔名
clientId integer · int64 客户身份证.
position PersonPosition 位置.
versionId integer · int64 版本ID.
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 联系方式
full string 满满.
phoneNumber string 电话号码.
addressFull string 地址是完整的.
additionalServiceForTariff DeliveryTariff 额外的关税服务.
对象场 DeliveryTariff
字段类型必填描述
deliverySum number · float 交货总额
periodMin integer · int32 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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_duplicate_warehouse_delivery_for_warehouse代码;localMessage包含上述翻译.

400error_empty_shipping_point
未指定发货地址

应用逻辑中使用稳定的error_empty_shipping_point代码;localMessage包含上述翻译.

400error_empty_shipping_service
未指定送货服务

应用逻辑中使用稳定的error_empty_shipping_service代码;localMessage包含上述翻译.

400error_empty_tariff_priority
对关税号{position}不给予优先权。

应用逻辑中使用稳定的error_empty_tariff_priority代码;localMessage包含上述翻译.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_no_warehouse_delivery
未指定运输公司的出发点

应用逻辑中使用稳定的error_no_warehouse_delivery代码;localMessage包含上述翻译.

400error_organization_not_found
没有发现任何组织

应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.

400error_subscription_expired
你的费率已经过期。支付关税以继续使用该服务。

应用逻辑中使用稳定的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 个人.
对象场 Person
字段类型必填描述
personId integer · int64 个人身份证.
firstName string 姓名
lastName string 姓名
surName string 苏尔名
clientId integer · int64 客户身份证.
position PersonPosition 位置.
versionId integer · int64 版本ID.
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 联系方式
full string 满满.
phoneNumber string 电话号码.
addressFull string 地址是完整的.
additionalServiceForTariff DeliveryTariff 额外的关税服务.
对象场 DeliveryTariff
字段类型必填描述
deliverySum number · float 交货总额
periodMin integer · int32 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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_no_client代码;localMessage包含上述翻译.

400error_organization_not_found
没有发现任何组织

应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.

400error_subscription_expired
你的费率已经过期。支付关税以继续使用该服务。

应用逻辑中使用稳定的error_subscription_expired代码;localMessage包含上述翻译.

POST

秩序

/api/delivery/order/{orderId}
具有写入的标志

使用POST的订单

路径参数

字段类型必填描述
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 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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
具有写入的标志

使用POSTX/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 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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 订购产品身份证.
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 根据Sku进行排序.
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[] 通过身份证.
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 消息帕拉姆.
createdDate string · date-time 创造日期.
startDate string · date-time 开始日期.
finishDate string · date-time 终结日期.
url string 查看一个URL.
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 取消交付订单

查询参数

字段类型必填描述
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
具有写入的标志

使用POSTX/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 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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 服务客户身份证.
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 服务客户身份证.
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
读取访问的标志

使用GETX/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 个人.
对象场 Person
字段类型必填描述
personId integer · int64 个人身份证.
firstName string 姓名
lastName string 姓名
surName string 苏尔名
clientId integer · int64 客户身份证.
position PersonPosition 位置.
versionId integer · int64 版本ID.
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 联系方式
full string 满满.
phoneNumber string 电话号码.
addressFull string 地址是完整的.
additionalServiceForTariff DeliveryTariff 额外的关税服务.
对象场 DeliveryTariff
字段类型必填描述
deliverySum number · float 交货总额
periodMin integer · int32 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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_no_client代码;localMessage包含上述翻译.

400error_no_warehouse_delivery
未指定运输公司的出发点

应用逻辑中使用稳定的error_no_warehouse_delivery代码;localMessage包含上述翻译.

400error_organization_not_found
没有发现任何组织

应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.

400error_subscription_expired
你的费率已经过期。支付关税以继续使用该服务。

应用逻辑中使用稳定的error_subscription_expired代码;localMessage包含上述翻译.

GET

获取地区

/api/delivery/getRegions
读取访问的标志

使用 GET 获取区域

查询参数

字段类型必填描述
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_empty_delivery_service代码;localMessage包含上述翻译.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_no_delivery_integration
沒有與送貨服務集成

应用逻辑中使用稳定的error_no_delivery_integration代码;localMessage包含上述翻译.

400error_organization_not_found
没有发现任何组织

应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.

400error_subscription_expired
你的费率已经过期。支付关税以继续使用该服务。

应用逻辑中使用稳定的error_subscription_expired代码;localMessage包含上述翻译.

400error_unsupported_delivery_service
不支持的配送服务

应用逻辑中使用稳定的error_unsupported_delivery_service代码;localMessage包含上述翻译.

GET

获取出货关税

/api/delivery/getDeliveryTariffs
读取访问的标志

使用GETX/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 时间时间为
periodMax integer · int32 时间马克斯.
calendarMin integer · int32 时间表 Min.
calendarMax integer · int32 时间表Max.
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
读取访问的标志

使用GETX/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 获取地址

查询参数

字段类型必填描述
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_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的响应.