SelSup Developers

API · API Đề xuất

Chuyển

Các điểm cuối cho việc giao hàng, bao gồm các tuyến đường chính xác, các tham số, cơ quan yêu cầu và các kế hoạch phản ứng có thể mở rộng.

18 điểm cuối/api/deliveryThường ổn địnhMô tả có thể đọc được bằng máy ↗
{ }

Trang này được hỗ trợ bởi một hợp đồng độc lập có thể chỉnh sửa. Thiết lập các hoạt động viết bằng dữ liệu thử nghiệm trước khi sử dụng sản xuất.

/api/delivery

Các dòng công việc sẵn sàng sử dụng

Các dòng công việc sẵn sàng sử dụng

01

Bắt đầu sử dụng Delivery

Sử dụng mã thông báo API chuyên dụng và xác nhận các hoạt động đọc bằng dữ liệu thử nghiệm trước.

  1. Giữ token bên máy chủ và gửi nó trong tiêu đề Authorization.
  2. Kiểm tra các tham số cần thiết và mở rộng quy trình yêu cầu hoặc phản hồi.
  3. xử lý trạng thái HTTP và trường error ổn định trong lỗi ứng dụng.

Mô hình dữ liệu

Các cấu trúc dữ liệu

Các mô hình được liệt kê một lần ở đây và cũng có thể được mở rộng trực tiếp từ các điểm cuối sử dụng chúng.

AdditionalDeliveryServiceDto3 trường
codestring

Code.

namestring

Tên.

descriptionstring

Mô tả.

Address15 trường
idinteger · int32

Id.

postCodestring

Mã thư.

countryCountry

Đất nước.

regionRegion

Khu vực.

regionIdinteger · int32

Khu vực ID

streetstring

- Thường phố.

housestring

Nhà.

districtstring

Quận.

citystring

Thành phố.

localitystring

- Địa điểm.

buildingstring

- Cầu xây.

flatstring

- Đơn giản.

shortstring

Này, ngắn thôi.

addressIdAddress

Địa chỉ ID.

fullstring

- Đúng rồi.

Country6 trường
countryIdinteger · int32

Đơn vị quốc gia.

namestring

Tên.

code2string

Mã số 2.

code3string

Mã số 3.

namesobject

Tên.

printNamestring

Tiếp tục.

DeliveryTariff13 trường
deliverySumnumber · float

Số tiền giao hàng.

periodMininteger · int32

Thời gian Min.

periodMaxinteger · int32

Thời gian Max.

calendarMininteger · int32

- Thời gian lịch Min.

calendarMaxinteger · int32

Lịch Max.

tariffIdinteger · int32

Đơn vị thuế quan.

shippingServicestring

Dịch vụ vận chuyển.

tariffCodeinteger · int32

Bộ luật thuế quan.

externalTariffCodestring

Bộ luật thuế quan bên ngoài.

tariffNamestring

Tên thuế quan.

tariffDescriptionstring

Mô tả thuế quan

deliveryModeinteger · int32

Chế độ giao hàng.

additionalServicesAdditionalDeliveryServiceDto[]

Dịch vụ bổ sung.

Organization33 trường
idinteger · int64

Id.

read-only
namestring

Tên.

Bắt buộc
shortNamestring

Tên ngắn.

taxTypestring

Nhóm thuế.

taxRateinteger · int32

Tỷ lệ thuế.

taxNdsinteger · int32

Thuế.

inputTaxNdsinteger · int32

Thuế nhập khẩu.

outputTaxNdsinteger · int32

Thuế sản xuất.

enableNewTaxCalculationboolean

Khả năng tính toán thuế mới.

useNdsCostPriceboolean

Sử dụng giá trị chi phí của Nds.

innstring

Nhà nghỉ.

Bắt buộc
kppstring

Kpp.

bankstring

Ngân hàng.

bikstring

Đạp xe.

corrBillstring

Corr Bill.

billNumberstring

Số tiền.

stampPathstring

Đường đi dấu.

read-only
stampUrlstring

Đơn vị URL.

read-only
stampSizeinteger · int32

Sơn bìa.

read-only
stampWidthinteger · int32

Lượng dệt.

read-only
stampHeightinteger · int32

Stamp Height.

read-only
signaturePathstring

Đường chữ ký.

read-only
signatureUrlstring

Url chữ ký.

read-only
signatureSizeinteger · int32

Sơn ký.

read-only
signatureWidthinteger · int32

Độ rộng chữ ký.

read-only
signatureHeightinteger · int32

Tốc độ chữ ký.

read-only
ipPersonPerson

Người IP.

formstring

- Tương tự.

Bắt buộc
ipboolean

Ip.

clientIdinteger · int64

- Đồ nhận khách hàng.

read-only
addressAddress

Địa chỉ.

phoneNumberstring

Số điện thoại.

addressFullstring

Địa chỉ đầy đủ.

read-only
Person14 trường
personIdinteger · int64

Đơn vị cá nhân.

read-only
firstNamestring

Tên đầu tiên.

Bắt buộc
lastNamestring

Tên cuối cùng.

Bắt buộc
surNamestring

Sur Name.

clientIdinteger · int64

- Đồ nhận khách hàng.

read-only
positionPersonPosition

Vị trí.

Bắt buộc
versionIdinteger · int64

Phiên bản ID.

read-only
createdUserstring

Tạo User.

read-only
createdDatestring · date-time

Ngày được tạo ra.

read-only
deletedboolean

- Quá xóa.

read-only
userIdinteger · int32

ID người dùng.

read-only
hasChangesboolean

Có những thay đổi.

fullNamestring

Tên đầy đủ.

read-only
shortNamestring

Tên ngắn.

read-only
PersonPosition7 trường
idinteger · int64

Id.

read-only
namestring

Tên.

Bắt buộc
deletedboolean

- Quá xóa.

read-only
clientIdinteger · int64

- Đồ nhận khách hàng.

read-only
defaultJobIdinteger · int64

ID công việc mặc định.

createdUserstring

Tạo User.

read-only
createdDatestring · date-time

Ngày được tạo ra.

read-only
Region4 trường
regionIdinteger · int32

Khu vực ID

countryIdinteger · int32

Đơn vị quốc gia.

namestring

Tên.

regionSynonymsRegionSynonym[]

Các từ đồng nghĩa vùng.

RegionSynonym4 trường
idinteger · int64

Id.

regionIdinteger · int64

Khu vực ID

synonymstring

- Tương tự.

servicestring

Dịch vụ.

WarehouseDelivery15 trường
warehouseDeliveryIdinteger · int64

Đơn nhận giao hàng kho.

pointstring

Điểm.

servicestring

Dịch vụ.

warehouseIdinteger · int64

Đơn vị kho.

organizationIdinteger · int64

Đơn vị tổ chức.

tariffPrioritystring

Tỷ lệ ưu tiên thuế quan.

prioritiesobject

Các ưu tiên.

priorityByModeboolean

Tầm ưu tiên theo chế độ

additionalServicesstring

Dịch vụ bổ sung.

sendZeroPriceboolean

Gửi Zero Price.

fakeNamestring

Tên giả.

hideOrganizationboolean

Tổ chức ẩn.

sellerOrganizationIdinteger · int64

Đơn vị tổ chức bán hàng.

organizationOrganization

Tổ chức.

additionalServiceForTariffDeliveryTariff

Dịch vụ bổ sung cho thuế quan.

FileExportColumn5 trường
idinteger · int64

Id.

fileExportIdinteger · int64

File Export ID.

columnNamestring

Tên cột.

columnOrderinteger · int32

Lệnh Cột.

isEnabledboolean

Được bật.

TmsTask25 trường
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Tên.

clientIdinteger · int64

- Đồ nhận khách hàng.

entityIdinteger · int64

Đơn vị nhận dạng.

progressinteger · int32

- Tiến bộ.

processedQuantityinteger · int32

Số lượng xử lý.

organizationIdinteger · int64

Đơn vị tổ chức.

priorityinteger · int32

Tự ưu tiên.

propertiesstring

Các tài sản.

messagestring

Thông điệp.

messageParamsstring

Tin nhắn Params.

createdDatestring · date-time

Ngày được tạo ra.

startDatestring · date-time

Ngày bắt đầu.

finishDatestring · date-time

Ngày kết thúc.

urlstring

Url.

inputFileUrlstring

Đăng file URL.

retryNumberinteger · int32

Lần thử lại.

userIdinteger · int32

ID người dùng.

retryDatestring · date-time

Ngày thử lại.

debugboolean

Tháo gỡ.

forcedStartboolean

Bắt đầu bắt buộc.

servicestring

Dịch vụ.

langstring

Lang.

CalculatedDeliveryTariff11 trường
deliverySumnumber · float

Số tiền giao hàng.

periodMininteger · int32

Thời gian Min.

periodMaxinteger · int32

Thời gian Max.

calendarMininteger · int32

- Thời gian lịch Min.

calendarMaxinteger · int32

Lịch Max.

servicesobject

Dịch vụ.

locationToCodestring

Địa điểm đến mã.

locationFromCodestring

Địa điểm từ mã.

tariffCodeinteger · int32

Bộ luật thuế quan.

deliveryModeToOrderCreateinteger · int32

Chế độ giao hàng để đặt hàng tạo.

deliveryModeListinteger[]

Danh sách chế độ giao hàng.

DeliveryServiceData10 trường
idinteger · int64

Id.

tokenExpiredDatestring · date-time

Ngày hết hạn của token.

servicestring

Dịch vụ.

serviceClientIdstring

Hình danh khách hàng dịch vụ.

serviceSecretDeliveryServiceData

Dịch vụ bí mật.

clientIdinteger · int64

- Đồ nhận khách hàng.

organizationIdinteger · int64

Đơn vị tổ chức.

updateTokenboolean

Tải đổi Token.

hasTokenboolean

Có Token.

hasSecretboolean

Có bí mật.

DeliveryRegion2 trường
namestring

Tên.

idstring

Id.

DeliveryPoint11 trường
namestring

Tên.

locationDeliveryPointsLocation

- Vị trí.

addressstring

Địa chỉ.

addressCommentstring

Địa chỉ bình luận.

notestring

Lưu ý.

workTimestring

Thời gian làm việc.

phonesPhone[]

Điện thoại.

zipCodestring

Mã zip.

codestring

Code.

emailstring

Email.

sitestring

Địa điểm.

DeliveryPointsLocation12 trường
addressstring

Địa chỉ.

codeinteger · int32

Code.

postal_codestring

Mã bưu chính.

country_codestring

Mã quốc gia.

citystring

Thành phố.

fias_guidstring

- Chị đi.

longitudenumber · float

Đường dài.

latitudenumber · float

- Đường độ.

regionstring

Khu vực.

region_codeinteger · int32

Mã vùng.

address_fullstring

Địa chỉ đầy đủ.

city_codestring

Mã thành phố.

Phone2 trường
numberstring

Số.

additionalstring

Thêm nữa.

DeliveryCity2 trường
namestring

Tên.

idstring

Id.

AddressDto8 trường
addressstring

Địa chỉ.

postalCodestring

Mã bưu chính.

regionstring

Khu vực.

localitystring

- Địa điểm.

streetstring

- Thường phố.

housestring

Nhà.

longitudenumber · double

Đường dài.

latitudenumber · double

- Đường độ.

Hợp đồng lỗi

Cách trả lại lỗi ứng dụng

Mã error giống nhau ở mọi địa điểm, trong khi thông điệp đối diện người dùng được dịch bởi máy chủ. Xây dựng logic ứng dụng xung quanh error và sử dụng localMessage chỉ cho hiển thị.

error

Mã máy tính có thể đọc ổn định cho logic tích hợp.

localMessage

Thông điệp sẵn sàng hiển thị trong ngôn ngữ của người dùng mã thông báo API.

params

Các giá trị được máy chủ liên kết vào mẫu tin nhắn địa phương.

localMessage sử dụng trường lang của người dùng sở hữu mã thông báo API. Ngôn ngữ tài liệu và tiêu đề Accept-Language không thay đổi nó; tiếng Nga được sử dụng khi người dùng không có ngôn ngữ được cấu hình.

RUUser locale là ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
VNTiếng Việt (vn)
{
  "error": "error_brand_already_exists",
  "localMessage": "Thương hiệu Base đã tồn tại",
  "params": {
    "name": "Base"
  }
}

Điểm cuối

Điểm cuối

POST

Cập nhật lệnh giao hàng

/api/delivery/updateDeliveryOrder
Tấm mã với quyền truy cập viết

Cập nhật lệnh giao hàng bằng POST /api/delivery/updateDeliveryOrder.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
orderId integer · int64 Đơn vị nhận dạng.
curl --request POST 'https://api.selsup.ru/api/delivery/updateDeliveryOrder?orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

POST

Đưa hàng tại kho

/api/delivery/storeWarehouseDelivery
Tấm mã với quyền truy cập viết

Nhà kho hàng giao hàng sử dụng POST /api/delivery/storeWarehouseDelivery.

Cơ quan yêu cầu

application/json
Các trường đối tượngWarehouseDelivery
TrườngLoạiBắt buộcMô tả
warehouseDeliveryId integer · int64 Không Đơn nhận giao hàng kho.
point string Không Điểm.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ.
warehouseId integer · int64 Không Đơn vị kho.
organizationId integer · int64 Không Đơn vị tổ chức.
tariffPriority string Không Tỷ lệ ưu tiên thuế quan.
priorities object Không Các ưu tiên.
priorityByMode boolean Không Tầm ưu tiên theo chế độ
additionalServices string Không Dịch vụ bổ sung.
sendZeroPrice boolean Không Gửi Zero Price.
fakeName string Không Tên giả.
hideOrganization boolean Không Tổ chức ẩn.
sellerOrganizationId integer · int64 Không Đơn vị tổ chức bán hàng.
organization Organization Không Tổ chức.
Các trường đối tượng Organization
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
shortName string Không Tên ngắn.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Không Nhóm thuế.
taxRate integer · int32 Không Tỷ lệ thuế.
taxNds integer · int32 Không Thuế.
inputTaxNds integer · int32 Không Thuế nhập khẩu.
outputTaxNds integer · int32 Không Thuế sản xuất.
enableNewTaxCalculation boolean Không Khả năng tính toán thuế mới.
useNdsCostPrice boolean Không Sử dụng giá trị chi phí của Nds.
inn string Nhà nghỉ.
kpp string Không Kpp.
bank string Không Ngân hàng.
bik string Không Đạp xe.
corrBill string Không Corr Bill.
billNumber string Không Số tiền.
stampPath string Không Đường đi dấu.
stampUrl string Không Đơn vị URL.
stampSize integer · int32 Không Sơn bìa.
stampWidth integer · int32 Không Lượng dệt.
stampHeight integer · int32 Không Stamp Height.
signaturePath string Không Đường chữ ký.
signatureUrl string Không Url chữ ký.
signatureSize integer · int32 Không Sơn ký.
signatureWidth integer · int32 Không Độ rộng chữ ký.
signatureHeight integer · int32 Không Tốc độ chữ ký.
ipPerson Person Không Người IP.
Các trường đối tượng Person
TrườngLoạiBắt buộcMô tả
personId integer · int64 Không Đơn vị cá nhân.
firstName string Tên đầu tiên.
lastName string Tên cuối cùng.
surName string Không Sur Name.
clientId integer · int64 Không - Đồ nhận khách hàng.
position PersonPosition Vị trí.
versionId integer · int64 Không Phiên bản ID.
createdUser string Không Tạo User.
createdDate string · date-time Không Ngày được tạo ra.
deleted boolean Không - Quá xóa.
userId integer · int32 Không ID người dùng.
hasChanges boolean Không Có những thay đổi.
fullName string Không Tên đầy đủ.
shortName string Không Tên ngắn.
form stringOOO, IP, SELF_EMPLOYED - Tương tự.
ip boolean Không Ip.
clientId integer · int64 Không - Đồ nhận khách hàng.
address Address Không Địa chỉ.
Các trường đối tượng Address
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
postCode string Không Mã thư.
country Country Không Đất nước.
region Region Không Khu vực.
regionId integer · int32 Không Khu vực ID
street string Không - Thường phố.
house string Không Nhà.
district string Không Quận.
city string Không Thành phố.
locality string Không - Địa điểm.
building string Không - Cầu xây.
flat string Không - Đơn giản.
short string Không Này, ngắn thôi.
addressId Address Không Địa chỉ ID.
full string Không - Đúng rồi.
phoneNumber string Không Số điện thoại.
addressFull string Không Địa chỉ đầy đủ.
additionalServiceForTariff DeliveryTariff Không Dịch vụ bổ sung cho thuế quan.
Các trường đối tượng DeliveryTariff
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
tariffId integer · int32 Không Đơn vị thuế quan.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ vận chuyển.
tariffCode integer · int32 Không Bộ luật thuế quan.
externalTariffCode string Không Bộ luật thuế quan bên ngoài.
tariffName string Không Tên thuế quan.
tariffDescription string Không Mô tả thuế quan
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng.
additionalServices AdditionalDeliveryServiceDto[] Không Dịch vụ bổ sung.
Cấu trúc của mục array AdditionalDeliveryServiceDto
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
curl --request POST 'https://api.selsup.ru/api/delivery/storeWarehouseDelivery' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "warehouseDeliveryId": 1001,
  "point": "string",
  "service": "CDEK",
  "warehouseId": 1001,
  "organizationId": 1001,
  "tariffPriority": "string"
}'

Phản ứng thành công

200
Các trường đối tượng WarehouseDelivery
TrườngLoạiBắt buộcMô tả
warehouseDeliveryId integer · int64 Không Đơn nhận giao hàng kho.
point string Không Điểm.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ.
warehouseId integer · int64 Không Đơn vị kho.
organizationId integer · int64 Không Đơn vị tổ chức.
tariffPriority string Không Tỷ lệ ưu tiên thuế quan.
priorities object Không Các ưu tiên.
priorityByMode boolean Không Tầm ưu tiên theo chế độ
additionalServices string Không Dịch vụ bổ sung.
sendZeroPrice boolean Không Gửi Zero Price.
fakeName string Không Tên giả.
hideOrganization boolean Không Tổ chức ẩn.
sellerOrganizationId integer · int64 Không Đơn vị tổ chức bán hàng.
organization Organization Không Tổ chức.
Các trường đối tượng Organization
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
shortName string Không Tên ngắn.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Không Nhóm thuế.
taxRate integer · int32 Không Tỷ lệ thuế.
taxNds integer · int32 Không Thuế.
inputTaxNds integer · int32 Không Thuế nhập khẩu.
outputTaxNds integer · int32 Không Thuế sản xuất.
enableNewTaxCalculation boolean Không Khả năng tính toán thuế mới.
useNdsCostPrice boolean Không Sử dụng giá trị chi phí của Nds.
inn string Nhà nghỉ.
kpp string Không Kpp.
bank string Không Ngân hàng.
bik string Không Đạp xe.
corrBill string Không Corr Bill.
billNumber string Không Số tiền.
stampPath string Không Đường đi dấu.
stampUrl string Không Đơn vị URL.
stampSize integer · int32 Không Sơn bìa.
stampWidth integer · int32 Không Lượng dệt.
stampHeight integer · int32 Không Stamp Height.
signaturePath string Không Đường chữ ký.
signatureUrl string Không Url chữ ký.
signatureSize integer · int32 Không Sơn ký.
signatureWidth integer · int32 Không Độ rộng chữ ký.
signatureHeight integer · int32 Không Tốc độ chữ ký.
ipPerson Person Không Người IP.
Các trường đối tượng Person
TrườngLoạiBắt buộcMô tả
personId integer · int64 Không Đơn vị cá nhân.
firstName string Tên đầu tiên.
lastName string Tên cuối cùng.
surName string Không Sur Name.
clientId integer · int64 Không - Đồ nhận khách hàng.
position PersonPosition Vị trí.
versionId integer · int64 Không Phiên bản ID.
createdUser string Không Tạo User.
createdDate string · date-time Không Ngày được tạo ra.
deleted boolean Không - Quá xóa.
userId integer · int32 Không ID người dùng.
hasChanges boolean Không Có những thay đổi.
fullName string Không Tên đầy đủ.
shortName string Không Tên ngắn.
form stringOOO, IP, SELF_EMPLOYED - Tương tự.
ip boolean Không Ip.
clientId integer · int64 Không - Đồ nhận khách hàng.
address Address Không Địa chỉ.
Các trường đối tượng Address
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
postCode string Không Mã thư.
country Country Không Đất nước.
region Region Không Khu vực.
regionId integer · int32 Không Khu vực ID
street string Không - Thường phố.
house string Không Nhà.
district string Không Quận.
city string Không Thành phố.
locality string Không - Địa điểm.
building string Không - Cầu xây.
flat string Không - Đơn giản.
short string Không Này, ngắn thôi.
addressId Address Không Địa chỉ ID.
full string Không - Đúng rồi.
phoneNumber string Không Số điện thoại.
addressFull string Không Địa chỉ đầy đủ.
additionalServiceForTariff DeliveryTariff Không Dịch vụ bổ sung cho thuế quan.
Các trường đối tượng DeliveryTariff
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
tariffId integer · int32 Không Đơn vị thuế quan.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ vận chuyển.
tariffCode integer · int32 Không Bộ luật thuế quan.
externalTariffCode string Không Bộ luật thuế quan bên ngoài.
tariffName string Không Tên thuế quan.
tariffDescription string Không Mô tả thuế quan
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng.
additionalServices AdditionalDeliveryServiceDto[] Không Dịch vụ bổ sung.
Cấu trúc của mục array AdditionalDeliveryServiceDto
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
{
  "warehouseDeliveryId": 1001,
  "point": "string",
  "service": "CDEK",
  "warehouseId": 1001,
  "organizationId": 1001,
  "tariffPriority": "string"
}
Hầm lẫn11

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_duplicate_warehouse_delivery_for_warehouse
Настройки службы доставки не могут дублироваться для склада

error cụ thể cho điểm cuối. Sử dụng mã error_duplicate_warehouse_delivery_for_warehouse ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_shipping_point
Địa chỉ gửi lô hàng không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_empty_shipping_point ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_shipping_service
Dịch vụ giao hàng không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_empty_shipping_service ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_tariff_priority
Không có ưu tiên nào được chỉ định cho biểu thuế số{position}

error cụ thể cho điểm cuối. Sử dụng mã error_empty_tariff_priority ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_warehouse_delivery
Điểm khởi hành của công ty vận tải không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_no_warehouse_delivery ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

POST

Tắt ra hàng kho

/api/delivery/removeWarehouseDelivery
Tấm mã với quyền truy cập viết

Xóa giao hàng kho bằng cách sử dụng POST /api/delivery/removeWarehouseDelivery.

Cơ quan yêu cầu

application/json
Các trường đối tượngWarehouseDelivery
TrườngLoạiBắt buộcMô tả
warehouseDeliveryId integer · int64 Không Đơn nhận giao hàng kho.
point string Không Điểm.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ.
warehouseId integer · int64 Không Đơn vị kho.
organizationId integer · int64 Không Đơn vị tổ chức.
tariffPriority string Không Tỷ lệ ưu tiên thuế quan.
priorities object Không Các ưu tiên.
priorityByMode boolean Không Tầm ưu tiên theo chế độ
additionalServices string Không Dịch vụ bổ sung.
sendZeroPrice boolean Không Gửi Zero Price.
fakeName string Không Tên giả.
hideOrganization boolean Không Tổ chức ẩn.
sellerOrganizationId integer · int64 Không Đơn vị tổ chức bán hàng.
organization Organization Không Tổ chức.
Các trường đối tượng Organization
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
shortName string Không Tên ngắn.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Không Nhóm thuế.
taxRate integer · int32 Không Tỷ lệ thuế.
taxNds integer · int32 Không Thuế.
inputTaxNds integer · int32 Không Thuế nhập khẩu.
outputTaxNds integer · int32 Không Thuế sản xuất.
enableNewTaxCalculation boolean Không Khả năng tính toán thuế mới.
useNdsCostPrice boolean Không Sử dụng giá trị chi phí của Nds.
inn string Nhà nghỉ.
kpp string Không Kpp.
bank string Không Ngân hàng.
bik string Không Đạp xe.
corrBill string Không Corr Bill.
billNumber string Không Số tiền.
stampPath string Không Đường đi dấu.
stampUrl string Không Đơn vị URL.
stampSize integer · int32 Không Sơn bìa.
stampWidth integer · int32 Không Lượng dệt.
stampHeight integer · int32 Không Stamp Height.
signaturePath string Không Đường chữ ký.
signatureUrl string Không Url chữ ký.
signatureSize integer · int32 Không Sơn ký.
signatureWidth integer · int32 Không Độ rộng chữ ký.
signatureHeight integer · int32 Không Tốc độ chữ ký.
ipPerson Person Không Người IP.
Các trường đối tượng Person
TrườngLoạiBắt buộcMô tả
personId integer · int64 Không Đơn vị cá nhân.
firstName string Tên đầu tiên.
lastName string Tên cuối cùng.
surName string Không Sur Name.
clientId integer · int64 Không - Đồ nhận khách hàng.
position PersonPosition Vị trí.
versionId integer · int64 Không Phiên bản ID.
createdUser string Không Tạo User.
createdDate string · date-time Không Ngày được tạo ra.
deleted boolean Không - Quá xóa.
userId integer · int32 Không ID người dùng.
hasChanges boolean Không Có những thay đổi.
fullName string Không Tên đầy đủ.
shortName string Không Tên ngắn.
form stringOOO, IP, SELF_EMPLOYED - Tương tự.
ip boolean Không Ip.
clientId integer · int64 Không - Đồ nhận khách hàng.
address Address Không Địa chỉ.
Các trường đối tượng Address
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
postCode string Không Mã thư.
country Country Không Đất nước.
region Region Không Khu vực.
regionId integer · int32 Không Khu vực ID
street string Không - Thường phố.
house string Không Nhà.
district string Không Quận.
city string Không Thành phố.
locality string Không - Địa điểm.
building string Không - Cầu xây.
flat string Không - Đơn giản.
short string Không Này, ngắn thôi.
addressId Address Không Địa chỉ ID.
full string Không - Đúng rồi.
phoneNumber string Không Số điện thoại.
addressFull string Không Địa chỉ đầy đủ.
additionalServiceForTariff DeliveryTariff Không Dịch vụ bổ sung cho thuế quan.
Các trường đối tượng DeliveryTariff
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
tariffId integer · int32 Không Đơn vị thuế quan.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ vận chuyển.
tariffCode integer · int32 Không Bộ luật thuế quan.
externalTariffCode string Không Bộ luật thuế quan bên ngoài.
tariffName string Không Tên thuế quan.
tariffDescription string Không Mô tả thuế quan
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng.
additionalServices AdditionalDeliveryServiceDto[] Không Dịch vụ bổ sung.
Cấu trúc của mục array AdditionalDeliveryServiceDto
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
curl --request POST 'https://api.selsup.ru/api/delivery/removeWarehouseDelivery' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "warehouseDeliveryId": 1001,
  "point": "string",
  "service": "CDEK",
  "warehouseId": 1001,
  "organizationId": 1001,
  "tariffPriority": "string"
}'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn6

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

POST

Trật tự

/api/delivery/order/{orderId}
Tấm mã với quyền truy cập viết

Đơn đặt bằng POST /api/delivery/order/{orderId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
orderId integer · int64 Đơn vị nhận dạng.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ.

Cơ quan yêu cầu

application/json
Các trường đối tượngDeliveryTariff
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
tariffId integer · int32 Không Đơn vị thuế quan.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ vận chuyển.
tariffCode integer · int32 Không Bộ luật thuế quan.
externalTariffCode string Không Bộ luật thuế quan bên ngoài.
tariffName string Không Tên thuế quan.
tariffDescription string Không Mô tả thuế quan
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng.
additionalServices AdditionalDeliveryServiceDto[] Không Dịch vụ bổ sung.
Cấu trúc của mục array AdditionalDeliveryServiceDto
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
curl --request POST 'https://api.selsup.ru/api/delivery/order/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "deliverySum": 1,
  "periodMin": 1,
  "periodMax": 1,
  "calendarMin": 1,
  "calendarMax": 1,
  "tariffId": 1001
}'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

POST

Nhận thuế quan

/api/delivery/getTariffs
Tấm mã với quyền truy cập viết

Nhận thuế bằng cách sử dụng POST /api/delivery/getTariffs.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
orderId integer · int64 Đơn vị nhận dạng.
curl --request POST 'https://api.selsup.ru/api/delivery/getTariffs?service=CDEK&orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array DeliveryTariff[]
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
tariffId integer · int32 Không Đơn vị thuế quan.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ vận chuyển.
tariffCode integer · int32 Không Bộ luật thuế quan.
externalTariffCode string Không Bộ luật thuế quan bên ngoài.
tariffName string Không Tên thuế quan.
tariffDescription string Không Mô tả thuế quan
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng.
additionalServices AdditionalDeliveryServiceDto[] Không Dịch vụ bổ sung.
Cấu trúc của mục array AdditionalDeliveryServiceDto
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
[
  "string"
]
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

POST

Tải xuống nhãn giao hàng

/api/delivery/downloadDeliveryLabels
Tấm mã với quyền truy cập viết

Tải xuống Đồ ghi giao hàng sử dụng POST /api/delivery/downloadDeliveryLabels.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
columns FileExportColumn[] Không Cột.
Cấu trúc của mục array FileExportColumn
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
fileExportId integer · int64 Không File Export ID.
columnName string Không Tên cột.
columnOrder integer · int32 Không Lệnh Cột.
isEnabled boolean Không Được bật.
actual boolean Không Thực tế.
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Không Type.
serviceWarehouseId string Không Hình dạng kho dịch vụ.
externalOrderId string Không - Đơn vị nhận dạng của lệnh bên ngoài.
invoiceNumber integer · int64 Không Số hóa đơn.
article string Không Bài viết.
containsArticle string Không Có chứa bài viết.
product string Không Sản phẩm.
barcode string Không Mã vạch.
organizations integer[] Không Các tổ chức.
query string Không - Tôi hỏi.
userId integer · int32 Không ID người dùng.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Không Dịch vụ.
services string[] Không Dịch vụ.
status stringCREATED, REVOKING, REVOKED, ORDER_CREATED, CARDS_CREATED, BOX_BARCODES, IMAGES_UPLOADED, INVOICE_UPLOADED, READY_TO_SUPPLY, SUPPLIED, FINISHED, COLLECTED, SEND, DELIVERY, REFUND, COLLECTING, PACKING, PAYMENT_REQUIRED, CANCELED, CONTROVERSIAL, OVERDUE, READY_FOR_PICKUP, WAITING_SUPPLY, PICK_UP_REFUND, REFUND_RECEIVED, DELETED, RESTORE, PRODUCTION_CONFIRMED Không Status.
statuses string[] Không Tình trạng.
withoutSupply boolean Không Không có nguồn cung cấp.
orderProductId integer · int64 Không Đơn đặt hàng ID sản phẩm.
productId integer · int64 Không Đơn vị sản phẩm
brandId integer · int32 Không Đơn vị thương hiệu.
supplierId integer · int64 Không Đơn vị cung cấp.
hasCollectTask boolean Không Có nhiệm vụ thu thập.
organizationId integer · int64 Không Đơn vị tổ chức.
clientOrganizationIds integer[] Không Đồ nhận dạng tổ chức khách hàng.
updateInService boolean Không Tải về dịch vụ.
hasServiceError boolean Không Có lỗi dịch vụ.
noLabel boolean Không Không có nhãn.
isLegal boolean Không Là hợp pháp.
noMsOrder boolean Không Không có cô Order.
noMsDemand boolean Không Không có cô Demand.
ids integer[] Không Đồ nhận dạng.
supplyId integer · int64 Không Đơn vị cung cấp.
notCollected boolean Không Không được thu thập.
dbs boolean Không DBS.
express boolean Không - Đi nhanh.
fbs boolean Không FBI.
noWarehouse boolean Không Không có kho.
closeDate string Không Gần hẹn hò.
modifiedDate string · date-time Không Ngày sửa đổi.
modifiedDateTo string · date-time Không Ngày sửa đổi đến.
incomeId integer · int64 Không Đơn nhận thu nhập.
bindingOrderId integer · int64 Không Đơn vị nhận dạng bắt buộc.
closeDateFrom string · date-time Không - Ngày gần.
closeDateTo string · date-time Không Gần đến ngày.
orderDate string Không Ngày đặt hàng.
deliveryDate string Không Ngày giao hàng.
deliveryDateFrom string Không Ngày giao hàng từ.
deliveryDateTo string Không Ngày giao hàng đến.
createdDateFrom string Không Ngày được tạo ra từ.
createdDateTo string Không Được tạo ra ngày đến.
forMoySklad boolean Không Cho Moy Sklad.
withMoySkladOrder boolean Không Với Hội Thánh Moy Sklad.
warehouseId integer · int64 Không Đơn vị kho.
warehouseIds integer[] Không Thẻ kho.
dateFrom string · date-time Không Ngày từ.
dateTo string · date-time Không Ngày đến.
timeZone integer · int32 Không Khu vực thời gian.
markingStatus stringUNKNOWN, CARDS_SEND, CARDS_CREATED, SUZ_ORDERS_CREATED, MARKS_RECEIVED, CARDS_SIGNED, DOCUMENT_CREATED, SUCCESS, NO_NEED_MARKING Không Đánh dấu trạng thái.
deleted boolean Không - Quá xóa.
collectLabel boolean Không Nhặt Label.
sortOrdersByDate boolean Không Đặt thứ tự theo ngày.
sortBySku boolean Không Được xếp hạng theo Sku.
notGroupByOrganization boolean Không Không theo nhóm theo tổ chức.
notGroupByService boolean Không Không phải nhóm theo nhóm.
productLabel boolean Không Đèn nhãn sản phẩm
productCodeLabel boolean Không Đèn nhãn mã sản phẩm.
servicesForLabel string[] Không Dịch vụ cho Label.
infoLabel boolean Không Đồ thông tin.
grouped boolean Không Nhóm.
replaceSetByComponent boolean Không Thay thế Set By Component.
replaceSetsByComponentsIncome boolean Không Thay thế các bộ bằng các thành phần thu nhập.
collectDeliveryLabel boolean Không Nhặt nhãn giao hàng.
shippingServicesForLabel string[] Không Dịch vụ vận chuyển cho Label.
orderId integer · int64 Không Đơn vị nhận dạng.
hasVideoFixation boolean Không Có video cố định.
withProducts boolean Không Với sản phẩm.
passageIds integer[] Không Thẻ đi qua.
withContractor boolean Không Với Cầu Đề xuất.
boxId integer · int64 Không Thẻ danh bạ.
hasMarkedProducts boolean Không Có nhãn sản phẩm.
withAnalytics boolean Không Với Analytics.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringID, CREATEDDATE, ORDERCREATED, CREATED, CREATEDUSER, STATUS, SERVICE, TYPE, BOXTYPE, NAME, ORGANIZATIONID, WAREHOUSE, INVOICENUMBER, EXTERNALORDERID, QUEUE, SUPPLYID, CLOSEDATE, STARTCOLLECTDATE, CLOSEUSERID, USERID, PRICE, PRODUCT, COLLECTORDERTASKID, DELIVERYDATE, MARKINGSTATUS, QUANTITY, DATE, SERVICEWAREHOUSEID Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request POST 'https://api.selsup.ru/api/delivery/downloadDeliveryLabels?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng TmsTask
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Không Status.
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Không Type.
name string Không Tên.
clientId integer · int64 Không - Đồ nhận khách hàng.
entityId integer · int64 Không Đơn vị nhận dạng.
progress integer · int32 Không - Tiến bộ.
processedQuantity integer · int32 Không Số lượng xử lý.
organizationId integer · int64 Không Đơn vị tổ chức.
priority integer · int32 Không Tự ưu tiên.
properties string Không Các tài sản.
message string Không Thông điệp.
messageParams string Không Tin nhắn Params.
createdDate string · date-time Không Ngày được tạo ra.
startDate string · date-time Không Ngày bắt đầu.
finishDate string · date-time Không Ngày kết thúc.
url string Không Url.
inputFileUrl string Không Đăng file URL.
retryNumber integer · int32 Không Lần thử lại.
userId integer · int32 Không ID người dùng.
retryDate string · date-time Không Ngày thử lại.
debug boolean Không Tháo gỡ.
forcedStart boolean Không Bắt đầu bắt buộc.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Không Dịch vụ.
lang string Không Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

POST

Tháo lệnh giao hàng

/api/delivery/cancelDeliveryOrder
Tấm mã với quyền truy cập viết

Tháo lệnh giao hàng bằng cách sử dụng POST /api/delivery/cancelDeliveryOrder.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
orderId integer · int64 Đơn vị nhận dạng.
curl --request POST 'https://api.selsup.ru/api/delivery/cancelDeliveryOrder?orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

POST

Xét thuế quan

/api/delivery/calculateTariff
Tấm mã với quyền truy cập viết

Xét thuế bằng cách sử dụng POST /api/delivery/calculateTariff.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
tariffCode integer · int32 Bộ luật thuế quan.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
orderId integer · int64 Đơn vị nhận dạng.
curl --request POST 'https://api.selsup.ru/api/delivery/calculateTariff?tariffCode=1&service=CDEK&orderId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng CalculatedDeliveryTariff
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
services object Không Dịch vụ.
locationToCode string Không Địa điểm đến mã.
locationFromCode string Không Địa điểm từ mã.
tariffCode integer · int32 Không Bộ luật thuế quan.
deliveryModeToOrderCreate integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng để đặt hàng tạo.
deliveryModeList integer[] Không Danh sách chế độ giao hàng.
{
  "deliverySum": 1,
  "periodMin": 1,
  "periodMax": 1,
  "calendarMin": 1,
  "calendarMax": 1,
  "services": "string"
}
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

POST

Thêm sự tích hợp dịch vụ giao hàng

/api/delivery/addDeliveryServiceIntegration
Tấm mã với quyền truy cập viết

Thêm Tích hợp Dịch vụ giao hàng bằng cách sử dụng POST /api/delivery/addDeliveryServiceIntegration.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
serviceClientId string Hình danh khách hàng dịch vụ.
serviceSecret string Không Dịch vụ bí mật.
token string Không Đồ tín hiệu.
organizationId integer · int64 Đơn vị tổ chức.
curl --request POST 'https://api.selsup.ru/api/delivery/addDeliveryServiceIntegration?service=CDEK&serviceClientId=string&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

GET

Nhận được sự hội nhập

/api/delivery/integration/{organizationId}/{service}
Tấm mã với truy cập đọc

Nhận tích hợp bằng GET /api/delivery/integration/{organizationId}/{service}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
curl --request GET 'https://api.selsup.ru/api/delivery/integration/1001/CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng DeliveryServiceData
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
tokenExpiredDate string · date-time Không Ngày hết hạn của token.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ.
serviceClientId string Không Hình danh khách hàng dịch vụ.
serviceSecret DeliveryServiceData Không Dịch vụ bí mật.
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
updateToken boolean Không Tải đổi Token.
hasToken boolean Không Có Token.
hasSecret boolean Không Có bí mật.
{
  "id": 1001,
  "tokenExpiredDate": "2026-01-15T12:00:00Z",
  "service": "CDEK",
  "serviceClientId": "string",
  "serviceSecret": "string",
  "clientId": 1001
}
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

GET

Nhận được giao hàng tại kho

/api/delivery/getWarehouseDelivery
Tấm mã với truy cập đọc

Nhận giao hàng kho bằng GET /api/delivery/getWarehouseDelivery.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Đơn vị tổ chức.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
curl --request GET 'https://api.selsup.ru/api/delivery/getWarehouseDelivery?organizationId=1001&service=CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array WarehouseDelivery[]
TrườngLoạiBắt buộcMô tả
warehouseDeliveryId integer · int64 Không Đơn nhận giao hàng kho.
point string Không Điểm.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ.
warehouseId integer · int64 Không Đơn vị kho.
organizationId integer · int64 Không Đơn vị tổ chức.
tariffPriority string Không Tỷ lệ ưu tiên thuế quan.
priorities object Không Các ưu tiên.
priorityByMode boolean Không Tầm ưu tiên theo chế độ
additionalServices string Không Dịch vụ bổ sung.
sendZeroPrice boolean Không Gửi Zero Price.
fakeName string Không Tên giả.
hideOrganization boolean Không Tổ chức ẩn.
sellerOrganizationId integer · int64 Không Đơn vị tổ chức bán hàng.
organization Organization Không Tổ chức.
Các trường đối tượng Organization
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
shortName string Không Tên ngắn.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Không Nhóm thuế.
taxRate integer · int32 Không Tỷ lệ thuế.
taxNds integer · int32 Không Thuế.
inputTaxNds integer · int32 Không Thuế nhập khẩu.
outputTaxNds integer · int32 Không Thuế sản xuất.
enableNewTaxCalculation boolean Không Khả năng tính toán thuế mới.
useNdsCostPrice boolean Không Sử dụng giá trị chi phí của Nds.
inn string Nhà nghỉ.
kpp string Không Kpp.
bank string Không Ngân hàng.
bik string Không Đạp xe.
corrBill string Không Corr Bill.
billNumber string Không Số tiền.
stampPath string Không Đường đi dấu.
stampUrl string Không Đơn vị URL.
stampSize integer · int32 Không Sơn bìa.
stampWidth integer · int32 Không Lượng dệt.
stampHeight integer · int32 Không Stamp Height.
signaturePath string Không Đường chữ ký.
signatureUrl string Không Url chữ ký.
signatureSize integer · int32 Không Sơn ký.
signatureWidth integer · int32 Không Độ rộng chữ ký.
signatureHeight integer · int32 Không Tốc độ chữ ký.
ipPerson Person Không Người IP.
Các trường đối tượng Person
TrườngLoạiBắt buộcMô tả
personId integer · int64 Không Đơn vị cá nhân.
firstName string Tên đầu tiên.
lastName string Tên cuối cùng.
surName string Không Sur Name.
clientId integer · int64 Không - Đồ nhận khách hàng.
position PersonPosition Vị trí.
versionId integer · int64 Không Phiên bản ID.
createdUser string Không Tạo User.
createdDate string · date-time Không Ngày được tạo ra.
deleted boolean Không - Quá xóa.
userId integer · int32 Không ID người dùng.
hasChanges boolean Không Có những thay đổi.
fullName string Không Tên đầy đủ.
shortName string Không Tên ngắn.
form stringOOO, IP, SELF_EMPLOYED - Tương tự.
ip boolean Không Ip.
clientId integer · int64 Không - Đồ nhận khách hàng.
address Address Không Địa chỉ.
Các trường đối tượng Address
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
postCode string Không Mã thư.
country Country Không Đất nước.
region Region Không Khu vực.
regionId integer · int32 Không Khu vực ID
street string Không - Thường phố.
house string Không Nhà.
district string Không Quận.
city string Không Thành phố.
locality string Không - Địa điểm.
building string Không - Cầu xây.
flat string Không - Đơn giản.
short string Không Này, ngắn thôi.
addressId Address Không Địa chỉ ID.
full string Không - Đúng rồi.
phoneNumber string Không Số điện thoại.
addressFull string Không Địa chỉ đầy đủ.
additionalServiceForTariff DeliveryTariff Không Dịch vụ bổ sung cho thuế quan.
Các trường đối tượng DeliveryTariff
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
tariffId integer · int32 Không Đơn vị thuế quan.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ vận chuyển.
tariffCode integer · int32 Không Bộ luật thuế quan.
externalTariffCode string Không Bộ luật thuế quan bên ngoài.
tariffName string Không Tên thuế quan.
tariffDescription string Không Mô tả thuế quan
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng.
additionalServices AdditionalDeliveryServiceDto[] Không Dịch vụ bổ sung.
Cấu trúc của mục array AdditionalDeliveryServiceDto
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
[
  "string"
]
Hầm lẫn7

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_warehouse_delivery
Điểm khởi hành của công ty vận tải không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_no_warehouse_delivery ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Tìm vùng

/api/delivery/getRegions
Tấm mã với truy cập đọc

Nhận vùng sử dụng GET /api/delivery/getRegions.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
query string - Tôi hỏi.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
curl --request GET 'https://api.selsup.ru/api/delivery/getRegions?query=string&service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array DeliveryRegion[]
TrườngLoạiBắt buộcMô tả
name string Không Tên.
id string Không Id.
[
  "string"
]
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

GET

Nhận điểm

/api/delivery/getPoints
Tấm mã với truy cập đọc

Nhận điểm bằng cách sử dụng GET /api/delivery/getPoints.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
postCode string Không Mã thư.
country string Không Đất nước.
region string Không Khu vực.
city string Không Thành phố.
query string Không - Tôi hỏi.
forSupply boolean Không Để cung cấp.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
curl --request GET 'https://api.selsup.ru/api/delivery/getPoints?service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array DeliveryPoint[]
TrườngLoạiBắt buộcMô tả
name string Không Tên.
location DeliveryPointsLocation Không - Vị trí.
Các trường đối tượng DeliveryPointsLocation
TrườngLoạiBắt buộcMô tả
address string Không Địa chỉ.
code integer · int32 Không Code.
postal_code string Không Mã bưu chính.
country_code string Không Mã quốc gia.
city string Không Thành phố.
fias_guid string Không - Chị đi.
longitude number · float Không Đường dài.
latitude number · float Không - Đường độ.
region string Không Khu vực.
region_code integer · int32 Không Mã vùng.
address_full string Không Địa chỉ đầy đủ.
city_code string Không Mã thành phố.
address string Không Địa chỉ.
addressComment string Không Địa chỉ bình luận.
note string Không Lưu ý.
workTime string Không Thời gian làm việc.
phones Phone[] Không Điện thoại.
Cấu trúc của mục array Phone
TrườngLoạiBắt buộcMô tả
number string Không Số.
additional string Không Thêm nữa.
zipCode string Không Mã zip.
code string Không Code.
email string Không Email.
site string Không Địa điểm.
[
  "string"
]
Hầm lẫn9

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_empty_delivery_service
Không chỉ định dịch vụ giao hàng

error cụ thể cho điểm cuối. Sử dụng mã error_empty_delivery_service ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_delivery_integration
Không tích hợp với dịch vụ giao hàng

error cụ thể cho điểm cuối. Sử dụng mã error_no_delivery_integration ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_unsupported_delivery_service
dịch vụ giao hàng không được hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_unsupported_delivery_service ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Nhận thuế giao hàng

/api/delivery/getDeliveryTariffs
Tấm mã với truy cập đọc

Nhận thuế giao hàng bằng cách sử dụng GET /api/delivery/getDeliveryTariffs.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
query string - Tôi hỏi.
curl --request GET 'https://api.selsup.ru/api/delivery/getDeliveryTariffs?service=CDEK&query=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array DeliveryTariff[]
TrườngLoạiBắt buộcMô tả
deliverySum number · float Không Số tiền giao hàng.
periodMin integer · int32 Không Thời gian Min.
periodMax integer · int32 Không Thời gian Max.
calendarMin integer · int32 Không - Thời gian lịch Min.
calendarMax integer · int32 Không Lịch Max.
tariffId integer · int32 Không Đơn vị thuế quan.
shippingService stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Không Dịch vụ vận chuyển.
tariffCode integer · int32 Không Bộ luật thuế quan.
externalTariffCode string Không Bộ luật thuế quan bên ngoài.
tariffName string Không Tên thuế quan.
tariffDescription string Không Mô tả thuế quan
deliveryMode integer · int320, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Không Chế độ giao hàng.
additionalServices AdditionalDeliveryServiceDto[] Không Dịch vụ bổ sung.
Cấu trúc của mục array AdditionalDeliveryServiceDto
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
[
  "string"
]
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

GET

Nhận thành phố

/api/delivery/getCities
Tấm mã với truy cập đọc

Nhận thành phố bằng GET /api/delivery/getCities.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
query string - Tôi hỏi.
region string Khu vực.
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
curl --request GET 'https://api.selsup.ru/api/delivery/getCities?query=string&region=string&service=CDEK&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array DeliveryCity[]
TrườngLoạiBắt buộcMô tả
name string Không Tên.
id string Không Id.
[
  "string"
]
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

GET

Tìm địa chỉ

/api/delivery/getAddress
Tấm mã với truy cập đọc

Nhận địa chỉ bằng cách sử dụng GET /api/delivery/getAddress.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
postCode string Không Mã thư.
country string Không Đất nước.
region string Không Khu vực.
city string Không Thành phố.
query string Không - Tôi hỏi.
forSupply boolean Không Để cung cấp.
curl --request GET 'https://api.selsup.ru/api/delivery/getAddress' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array AddressDto[]
TrườngLoạiBắt buộcMô tả
address string Không Địa chỉ.
postalCode string Không Mã bưu chính.
region string Không Khu vực.
locality string Không - Địa điểm.
street string Không - Thường phố.
house string Không Nhà.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
[
  "string"
]
Hầm lẫn4

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_cant_get_address
Không thể lấy địa chỉ giao hàng

error cụ thể cho điểm cuối. Sử dụng mã error_cant_get_address ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Dịch vụ giao hàng thêm

/api/delivery/fetchDeliveryServiceAdditionalServices
Tấm mã với truy cập đọc

Tới các dịch vụ bổ sung giao hàng sử dụng GET /api/delivery/fetchDeliveryServiceAdditionalServices.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
tariffCode integer · int32 Không Bộ luật thuế quan.
curl --request GET 'https://api.selsup.ru/api/delivery/fetchDeliveryServiceAdditionalServices?service=CDEK' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array AdditionalDeliveryServiceDto[]
TrườngLoạiBắt buộcMô tả
code string Không Code.
name string Không Tên.
description string Không Mô tả.
[
  "string"
]
Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

DELETE

Tháo Dùng Dịch vụ Đưa hàng

/api/delivery/{service}/{organizationId}
Tấm mã với quyền truy cập viết

Xóa kết hợp dịch vụ giao hàng bằng cách sử dụng DELETE /api/delivery/{service}/{organizationId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
service stringCDEK, OWN_DELIVERY, POST, BOXBERRY, DPD, YANDEX, DOSTAVISTA, DELLIN, PEC, YANDEX_EXPRESS, FIVE_POST Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
curl --request DELETE 'https://api.selsup.ru/api/delivery/CDEK/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

Authorization

Tỷ hiệu cho các yêu cầu thử nghiệm

Các token vẫn ở trong localStorage của trình duyệt này và chỉ được gửi trong tiêu đề Authorization của các yêu cầu đến api.selsup.ru.

Thử

Các tham số yêu cầu thực

Đáp lại API trực tiếp

Gửi yêu cầu để xem phản ứng SelSup.