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[]

其他服务.

Organization38 字段
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
stampFileNamestring

邮票文件名称

read-only
signaturePathstring

签字之路.

read-only
signatureUrlstring

签字的URL.

read-only
signatureFileNamestring

签名文件名称

read-only
fulfillmentContractSignerNamestring

履行合同签署人名

fulfillmentContractSignerPositionstring

履行合同签署员的位置

signatureSizeinteger · int32

签名大小.

read-only
signatureWidthinteger · int32

签字宽度.

read-only
signatureHeightinteger · int32

签字高度.

read-only
ipPersonPerson

个人.

formstring

形式.

必填
ipboolean

,我知道.

clientIdinteger · int64

客户身份证.

read-only
addressAddress

现在,我有个地址.

phoneNumberstring

电话号码.

addressFullstring

地址是完整的.

read-only
sampleboolean

样本.

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

更新代码.

hasSecretboolean

有秘密.

hasTokenboolean

有代币.

DeliveryRegion2 字段
namestring

姓名.

idstring

Id.

DeliveryPoint11 字段
namestring

姓名.

locationDeliveryPointsLocation

位置.

addressstring

现在,我有个地址.

addressCommentstring

收到的地址评论

notestring

记住.

sitestring

网站.

zipCodestring

邮政码.

codestring

Code.

emailstring

电子邮件.

workTimestring

工作时间.

phonesPhone[]

电话.

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, YSN_GENERAL 否 税收类型.
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 否 邮票高度.
stampFileName string 否 邮票文件名称
signaturePath string 否 签字之路.
signatureUrl string 否 签字的URL.
signatureFileName string 否 签名文件名称
fulfillmentContractSignerName string 否 履行合同签署人名
fulfillmentContractSignerPosition string 否 履行合同签署员的位置
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 否 地址是完整的.
sample boolean 否 样本.
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, YSN_GENERAL 否 税收类型.
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 否 邮票高度.
stampFileName string 否 邮票文件名称
signaturePath string 否 签字之路.
signatureUrl string 否 签字的URL.
signatureFileName string 否 签名文件名称
fulfillmentContractSignerName string 否 履行合同签署人名
fulfillmentContractSignerPosition string 否 履行合同签署员的位置
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 否 地址是完整的.
sample boolean 否 样本.
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"
}
错误12

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_cant_extract_tariffs
无法获取费率。请联系支持团队

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

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, YSN_GENERAL 否 税收类型.
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 否 邮票高度.
stampFileName string 否 邮票文件名称
signaturePath string 否 签字之路.
signatureUrl string 否 签字的URL.
signatureFileName string 否 签名文件名称
fulfillmentContractSignerName string 否 履行合同签署人名
fulfillmentContractSignerPosition string 否 履行合同签署员的位置
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 否 地址是完整的.
sample boolean 否 样本.
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

答案没有身体.

错误7

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_cant_extract_tariffs
无法获取费率。请联系支持团队

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

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.
otherShipments boolean 否 其他货物
shipmentMethod stringPICKUP, DELIVERY 否 运输方式.
shipmentPhase stringNEW, REWORK, COLLECTING, COLLECTED, PACKING, READY_PICKUP, READY_DELIVERY, IN_TRANSIT, SHIPPED, CANCELED 否 运输阶段.
serviceWarehouseId string 否 服务仓库身份证.
externalOrderId string 否 其他类型的信息.
invoiceNumber integer · int64 否 发票号码.
article string 否 关于此的文章.
containsArticle string 否 包含文章.
product string 否 产品
barcode string 否 条码.
organizations integer[] 否 组织.
query string 否 问问.
userId integer · int32 否 用户身份证
closeUserId 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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN 否 服务.
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, REVERSED 否 Status.
statuses string[] 否 法律规定.
withoutSupply boolean 否 没有供应.
orderProductId integer · int64 否 订购产品身份证.
productId integer · int64 否 产品身份证
brandId integer · int32 否 品牌身份证.
supplierId integer · int64 否 供应商身份证
hasCollectTask boolean 否 收藏任务.
organizationId integer · int64 否 组织身份证.
clientOrganizationIds integer[] 否 客户组织的身份证.
fulfillmentClientId integer · int64 否 执行客户身份证.
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 否 接近日期.
checked boolean 否 检查了.
modifiedDate string · date-time 否 修改日期
modifiedDateTo string · date-time 否 修改日期到
incomeId integer · int64 否 收入证.
bindingOrderId integer · int64 否 约束性订单身份证.
closeDateFrom string · date-time 否 接近日期.
closeDateTo string · date-time 否 接近日期.
deliveryTransferDateFrom string · date-time 否 交货转移日期
deliveryTransferDateTo string · date-time 否 交货转移日期到
orderDate string 否 订单日期.
deliveryDate string 否 交货日期.
deliveryDateFrom string 否 交货日期
deliveryDateTo string 否 交货日期到
createdDateFrom string 否 创建日期
createdDateTo string 否 创造日期到.
forMoySklad boolean 否 为了莫伊·斯克拉德.
withMoySkladOrder boolean 否 随着莫伊斯克拉德秩序.
warehouseId integer · int64 否 仓库身份证.
categoryId integer · int32 否 类别的ID.
warehouseIds integer[] 否 仓库身份证.
stockWarehouseId integer · int64 否 库存仓库身份证.
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 否 没有按组服务.
targetCount integer · int32 否 目标数量.
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 否 收藏的文件.
sortType stringsort, non-sort 否 某种类型.
hasMarkedProducts boolean 否 标记产品.
hasMissingMarkingCodes 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, DELIVERYTRANSFERDATE, CHECKED, 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, EXPORT_PURCHASE_PLAN_FILE_TASK, RETAIL_ORDER_PRODUCTS_FILE_TASK, FULFILLMENT_BILLING_REGISTRY_FILE_TASK, SUPPLY_PLANNING_REPORT_FILE_TASK, REBUILD_TAX_BASE_HOURLY_AGGREGATE_TASK, PACK_ORDERS_TASK, IMPORT_ORDER_MARKING_CODES_TASK, PRODUCTION_ANALYTICS_FILE_TASK, CARD_REQUIREMENT_AI_TASK, CARD_REQUIREMENT_SCAN_TASK, SUPPLY_LABELS_FILE_TASK, TRANSFER_PRODUCTS_BETWEEN_SERVICES_TASK, RETIRE_SOLD_OUT_CARDS_TASK, WILDBERRIES_CARDS_JOIN_TASK 否 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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN 否 服务.
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 否 更新代码.
hasSecret boolean 否 有秘密.
hasToken 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, YSN_GENERAL 否 税收类型.
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 否 邮票高度.
stampFileName string 否 邮票文件名称
signaturePath string 否 签字之路.
signatureUrl string 否 签字的URL.
signatureFileName string 否 签名文件名称
fulfillmentContractSignerName string 否 履行合同签署人名
fulfillmentContractSignerPosition string 否 履行合同签署员的位置
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 否 地址是完整的.
sample boolean 否 样本.
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"
]
错误8

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_cant_extract_tariffs
无法获取费率。请联系支持团队

应用逻辑中使用稳定的error_cant_extract_tariffs代码;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包含上述翻译.

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 否 记住.
site string 否 网站.
zipCode string 否 邮政码.
code string 否 Code.
email string 否 电子邮件.
workTime string 否 工作时间.
phones Phone[] 否 电话.
阵列项结构 Phone
字段类型必填描述
number string 否 号码.
additional string 否 其他.
[
  "string"
]
错误10

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_cant_extract_tariffs
无法获取费率。请联系支持团队

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

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

测试请求的标志

获取 API 令牌

代币存储在本浏览器的本地存储库中,只会在要求的Authorization头上发送到 api.selsup.ru.

试一试

实际请求参数

现场API响应

发送请求查看SelSup的响应.