开始使用Job
使用专用API代币,首先验证测试数据的读取操作.
- 保存代币服务器侧,然后将其发送到Authorization标题中.
- 检查所需参数,并扩大请求或响应方案.
- 在应用错误中处理HTTP状态和稳定的error字段.
通过可编辑的独立合同来支持本页面. 在生产使用之前,验证使用测试数据的写作操作.
/api/job
准备使用的工作流程
使用专用API代币,首先验证测试数据的读取操作.
数据模型
模型在此列出一次,并且可以直接从使用它们的终端点扩展.
idstringId.
namestring姓名.
pricenumber · double价格.
warehouseIdinteger · int64仓库身份证.
currencystring货币.
minimumAmountnumber · double最低量
validFromstring有效的.
validTostring适用于.
organizationIdinteger · int64组织身份证.
vatModestring电气模式.
vatRatenumber · double率
vatIncludedboolean含有
pricenumber · double价格.
validFromstring · date-time有效的.
validTostring · date-time适用于.
indefiniteboolean无限期.
currencystring货币.
minimumAmountnumber · double最低量
idstringId.
namestring姓名.
subjectstring问题.
weightFromnumber · double体重从.
weightTonumber · double体重到.
weightUnitstring体重单位.
lengthFromnumber · double距离的长度.
lengthTonumber · double长度到.
widthFromnumber · double宽度从.
widthTonumber · double宽度到
heightFromnumber · double距离高度.
heightTonumber · double升到高度.
countFromnumber · double伯爵从.
countTonumber · double算到.
countUnitstring伯爵单位.
surchargeMetricstring补充量计.
pricenumber · double价格.
modestring模式.
surchargeThresholdnumber · double额外收费门.
surchargeStepnumber · double补充措施.
surchargeAmountnumber · double额外收费.
roundPartialStepUpboolean圆部分步骤.
clientPricesFulfillmentPriceVariantClientPrice[]客户价格.
clientIdinteger · int64客户身份证.
pricenumber · double价格.
idinteger · int32Id.
namestring姓名.
categoryClassstring类别类.
clientIdinteger · int64客户身份证.
organizationIdinteger · int64组织身份证.
deletedboolean删除了.
positionIdinteger · int64位置身份.
versionIdinteger · int64版本ID.
createdUserstring创建用户.
createdDatestring · date-time创造日期.
pricenumber · double价格.
fulfillmentServiceboolean执行服务.
fulfillmentServiceTypestring服务类型
logisticsTemplatestring运营模板
logisticsPricingConfigLogisticsPricingConfig物流定价配置.
showInFulfillmentProfileboolean显示在实现的个人资料.
fulfillmentProfileWarehouseIdsinteger[]填写档案仓库身份证.
descriptionstring描述
workCategorystring工作类别
calculationUnitstring计算单位.
automaticRequestTypesstring[]系统的要求类型
storageMethodstring存储方法
storageUnitstring储存单位.
storagePricingConfigStoragePricingConfig存储价格配置
vatModestring电气模式.
fulfillmentCategorystring实现类别
unitstring单位.
currencystring货币.
employeeRatenumber · double员工率
employeeCurrencystring员工货币.
vatRatenumber · double率
vatIncludedboolean含有
organizationPricesFulfillmentOrganizationPrice[]组织价格.
plannedClientPriceFulfillmentPlannedPrice预计客户价格.
priceVariantsFulfillmentPriceVariant[]价格变量.
tariffTypesFulfillmentJobTariffType[]关税类型.
minimumAmountnumber · double最低量
priceValidFromstring · date-time价格有效从.
priceValidTostring · date-time价格有效.
employeeRateValidFromstring · date-time员工率有效期
employeeRateValidTostring · date-time员工率有效
sampleboolean样本.
seedCodestring种子代码.
read-onlytariffsJobTariff[]关税.
idinteger · int64Id.
jobIdinteger · int32工作身份证.
pricenumber · double价格.
clientIdinteger · int64客户身份证.
employeeRatenumber · double员工率
brandIdinteger · int32品牌身份证.
categoryClassstring类别类.
categoryIdinteger · int32类别的ID.
priorityinteger · int32优先考虑.
productIdinteger · int64产品身份证
minQuantityinteger · int32微量量.
maxQuantityinteger · int32马克斯量.
validFromstring · date-time有效的.
validTostring · date-time适用于.
changedAtstring · date-time改变了
quantityTointeger · int32量到.
quantityFrominteger · int32量从.
originstring起源.
templatestring模板.
routesLogisticsTariff[]路线.
savedRoutesLogisticsTariff[]拯救路线.
ownPointsOwnPoint[]自己的点.
pointNamestring标题名
marketplacestring市场.
marketplaceWarehouseIdinteger · int64商场仓库身份证.
destinationTypestring目的地类型.
addressstring现在,我有个地址.
vehiclestring车辆.
vehicleNamestring车辆名称.
transportFormatstring运输格式.
transportUnitstring交通部.
pricingTypestring价格类型.
firstUnitPricenumber · double首个单位价格.
nextUnitPricenumber · double下一个单位价格.
pricePerUnitnumber · double单位价格
maximumUnitsinteger · int32最大单位.
maximumSurchargedUnitsinteger · int32充电量最大的单位.
fixedPricenumber · double定价.
commentstring评论.
freeWaitingHoursnumber · double免费等待时间.
waitingPricePerHournumber · double预计每小时的价格.
waitRoundingstring待一下.
waitingTariffsLogisticsWaitingTariff[]预计关税.
vehiclestring车辆.
vehicleNamestring车辆名称.
freeWaitingHoursnumber · double免费等待时间.
waitingPricePerHournumber · double预计每小时的价格.
waitRoundingstring待一下.
pointNamestring标题名
addressstring现在,我有个地址.
marketplacestring市场.
destinationTypestring目的地类型.
toDayinteger · int32现在,我们要去.
pricenumber · double价格.
chargeBasisstring充电基地.
timeUnitstring时间单位.
monthlyCalculationstring计数月数.
freeDaysinteger · int32免费的日子.
agePricingEnabledboolean年龄定价已启用.
ageBasisstring年龄基础.
pricePeriodsStoragePricePeriod[]价格期
minimumQuantitynumber · double极限量.
roundingStepnumber · double圆形步骤.
dispatchDaystring发送日.
pointNamestring标题名
addressstring现在,我有个地址.
marketplacestring市场.
destinationTypestring目的地类型.
rowNumberinteger · int32排号.
jobJob工作.
actionstring行动.
errorstring错误.
previewIdstring预览身份证.
entriesFulfillmentJobImportEntry[]报名.
createdinteger · int32创造了.
updatedinteger · int32更新了.
archivedinteger · int32存档.
errorsinteger · int32错误.
validboolean现在,我们要去.
idinteger · int64Id.
jobIdinteger · int32工作身份证.
tariffIdinteger · int64关税证.
eventTypestring事件类型.
pricenumber · double价格.
employeeRatenumber · double员工率
clientIdinteger · int64客户身份证.
brandIdinteger · int32品牌身份证.
categoryClassstring类别类.
categoryIdinteger · int32类别的ID.
productIdinteger · int64产品身份证
quantityFrominteger · int32量从.
quantityTointeger · int32量到.
validFromstring · date-time有效的.
validTostring · date-time适用于.
changedAtstring · date-time改变了
changedBystring改变了.
错误合同
编程的代码在每个地方都相同,而用户面向的消息由服务器翻译. 建立在error周围的应用逻辑,仅用于显示.
鱼类稳定机器可读的代码用于集成逻辑.
鱼类在API代币用户语言中显示准备的消息.
鱼类服务器在本地化消息模板中插入的值.
localMessage使用了 API代币的用户的lang字段.文档语言和 Accept-Language标题不会改变它;当用户没有语言配置时,使用俄语.
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}{
"error": "error_brand_already_exists",
"localMessage": "品牌 Base 已经存在",
"params": {
"name": "Base"
}
}终点
/api/job/{jobId}通过PUT/api/job/{jobId}. 输入工作
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
jobId |
integer · int32 | 是 | 工作身份证. |
application/jsonJob| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | 否 | 位置身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | 否 | 创造日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | 否 | 执行服务. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | 否 | 服务类型 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | 否 | 运营模板 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | 否 | 物流定价配置. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | 否 | 起源. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | 否 | 模板. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | 否 | 路线. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
savedRoutesLogisticsTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
ownPointsOwnPoint
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
address |
string | 否 | 现在,我有个地址. |
marketplace |
string | 否 | 市场. |
destinationType |
string | 否 | 目的地类型. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfigStoragePricingConfig
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | 否 | 充电基地. | ||||||||||||
timeUnit |
string | 否 | 时间单位. | ||||||||||||
monthlyCalculation |
string | 否 | 计数月数. | ||||||||||||
freeDays |
integer · int32 | 否 | 免费的日子. | ||||||||||||
agePricingEnabled |
boolean | 否 | 年龄定价已启用. | ||||||||||||
ageBasis |
string | 否 | 年龄基础. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | 否 | 价格期 | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
toDay |
integer · int32 | 否 | 现在,我们要去. |
price |
number · double | 否 | 价格. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPricesFulfillmentOrganizationPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
organizationId |
integer · int64 | 否 | 组织身份证. |
vatMode |
string | 否 | 电气模式. |
vatRate |
number · double | 否 | 率 |
vatIncluded |
boolean | 否 | 含有 |
plannedClientPriceFulfillmentPlannedPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
price |
number · double | 否 | 价格. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
indefinite |
boolean | 否 | 无限期. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
priceVariantsFulfillmentPriceVariant
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | 否 | Id. | ||||||||||||
name |
string | 否 | 姓名. | ||||||||||||
subject |
string | 否 | 问题. | ||||||||||||
weightFrom |
number · double | 否 | 体重从. | ||||||||||||
weightTo |
number · double | 否 | 体重到. | ||||||||||||
weightUnit |
string | 否 | 体重单位. | ||||||||||||
lengthFrom |
number · double | 否 | 距离的长度. | ||||||||||||
lengthTo |
number · double | 否 | 长度到. | ||||||||||||
widthFrom |
number · double | 否 | 宽度从. | ||||||||||||
widthTo |
number · double | 否 | 宽度到 | ||||||||||||
heightFrom |
number · double | 否 | 距离高度. | ||||||||||||
heightTo |
number · double | 否 | 升到高度. | ||||||||||||
countFrom |
number · double | 否 | 伯爵从. | ||||||||||||
countTo |
number · double | 否 | 算到. | ||||||||||||
countUnit |
string | 否 | 伯爵单位. | ||||||||||||
surchargeMetric |
string | 否 | 补充量计. | ||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||
mode |
string | 否 | 模式. | ||||||||||||
surchargeThreshold |
number · double | 否 | 额外收费门. | ||||||||||||
surchargeStep |
number · double | 否 | 补充措施. | ||||||||||||
surchargeAmount |
number · double | 否 | 额外收费. | ||||||||||||
roundPartialStepUp |
boolean | 否 | 圆部分步骤. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | 否 | 客户价格. | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
clientId |
integer · int64 | 否 | 客户身份证. |
price |
number · double | 否 | 价格. |
tariffTypesFulfillmentJobTariffType
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
string | 否 | Id. |
name |
string | 否 | 姓名. |
price |
number · double | 否 | 价格. |
warehouseId |
integer · int64 | 否 | 仓库身份证. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
validFrom |
string | 否 | 有效的. |
validTo |
string | 否 | 适用于. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffsJobTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
jobId |
integer · int32 | 否 | 工作身份证. |
price |
number · double | 否 | 价格. |
clientId |
integer · int64 | 否 | 客户身份证. |
employeeRate |
number · double | 否 | 员工率 |
brandId |
integer · int32 | 否 | 品牌身份证. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
categoryId |
integer · int32 | 否 | 类别的ID. |
priority |
integer · int32 | 否 | 优先考虑. |
productId |
integer · int64 | 否 | 产品身份证 |
minQuantity |
integer · int32 | 否 | 微量量. |
maxQuantity |
integer · int32 | 否 | 马克斯量. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
changedAt |
string · date-time | 否 | 改变了 |
quantityTo |
integer · int32 | 否 | 量到. |
quantityFrom |
integer · int32 | 否 | 量从. |
curl --request PUT 'https://api.selsup.ru/api/job/1001' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}'
const response = await fetch('https://api.selsup.ru/api/job/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}),
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.put(
'https://api.selsup.ru/api/job/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'id': 1001,
'name': 'Example',
'categoryClass': 'SHOES',
'clientId': 1001,
'organizationId': 1001,
'deleted': False
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/1001',
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/job/1001", strings.NewReader(`{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("PUT", HttpRequest.BodyPublishers.ofString("""
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Job
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | 否 | 位置身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | 否 | 创造日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | 否 | 执行服务. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | 否 | 服务类型 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | 否 | 运营模板 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | 否 | 物流定价配置. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | 否 | 起源. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | 否 | 模板. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | 否 | 路线. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
savedRoutesLogisticsTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
ownPointsOwnPoint
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
address |
string | 否 | 现在,我有个地址. |
marketplace |
string | 否 | 市场. |
destinationType |
string | 否 | 目的地类型. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfigStoragePricingConfig
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | 否 | 充电基地. | ||||||||||||
timeUnit |
string | 否 | 时间单位. | ||||||||||||
monthlyCalculation |
string | 否 | 计数月数. | ||||||||||||
freeDays |
integer · int32 | 否 | 免费的日子. | ||||||||||||
agePricingEnabled |
boolean | 否 | 年龄定价已启用. | ||||||||||||
ageBasis |
string | 否 | 年龄基础. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | 否 | 价格期 | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
toDay |
integer · int32 | 否 | 现在,我们要去. |
price |
number · double | 否 | 价格. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPricesFulfillmentOrganizationPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
organizationId |
integer · int64 | 否 | 组织身份证. |
vatMode |
string | 否 | 电气模式. |
vatRate |
number · double | 否 | 率 |
vatIncluded |
boolean | 否 | 含有 |
plannedClientPriceFulfillmentPlannedPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
price |
number · double | 否 | 价格. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
indefinite |
boolean | 否 | 无限期. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
priceVariantsFulfillmentPriceVariant
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | 否 | Id. | ||||||||||||
name |
string | 否 | 姓名. | ||||||||||||
subject |
string | 否 | 问题. | ||||||||||||
weightFrom |
number · double | 否 | 体重从. | ||||||||||||
weightTo |
number · double | 否 | 体重到. | ||||||||||||
weightUnit |
string | 否 | 体重单位. | ||||||||||||
lengthFrom |
number · double | 否 | 距离的长度. | ||||||||||||
lengthTo |
number · double | 否 | 长度到. | ||||||||||||
widthFrom |
number · double | 否 | 宽度从. | ||||||||||||
widthTo |
number · double | 否 | 宽度到 | ||||||||||||
heightFrom |
number · double | 否 | 距离高度. | ||||||||||||
heightTo |
number · double | 否 | 升到高度. | ||||||||||||
countFrom |
number · double | 否 | 伯爵从. | ||||||||||||
countTo |
number · double | 否 | 算到. | ||||||||||||
countUnit |
string | 否 | 伯爵单位. | ||||||||||||
surchargeMetric |
string | 否 | 补充量计. | ||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||
mode |
string | 否 | 模式. | ||||||||||||
surchargeThreshold |
number · double | 否 | 额外收费门. | ||||||||||||
surchargeStep |
number · double | 否 | 补充措施. | ||||||||||||
surchargeAmount |
number · double | 否 | 额外收费. | ||||||||||||
roundPartialStepUp |
boolean | 否 | 圆部分步骤. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | 否 | 客户价格. | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
clientId |
integer · int64 | 否 | 客户身份证. |
price |
number · double | 否 | 价格. |
tariffTypesFulfillmentJobTariffType
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
string | 否 | Id. |
name |
string | 否 | 姓名. |
price |
number · double | 否 | 价格. |
warehouseId |
integer · int64 | 否 | 仓库身份证. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
validFrom |
string | 否 | 有效的. |
validTo |
string | 否 | 适用于. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffsJobTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
jobId |
integer · int32 | 否 | 工作身份证. |
price |
number · double | 否 | 价格. |
clientId |
integer · int64 | 否 | 客户身份证. |
employeeRate |
number · double | 否 | 员工率 |
brandId |
integer · int32 | 否 | 品牌身份证. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
categoryId |
integer · int32 | 否 | 类别的ID. |
priority |
integer · int32 | 否 | 优先考虑. |
productId |
integer · int64 | 否 | 产品身份证 |
minQuantity |
integer · int32 | 否 | 微量量. |
maxQuantity |
integer · int32 | 否 | 马克斯量. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
changedAt |
string · date-time | 否 | 改变了 |
quantityTo |
integer · int32 | 否 | 量到. |
quantityFrom |
integer · int32 | 否 | 量从. |
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_cant_extract_tariffs应用逻辑中使用稳定的error_cant_extract_tariffs代码;localMessage包含上述翻译.
error_empty_job_price应用逻辑中使用稳定的error_empty_job_price代码;localMessage包含上述翻译.
error_empty_tariff_price应用逻辑中使用稳定的error_empty_tariff_price代码;localMessage包含上述翻译.
error_empty_tariff_priority应用逻辑中使用稳定的error_empty_tariff_priority代码;localMessage包含上述翻译.
error_empty_tariffs应用逻辑中使用稳定的error_empty_tariffs代码;localMessage包含上述翻译.
error_fulfillment_catalog_organization_required应用逻辑中使用稳定的error_fulfillment_catalog_organization_required代码;localMessage包含上述翻译.
error_fulfillment_invalid_client_pricing应用逻辑中使用稳定的error_fulfillment_invalid_client_pricing代码;localMessage包含上述翻译.
error_invalid_fulfillment_logistics_template应用逻辑中使用稳定的error_invalid_fulfillment_logistics_template代码;localMessage包含上述翻译.
error_invalid_fulfillment_service_type应用逻辑中使用稳定的error_invalid_fulfillment_service_type代码;localMessage包含上述翻译.
error_job_already_exists应用逻辑中使用稳定的error_job_already_exists代码;localMessage包含上述翻译.
error_job_modified应用逻辑中使用稳定的error_job_modified代码;localMessage包含上述翻译.
error_job_tariff_wrong_product_id应用逻辑中使用稳定的error_job_tariff_wrong_product_id代码;localMessage包含上述翻译.
error_logistics_invalid_pricing_config应用逻辑中使用稳定的error_logistics_invalid_pricing_config代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_storage_invalid_pricing_config应用逻辑中使用稳定的error_storage_invalid_pricing_config代码;localMessage包含上述翻译.
error_storage_invalid_pricing_periods应用逻辑中使用稳定的error_storage_invalid_pricing_periods代码;localMessage包含上述翻译.
error_storage_invalid_work应用逻辑中使用稳定的error_storage_invalid_work代码;localMessage包含上述翻译.
/api/job/{jobId}使用 DELETE /api/job/{jobId}. 删除工作
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
jobId |
integer · int32 | 是 | 工作身份证. |
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
deleted |
boolean | 是 | 删除了. |
curl --request DELETE 'https://api.selsup.ru/api/job/1001?deleted=false' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/job/1001?deleted=false', {
method: 'DELETE',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/1001?deleted=false', {
method: 'DELETE',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.delete(
'https://api.selsup.ru/api/job/1001?deleted=false',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/1001?deleted=false',
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/job/1001?deleted=false", nil)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/1001?deleted=false"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
"string"应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_cant_extract_tariffs应用逻辑中使用稳定的error_cant_extract_tariffs代码;localMessage包含上述翻译.
error_job_modified应用逻辑中使用稳定的error_job_modified代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
/api/job/fulfillment/logistics-points使用GET/api/job/fulfillment/logistics-points.获得实现物流点
curl --request GET 'https://api.selsup.ru/api/job/fulfillment/logistics-points' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/job/fulfillment/logistics-points', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/fulfillment/logistics-points', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.get(
'https://api.selsup.ru/api/job/fulfillment/logistics-points',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/fulfillment/logistics-points',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.selsup.ru/api/job/fulfillment/logistics-points", nil)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/fulfillment/logistics-points"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
FulfillmentLogisticsPoint[]
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
address |
string | 否 | 现在,我有个地址. |
marketplace |
string | 否 | 市场. |
destinationType |
string | 否 | 目的地类型. |
[
"string"
]应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
/api/job/fulfillment/logistics-points使用 PUT /api/job/fulfillment/logistics-points. 保存实现物流点
application/jsonFulfillmentLogisticsPoint[]| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
address |
string | 否 | 现在,我有个地址. |
marketplace |
string | 否 | 市场. |
destinationType |
string | 否 | 目的地类型. |
curl --request PUT 'https://api.selsup.ru/api/job/fulfillment/logistics-points' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '[
"string"
]'
const response = await fetch('https://api.selsup.ru/api/job/fulfillment/logistics-points', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify([
"string"
]),
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/fulfillment/logistics-points', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify([
"string"
]),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.put(
'https://api.selsup.ru/api/job/fulfillment/logistics-points',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json=[
'string'
],
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
[
"string"
]
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/fulfillment/logistics-points',
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/job/fulfillment/logistics-points", strings.NewReader(`[
"string"
]`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/fulfillment/logistics-points"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("PUT", HttpRequest.BodyPublishers.ofString("""
[
"string"
]
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
FulfillmentLogisticsPoint[]
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
address |
string | 否 | 现在,我有个地址. |
marketplace |
string | 否 | 市场. |
destinationType |
string | 否 | 目的地类型. |
[
"string"
]应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
/api/job/fulfillment/excel/preview预览 执行使用POST /api/job/fulfillment/excel/preview.
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
organizationId |
integer · int64 | 否 | 组织身份证. |
multipart/form-data| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
file |
string · binary | 是 | 文件. |
curl --request POST 'https://api.selsup.ru/api/job/fulfillment/excel/preview' \
--header 'Authorization: YOUR_API_TOKEN' \
--form 'file=@./file.bin'
const form = new FormData();
form.append('file', fileInput.files[0]);
const response = await fetch('https://api.selsup.ru/api/job/fulfillment/excel/preview', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
body: form,
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const form: FormData = new FormData();
form.append('file', fileInput.files![0]);
const response: Response = await fetch('https://api.selsup.ru/api/job/fulfillment/excel/preview', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
body: form,
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/job/fulfillment/excel/preview',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
files={'file': open('./logo.png', 'rb')},
)
response.raise_for_status()
result = response.json()
<?php
$payload = ['file' => new CURLFile('./logo.png')];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/fulfillment/excel/preview',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"bytes"
"fmt"
"io"
"mime/multipart"
"net/http"
"os"
"path/filepath"
)
func main() {
var body bytes.Buffer
writer := multipart.NewWriter(&body)
file, err := os.Open("./logo.png")
if err != nil { panic(err) }
defer file.Close()
part, err := writer.CreateFormFile("file", filepath.Base(file.Name()))
if err != nil { panic(err) }
if _, err = io.Copy(part, file); err != nil { panic(err) }
writer.Close()
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/job/fulfillment/excel/preview", &body)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", writer.FormDataContentType())
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class SelSupExample {
public static void main(String[] args) throws Exception {
String boundary = "SelSupBoundary" + System.currentTimeMillis();
byte[] file = Files.readAllBytes(Path.of("./logo.png"));
byte[] head = ("--" + boundary + "\r\n" +
"Content-Disposition: form-data; name=\"file\"; filename=\"logo.png\"\r\n" +
"Content-Type: image/png\r\n\r\n").getBytes(StandardCharsets.UTF_8);
byte[] tail = ("\r\n--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8);
byte[] payload = new byte[head.length + file.length + tail.length];
System.arraycopy(head, 0, payload, 0, head.length);
System.arraycopy(file, 0, payload, head.length, file.length);
System.arraycopy(tail, 0, payload, head.length + file.length, tail.length);
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/fulfillment/excel/preview"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "multipart/form-data; boundary=" + boundary)
.method("POST", HttpRequest.BodyPublishers.ofByteArray(payload))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
FulfillmentJobImportPreview
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
previewId |
string | 否 | 预览身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entries |
FulfillmentJobImportEntry[] | 否 | 报名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rowNumber |
integer · int32 | 否 | 排号. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
job |
Job | 否 | 工作. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int32 | 否 | Id. |
name |
string | 否 | 姓名. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
clientId |
integer · int64 | 否 | 客户身份证. |
organizationId |
integer · int64 | 否 | 组织身份证. |
deleted |
boolean | 否 | 删除了. |
positionId |
integer · int64 | 否 | 位置身份. |
versionId |
integer · int64 | 否 | 版本ID. |
createdUser |
string | 否 | 创建用户. |
createdDate |
string · date-time | 否 | 创造日期. |
price |
number · double | 否 | 价格. |
fulfillmentService |
boolean | 否 | 执行服务. |
fulfillmentServiceType |
string | 否 | 服务类型 |
logisticsTemplate |
string | 否 | 运营模板 |
logisticsPricingConfig |
LogisticsPricingConfig | 否 | 物流定价配置. |
showInFulfillmentProfile |
boolean | 否 | 显示在实现的个人资料. |
fulfillmentProfileWarehouseIds |
integer[] | 否 | 填写档案仓库身份证. |
description |
string | 否 | 描述 |
workCategory |
string | 否 | 工作类别 |
calculationUnit |
string | 否 | 计算单位. |
automaticRequestTypes |
string[] | 否 | 系统的要求类型 |
storageMethod |
stringVOLUME, ITEM, PALLET, CELL, FIXED | 否 | 存储方法 |
storageUnit |
stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD | 否 | 储存单位. |
storagePricingConfig |
StoragePricingConfig | 否 | 存储价格配置 |
vatMode |
stringNONE, RATE, COMPANY_SETTINGS | 否 | 电气模式. |
fulfillmentCategory |
string | 否 | 实现类别 |
unit |
string | 否 | 单位. |
currency |
string | 否 | 货币. |
employeeRate |
number · double | 否 | 员工率 |
employeeCurrency |
string | 否 | 员工货币. |
vatRate |
number · double | 否 | 率 |
vatIncluded |
boolean | 否 | 含有 |
organizationPrices |
FulfillmentOrganizationPrice[] | 否 | 组织价格. |
plannedClientPrice |
FulfillmentPlannedPrice | 否 | 预计客户价格. |
priceVariants |
FulfillmentPriceVariant[] | 否 | 价格变量. |
tariffTypes |
FulfillmentJobTariffType[] | 否 | 关税类型. |
minimumAmount |
number · double | 否 | 最低量 |
priceValidFrom |
string · date-time | 否 | 价格有效从. |
priceValidTo |
string · date-time | 否 | 价格有效. |
employeeRateValidFrom |
string · date-time | 否 | 员工率有效期 |
employeeRateValidTo |
string · date-time | 否 | 员工率有效 |
sample |
boolean | 否 | 样本. |
seedCode |
string | 否 | 种子代码. |
tariffs |
JobTariff[] | 否 | 关税. |
actionerrorcreatedupdatedarchivederrorsvalid{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_max_upload_size_exceeded应用逻辑中使用稳定的error_max_upload_size_exceeded代码;localMessage包含上述翻译.
/api/job/fulfillment/excel/apply使用POST/api/job/fulfillment/excel/apply.应用完成工作
application/jsonFulfillmentJobImportPreview| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
previewId |
string | 否 | 预览身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entries |
FulfillmentJobImportEntry[] | 否 | 报名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rowNumber |
integer · int32 | 否 | 排号. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
job |
Job | 否 | 工作. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int32 | 否 | Id. |
name |
string | 否 | 姓名. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
clientId |
integer · int64 | 否 | 客户身份证. |
organizationId |
integer · int64 | 否 | 组织身份证. |
deleted |
boolean | 否 | 删除了. |
positionId |
integer · int64 | 否 | 位置身份. |
versionId |
integer · int64 | 否 | 版本ID. |
createdUser |
string | 否 | 创建用户. |
createdDate |
string · date-time | 否 | 创造日期. |
price |
number · double | 否 | 价格. |
fulfillmentService |
boolean | 否 | 执行服务. |
fulfillmentServiceType |
string | 否 | 服务类型 |
logisticsTemplate |
string | 否 | 运营模板 |
logisticsPricingConfig |
LogisticsPricingConfig | 否 | 物流定价配置. |
showInFulfillmentProfile |
boolean | 否 | 显示在实现的个人资料. |
fulfillmentProfileWarehouseIds |
integer[] | 否 | 填写档案仓库身份证. |
description |
string | 否 | 描述 |
workCategory |
string | 否 | 工作类别 |
calculationUnit |
string | 否 | 计算单位. |
automaticRequestTypes |
string[] | 否 | 系统的要求类型 |
storageMethod |
stringVOLUME, ITEM, PALLET, CELL, FIXED | 否 | 存储方法 |
storageUnit |
stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD | 否 | 储存单位. |
storagePricingConfig |
StoragePricingConfig | 否 | 存储价格配置 |
vatMode |
stringNONE, RATE, COMPANY_SETTINGS | 否 | 电气模式. |
fulfillmentCategory |
string | 否 | 实现类别 |
unit |
string | 否 | 单位. |
currency |
string | 否 | 货币. |
employeeRate |
number · double | 否 | 员工率 |
employeeCurrency |
string | 否 | 员工货币. |
vatRate |
number · double | 否 | 率 |
vatIncluded |
boolean | 否 | 含有 |
organizationPrices |
FulfillmentOrganizationPrice[] | 否 | 组织价格. |
plannedClientPrice |
FulfillmentPlannedPrice | 否 | 预计客户价格. |
priceVariants |
FulfillmentPriceVariant[] | 否 | 价格变量. |
tariffTypes |
FulfillmentJobTariffType[] | 否 | 关税类型. |
minimumAmount |
number · double | 否 | 最低量 |
priceValidFrom |
string · date-time | 否 | 价格有效从. |
priceValidTo |
string · date-time | 否 | 价格有效. |
employeeRateValidFrom |
string · date-time | 否 | 员工率有效期 |
employeeRateValidTo |
string · date-time | 否 | 员工率有效 |
sample |
boolean | 否 | 样本. |
seedCode |
string | 否 | 种子代码. |
tariffs |
JobTariff[] | 否 | 关税. |
actionerrorcreatedupdatedarchivederrorsvalidcurl --request POST 'https://api.selsup.ru/api/job/fulfillment/excel/apply' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}'
const response = await fetch('https://api.selsup.ru/api/job/fulfillment/excel/apply', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}),
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/fulfillment/excel/apply', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/job/fulfillment/excel/apply',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'previewId': 'string',
'entries': 'string',
'created': 1,
'updated': 1,
'archived': 1,
'errors': 1
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/fulfillment/excel/apply',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/job/fulfillment/excel/apply", strings.NewReader(`{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/fulfillment/excel/apply"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
FulfillmentJobImportPreview
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
previewId |
string | 否 | 预览身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entries |
FulfillmentJobImportEntry[] | 否 | 报名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rowNumber |
integer · int32 | 否 | 排号. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
job |
Job | 否 | 工作. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int32 | 否 | Id. |
name |
string | 否 | 姓名. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
clientId |
integer · int64 | 否 | 客户身份证. |
organizationId |
integer · int64 | 否 | 组织身份证. |
deleted |
boolean | 否 | 删除了. |
positionId |
integer · int64 | 否 | 位置身份. |
versionId |
integer · int64 | 否 | 版本ID. |
createdUser |
string | 否 | 创建用户. |
createdDate |
string · date-time | 否 | 创造日期. |
price |
number · double | 否 | 价格. |
fulfillmentService |
boolean | 否 | 执行服务. |
fulfillmentServiceType |
string | 否 | 服务类型 |
logisticsTemplate |
string | 否 | 运营模板 |
logisticsPricingConfig |
LogisticsPricingConfig | 否 | 物流定价配置. |
showInFulfillmentProfile |
boolean | 否 | 显示在实现的个人资料. |
fulfillmentProfileWarehouseIds |
integer[] | 否 | 填写档案仓库身份证. |
description |
string | 否 | 描述 |
workCategory |
string | 否 | 工作类别 |
calculationUnit |
string | 否 | 计算单位. |
automaticRequestTypes |
string[] | 否 | 系统的要求类型 |
storageMethod |
stringVOLUME, ITEM, PALLET, CELL, FIXED | 否 | 存储方法 |
storageUnit |
stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD | 否 | 储存单位. |
storagePricingConfig |
StoragePricingConfig | 否 | 存储价格配置 |
vatMode |
stringNONE, RATE, COMPANY_SETTINGS | 否 | 电气模式. |
fulfillmentCategory |
string | 否 | 实现类别 |
unit |
string | 否 | 单位. |
currency |
string | 否 | 货币. |
employeeRate |
number · double | 否 | 员工率 |
employeeCurrency |
string | 否 | 员工货币. |
vatRate |
number · double | 否 | 率 |
vatIncluded |
boolean | 否 | 含有 |
organizationPrices |
FulfillmentOrganizationPrice[] | 否 | 组织价格. |
plannedClientPrice |
FulfillmentPlannedPrice | 否 | 预计客户价格. |
priceVariants |
FulfillmentPriceVariant[] | 否 | 价格变量. |
tariffTypes |
FulfillmentJobTariffType[] | 否 | 关税类型. |
minimumAmount |
number · double | 否 | 最低量 |
priceValidFrom |
string · date-time | 否 | 价格有效从. |
priceValidTo |
string · date-time | 否 | 价格有效. |
employeeRateValidFrom |
string · date-time | 否 | 员工率有效期 |
employeeRateValidTo |
string · date-time | 否 | 员工率有效 |
sample |
boolean | 否 | 样本. |
seedCode |
string | 否 | 种子代码. |
tariffs |
JobTariff[] | 否 | 关税. |
actionerrorcreatedupdatedarchivederrorsvalid{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_cant_extract_tariffs应用逻辑中使用稳定的error_cant_extract_tariffs代码;localMessage包含上述翻译.
error_empty_job_price应用逻辑中使用稳定的error_empty_job_price代码;localMessage包含上述翻译.
error_empty_tariff_price应用逻辑中使用稳定的error_empty_tariff_price代码;localMessage包含上述翻译.
error_empty_tariff_priority应用逻辑中使用稳定的error_empty_tariff_priority代码;localMessage包含上述翻译.
error_empty_tariffs应用逻辑中使用稳定的error_empty_tariffs代码;localMessage包含上述翻译.
error_fulfillment_catalog_organization_required应用逻辑中使用稳定的error_fulfillment_catalog_organization_required代码;localMessage包含上述翻译.
error_fulfillment_invalid_client_pricing应用逻辑中使用稳定的error_fulfillment_invalid_client_pricing代码;localMessage包含上述翻译.
error_incorrect_excel应用逻辑中使用稳定的error_incorrect_excel代码;localMessage包含上述翻译.
error_invalid_fulfillment_logistics_template应用逻辑中使用稳定的error_invalid_fulfillment_logistics_template代码;localMessage包含上述翻译.
error_invalid_fulfillment_service_type应用逻辑中使用稳定的error_invalid_fulfillment_service_type代码;localMessage包含上述翻译.
error_job_already_exists应用逻辑中使用稳定的error_job_already_exists代码;localMessage包含上述翻译.
error_job_modified应用逻辑中使用稳定的error_job_modified代码;localMessage包含上述翻译.
error_job_tariff_wrong_product_id应用逻辑中使用稳定的error_job_tariff_wrong_product_id代码;localMessage包含上述翻译.
error_logistics_invalid_pricing_config应用逻辑中使用稳定的error_logistics_invalid_pricing_config代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_storage_invalid_pricing_config应用逻辑中使用稳定的error_storage_invalid_pricing_config代码;localMessage包含上述翻译.
error_storage_invalid_pricing_periods应用逻辑中使用稳定的error_storage_invalid_pricing_periods代码;localMessage包含上述翻译.
error_storage_invalid_work应用逻辑中使用稳定的error_storage_invalid_work代码;localMessage包含上述翻译.
/api/job/使用 POST /api/job/. 发布工作
application/jsonJob| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | 否 | 位置身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | 否 | 创造日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | 否 | 执行服务. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | 否 | 服务类型 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | 否 | 运营模板 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | 否 | 物流定价配置. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | 否 | 起源. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | 否 | 模板. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | 否 | 路线. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
savedRoutesLogisticsTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
ownPointsOwnPoint
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
address |
string | 否 | 现在,我有个地址. |
marketplace |
string | 否 | 市场. |
destinationType |
string | 否 | 目的地类型. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfigStoragePricingConfig
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | 否 | 充电基地. | ||||||||||||
timeUnit |
string | 否 | 时间单位. | ||||||||||||
monthlyCalculation |
string | 否 | 计数月数. | ||||||||||||
freeDays |
integer · int32 | 否 | 免费的日子. | ||||||||||||
agePricingEnabled |
boolean | 否 | 年龄定价已启用. | ||||||||||||
ageBasis |
string | 否 | 年龄基础. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | 否 | 价格期 | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
toDay |
integer · int32 | 否 | 现在,我们要去. |
price |
number · double | 否 | 价格. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPricesFulfillmentOrganizationPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
organizationId |
integer · int64 | 否 | 组织身份证. |
vatMode |
string | 否 | 电气模式. |
vatRate |
number · double | 否 | 率 |
vatIncluded |
boolean | 否 | 含有 |
plannedClientPriceFulfillmentPlannedPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
price |
number · double | 否 | 价格. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
indefinite |
boolean | 否 | 无限期. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
priceVariantsFulfillmentPriceVariant
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | 否 | Id. | ||||||||||||
name |
string | 否 | 姓名. | ||||||||||||
subject |
string | 否 | 问题. | ||||||||||||
weightFrom |
number · double | 否 | 体重从. | ||||||||||||
weightTo |
number · double | 否 | 体重到. | ||||||||||||
weightUnit |
string | 否 | 体重单位. | ||||||||||||
lengthFrom |
number · double | 否 | 距离的长度. | ||||||||||||
lengthTo |
number · double | 否 | 长度到. | ||||||||||||
widthFrom |
number · double | 否 | 宽度从. | ||||||||||||
widthTo |
number · double | 否 | 宽度到 | ||||||||||||
heightFrom |
number · double | 否 | 距离高度. | ||||||||||||
heightTo |
number · double | 否 | 升到高度. | ||||||||||||
countFrom |
number · double | 否 | 伯爵从. | ||||||||||||
countTo |
number · double | 否 | 算到. | ||||||||||||
countUnit |
string | 否 | 伯爵单位. | ||||||||||||
surchargeMetric |
string | 否 | 补充量计. | ||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||
mode |
string | 否 | 模式. | ||||||||||||
surchargeThreshold |
number · double | 否 | 额外收费门. | ||||||||||||
surchargeStep |
number · double | 否 | 补充措施. | ||||||||||||
surchargeAmount |
number · double | 否 | 额外收费. | ||||||||||||
roundPartialStepUp |
boolean | 否 | 圆部分步骤. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | 否 | 客户价格. | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
clientId |
integer · int64 | 否 | 客户身份证. |
price |
number · double | 否 | 价格. |
tariffTypesFulfillmentJobTariffType
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
string | 否 | Id. |
name |
string | 否 | 姓名. |
price |
number · double | 否 | 价格. |
warehouseId |
integer · int64 | 否 | 仓库身份证. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
validFrom |
string | 否 | 有效的. |
validTo |
string | 否 | 适用于. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffsJobTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
jobId |
integer · int32 | 否 | 工作身份证. |
price |
number · double | 否 | 价格. |
clientId |
integer · int64 | 否 | 客户身份证. |
employeeRate |
number · double | 否 | 员工率 |
brandId |
integer · int32 | 否 | 品牌身份证. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
categoryId |
integer · int32 | 否 | 类别的ID. |
priority |
integer · int32 | 否 | 优先考虑. |
productId |
integer · int64 | 否 | 产品身份证 |
minQuantity |
integer · int32 | 否 | 微量量. |
maxQuantity |
integer · int32 | 否 | 马克斯量. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
changedAt |
string · date-time | 否 | 改变了 |
quantityTo |
integer · int32 | 否 | 量到. |
quantityFrom |
integer · int32 | 否 | 量从. |
curl --request POST 'https://api.selsup.ru/api/job/' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}'
const response = await fetch('https://api.selsup.ru/api/job/', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}),
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/job/',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'id': 1001,
'name': 'Example',
'categoryClass': 'SHOES',
'clientId': 1001,
'organizationId': 1001,
'deleted': False
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/job/", strings.NewReader(`{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Job
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | 否 | 位置身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | 否 | 创造日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | 否 | 执行服务. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | 否 | 服务类型 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | 否 | 运营模板 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | 否 | 物流定价配置. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | 否 | 起源. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | 否 | 模板. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | 否 | 路线. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
savedRoutesLogisticsTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
marketplace |
string | 否 | 市场. |
marketplaceWarehouseId |
integer · int64 | 否 | 商场仓库身份证. |
destinationType |
string | 否 | 目的地类型. |
address |
string | 否 | 现在,我有个地址. |
vehicle |
string | 否 | 车辆. |
vehicleName |
string | 否 | 车辆名称. |
transportFormat |
string | 否 | 运输格式. |
transportUnit |
string | 否 | 交通部. |
pricingType |
string | 否 | 价格类型. |
firstUnitPrice |
number · double | 否 | 首个单位价格. |
nextUnitPrice |
number · double | 否 | 下一个单位价格. |
pricePerUnit |
number · double | 否 | 单位价格 |
maximumUnits |
integer · int32 | 否 | 最大单位. |
maximumSurchargedUnits |
integer · int32 | 否 | 充电量最大的单位. |
fixedPrice |
number · double | 否 | 定价. |
comment |
string | 否 | 评论. |
freeWaitingHours |
number · double | 否 | 免费等待时间. |
waitingPricePerHour |
number · double | 否 | 预计每小时的价格. |
waitRounding |
string | 否 | 待一下. |
waitingTariffs |
LogisticsWaitingTariff[] | 否 | 预计关税. |
ownPointsOwnPoint
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
pointName |
string | 否 | 标题名 |
address |
string | 否 | 现在,我有个地址. |
marketplace |
string | 否 | 市场. |
destinationType |
string | 否 | 目的地类型. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfigStoragePricingConfig
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | 否 | 充电基地. | ||||||||||||
timeUnit |
string | 否 | 时间单位. | ||||||||||||
monthlyCalculation |
string | 否 | 计数月数. | ||||||||||||
freeDays |
integer · int32 | 否 | 免费的日子. | ||||||||||||
agePricingEnabled |
boolean | 否 | 年龄定价已启用. | ||||||||||||
ageBasis |
string | 否 | 年龄基础. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | 否 | 价格期 | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
toDay |
integer · int32 | 否 | 现在,我们要去. |
price |
number · double | 否 | 价格. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPricesFulfillmentOrganizationPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
organizationId |
integer · int64 | 否 | 组织身份证. |
vatMode |
string | 否 | 电气模式. |
vatRate |
number · double | 否 | 率 |
vatIncluded |
boolean | 否 | 含有 |
plannedClientPriceFulfillmentPlannedPrice
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
price |
number · double | 否 | 价格. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
indefinite |
boolean | 否 | 无限期. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
priceVariantsFulfillmentPriceVariant
| 字段 | 类型 | 必填 | 描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | 否 | Id. | ||||||||||||
name |
string | 否 | 姓名. | ||||||||||||
subject |
string | 否 | 问题. | ||||||||||||
weightFrom |
number · double | 否 | 体重从. | ||||||||||||
weightTo |
number · double | 否 | 体重到. | ||||||||||||
weightUnit |
string | 否 | 体重单位. | ||||||||||||
lengthFrom |
number · double | 否 | 距离的长度. | ||||||||||||
lengthTo |
number · double | 否 | 长度到. | ||||||||||||
widthFrom |
number · double | 否 | 宽度从. | ||||||||||||
widthTo |
number · double | 否 | 宽度到 | ||||||||||||
heightFrom |
number · double | 否 | 距离高度. | ||||||||||||
heightTo |
number · double | 否 | 升到高度. | ||||||||||||
countFrom |
number · double | 否 | 伯爵从. | ||||||||||||
countTo |
number · double | 否 | 算到. | ||||||||||||
countUnit |
string | 否 | 伯爵单位. | ||||||||||||
surchargeMetric |
string | 否 | 补充量计. | ||||||||||||
price |
number · double | 否 | 价格. | ||||||||||||
mode |
string | 否 | 模式. | ||||||||||||
surchargeThreshold |
number · double | 否 | 额外收费门. | ||||||||||||
surchargeStep |
number · double | 否 | 补充措施. | ||||||||||||
surchargeAmount |
number · double | 否 | 额外收费. | ||||||||||||
roundPartialStepUp |
boolean | 否 | 圆部分步骤. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | 否 | 客户价格. | ||||||||||||
阵列项结构
|
|||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
clientId |
integer · int64 | 否 | 客户身份证. |
price |
number · double | 否 | 价格. |
tariffTypesFulfillmentJobTariffType
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
string | 否 | Id. |
name |
string | 否 | 姓名. |
price |
number · double | 否 | 价格. |
warehouseId |
integer · int64 | 否 | 仓库身份证. |
currency |
string | 否 | 货币. |
minimumAmount |
number · double | 否 | 最低量 |
validFrom |
string | 否 | 有效的. |
validTo |
string | 否 | 适用于. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffsJobTariff
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
jobId |
integer · int32 | 否 | 工作身份证. |
price |
number · double | 否 | 价格. |
clientId |
integer · int64 | 否 | 客户身份证. |
employeeRate |
number · double | 否 | 员工率 |
brandId |
integer · int32 | 否 | 品牌身份证. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
categoryId |
integer · int32 | 否 | 类别的ID. |
priority |
integer · int32 | 否 | 优先考虑. |
productId |
integer · int64 | 否 | 产品身份证 |
minQuantity |
integer · int32 | 否 | 微量量. |
maxQuantity |
integer · int32 | 否 | 马克斯量. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
changedAt |
string · date-time | 否 | 改变了 |
quantityTo |
integer · int32 | 否 | 量到. |
quantityFrom |
integer · int32 | 否 | 量从. |
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_cant_extract_tariffs应用逻辑中使用稳定的error_cant_extract_tariffs代码;localMessage包含上述翻译.
error_empty_job_price应用逻辑中使用稳定的error_empty_job_price代码;localMessage包含上述翻译.
error_empty_tariff_price应用逻辑中使用稳定的error_empty_tariff_price代码;localMessage包含上述翻译.
error_empty_tariff_priority应用逻辑中使用稳定的error_empty_tariff_priority代码;localMessage包含上述翻译.
error_empty_tariffs应用逻辑中使用稳定的error_empty_tariffs代码;localMessage包含上述翻译.
error_fulfillment_catalog_organization_required应用逻辑中使用稳定的error_fulfillment_catalog_organization_required代码;localMessage包含上述翻译.
error_fulfillment_invalid_client_pricing应用逻辑中使用稳定的error_fulfillment_invalid_client_pricing代码;localMessage包含上述翻译.
error_invalid_fulfillment_logistics_template应用逻辑中使用稳定的error_invalid_fulfillment_logistics_template代码;localMessage包含上述翻译.
error_invalid_fulfillment_service_type应用逻辑中使用稳定的error_invalid_fulfillment_service_type代码;localMessage包含上述翻译.
error_job_already_exists应用逻辑中使用稳定的error_job_already_exists代码;localMessage包含上述翻译.
error_job_tariff_wrong_product_id应用逻辑中使用稳定的error_job_tariff_wrong_product_id代码;localMessage包含上述翻译.
error_logistics_invalid_pricing_config应用逻辑中使用稳定的error_logistics_invalid_pricing_config代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_storage_invalid_pricing_config应用逻辑中使用稳定的error_storage_invalid_pricing_config代码;localMessage包含上述翻译.
error_storage_invalid_pricing_periods应用逻辑中使用稳定的error_storage_invalid_pricing_periods代码;localMessage包含上述翻译.
error_storage_invalid_work应用逻辑中使用稳定的error_storage_invalid_work代码;localMessage包含上述翻译.
/api/job/{jobId}/tariff-history使用 GET /api/job/{jobId}/tariff-history.获取工作关税历史
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
jobId |
integer · int32 | 是 | 工作身份证. |
curl --request GET 'https://api.selsup.ru/api/job/1001/tariff-history' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/job/1001/tariff-history', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/1001/tariff-history', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.get(
'https://api.selsup.ru/api/job/1001/tariff-history',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/1001/tariff-history',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.selsup.ru/api/job/1001/tariff-history", nil)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/1001/tariff-history"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
JobTariffHistory[]
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
jobId |
integer · int32 | 否 | 工作身份证. |
tariffId |
integer · int64 | 否 | 关税证. |
eventType |
string | 否 | 事件类型. |
price |
number · double | 否 | 价格. |
employeeRate |
number · double | 否 | 员工率 |
clientId |
integer · int64 | 否 | 客户身份证. |
brandId |
integer · int32 | 否 | 品牌身份证. |
categoryClass |
string | 否 | 类别类. |
categoryId |
integer · int32 | 否 | 类别的ID. |
productId |
integer · int64 | 否 | 产品身份证 |
quantityFrom |
integer · int32 | 否 | 量从. |
quantityTo |
integer · int32 | 否 | 量到. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
changedAt |
string · date-time | 否 | 改变了 |
changedBy |
string | 否 | 改变了. |
[
"string"
]应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_cant_extract_tariffs应用逻辑中使用稳定的error_cant_extract_tariffs代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_subscription_expired应用逻辑中使用稳定的error_subscription_expired代码;localMessage包含上述翻译.
/api/job/{jobId}/fulfillment/tariff-history使用 GET /api/job/{jobId}/fulfillment/tariff-history.获取完成工作关税历史
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
jobId |
integer · int32 | 是 | 工作身份证. |
curl --request GET 'https://api.selsup.ru/api/job/1001/fulfillment/tariff-history' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/job/1001/fulfillment/tariff-history', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/1001/fulfillment/tariff-history', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.get(
'https://api.selsup.ru/api/job/1001/fulfillment/tariff-history',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/1001/fulfillment/tariff-history',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.selsup.ru/api/job/1001/fulfillment/tariff-history", nil)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/1001/fulfillment/tariff-history"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
JobTariff[]
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
jobId |
integer · int32 | 否 | 工作身份证. |
price |
number · double | 否 | 价格. |
clientId |
integer · int64 | 否 | 客户身份证. |
employeeRate |
number · double | 否 | 员工率 |
brandId |
integer · int32 | 否 | 品牌身份证. |
categoryClass |
stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS | 否 | 类别类. |
categoryId |
integer · int32 | 否 | 类别的ID. |
priority |
integer · int32 | 否 | 优先考虑. |
productId |
integer · int64 | 否 | 产品身份证 |
minQuantity |
integer · int32 | 否 | 微量量. |
maxQuantity |
integer · int32 | 否 | 马克斯量. |
validFrom |
string · date-time | 否 | 有效的. |
validTo |
string · date-time | 否 | 适用于. |
changedAt |
string · date-time | 否 | 改变了 |
quantityTo |
integer · int32 | 否 | 量到. |
quantityFrom |
integer · int32 | 否 | 量从. |
[
"string"
]应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_cant_extract_tariffs应用逻辑中使用稳定的error_cant_extract_tariffs代码;localMessage包含上述翻译.
error_incorrect_job应用逻辑中使用稳定的error_incorrect_job代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
/api/job/fulfillment/excel运输执行使用GET/api/job/fulfillment/excel.
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
includeCurrent默认值: true |
boolean | 否 | 加入电流. |
organizationId |
integer · int64 | 否 | 组织身份证. |
curl --request GET 'https://api.selsup.ru/api/job/fulfillment/excel' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/job/fulfillment/excel', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/job/fulfillment/excel', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.get(
'https://api.selsup.ru/api/job/fulfillment/excel',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/job/fulfillment/excel',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.selsup.ru/api/job/fulfillment/excel", nil)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/job/fulfillment/excel"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
"string"应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.