{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}Публичный API · Справочник API
Работы
Справочник работ, логистические точки и импорт каталога работ.
Работы над товарами, например упаковка. Для работы можно назначить цену и учитывать её при расчёте заработной платы.
/api/job
Модель данных
Структуры данных
Поля объектов, которые используются в запросах и ответах этого раздела.
FulfillmentJobTariffType8 полей
idstringПоле id.
namestringПоле name.
pricenumber · doubleПоле price.
warehouseIdinteger · int64Поле warehouseId.
currencystringПоле currency.
minimumAmountnumber · doubleПоле minimumAmount.
validFromstringПоле validFrom.
validTostringПоле validTo.
FulfillmentOrganizationPrice4 полей
organizationIdinteger · int64Поле organizationId.
vatModestringПоле vatMode.
vatRatenumber · doubleПоле vatRate.
vatIncludedbooleanПоле vatIncluded.
FulfillmentPlannedPrice6 полей
pricenumber · doubleПоле price.
validFromstring · date-timeПоле validFrom.
validTostring · date-timeПоле validTo.
indefinitebooleanПоле indefinite.
currencystringПоле currency.
minimumAmountnumber · doubleПоле minimumAmount.
FulfillmentPriceVariant23 полей
idstringПоле id.
namestringПоле name.
subjectstringПоле subject.
weightFromnumber · doubleПоле weightFrom.
weightTonumber · doubleПоле weightTo.
weightUnitstringПоле weightUnit.
lengthFromnumber · doubleПоле lengthFrom.
lengthTonumber · doubleПоле lengthTo.
widthFromnumber · doubleПоле widthFrom.
widthTonumber · doubleПоле widthTo.
heightFromnumber · doubleПоле heightFrom.
heightTonumber · doubleПоле heightTo.
countFromnumber · doubleПоле countFrom.
countTonumber · doubleПоле countTo.
countUnitstringПоле countUnit.
surchargeMetricstringПоле surchargeMetric.
pricenumber · doubleПоле price.
modestringПоле mode.
surchargeThresholdnumber · doubleПоле surchargeThreshold.
surchargeStepnumber · doubleПоле surchargeStep.
surchargeAmountnumber · doubleПоле surchargeAmount.
roundPartialStepUpbooleanПоле roundPartialStepUp.
clientPricesFulfillmentPriceVariantClientPrice[]Поле clientPrices.
FulfillmentPriceVariantClientPrice2 полей
clientIdinteger · int64Поле clientId.
pricenumber · doubleПоле price.
Job44 полей
idinteger · int32Поле id.
namestringПоле name.
categoryClassstringГруппы категорий Честного знака
clientIdinteger · int64Поле clientId.
organizationIdinteger · int64Owning organization of the catalog service; null retains legacy shared scope
deletedbooleanПоле deleted.
positionIdinteger · int64Поле positionId.
versionIdinteger · int64Поле versionId.
createdUserstringПоле createdUser.
createdDatestring · date-timeПоле createdDate.
pricenumber · doubleПоле price.
fulfillmentServicebooleanПоле fulfillmentService.
fulfillmentServiceTypestringПоле fulfillmentServiceType.
logisticsTemplatestringПоле logisticsTemplate.
logisticsPricingConfigLogisticsPricingConfigПоле logisticsPricingConfig.
showInFulfillmentProfilebooleanПоле showInFulfillmentProfile.
fulfillmentProfileWarehouseIdsinteger[]Поле fulfillmentProfileWarehouseIds.
descriptionstringПоле description.
workCategorystringПоле workCategory.
calculationUnitstringПоле calculationUnit.
automaticRequestTypesstring[]Поле automaticRequestTypes.
storageMethodstringПоле storageMethod.
storageUnitstringПоле storageUnit.
storagePricingConfigStoragePricingConfigПоле storagePricingConfig.
vatModestringПоле vatMode.
fulfillmentCategorystringПоле fulfillmentCategory.
unitstringПоле unit.
currencystringПоле currency.
employeeRatenumber · doubleПоле employeeRate.
employeeCurrencystringПоле employeeCurrency.
vatRatenumber · doubleПоле vatRate.
vatIncludedbooleanПоле vatIncluded.
organizationPricesFulfillmentOrganizationPrice[]Поле organizationPrices.
plannedClientPriceFulfillmentPlannedPriceПоле plannedClientPrice.
priceVariantsFulfillmentPriceVariant[]Поле priceVariants.
tariffTypesFulfillmentJobTariffType[]Поле tariffTypes.
minimumAmountnumber · doubleПоле minimumAmount.
priceValidFromstring · date-timeПоле priceValidFrom.
priceValidTostring · date-timeПоле priceValidTo.
employeeRateValidFromstring · date-timeПоле employeeRateValidFrom.
employeeRateValidTostring · date-timeПоле employeeRateValidTo.
samplebooleanРабота создана автоматически как тестовая и подлежит замене
seedCodestringКод сида тестовой работы; обеспечивает повторный запуск без дублей
read-onlytariffsJobTariff[]Поле tariffs.
JobTariff17 полей
idinteger · int64Поле id.
jobIdinteger · int32Поле jobId.
pricenumber · doubleПоле price.
clientIdinteger · int64Поле clientId.
employeeRatenumber · doubleПоле employeeRate.
brandIdinteger · int32Поле brandId.
categoryClassstringГруппы категорий Честного знака
categoryIdinteger · int32Поле categoryId.
priorityinteger · int32Поле priority.
productIdinteger · int64Поле productId.
minQuantityinteger · int32Поле minQuantity.
maxQuantityinteger · int32Поле maxQuantity.
validFromstring · date-timeПоле validFrom.
validTostring · date-timeПоле validTo.
changedAtstring · date-timeПоле changedAt.
quantityTointeger · int32Поле quantityTo.
quantityFrominteger · int32Поле quantityFrom.
LogisticsPricingConfig5 полей
originstringПоле origin.
templatestringПоле template.
routesLogisticsTariff[]Поле routes.
savedRoutesLogisticsTariff[]Поле savedRoutes.
ownPointsOwnPoint[]Поле ownPoints.
LogisticsTariff21 полей
pointNamestringПоле pointName.
marketplacestringПоле marketplace.
marketplaceWarehouseIdinteger · int64Поле marketplaceWarehouseId.
destinationTypestringПоле destinationType.
addressstringПоле address.
vehiclestringПоле vehicle.
vehicleNamestringПоле vehicleName.
transportFormatstringПоле transportFormat.
transportUnitstringПоле transportUnit.
pricingTypestringПоле pricingType.
firstUnitPricenumber · doubleПоле firstUnitPrice.
nextUnitPricenumber · doubleПоле nextUnitPrice.
pricePerUnitnumber · doubleПоле pricePerUnit.
maximumUnitsinteger · int32Поле maximumUnits.
maximumSurchargedUnitsinteger · int32Поле maximumSurchargedUnits.
fixedPricenumber · doubleПоле fixedPrice.
commentstringПоле comment.
freeWaitingHoursnumber · doubleПоле freeWaitingHours.
waitingPricePerHournumber · doubleПоле waitingPricePerHour.
waitRoundingstringПоле waitRounding.
waitingTariffsLogisticsWaitingTariff[]Поле waitingTariffs.
LogisticsWaitingTariff5 полей
vehiclestringПоле vehicle.
vehicleNamestringПоле vehicleName.
freeWaitingHoursnumber · doubleПоле freeWaitingHours.
waitingPricePerHournumber · doubleПоле waitingPricePerHour.
waitRoundingstringПоле waitRounding.
OwnPoint4 полей
pointNamestringПоле pointName.
addressstringПоле address.
marketplacestringПоле marketplace.
destinationTypestringПоле destinationType.
StoragePricePeriod2 полей
toDayinteger · int32Поле toDay.
pricenumber · doubleПоле price.
StoragePricingConfig10 полей
chargeBasisstringПоле chargeBasis.
timeUnitstringПоле timeUnit.
monthlyCalculationstringПоле monthlyCalculation.
freeDaysinteger · int32Поле freeDays.
agePricingEnabledbooleanПоле agePricingEnabled.
ageBasisstringПоле ageBasis.
pricePeriodsStoragePricePeriod[]Поле pricePeriods.
minimumQuantitynumber · doubleПоле minimumQuantity.
roundingStepnumber · doubleПоле roundingStep.
dispatchDaystringПоле dispatchDay.
FulfillmentLogisticsPoint4 полей
pointNamestringПоле pointName.
addressstringПоле address.
marketplacestringПоле marketplace.
destinationTypestringПоле destinationType.
FulfillmentJobImportEntry4 полей
rowNumberinteger · int32Поле rowNumber.
jobJobПоле job.
actionstringПоле action.
errorstringПоле error.
FulfillmentJobImportPreview7 полей
previewIdstringПоле previewId.
entriesFulfillmentJobImportEntry[]Поле entries.
createdinteger · int32Поле created.
updatedinteger · int32Поле updated.
archivedinteger · int32Поле archived.
errorsinteger · int32Поле errors.
validbooleanПоле valid.
JobTariffHistory17 полей
idinteger · int64Поле id.
jobIdinteger · int32Поле jobId.
tariffIdinteger · int64Поле tariffId.
eventTypestringПоле eventType.
pricenumber · doubleПоле price.
employeeRatenumber · doubleПоле employeeRate.
clientIdinteger · int64Поле clientId.
brandIdinteger · int32Поле brandId.
categoryClassstringПоле categoryClass.
categoryIdinteger · int32Поле categoryId.
productIdinteger · int64Поле productId.
quantityFrominteger · int32Поле quantityFrom.
quantityTointeger · int32Поле quantityTo.
validFromstring · date-timeПоле validFrom.
validTostring · date-timeПоле validTo.
changedAtstring · date-timeПоле changedAt.
changedBystringПоле changedBy.
Ошибки
Обработка ошибок
При ошибке API возвращает её код в поле error и сообщение на языке пользователя в localMessage. Проверяйте код error в программе, а localMessage показывайте пользователю.
errorКод ошибки для обработки в программе.
localMessageСообщение на языке пользователя, которому принадлежит токен.
paramsЗначения, которые сервер подставил в сообщение об ошибке.
Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.
{
"error": "error_brand_already_exists",
"localMessage": "Brand Base already exists",
"params": {
"name": "Base"
}
}Методы
Методы
Изменить работу
/api/job/{jobId}Обновляет информацию о работе
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
jobId |
integer · int32 | Да | Поле jobId. |
Тело запроса
application/jsonПоля объектаJob
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Нет | Поле name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | Нет | Поле clientId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Owning organization of the catalog service; null retains legacy shared scope | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Поле deleted. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | Нет | Поле positionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле versionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Поле createdUser. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | Нет | Поле createdDate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | Нет | Поле fulfillmentService. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | Нет | Поле fulfillmentServiceType. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | Нет | Поле logisticsTemplate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | Нет | Поле logisticsPricingConfig. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | Нет | Поле origin. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | Нет | Поле template. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | Нет | Поле routes. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
savedRoutes
Структура элемента массива
LogisticsTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
ownPoints
Структура элемента массива
OwnPoint
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
address |
string | Нет | Поле address. |
marketplace |
string | Нет | Поле marketplace. |
destinationType |
string | Нет | Поле destinationType. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfig
Поля объекта
StoragePricingConfig
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | Нет | Поле chargeBasis. | ||||||||||||
timeUnit |
string | Нет | Поле timeUnit. | ||||||||||||
monthlyCalculation |
string | Нет | Поле monthlyCalculation. | ||||||||||||
freeDays |
integer · int32 | Нет | Поле freeDays. | ||||||||||||
agePricingEnabled |
boolean | Нет | Поле agePricingEnabled. | ||||||||||||
ageBasis |
string | Нет | Поле ageBasis. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | Нет | Поле pricePeriods. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
toDay |
integer · int32 | Нет | Поле toDay. |
price |
number · double | Нет | Поле price. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPrices
Структура элемента массива
FulfillmentOrganizationPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Нет | Поле organizationId. |
vatMode |
string | Нет | Поле vatMode. |
vatRate |
number · double | Нет | Поле vatRate. |
vatIncluded |
boolean | Нет | Поле vatIncluded. |
plannedClientPrice
Поля объекта
FulfillmentPlannedPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
price |
number · double | Нет | Поле price. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
indefinite |
boolean | Нет | Поле indefinite. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
priceVariants
Структура элемента массива
FulfillmentPriceVariant
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | Нет | Поле id. | ||||||||||||
name |
string | Нет | Поле name. | ||||||||||||
subject |
string | Нет | Поле subject. | ||||||||||||
weightFrom |
number · double | Нет | Поле weightFrom. | ||||||||||||
weightTo |
number · double | Нет | Поле weightTo. | ||||||||||||
weightUnit |
string | Нет | Поле weightUnit. | ||||||||||||
lengthFrom |
number · double | Нет | Поле lengthFrom. | ||||||||||||
lengthTo |
number · double | Нет | Поле lengthTo. | ||||||||||||
widthFrom |
number · double | Нет | Поле widthFrom. | ||||||||||||
widthTo |
number · double | Нет | Поле widthTo. | ||||||||||||
heightFrom |
number · double | Нет | Поле heightFrom. | ||||||||||||
heightTo |
number · double | Нет | Поле heightTo. | ||||||||||||
countFrom |
number · double | Нет | Поле countFrom. | ||||||||||||
countTo |
number · double | Нет | Поле countTo. | ||||||||||||
countUnit |
string | Нет | Поле countUnit. | ||||||||||||
surchargeMetric |
string | Нет | Поле surchargeMetric. | ||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||
mode |
string | Нет | Поле mode. | ||||||||||||
surchargeThreshold |
number · double | Нет | Поле surchargeThreshold. | ||||||||||||
surchargeStep |
number · double | Нет | Поле surchargeStep. | ||||||||||||
surchargeAmount |
number · double | Нет | Поле surchargeAmount. | ||||||||||||
roundPartialStepUp |
boolean | Нет | Поле roundPartialStepUp. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | Нет | Поле clientPrices. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
clientId |
integer · int64 | Нет | Поле clientId. |
price |
number · double | Нет | Поле price. |
tariffTypes
Структура элемента массива
FulfillmentJobTariffType
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
string | Нет | Поле id. |
name |
string | Нет | Поле name. |
price |
number · double | Нет | Поле price. |
warehouseId |
integer · int64 | Нет | Поле warehouseId. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
validFrom |
string | Нет | Поле validFrom. |
validTo |
string | Нет | Поле validTo. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffs
Структура элемента массива
JobTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Поле id. |
jobId |
integer · int32 | Нет | Поле jobId. |
price |
number · double | Нет | Поле price. |
clientId |
integer · int64 | Нет | Поле clientId. |
employeeRate |
number · double | Нет | Поле employeeRate. |
brandId |
integer · int32 | Нет | Поле brandId. |
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 | Нет | Поле categoryId. |
priority |
integer · int32 | Нет | Поле priority. |
productId |
integer · int64 | Нет | Поле productId. |
minQuantity |
integer · int32 | Нет | Поле minQuantity. |
maxQuantity |
integer · int32 | Нет | Поле maxQuantity. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
changedAt |
string · date-time | Нет | Поле changedAt. |
quantityTo |
integer · int32 | Нет | Поле quantityTo. |
quantityFrom |
integer · int32 | Нет | Поле quantityFrom. |
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());
}
}
Успешный ответ
200
Поля объекта
Job
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Нет | Поле name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | Нет | Поле clientId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Owning organization of the catalog service; null retains legacy shared scope | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Поле deleted. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | Нет | Поле positionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле versionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Поле createdUser. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | Нет | Поле createdDate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | Нет | Поле fulfillmentService. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | Нет | Поле fulfillmentServiceType. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | Нет | Поле logisticsTemplate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | Нет | Поле logisticsPricingConfig. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | Нет | Поле origin. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | Нет | Поле template. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | Нет | Поле routes. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
savedRoutes
Структура элемента массива
LogisticsTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
ownPoints
Структура элемента массива
OwnPoint
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
address |
string | Нет | Поле address. |
marketplace |
string | Нет | Поле marketplace. |
destinationType |
string | Нет | Поле destinationType. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfig
Поля объекта
StoragePricingConfig
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | Нет | Поле chargeBasis. | ||||||||||||
timeUnit |
string | Нет | Поле timeUnit. | ||||||||||||
monthlyCalculation |
string | Нет | Поле monthlyCalculation. | ||||||||||||
freeDays |
integer · int32 | Нет | Поле freeDays. | ||||||||||||
agePricingEnabled |
boolean | Нет | Поле agePricingEnabled. | ||||||||||||
ageBasis |
string | Нет | Поле ageBasis. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | Нет | Поле pricePeriods. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
toDay |
integer · int32 | Нет | Поле toDay. |
price |
number · double | Нет | Поле price. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPrices
Структура элемента массива
FulfillmentOrganizationPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Нет | Поле organizationId. |
vatMode |
string | Нет | Поле vatMode. |
vatRate |
number · double | Нет | Поле vatRate. |
vatIncluded |
boolean | Нет | Поле vatIncluded. |
plannedClientPrice
Поля объекта
FulfillmentPlannedPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
price |
number · double | Нет | Поле price. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
indefinite |
boolean | Нет | Поле indefinite. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
priceVariants
Структура элемента массива
FulfillmentPriceVariant
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | Нет | Поле id. | ||||||||||||
name |
string | Нет | Поле name. | ||||||||||||
subject |
string | Нет | Поле subject. | ||||||||||||
weightFrom |
number · double | Нет | Поле weightFrom. | ||||||||||||
weightTo |
number · double | Нет | Поле weightTo. | ||||||||||||
weightUnit |
string | Нет | Поле weightUnit. | ||||||||||||
lengthFrom |
number · double | Нет | Поле lengthFrom. | ||||||||||||
lengthTo |
number · double | Нет | Поле lengthTo. | ||||||||||||
widthFrom |
number · double | Нет | Поле widthFrom. | ||||||||||||
widthTo |
number · double | Нет | Поле widthTo. | ||||||||||||
heightFrom |
number · double | Нет | Поле heightFrom. | ||||||||||||
heightTo |
number · double | Нет | Поле heightTo. | ||||||||||||
countFrom |
number · double | Нет | Поле countFrom. | ||||||||||||
countTo |
number · double | Нет | Поле countTo. | ||||||||||||
countUnit |
string | Нет | Поле countUnit. | ||||||||||||
surchargeMetric |
string | Нет | Поле surchargeMetric. | ||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||
mode |
string | Нет | Поле mode. | ||||||||||||
surchargeThreshold |
number · double | Нет | Поле surchargeThreshold. | ||||||||||||
surchargeStep |
number · double | Нет | Поле surchargeStep. | ||||||||||||
surchargeAmount |
number · double | Нет | Поле surchargeAmount. | ||||||||||||
roundPartialStepUp |
boolean | Нет | Поле roundPartialStepUp. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | Нет | Поле clientPrices. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
clientId |
integer · int64 | Нет | Поле clientId. |
price |
number · double | Нет | Поле price. |
tariffTypes
Структура элемента массива
FulfillmentJobTariffType
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
string | Нет | Поле id. |
name |
string | Нет | Поле name. |
price |
number · double | Нет | Поле price. |
warehouseId |
integer · int64 | Нет | Поле warehouseId. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
validFrom |
string | Нет | Поле validFrom. |
validTo |
string | Нет | Поле validTo. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffs
Структура элемента массива
JobTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Поле id. |
jobId |
integer · int32 | Нет | Поле jobId. |
price |
number · double | Нет | Поле price. |
clientId |
integer · int64 | Нет | Поле clientId. |
employeeRate |
number · double | Нет | Поле employeeRate. |
brandId |
integer · int32 | Нет | Поле brandId. |
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 | Нет | Поле categoryId. |
priority |
integer · int32 | Нет | Поле priority. |
productId |
integer · int64 | Нет | Поле productId. |
minQuantity |
integer · int32 | Нет | Поле minQuantity. |
maxQuantity |
integer · int32 | Нет | Поле maxQuantity. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
changedAt |
string · date-time | Нет | Поле changedAt. |
quantityTo |
integer · int32 | Нет | Поле quantityTo. |
quantityFrom |
integer · int32 | Нет | Поле quantityFrom. |
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}Ошибки20
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
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}Удаляет работу помечая ее удаленной
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
jobId |
integer · int32 | Да | Поле jobId. |
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
deleted |
boolean | Да | Поле deleted. |
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());
}
}
Успешный ответ
200"string"Ошибки6
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
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Список собственных точек логистики фулфилмента.
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());
}
}
Успешный ответ
200
Структура элемента массива
FulfillmentLogisticsPoint[]
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
address |
string | Нет | Поле address. |
marketplace |
string | Нет | Поле marketplace. |
destinationType |
string | Нет | Поле destinationType. |
[
"string"
]Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Сохранение собственных точек логистики фулфилмента
/api/job/fulfillment/logistics-pointsСохранение собственных точек логистики фулфилмента.
Тело запроса
application/jsonСтруктура элемента массиваFulfillmentLogisticsPoint[]
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
address |
string | Нет | Поле address. |
marketplace |
string | Нет | Поле marketplace. |
destinationType |
string | Нет | Поле destinationType. |
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());
}
}
Успешный ответ
200
Структура элемента массива
FulfillmentLogisticsPoint[]
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
address |
string | Нет | Поле address. |
marketplace |
string | Нет | Поле marketplace. |
destinationType |
string | Нет | Поле destinationType. |
[
"string"
]Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Предварительная проверка каталога работ из Excel
/api/job/fulfillment/excel/previewПредварительная проверка каталога работ из Excel.
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Нет | Поле organizationId. |
Тело запроса
multipart/form-data| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
file |
string · binary | Да | Поле file. |
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());
}
}
Успешный ответ
200
Поля объекта
FulfillmentJobImportPreview
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
previewId |
string | Нет | Поле previewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entries |
FulfillmentJobImportEntry[] | Нет | Поле entries. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rowNumber |
integer · int32 | Нет | Поле rowNumber. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
job |
Job | Нет | Поле job. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
name |
string | Нет | Поле name. |
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 | Нет | Поле clientId. |
organizationId |
integer · int64 | Нет | Owning organization of the catalog service; null retains legacy shared scope |
deleted |
boolean | Нет | Поле deleted. |
positionId |
integer · int64 | Нет | Поле positionId. |
versionId |
integer · int64 | Нет | Поле versionId. |
createdUser |
string | Нет | Поле createdUser. |
createdDate |
string · date-time | Нет | Поле createdDate. |
price |
number · double | Нет | Поле price. |
fulfillmentService |
boolean | Нет | Поле fulfillmentService. |
fulfillmentServiceType |
string | Нет | Поле fulfillmentServiceType. |
logisticsTemplate |
string | Нет | Поле logisticsTemplate. |
logisticsPricingConfig |
LogisticsPricingConfig | Нет | Поле logisticsPricingConfig. |
showInFulfillmentProfile |
boolean | Нет | Поле showInFulfillmentProfile. |
fulfillmentProfileWarehouseIds |
integer[] | Нет | Поле fulfillmentProfileWarehouseIds. |
description |
string | Нет | Поле description. |
workCategory |
string | Нет | Поле workCategory. |
calculationUnit |
string | Нет | Поле calculationUnit. |
automaticRequestTypes |
string[] | Нет | Поле automaticRequestTypes. |
storageMethod |
stringVOLUME, ITEM, PALLET, CELL, FIXED | Нет | Поле storageMethod. |
storageUnit |
stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD | Нет | Поле storageUnit. |
storagePricingConfig |
StoragePricingConfig | Нет | Поле storagePricingConfig. |
vatMode |
stringNONE, RATE, COMPANY_SETTINGS | Нет | Поле vatMode. |
fulfillmentCategory |
string | Нет | Поле fulfillmentCategory. |
unit |
string | Нет | Поле unit. |
currency |
string | Нет | Поле currency. |
employeeRate |
number · double | Нет | Поле employeeRate. |
employeeCurrency |
string | Нет | Поле employeeCurrency. |
vatRate |
number · double | Нет | Поле vatRate. |
vatIncluded |
boolean | Нет | Поле vatIncluded. |
organizationPrices |
FulfillmentOrganizationPrice[] | Нет | Поле organizationPrices. |
plannedClientPrice |
FulfillmentPlannedPrice | Нет | Поле plannedClientPrice. |
priceVariants |
FulfillmentPriceVariant[] | Нет | Поле priceVariants. |
tariffTypes |
FulfillmentJobTariffType[] | Нет | Поле tariffTypes. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
priceValidFrom |
string · date-time | Нет | Поле priceValidFrom. |
priceValidTo |
string · date-time | Нет | Поле priceValidTo. |
employeeRateValidFrom |
string · date-time | Нет | Поле employeeRateValidFrom. |
employeeRateValidTo |
string · date-time | Нет | Поле employeeRateValidTo. |
sample |
boolean | Нет | Работа создана автоматически как тестовая и подлежит замене |
seedCode |
string | Нет | Код сида тестовой работы; обеспечивает повторный запуск без дублей |
tariffs |
JobTariff[] | Нет | Поле tariffs. |
actionerrorcreatedupdatedarchivederrorsvalid{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}Ошибки4
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_max_upload_size_exceededПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_max_upload_size_exceeded; localMessage содержит приведённый выше перевод.
Подтверждение импорта каталога работ из Excel
/api/job/fulfillment/excel/applyПодтверждение импорта каталога работ из Excel.
Тело запроса
application/jsonПоля объектаFulfillmentJobImportPreview
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
previewId |
string | Нет | Поле previewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entries |
FulfillmentJobImportEntry[] | Нет | Поле entries. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rowNumber |
integer · int32 | Нет | Поле rowNumber. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
job |
Job | Нет | Поле job. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
name |
string | Нет | Поле name. |
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 | Нет | Поле clientId. |
organizationId |
integer · int64 | Нет | Owning organization of the catalog service; null retains legacy shared scope |
deleted |
boolean | Нет | Поле deleted. |
positionId |
integer · int64 | Нет | Поле positionId. |
versionId |
integer · int64 | Нет | Поле versionId. |
createdUser |
string | Нет | Поле createdUser. |
createdDate |
string · date-time | Нет | Поле createdDate. |
price |
number · double | Нет | Поле price. |
fulfillmentService |
boolean | Нет | Поле fulfillmentService. |
fulfillmentServiceType |
string | Нет | Поле fulfillmentServiceType. |
logisticsTemplate |
string | Нет | Поле logisticsTemplate. |
logisticsPricingConfig |
LogisticsPricingConfig | Нет | Поле logisticsPricingConfig. |
showInFulfillmentProfile |
boolean | Нет | Поле showInFulfillmentProfile. |
fulfillmentProfileWarehouseIds |
integer[] | Нет | Поле fulfillmentProfileWarehouseIds. |
description |
string | Нет | Поле description. |
workCategory |
string | Нет | Поле workCategory. |
calculationUnit |
string | Нет | Поле calculationUnit. |
automaticRequestTypes |
string[] | Нет | Поле automaticRequestTypes. |
storageMethod |
stringVOLUME, ITEM, PALLET, CELL, FIXED | Нет | Поле storageMethod. |
storageUnit |
stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD | Нет | Поле storageUnit. |
storagePricingConfig |
StoragePricingConfig | Нет | Поле storagePricingConfig. |
vatMode |
stringNONE, RATE, COMPANY_SETTINGS | Нет | Поле vatMode. |
fulfillmentCategory |
string | Нет | Поле fulfillmentCategory. |
unit |
string | Нет | Поле unit. |
currency |
string | Нет | Поле currency. |
employeeRate |
number · double | Нет | Поле employeeRate. |
employeeCurrency |
string | Нет | Поле employeeCurrency. |
vatRate |
number · double | Нет | Поле vatRate. |
vatIncluded |
boolean | Нет | Поле vatIncluded. |
organizationPrices |
FulfillmentOrganizationPrice[] | Нет | Поле organizationPrices. |
plannedClientPrice |
FulfillmentPlannedPrice | Нет | Поле plannedClientPrice. |
priceVariants |
FulfillmentPriceVariant[] | Нет | Поле priceVariants. |
tariffTypes |
FulfillmentJobTariffType[] | Нет | Поле tariffTypes. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
priceValidFrom |
string · date-time | Нет | Поле priceValidFrom. |
priceValidTo |
string · date-time | Нет | Поле priceValidTo. |
employeeRateValidFrom |
string · date-time | Нет | Поле employeeRateValidFrom. |
employeeRateValidTo |
string · date-time | Нет | Поле employeeRateValidTo. |
sample |
boolean | Нет | Работа создана автоматически как тестовая и подлежит замене |
seedCode |
string | Нет | Код сида тестовой работы; обеспечивает повторный запуск без дублей |
tariffs |
JobTariff[] | Нет | Поле tariffs. |
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());
}
}
Успешный ответ
200
Поля объекта
FulfillmentJobImportPreview
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
previewId |
string | Нет | Поле previewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entries |
FulfillmentJobImportEntry[] | Нет | Поле entries. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rowNumber |
integer · int32 | Нет | Поле rowNumber. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
job |
Job | Нет | Поле job. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
name |
string | Нет | Поле name. |
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 | Нет | Поле clientId. |
organizationId |
integer · int64 | Нет | Owning organization of the catalog service; null retains legacy shared scope |
deleted |
boolean | Нет | Поле deleted. |
positionId |
integer · int64 | Нет | Поле positionId. |
versionId |
integer · int64 | Нет | Поле versionId. |
createdUser |
string | Нет | Поле createdUser. |
createdDate |
string · date-time | Нет | Поле createdDate. |
price |
number · double | Нет | Поле price. |
fulfillmentService |
boolean | Нет | Поле fulfillmentService. |
fulfillmentServiceType |
string | Нет | Поле fulfillmentServiceType. |
logisticsTemplate |
string | Нет | Поле logisticsTemplate. |
logisticsPricingConfig |
LogisticsPricingConfig | Нет | Поле logisticsPricingConfig. |
showInFulfillmentProfile |
boolean | Нет | Поле showInFulfillmentProfile. |
fulfillmentProfileWarehouseIds |
integer[] | Нет | Поле fulfillmentProfileWarehouseIds. |
description |
string | Нет | Поле description. |
workCategory |
string | Нет | Поле workCategory. |
calculationUnit |
string | Нет | Поле calculationUnit. |
automaticRequestTypes |
string[] | Нет | Поле automaticRequestTypes. |
storageMethod |
stringVOLUME, ITEM, PALLET, CELL, FIXED | Нет | Поле storageMethod. |
storageUnit |
stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD | Нет | Поле storageUnit. |
storagePricingConfig |
StoragePricingConfig | Нет | Поле storagePricingConfig. |
vatMode |
stringNONE, RATE, COMPANY_SETTINGS | Нет | Поле vatMode. |
fulfillmentCategory |
string | Нет | Поле fulfillmentCategory. |
unit |
string | Нет | Поле unit. |
currency |
string | Нет | Поле currency. |
employeeRate |
number · double | Нет | Поле employeeRate. |
employeeCurrency |
string | Нет | Поле employeeCurrency. |
vatRate |
number · double | Нет | Поле vatRate. |
vatIncluded |
boolean | Нет | Поле vatIncluded. |
organizationPrices |
FulfillmentOrganizationPrice[] | Нет | Поле organizationPrices. |
plannedClientPrice |
FulfillmentPlannedPrice | Нет | Поле plannedClientPrice. |
priceVariants |
FulfillmentPriceVariant[] | Нет | Поле priceVariants. |
tariffTypes |
FulfillmentJobTariffType[] | Нет | Поле tariffTypes. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
priceValidFrom |
string · date-time | Нет | Поле priceValidFrom. |
priceValidTo |
string · date-time | Нет | Поле priceValidTo. |
employeeRateValidFrom |
string · date-time | Нет | Поле employeeRateValidFrom. |
employeeRateValidTo |
string · date-time | Нет | Поле employeeRateValidTo. |
sample |
boolean | Нет | Работа создана автоматически как тестовая и подлежит замене |
seedCode |
string | Нет | Код сида тестовой работы; обеспечивает повторный запуск без дублей |
tariffs |
JobTariff[] | Нет | Поле tariffs. |
actionerrorcreatedupdatedarchivederrorsvalid{
"previewId": "string",
"entries": "string",
"created": 1,
"updated": 1,
"archived": 1,
"errors": 1
}Ошибки21
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
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/Создает новую работу, которую можно выполнять
Тело запроса
application/jsonПоля объектаJob
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Нет | Поле name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | Нет | Поле clientId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Owning organization of the catalog service; null retains legacy shared scope | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Поле deleted. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | Нет | Поле positionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле versionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Поле createdUser. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | Нет | Поле createdDate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | Нет | Поле fulfillmentService. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | Нет | Поле fulfillmentServiceType. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | Нет | Поле logisticsTemplate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | Нет | Поле logisticsPricingConfig. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | Нет | Поле origin. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | Нет | Поле template. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | Нет | Поле routes. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
savedRoutes
Структура элемента массива
LogisticsTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
ownPoints
Структура элемента массива
OwnPoint
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
address |
string | Нет | Поле address. |
marketplace |
string | Нет | Поле marketplace. |
destinationType |
string | Нет | Поле destinationType. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfig
Поля объекта
StoragePricingConfig
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | Нет | Поле chargeBasis. | ||||||||||||
timeUnit |
string | Нет | Поле timeUnit. | ||||||||||||
monthlyCalculation |
string | Нет | Поле monthlyCalculation. | ||||||||||||
freeDays |
integer · int32 | Нет | Поле freeDays. | ||||||||||||
agePricingEnabled |
boolean | Нет | Поле agePricingEnabled. | ||||||||||||
ageBasis |
string | Нет | Поле ageBasis. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | Нет | Поле pricePeriods. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
toDay |
integer · int32 | Нет | Поле toDay. |
price |
number · double | Нет | Поле price. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPrices
Структура элемента массива
FulfillmentOrganizationPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Нет | Поле organizationId. |
vatMode |
string | Нет | Поле vatMode. |
vatRate |
number · double | Нет | Поле vatRate. |
vatIncluded |
boolean | Нет | Поле vatIncluded. |
plannedClientPrice
Поля объекта
FulfillmentPlannedPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
price |
number · double | Нет | Поле price. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
indefinite |
boolean | Нет | Поле indefinite. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
priceVariants
Структура элемента массива
FulfillmentPriceVariant
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | Нет | Поле id. | ||||||||||||
name |
string | Нет | Поле name. | ||||||||||||
subject |
string | Нет | Поле subject. | ||||||||||||
weightFrom |
number · double | Нет | Поле weightFrom. | ||||||||||||
weightTo |
number · double | Нет | Поле weightTo. | ||||||||||||
weightUnit |
string | Нет | Поле weightUnit. | ||||||||||||
lengthFrom |
number · double | Нет | Поле lengthFrom. | ||||||||||||
lengthTo |
number · double | Нет | Поле lengthTo. | ||||||||||||
widthFrom |
number · double | Нет | Поле widthFrom. | ||||||||||||
widthTo |
number · double | Нет | Поле widthTo. | ||||||||||||
heightFrom |
number · double | Нет | Поле heightFrom. | ||||||||||||
heightTo |
number · double | Нет | Поле heightTo. | ||||||||||||
countFrom |
number · double | Нет | Поле countFrom. | ||||||||||||
countTo |
number · double | Нет | Поле countTo. | ||||||||||||
countUnit |
string | Нет | Поле countUnit. | ||||||||||||
surchargeMetric |
string | Нет | Поле surchargeMetric. | ||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||
mode |
string | Нет | Поле mode. | ||||||||||||
surchargeThreshold |
number · double | Нет | Поле surchargeThreshold. | ||||||||||||
surchargeStep |
number · double | Нет | Поле surchargeStep. | ||||||||||||
surchargeAmount |
number · double | Нет | Поле surchargeAmount. | ||||||||||||
roundPartialStepUp |
boolean | Нет | Поле roundPartialStepUp. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | Нет | Поле clientPrices. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
clientId |
integer · int64 | Нет | Поле clientId. |
price |
number · double | Нет | Поле price. |
tariffTypes
Структура элемента массива
FulfillmentJobTariffType
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
string | Нет | Поле id. |
name |
string | Нет | Поле name. |
price |
number · double | Нет | Поле price. |
warehouseId |
integer · int64 | Нет | Поле warehouseId. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
validFrom |
string | Нет | Поле validFrom. |
validTo |
string | Нет | Поле validTo. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffs
Структура элемента массива
JobTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Поле id. |
jobId |
integer · int32 | Нет | Поле jobId. |
price |
number · double | Нет | Поле price. |
clientId |
integer · int64 | Нет | Поле clientId. |
employeeRate |
number · double | Нет | Поле employeeRate. |
brandId |
integer · int32 | Нет | Поле brandId. |
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 | Нет | Поле categoryId. |
priority |
integer · int32 | Нет | Поле priority. |
productId |
integer · int64 | Нет | Поле productId. |
minQuantity |
integer · int32 | Нет | Поле minQuantity. |
maxQuantity |
integer · int32 | Нет | Поле maxQuantity. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
changedAt |
string · date-time | Нет | Поле changedAt. |
quantityTo |
integer · int32 | Нет | Поле quantityTo. |
quantityFrom |
integer · int32 | Нет | Поле quantityFrom. |
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());
}
}
Успешный ответ
200
Поля объекта
Job
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int32 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Нет | Поле name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | Нет | Поле clientId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Owning organization of the catalog service; null retains legacy shared scope | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Поле deleted. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
positionId |
integer · int64 | Нет | Поле positionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле versionId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Поле createdUser. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate |
string · date-time | Нет | Поле createdDate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentService |
boolean | Нет | Поле fulfillmentService. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentServiceType |
string | Нет | Поле fulfillmentServiceType. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsTemplate |
string | Нет | Поле logisticsTemplate. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logisticsPricingConfig |
LogisticsPricingConfig | Нет | Поле logisticsPricingConfig. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
origin |
string | Нет | Поле origin. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template |
string | Нет | Поле template. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
routes |
LogisticsTariff[] | Нет | Поле routes. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
savedRoutes
Структура элемента массива
LogisticsTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
marketplace |
string | Нет | Поле marketplace. |
marketplaceWarehouseId |
integer · int64 | Нет | Поле marketplaceWarehouseId. |
destinationType |
string | Нет | Поле destinationType. |
address |
string | Нет | Поле address. |
vehicle |
string | Нет | Поле vehicle. |
vehicleName |
string | Нет | Поле vehicleName. |
transportFormat |
string | Нет | Поле transportFormat. |
transportUnit |
string | Нет | Поле transportUnit. |
pricingType |
string | Нет | Поле pricingType. |
firstUnitPrice |
number · double | Нет | Поле firstUnitPrice. |
nextUnitPrice |
number · double | Нет | Поле nextUnitPrice. |
pricePerUnit |
number · double | Нет | Поле pricePerUnit. |
maximumUnits |
integer · int32 | Нет | Поле maximumUnits. |
maximumSurchargedUnits |
integer · int32 | Нет | Поле maximumSurchargedUnits. |
fixedPrice |
number · double | Нет | Поле fixedPrice. |
comment |
string | Нет | Поле comment. |
freeWaitingHours |
number · double | Нет | Поле freeWaitingHours. |
waitingPricePerHour |
number · double | Нет | Поле waitingPricePerHour. |
waitRounding |
string | Нет | Поле waitRounding. |
waitingTariffs |
LogisticsWaitingTariff[] | Нет | Поле waitingTariffs. |
ownPoints
Структура элемента массива
OwnPoint
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
pointName |
string | Нет | Поле pointName. |
address |
string | Нет | Поле address. |
marketplace |
string | Нет | Поле marketplace. |
destinationType |
string | Нет | Поле destinationType. |
showInFulfillmentProfilefulfillmentProfileWarehouseIdsdescriptionworkCategorycalculationUnitautomaticRequestTypesstorageMethodstorageUnitstoragePricingConfig
Поля объекта
StoragePricingConfig
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
chargeBasis |
string | Нет | Поле chargeBasis. | ||||||||||||
timeUnit |
string | Нет | Поле timeUnit. | ||||||||||||
monthlyCalculation |
string | Нет | Поле monthlyCalculation. | ||||||||||||
freeDays |
integer · int32 | Нет | Поле freeDays. | ||||||||||||
agePricingEnabled |
boolean | Нет | Поле agePricingEnabled. | ||||||||||||
ageBasis |
string | Нет | Поле ageBasis. | ||||||||||||
pricePeriods |
StoragePricePeriod[] | Нет | Поле pricePeriods. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
toDay |
integer · int32 | Нет | Поле toDay. |
price |
number · double | Нет | Поле price. |
minimumQuantityroundingStepdispatchDayvatModefulfillmentCategoryunitcurrencyemployeeRateemployeeCurrencyvatRatevatIncludedorganizationPrices
Структура элемента массива
FulfillmentOrganizationPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Нет | Поле organizationId. |
vatMode |
string | Нет | Поле vatMode. |
vatRate |
number · double | Нет | Поле vatRate. |
vatIncluded |
boolean | Нет | Поле vatIncluded. |
plannedClientPrice
Поля объекта
FulfillmentPlannedPrice
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
price |
number · double | Нет | Поле price. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
indefinite |
boolean | Нет | Поле indefinite. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
priceVariants
Структура элемента массива
FulfillmentPriceVariant
| Поле | Тип | Обязательно | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | Нет | Поле id. | ||||||||||||
name |
string | Нет | Поле name. | ||||||||||||
subject |
string | Нет | Поле subject. | ||||||||||||
weightFrom |
number · double | Нет | Поле weightFrom. | ||||||||||||
weightTo |
number · double | Нет | Поле weightTo. | ||||||||||||
weightUnit |
string | Нет | Поле weightUnit. | ||||||||||||
lengthFrom |
number · double | Нет | Поле lengthFrom. | ||||||||||||
lengthTo |
number · double | Нет | Поле lengthTo. | ||||||||||||
widthFrom |
number · double | Нет | Поле widthFrom. | ||||||||||||
widthTo |
number · double | Нет | Поле widthTo. | ||||||||||||
heightFrom |
number · double | Нет | Поле heightFrom. | ||||||||||||
heightTo |
number · double | Нет | Поле heightTo. | ||||||||||||
countFrom |
number · double | Нет | Поле countFrom. | ||||||||||||
countTo |
number · double | Нет | Поле countTo. | ||||||||||||
countUnit |
string | Нет | Поле countUnit. | ||||||||||||
surchargeMetric |
string | Нет | Поле surchargeMetric. | ||||||||||||
price |
number · double | Нет | Поле price. | ||||||||||||
mode |
string | Нет | Поле mode. | ||||||||||||
surchargeThreshold |
number · double | Нет | Поле surchargeThreshold. | ||||||||||||
surchargeStep |
number · double | Нет | Поле surchargeStep. | ||||||||||||
surchargeAmount |
number · double | Нет | Поле surchargeAmount. | ||||||||||||
roundPartialStepUp |
boolean | Нет | Поле roundPartialStepUp. | ||||||||||||
clientPrices |
FulfillmentPriceVariantClientPrice[] | Нет | Поле clientPrices. | ||||||||||||
Структура элемента массива
|
|||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
clientId |
integer · int64 | Нет | Поле clientId. |
price |
number · double | Нет | Поле price. |
tariffTypes
Структура элемента массива
FulfillmentJobTariffType
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
string | Нет | Поле id. |
name |
string | Нет | Поле name. |
price |
number · double | Нет | Поле price. |
warehouseId |
integer · int64 | Нет | Поле warehouseId. |
currency |
string | Нет | Поле currency. |
minimumAmount |
number · double | Нет | Поле minimumAmount. |
validFrom |
string | Нет | Поле validFrom. |
validTo |
string | Нет | Поле validTo. |
minimumAmountpriceValidFrompriceValidToemployeeRateValidFromemployeeRateValidTosampleseedCodetariffs
Структура элемента массива
JobTariff
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Поле id. |
jobId |
integer · int32 | Нет | Поле jobId. |
price |
number · double | Нет | Поле price. |
clientId |
integer · int64 | Нет | Поле clientId. |
employeeRate |
number · double | Нет | Поле employeeRate. |
brandId |
integer · int32 | Нет | Поле brandId. |
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 | Нет | Поле categoryId. |
priority |
integer · int32 | Нет | Поле priority. |
productId |
integer · int64 | Нет | Поле productId. |
minQuantity |
integer · int32 | Нет | Поле minQuantity. |
maxQuantity |
integer · int32 | Нет | Поле maxQuantity. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
changedAt |
string · date-time | Нет | Поле changedAt. |
quantityTo |
integer · int32 | Нет | Поле quantityTo. |
quantityFrom |
integer · int32 | Нет | Поле quantityFrom. |
{
"id": 1001,
"name": "Example",
"categoryClass": "SHOES",
"clientId": 1001,
"organizationId": 1001,
"deleted": false
}Ошибки19
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
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История индивидуальных правил цены.
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
jobId |
integer · int32 | Да | Поле jobId. |
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());
}
}
Успешный ответ
200
Структура элемента массива
JobTariffHistory[]
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Поле id. |
jobId |
integer · int32 | Нет | Поле jobId. |
tariffId |
integer · int64 | Нет | Поле tariffId. |
eventType |
string | Нет | Поле eventType. |
price |
number · double | Нет | Поле price. |
employeeRate |
number · double | Нет | Поле employeeRate. |
clientId |
integer · int64 | Нет | Поле clientId. |
brandId |
integer · int32 | Нет | Поле brandId. |
categoryClass |
string | Нет | Поле categoryClass. |
categoryId |
integer · int32 | Нет | Поле categoryId. |
productId |
integer · int64 | Нет | Поле productId. |
quantityFrom |
integer · int32 | Нет | Поле quantityFrom. |
quantityTo |
integer · int32 | Нет | Поле quantityTo. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
changedAt |
string · date-time | Нет | Поле changedAt. |
changedBy |
string | Нет | Поле changedBy. |
[
"string"
]Ошибки6
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
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История индивидуальных правил цены работы фулфилмента.
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
jobId |
integer · int32 | Да | Поле jobId. |
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());
}
}
Успешный ответ
200
Структура элемента массива
JobTariff[]
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Поле id. |
jobId |
integer · int32 | Нет | Поле jobId. |
price |
number · double | Нет | Поле price. |
clientId |
integer · int64 | Нет | Поле clientId. |
employeeRate |
number · double | Нет | Поле employeeRate. |
brandId |
integer · int32 | Нет | Поле brandId. |
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 | Нет | Поле categoryId. |
priority |
integer · int32 | Нет | Поле priority. |
productId |
integer · int64 | Нет | Поле productId. |
minQuantity |
integer · int32 | Нет | Поле minQuantity. |
maxQuantity |
integer · int32 | Нет | Поле maxQuantity. |
validFrom |
string · date-time | Нет | Поле validFrom. |
validTo |
string · date-time | Нет | Поле validTo. |
changedAt |
string · date-time | Нет | Поле changedAt. |
quantityTo |
integer · int32 | Нет | Поле quantityTo. |
quantityFrom |
integer · int32 | Нет | Поле quantityFrom. |
[
"string"
]Ошибки6
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
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 содержит приведённый выше перевод.
Экспорт каталога работ фулфилмента в Excel
/api/job/fulfillment/excelЭкспорт каталога работ фулфилмента в Excel.
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
includeCurrentПо умолчанию: true |
boolean | Нет | Поле includeCurrent. |
organizationId |
integer · int64 | Нет | Поле organizationId. |
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());
}
}
Успешный ответ
200"string"Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.