SelSup Developers

API · API Đề xuất

Kho hàng

Các điểm cuối cho kho, bao gồm các tuyến đường chính xác, các tham số, các cơ quan yêu cầu và các chương trình đáp ứng có thể mở rộng.

35 điểm cuối/api/warehouseThườ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/warehouse

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 kho

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.

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.

Cell16 trường
idinteger · int32

Id.

read-only
warehouseIdinteger · int64

Đơn vị kho.

passageIdinteger · int32

Đồ thông qua.

shelfIdinteger · int32

Thẻ danh sách.

rackIdinteger · int32

Đồ nhận dạng.

namestring

Tên.

fullNamestring

Tên đầy đủ.

sortNamestring

Tên gọi.

barcodestring

Mã vạch.

deletedboolean

- Quá xóa.

widthinteger · int32

Lớn.

heightinteger · int32

Tốc độ.

depthinteger · int32

Đâu sâu.

clientIdinteger · int64

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

read-only
lastInventoryIdinteger · int32

Thẻ danh mục hàng tồn kho cuối cùng.

read-only
typestring

Type.

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.

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
Passage6 trường
idinteger · int32

Id.

namestring

Tên.

warehouseIdinteger · int64

Đơn vị kho.

deletedboolean

- Quá xóa.

clientIdinteger · int64

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

racksRack[]

Đồ đệm.

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
Rack7 trường
idinteger · int32

Id.

namestring

Tên.

warehouseIdinteger · int64

Đơn vị kho.

passageIdinteger · int32

Đồ thông qua.

deletedboolean

- Quá xóa.

clientIdinteger · int64

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

shelvesShelf[]

- Đồ.

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ụ.

ServiceWarehouse7 trường
idinteger · int64

Id.

read-only
namestring

Tên.

Bắt buộc
externalIdstring

Thẻ cá nhân bên ngoài.

Bắt buộc
warehouseIdinteger · int64

Đơn vị kho.

Bắt buộc
servicestring

Dịch vụ.

Bắt buộc
organizationIdinteger · int64

Đơn vị tổ chức.

Bắt buộc
serviceOrganizationIdinteger · int64

Đơn vị tổ chức dịch vụ.

Shelf7 trường
idinteger · int32

Id.

namestring

Tên.

warehouseIdinteger · int64

Đơn vị kho.

rackIdinteger · int32

Đồ nhận dạng.

deletedboolean

- Quá xóa.

clientIdinteger · int64

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

cellsCell[]

Các tế bào.

Warehouse43 trường
idinteger · int64

Id.

namestring

Tên.

servicestring

Dịch vụ.

organizationIdinteger · int64

Đơn vị tổ chức.

fboOrganizationIdinteger · int64

Hình danh tổ chức FBI.

noPlaceCellIdinteger · int32

Không có giấy tờ phòng.

noPlaceCellCell

Không có phòng giam.

refundCellIdinteger · int32

Cung cấp lại ID của tế bào.

organizationOrganization

Tổ chức.

priorityinteger · int32

Tự ưu tiên.

useForOrderboolean

Sử dụng để sắp xếp.

clientIdinteger · int64

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

externalNamestring

Tên bên ngoài.

notSyncStocksboolean

Không phải Sync Stocks.

ignoreOrdersboolean

Phớt lờ lệnh.

passagesPassage[]

Các đoạn.

warehouseServicesServiceWarehouse[]

Dịch vụ kho.

deliveriesobject

Chuyển hàng.

deletedboolean

- Quá xóa.

captionstring

- Tác phẩm.

durationHoursinteger · int32

Thời gian:

reservationDaysinteger · int32

Ngày đặt chỗ.

schedulestring

- Định lịch.

urAddressstring

Địa chỉ của bạn.

citystring

Thành phố.

longitudenumber · double

Đường dài.

latitudenumber · double

- Đường độ.

warehouseServiceIdinteger · int64

Hình danh dịch vụ kho.

warehouseTypestring

Tiểu kho.

descriptionstring

Mô tả.

inninteger · int64

Nhà nghỉ.

kppinteger · int64

Kpp.

paymentAccountstring

Tài khoản thanh toán.

telephonestring

Điện thoại.

regionNamestring

Tên vùng

regionRegion

Khu vực.

regionIdinteger · int32

Khu vực ID

isPrepayOnlineboolean

Prepay Online.

isCashboolean

Đó là Cash.

isCardboolean

Là Card.

isGoodsActiveboolean

Có hàng hóa hoạt động.

orgIdWarehouse

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

addressstring

Địa chỉ.

CellFilter5 trường
cellIdinteger · int32

- Hình số di động.

shelfIdinteger · int32

Thẻ danh sách.

rackIdinteger · int32

Đồ nhận dạng.

passageIdinteger · int32

Đồ thông qua.

warehouseIdinteger · int64

Đơn vị kho.

ImportResult2 trường
createdinteger · int32

Được tạo ra.

updatedinteger · int32

Được cập nhật.

Coordinates2 trường
latitudenumber · double

- Đường độ.

longitudenumber · double

Đường dài.

OzonFboWarehouse5 trường
addressstring

Địa chỉ.

namestring

Tên.

coordinatesCoordinates

Các định vị.

warehouse_idinteger · int64

Thẻ kho.

warehouse_typestring

Tiểu đồ kho.

WarehouseOfService2 trường
idobject

Id.

namestring

Tên.

WarehouseBalancesWithPrices11 trường
warehouseIdinteger · int64

Đơn vị kho.

quantityinteger · int32

Số lượng.

distinctQuantityinteger · int64

Số lượng rõ ràng.

purchasePricenumber · double

Giá mua.

additionalExpensesAmountnumber · double

Số tiền chi phí bổ sung

wildberriesRetailPricenumber · double

Giá bán lẻ Wildberries.

ozonRetailPricenumber · double

Giá bán lẻ Ozon.

yandexMarketRetailPricenumber · double

Giá bán lẻ thị trường Yandex.

aliexpressRetailPricenumber · double

Giá bán lẻ Aliexpress.

sberMegaMarketRetailPricenumber · double

Giá bán lẻ Sber Mega Market.

retailPriceByMarketplacenumber · double

Giá bán lẻ theo thị trườ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

GET

ID kho

/api/warehouse/{warehouseId}
Tấm mã với truy cập đọc

ID kho sử dụng GET /api/warehouse/{warehouseId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
warehouseId integer · int64 Đơn vị kho.
curl --request GET 'https://api.selsup.ru/api/warehouse/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Warehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}
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_cell_not_found
Không tìm thấy ô

error cụ thể cho điểm cuối. Sử dụng mã error_cell_not_found ổ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_warehouse_not_found
Kho không tìm thấy

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

PUT

Nhà kho đệm

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

Lớp vá kho sử dụng PUT /api/warehouse/{warehouseId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
warehouseId integer · int64 Đơn vị kho.

Cơ quan yêu cầu

application/json
Các trường đối tượngWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
curl --request PUT 'https://api.selsup.ru/api/warehouse/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}'

Phản ứng thành công

200
Các trường đối tượng Warehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}
Hầm lẫn22

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_extract_tariffs
Không thể lấy biểu phí. Hãy viết thư cho bộ phận hỗ trợ

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

400error_duplicate_warehouse_name
Một nhà kho có cùng tên đã tồn tại

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

400error_empty_first_name
Tên không được chỉ định

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

400error_empty_last_name
Họ không được chỉ định

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

400error_empty_organization_form
không chỉ định hình thức tổ chức

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

400error_empty_organization_inn
TIN tổ chức không được chỉ định

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

400error_empty_organization_name
Tên tổ chức không được chỉ định

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

400error_empty_position_name
Chức danh công việc không được chỉ định

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

400error_empty_warehouse_name
Tên kho hàng không được chỉ định

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

400error_max_page
Số trang không thể lớn hơn 100 000

error cụ thể cho điểm cuối. Sử dụng mã error_max_page ổ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_organization_create_failed
Có một vấn đề khi tạo ra một tổ chức. Vui lòng liên hệ với bộ phận hỗ trợ

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

400error_organization_exists
Tổ chức đã được thành lập

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

400error_position_exists
Một vị trí với tiêu đề này đã tồn tại

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

400error_reload
Phiên ủy quyền đã hết hạn, hãy làm mới trang trình duyệt. Nếu cập nhật không hiệu quả, hãy thử xóa cookie của trang web

error cụ thể cho điểm cuối. Sử dụng mã error_reload ổ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_warehouses_limit_exceeded
Đã đạt giới hạn kho FBS trong gói dịch vụ: {limit}

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

400error_wrong_inn
TIN được chỉ định không chính xác của tổ chức, độ dài 10 hoặc 12 chữ số

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

400error_wrong_version
Phiên bản không chính xác

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

DELETE

Xóa kho

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

Xóa kho bằng cách sử dụng DELETE /api/warehouse/{warehouseId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
warehouseId integer · int64 Đơn vị kho.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
restore boolean Không Khôi phục lại.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
"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.

PUT

Đặt ra kệ

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

Đặt Rack sử dụng PUT /api/warehouse/shelf.

Cơ quan yêu cầu

application/json
Các trường đối tượngShelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
curl --request PUT 'https://api.selsup.ru/api/warehouse/shelf' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}'

Phản ứng thành công

200
Các trường đối tượng Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}
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_shelf_already_exist
Một giá có cùng tên đã tồn tại

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

400error_shelf_not_found
Không tìm thấy kệ

error cụ thể cho điểm cuối. Sử dụng mã error_shelf_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.

PUT

Đặt rack

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

Đặt Rack sử dụng PUT /api/warehouse/rack.

Cơ quan yêu cầu

application/json
Các trường đối tượngRack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
curl --request PUT 'https://api.selsup.ru/api/warehouse/rack' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}'

Phản ứng thành công

200
Các trường đối tượng Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}
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_rack_already_exist
Một giá có cùng tên đã tồn tại

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

400error_rack_not_found
Không tìm thấy giá đỡ

error cụ thể cho điểm cuối. Sử dụng mã error_rack_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.

PUT

Đặt Passage

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

Đặt Passage bằng PUT /api/warehouse/passage.

Cơ quan yêu cầu

application/json
Các trường đối tượngPassage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
curl --request PUT 'https://api.selsup.ru/api/warehouse/passage' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "string"
}'

Phản ứng thành công

200
Các trường đối tượng Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "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_passage_already_exist
Đoạn văn có cùng tên đã tồn tại

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

400error_passage_not_found
Đoạn văn không tìm thấy

error cụ thể cho điểm cuối. Sử dụng mã error_passage_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.

PUT

Đặt Cell

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

Đặt Cell sử dụng PUT /api/warehouse/cell.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
passageId integer · int32 Đồ thông qua.
rackId integer · int32 Đồ nhận dạng.
shelfId integer · int32 Thẻ danh sách.

Cơ quan yêu cầu

application/json
Các trường đối tượngCell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
curl --request PUT 'https://api.selsup.ru/api/warehouse/cell?passageId=1001&rackId=1001&shelfId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}'

Phản ứng thành công

200
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}
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_cell_already_exist
Một ô có cùng tên đã tồn tại

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

400error_cell_not_found
Không tìm thấy ô

error cụ thể cho điểm cuối. Sử dụng mã error_cell_not_found ổ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_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ác phẩm của kệ

/api/warehouse/shelf/{shelfId}/copy
Tấm mã với quyền truy cập viết

Tác giả kệ sử dụng POST /api/warehouse/shelf/{shelfId}/copy.

Các tham số đường

TrườngLoạiBắt buộcMô tả
shelfId integer · int32 Thẻ danh sách.
curl --request POST 'https://api.selsup.ru/api/warehouse/shelf/1001/copy' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}
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_shelf_not_found
Không tìm thấy kệ

error cụ thể cho điểm cuối. Sử dụng mã error_shelf_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 kho dịch vụ

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

Xóa Service Warehouse bằng cách sử dụng POST /api/warehouse/removeServiceWarehouse.

Cơ quan yêu cầu

application/json
Các trường đối tượngServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
curl --request POST 'https://api.selsup.ru/api/warehouse/removeServiceWarehouse' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "externalId": "string",
  "warehouseId": 1001,
  "service": "NONE",
  "organizationId": 1001,
  "id": 1001
}'

Phản ứng thành công

200

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

Hầm lẫn21

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_extract_tariffs
Không thể lấy biểu phí. Hãy viết thư cho bộ phận hỗ trợ

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

400error_empty_first_name
Tên không được chỉ định

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

400error_empty_last_name
Họ không được chỉ định

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

400error_empty_organization_form
không chỉ định hình thức tổ chức

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

400error_empty_organization_inn
TIN tổ chức không được chỉ định

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

400error_empty_organization_name
Tên tổ chức không được chỉ định

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

400error_empty_position_name
Chức danh công việc không được chỉ định

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

400error_max_page
Số trang không thể lớn hơn 100 000

error cụ thể cho điểm cuối. Sử dụng mã error_max_page ổ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_organization_create_failed
Có một vấn đề khi tạo ra một tổ chức. Vui lòng liên hệ với bộ phận hỗ trợ

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

400error_organization_exists
Tổ chức đã được thành lập

error cụ thể cho điểm cuối. Sử dụng mã error_organization_exists ổ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_position_exists
Một vị trí với tiêu đề này đã tồn tại

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

400error_reload
Phiên ủy quyền đã hết hạn, hãy làm mới trang trình duyệt. Nếu cập nhật không hiệu quả, hãy thử xóa cookie của trang web

error cụ thể cho điểm cuối. Sử dụng mã error_reload ổ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_user_does_not_have_this_organization
Người dùng không có quyền truy cập vào tổ chức này

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

400error_wrong_inn
TIN được chỉ định không chính xác của tổ chức, độ dài 10 hoặc 12 chữ số

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

400error_wrong_version
Phiên bản không chính xác

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

POST

Tải ra

/api/warehouse/rack/{rackId}/copy
Tấm mã với quyền truy cập viết

Rack Copy sử dụng POST /api/warehouse/rack/{rackId}/copy.

Các tham số đường

TrườngLoạiBắt buộcMô tả
rackId integer · int32 Đồ nhận dạng.
curl --request POST 'https://api.selsup.ru/api/warehouse/rack/1001/copy' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}
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_rack_not_found
Không tìm thấy giá đỡ

error cụ thể cho điểm cuối. Sử dụng mã error_rack_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

Chuyển văn bản

/api/warehouse/passage/{passageId}/copy
Tấm mã với quyền truy cập viết

Bản sao thông qua sử dụng POST /api/warehouse/passage/{passageId}/copy.

Các tham số đường

TrườngLoạiBắt buộcMô tả
passageId integer · int32 Đồ thông qua.
curl --request POST 'https://api.selsup.ru/api/warehouse/passage/1001/copy' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "string"
}
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_passage_not_found
Đoạn văn không tìm thấy

error cụ thể cho điểm cuối. Sử dụng mã error_passage_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

Nhận tế bào bằng cách lọc

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

Nhận các tế bào bằng cách lọc bằng cách sử dụng POST /api/warehouse/getCellsByFilter.

Cơ quan yêu cầu

application/json
Các trường đối tượngCellFilter
TrườngLoạiBắt buộcMô tả
cellId integer · int32 Không - Hình số di động.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
passageId integer · int32 Không Đồ thông qua.
warehouseId integer · int64 Không Đơn vị kho.
curl --request POST 'https://api.selsup.ru/api/warehouse/getCellsByFilter' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "cellId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "passageId": 1001,
  "warehouseId": 1001
}'

Phản ứng thành công

200
Cấu trúc của mục array Cell[]
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
[
  "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_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.

POST

Tạo kho dịch vụ

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

Tạo Service Warehouse bằng POST /api/warehouse/createServiceWarehouse.

Cơ quan yêu cầu

application/json
Các trường đối tượngServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
curl --request POST 'https://api.selsup.ru/api/warehouse/createServiceWarehouse' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "externalId": "string",
  "warehouseId": 1001,
  "service": "NONE",
  "organizationId": 1001,
  "id": 1001
}'

Phản ứng thành công

200
Các trường đối tượng ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
{
  "name": "Example",
  "externalId": "string",
  "warehouseId": 1001,
  "service": "NONE",
  "organizationId": 1001,
  "id": 1001
}
Hầm lẫn24

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_extract_tariffs
Không thể lấy biểu phí. Hãy viết thư cho bộ phận hỗ trợ

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

400error_empty_first_name
Tên không được chỉ định

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

400error_empty_last_name
Họ không được chỉ định

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

400error_empty_name
Tiêu đề không được chỉ định

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

400error_empty_organization_form
không chỉ định hình thức tổ chức

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

400error_empty_organization_inn
TIN tổ chức không được chỉ định

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

400error_empty_organization_name
Tên tổ chức không được chỉ định

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

400error_empty_position_name
Chức danh công việc không được chỉ định

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

400error_empty_service
Thị trường không được chỉ định

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

400error_max_page
Số trang không thể lớn hơn 100 000

error cụ thể cho điểm cuối. Sử dụng mã error_max_page ổ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_organization_create_failed
Có một vấn đề khi tạo ra một tổ chức. Vui lòng liên hệ với bộ phận hỗ trợ

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

400error_organization_exists
Tổ chức đã được thành lập

error cụ thể cho điểm cuối. Sử dụng mã error_organization_exists ổ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_position_exists
Một vị trí với tiêu đề này đã tồn tại

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

400error_reload
Phiên ủy quyền đã hết hạn, hãy làm mới trang trình duyệt. Nếu cập nhật không hiệu quả, hãy thử xóa cookie của trang web

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

400error_service_warehouse_exists
Kết nối kho hàng đã tồn tại

error cụ thể cho điểm cuối. Sử dụng mã error_service_warehouse_exists ổ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_warehouse_empty_id
Chưa chỉ định mã kho trong liên kết với Yandex Market

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

400error_wrong_inn
TIN được chỉ định không chính xác của tổ chức, độ dài 10 hoặc 12 chữ số

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

400error_wrong_version
Phiên bản không chính xác

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

POST

Tạo các tế bào

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

Tạo các tế bào bằng POST /api/warehouse/cells.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
passageId integer · int32 Đồ thông qua.
rackId integer · int32 Đồ nhận dạng.
shelfId integer · int32 Thẻ danh sách.

Cơ quan yêu cầu

application/json
Cấu trúc của mục arrayCell[]
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
curl --request POST 'https://api.selsup.ru/api/warehouse/cells?passageId=1001&rackId=1001&shelfId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Phản ứng thành công

200
Cấu trúc của mục array Cell[]
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
[
  "string"
]
Hầm lẫn8

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_cell_already_exist
Một ô có cùng tên đã tồn tại

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

400error_cell_not_found
Không tìm thấy ô

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

400error_cells_batch_size_invalid
Số lượng ô phải từ 1 đến {maxCount}

error cụ thể cho điểm cuối. Sử dụng mã error_cells_batch_size_invalid ổ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_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

Các tế bào xuất khẩu

/api/warehouse/cells/excel
Tấm mã với truy cập đọc

Xuất khẩu các tế bào sử dụng GET /api/warehouse/cells/excel.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
warehouseId integer · int64 Đơn vị kho.
curl --request GET 'https://api.selsup.ru/api/warehouse/cells/excel?warehouseId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
"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_cells_excel_failed
Không thể xử lý tệp Excel của ô. Không lưu thay đổi.

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

400error_cells_excel_limit
Tệp có thể chứa tối đa {limit} ô.

error cụ thể cho điểm cuối. Sử dụng mã error_cells_excel_limit ổ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_warehouse_not_found
Kho không tìm thấy

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

POST

Nhập tế bào

/api/warehouse/cells/excel
Tấm mã với quyền truy cập viết

Nhập tế bào sử dụng POST /api/warehouse/cells/excel.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
warehouseId integer · int64 Đơn vị kho.

Cơ quan yêu cầu

multipart/form-data
TrườngLoạiBắt buộcMô tả
file string · binary Lưu ý.
curl --request POST 'https://api.selsup.ru/api/warehouse/cells/excel?warehouseId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

Phản ứng thành công

200
Các trường đối tượng ImportResult
TrườngLoạiBắt buộcMô tả
created integer · int32 Không Được tạo ra.
updated integer · int32 Không Được cập nhật.
{
  "created": 1,
  "updated": 1
}
Hầm lẫn14

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_cells_excel_conflict
Dòng {row}: địa chỉ và tên này đã tồn tại hoặc dữ liệu xung đột. Không lưu thay đổi.

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

400error_cells_excel_failed
Không thể xử lý tệp Excel của ô. Không lưu thay đổi.

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

400error_cells_excel_id_invalid
Dòng {row}: ID trùng hoặc không thuộc ô đang hoạt động trong kho này. Để trống ID cho ô mới.

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

400error_cells_excel_limit
Tệp có thể chứa tối đa {limit} ô.

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

400error_cells_excel_parent
Dòng {row}: nhiều lối đi, giá hàng hoặc kệ có cùng tên. Hãy làm rõ tên trong kho.

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

400error_cells_excel_row
Dòng {row}: điền lối đi, giá hàng, kệ và tên; tối đa 100 ký tự mỗi trường, không dùng công thức.

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

400error_incorrect_excel
Định dạng tệp không chính xác. Tải xuống bảng tính Excel.

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

400error_max_upload_size_exceeded
Kích thước tệp được phép đã bị vượt quá

error cụ thể cho điểm cuối. Sử dụng mã error_max_upload_size_exceeded ổ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_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_warehouse_not_found
Kho không tìm thấy

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

POST

Tạo kho mới

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

Tạo kho mới bằng POST /api/warehouse/.

Cơ quan yêu cầu

application/json
Các trường đối tượngWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
curl --request POST 'https://api.selsup.ru/api/warehouse/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}'

Phản ứng thành công

200
Các trường đối tượng Warehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}
Hầm lẫn22

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_extract_tariffs
Không thể lấy biểu phí. Hãy viết thư cho bộ phận hỗ trợ

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

400error_duplicate_warehouse_name
Một nhà kho có cùng tên đã tồn tại

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

400error_empty_first_name
Tên không được chỉ định

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

400error_empty_last_name
Họ không được chỉ định

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

400error_empty_organization_form
không chỉ định hình thức tổ chức

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

400error_empty_organization_inn
TIN tổ chức không được chỉ định

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

400error_empty_organization_name
Tên tổ chức không được chỉ định

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

400error_empty_position_name
Chức danh công việc không được chỉ định

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

400error_empty_warehouse_name
Tên kho hàng không được chỉ định

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

400error_max_page
Số trang không thể lớn hơn 100 000

error cụ thể cho điểm cuối. Sử dụng mã error_max_page ổ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_organization_create_failed
Có một vấn đề khi tạo ra một tổ chức. Vui lòng liên hệ với bộ phận hỗ trợ

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

400error_organization_exists
Tổ chức đã được thành lập

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

400error_position_exists
Một vị trí với tiêu đề này đã tồn tại

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

400error_reload
Phiên ủy quyền đã hết hạn, hãy làm mới trang trình duyệt. Nếu cập nhật không hiệu quả, hãy thử xóa cookie của trang web

error cụ thể cho điểm cuối. Sử dụng mã error_reload ổ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_warehouses_limit_exceeded
Đã đạt giới hạn kho FBS trong gói dịch vụ: {limit}

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

400error_wrong_inn
TIN được chỉ định không chính xác của tổ chức, độ dài 10 hoặc 12 chữ số

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

400error_wrong_version
Phiên bản không chính xác

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

GET

Loại kho

/api/warehouse/{warehouseId}/sort
Tấm mã với truy cập đọc

Sort kho sử dụng GET /api/warehouse/{warehouseId}/sort.

Các tham số đường

TrườngLoạiBắt buộcMô tả
warehouseId integer · int64 Đơn vị kho.
curl --request GET 'https://api.selsup.ru/api/warehouse/1001/sort' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200

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

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_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.

GET

Thang

/api/warehouse/shelf/{shelfId}
Tấm mã với truy cập đọc

Lưu trữ sử dụng GET /api/warehouse/shelf/{shelfId}.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
shelfId integer · int32 Thẻ danh sách.
curl --request GET 'https://api.selsup.ru/api/warehouse/shelf/%7BshelfId%7D?shelfId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}
Hầm lẫn5

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_shelf_not_found
Không tìm thấy kệ

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

DELETE

Xóa ra kệ

/api/warehouse/shelf/{shelfId}
Tấm mã với quyền truy cập viết

Xóa Shelf bằng cách sử dụng DELETE /api/warehouse/shelf/{shelfId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
shelfId integer · int32 Thẻ danh sách.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/shelf/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ẫ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_cell_denied_delete
Sản phẩm được gắn vào ô, không thể xóa

error cụ thể cho điểm cuối. Sử dụng mã error_cell_denied_delete ổ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_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

Nhận các kho dịch vụ

/api/warehouse/service
Tấm mã với truy cập đọc

Nhận các kho dịch vụ bằng cách sử dụng GET /api/warehouse/service.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
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ụ.
externalName string Không Tên bên ngoài.
curl --request GET 'https://api.selsup.ru/api/warehouse/service' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array Warehouse[]
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
[
  "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

Đàn

/api/warehouse/rack/{rackId}
Tấm mã với truy cập đọc

Rack sử dụng GET /api/warehouse/rack/{rackId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
rackId integer · int32 Đồ nhận dạng.
curl --request GET 'https://api.selsup.ru/api/warehouse/rack/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
Cấu trúc của mục array Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}
Hầm lẫn5

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_rack_not_found
Không tìm thấy giá đỡ

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

DELETE

Xóa rack

/api/warehouse/rack/{rackId}
Tấm mã với quyền truy cập viết

Xóa Rack bằng cách sử dụng DELETE /api/warehouse/rack/{rackId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
rackId integer · int32 Đồ nhận dạng.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/rack/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ẫ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_cell_denied_delete
Sản phẩm được gắn vào ô, không thể xóa

error cụ thể cho điểm cuối. Sử dụng mã error_cell_denied_delete ổ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_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

Nhận được Ozon Crossdock Warehouses

/api/warehouse/plan/crossdock-warehouses
Tấm mã với truy cập đọc

Nhận được Ozon Crossdock Warehouses sử dụng GET /api/warehouse/plan/crossdock-warehouses.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Đơn vị tổ chức.
search string Tìm kiếm.
curl --request GET 'https://api.selsup.ru/api/warehouse/plan/crossdock-warehouses?organizationId=1001&search=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array OzonFboWarehouse[]
TrườngLoạiBắt buộcMô tả
address string Không Địa chỉ.
name string Không Tên.
coordinates Coordinates Không Các định vị.
Các trường đối tượng Coordinates
TrườngLoạiBắt buộcMô tả
latitude number · double Không - Đường độ.
longitude number · double Không Đường dài.
warehouse_id integer · int64 Không Thẻ kho.
warehouse_type string Không Tiểu đồ kho.
[
  "string"
]
Hầm lẫn5

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_ozon_id
ID Ozon trống

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

400error_token_expired_or_revoked
Mã thông báo API bị thu hồi hoặc nhập không chính xác

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

GET

Điểm đi

/api/warehouse/passage/{passageId}
Tấm mã với truy cập đọc

Điểm đi qua sử dụng GET /api/warehouse/passage/{passageId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
passageId integer · int32 Đồ thông qua.
curl --request GET 'https://api.selsup.ru/api/warehouse/passage/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
Cấu trúc của mục array Shelf
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
rackId integer · int32 Không Đồ nhận dạng.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
cells Cell[] Không Các tế bào.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "string"
}
Hầm lẫn5

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_passage_not_found
Đoạn văn không tìm thấy

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

DELETE

Xóa đoạn văn

/api/warehouse/passage/{passageId}
Tấm mã với quyền truy cập viết

Xóa Passage bằng cách sử dụng DELETE /api/warehouse/passage/{passageId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
passageId integer · int32 Đồ thông qua.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/passage/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ẫ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_cell_denied_delete
Sản phẩm được gắn vào ô, không thể xóa

error cụ thể cho điểm cuối. Sử dụng mã error_cell_denied_delete ổ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_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

Danh sách

/api/warehouse/list
Tấm mã với truy cập đọc

Danh sách sử dụng GET /api/warehouse/list.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
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ụ.
curl --request GET 'https://api.selsup.ru/api/warehouse/list' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array Warehouse[]
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
[
  "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_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

Nhận kho bằng dịch vụ

/api/warehouse/getWarehousesByService
Tấm mã với truy cập đọc

Nhận các kho theo dịch vụ bằng cách sử dụng GET /api/warehouse/getWarehousesByService.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
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 Dịch vụ.
externalName string Không Tên bên ngoài.
curl --request GET 'https://api.selsup.ru/api/warehouse/getWarehousesByService?service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array Warehouse[]
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
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ụ.
organizationId integer · int64 Không Đơn vị tổ chức.
fboOrganizationId integer · int64 Không Hình danh tổ chức FBI.
noPlaceCellId integer · int32 Không Không có giấy tờ phòng.
noPlaceCell Cell Không Không có phòng giam.
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
refundCellId integer · int32 Không Cung cấp lại ID của tế bào.
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 đủ.
priority integer · int32 Không Tự ưu tiên.
useForOrder boolean Không Sử dụng để sắp xếp.
clientId integer · int64 Không - Đồ nhận khách hàng.
externalName string Không Tên bên ngoài.
notSyncStocks boolean Không Không phải Sync Stocks.
ignoreOrders boolean Không Phớt lờ lệnh.
passages Passage[] Không Các đoạn.
Cấu trúc của mục array Passage
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
racks Rack[] Không Đồ đệm.
Cấu trúc của mục array Rack
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
deleted boolean Không - Quá xóa.
clientId integer · int64 Không - Đồ nhận khách hàng.
shelves Shelf[] Không - Đồ.
warehouseServices ServiceWarehouse[] Không Dịch vụ kho.
Cấu trúc của mục array ServiceWarehouse
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
deliveries object Không Chuyển hàng.
deleted boolean Không - Quá xóa.
caption string Không - Tác phẩm.
durationHours integer · int32 Không Thời gian:
reservationDays integer · int32 Không Ngày đặt chỗ.
schedule string Không - Định lịch.
urAddress string Không Địa chỉ của bạn.
city string Không Thành phố.
longitude number · double Không Đường dài.
latitude number · double Không - Đường độ.
warehouseServiceId integer · int64 Không Hình danh dịch vụ kho.
warehouseType string Không Tiểu kho.
description string Không Mô tả.
inn integer · int64 Không Nhà nghỉ.
kpp integer · int64 Không Kpp.
paymentAccount string Không Tài khoản thanh toán.
telephone string Không Điện thoại.
regionName string Không Tên vùng
region Region Không Khu vực.
Các trường đối tượng Region
TrườngLoạiBắt buộcMô tả
regionId integer · int32 Không Khu vực ID
countryId integer · int32 Không Đơn vị quốc gia.
name string Không Tên.
regionSynonyms RegionSynonym[] Không Các từ đồng nghĩa vùng.
Cấu trúc của mục array RegionSynonym
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
regionId integer · int64 Không Khu vực ID
synonym string Không - Tương tự.
service string Không Dịch vụ.
regionId integer · int32 Không Khu vực ID
isPrepayOnline boolean Không Prepay Online.
isCash boolean Không Đó là Cash.
isCard boolean Không Là Card.
isGoodsActive boolean Không Có hàng hóa hoạt động.
orgId Warehouse Không - Đơn vị nhận dạng.
address string Không Địa chỉ.
[
  "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 được kho dịch vụ

/api/warehouse/getWarehouseOfService
Tấm mã với truy cập đọc

Nhận Warehouse Of Service bằng cách sử dụng GET /api/warehouse/getWarehouseOfService.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Đơn vị tổ chứ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 Dịch vụ.
curl --request GET 'https://api.selsup.ru/api/warehouse/getWarehouseOfService?organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

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

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_ozon_id
ID Ozon trống

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

400error_ms_error
Lỗi API Kho hàng của tôi: {message}

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

400error_no_business_id_yandex_market
Укажите ID кабинета в настройках интеграции с Яндекс.Маркет

error cụ thể cho điểm cuối. Sử dụng mã error_no_business_id_yandex_market ổ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_integration_with_service
Tích hợp với {service}không được cấu hình

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

400error_no_integration_with_wb_ozon
Tích hợp với Wildberries hoặc Ozon chưa được định cấu hình hoặc khóa không hợp lệ. Chuyển đến phần tích hợp để định cấu hình

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

400error_no_integration_with_wildberries
Tích hợp với Wildberries không được định cấu hình. Chỉ định khóa API tiêu chuẩn

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

400error_no_integration_with_yandex_market
Tích hợp với Yandex.Market chưa được định cấu hình. Hoàn thành việc tích hợp.

error cụ thể cho điểm cuối. Sử dụng mã error_no_integration_with_yandex_market ổ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_ozon_api
Lỗi API Ozon: {message}

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

400error_ozon_api_limit
Đã vượt quá giới hạn yêu cầu đối với API Ozone. Điều này có thể xảy ra nếu bạn chạy tác vụ quá thường xuyên. Đợi vài phút trước khi chạy lại tác vụ

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

400error_ozon_premium_plus_subscription_required
Cần có đăng ký OZON Premium Pro để sử dụng

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

400error_ozon_token_invalid
Mã thông báo Ozone không chính xác hoặc bị xóa khỏi tài khoản. Chuyển đến phần tích hợp để định cấu hình

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

400error_prepared_integration_not_found
không tìm thấy tích hợp đã chuẩn bị

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

400error_remote_error
 {message}

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

400error_service_error
Thị trường hoặc dịch vụ mà bạn gửi hoặc dữ liệu chúng tôi nhận được không phản hồi API do lỗi mạng. Khởi động lại tác vụ sau, có thể nó sẽ hoạt động.

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

400error_token_expired_or_revoked
Mã thông báo API bị thu hồi hoặc nhập không chính xác

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

GET

Nhận giá cả tiền trong kho

/api/warehouse/getWarehouseBalancesWithPrices
Tấm mã với truy cập đọc

Nhận số dư kho với giá bằng cách sử dụng GET /api/warehouse/getWarehouseBalancesWithPrices.

curl --request GET 'https://api.selsup.ru/api/warehouse/getWarehouseBalancesWithPrices' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array WarehouseBalancesWithPrices[]
TrườngLoạiBắt buộcMô tả
warehouseId integer · int64 Không Đơn vị kho.
quantity integer · int32 Không Số lượng.
distinctQuantity integer · int64 Không Số lượng rõ ràng.
purchasePrice number · double Không Giá mua.
additionalExpensesAmount number · double Không Số tiền chi phí bổ sung
wildberriesRetailPrice number · double Không Giá bán lẻ Wildberries.
ozonRetailPrice number · double Không Giá bán lẻ Ozon.
yandexMarketRetailPrice number · double Không Giá bán lẻ thị trường Yandex.
aliexpressRetailPrice number · double Không Giá bán lẻ Aliexpress.
sberMegaMarketRetailPrice number · double Không Giá bán lẻ Sber Mega Market.
retailPriceByMarketplace number · double Không Giá bán lẻ theo thị trườ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_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.

GET

Nhận được kho dịch vụ

/api/warehouse/getServiceWarehouse
Tấm mã với truy cập đọc

Nhận Service Warehouse bằng GET /api/warehouse/getServiceWarehouse.

curl --request GET 'https://api.selsup.ru/api/warehouse/getServiceWarehouse' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array ServiceWarehouse[]
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Tên.
externalId string Thẻ cá nhân bên ngoài.
warehouseId integer · int64 Đơn vị kho.
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 Dịch vụ.
organizationId integer · int64 Đơn vị tổ chức.
serviceOrganizationId integer · int64 Không Đơn vị tổ chức dịch vụ.
[
  "string"
]
Hầm lẫn5

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_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

Nhận các kho hàng vùng theo dịch vụ

/api/warehouse/getRegionWarehousesByService
Tấm mã với truy cập đọc

Nhận các kho khu vực theo dịch vụ bằng cách sử dụng GET /api/warehouse/getRegionWarehousesByService.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
services 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 Dịch vụ.
curl --request GET 'https://api.selsup.ru/api/warehouse/getRegionWarehousesByService?services=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
[
  "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_service_not_found
Marketplace không được chọn

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

GET

Tìm Cục

/api/warehouse/findCell
Tấm mã với truy cập đọc

Tìm Cell sử dụng GET /api/warehouse/findCell.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
barcode string Mã vạch.
curl --request GET 'https://api.selsup.ru/api/warehouse/findCell?barcode=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}
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

Phòng

/api/warehouse/cell/{cellId}
Tấm mã với truy cập đọc

Phương án sử dụng GET /api/warehouse/cell/{cellId}.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
cellId integer · int32 - Hình số di động.
curl --request GET 'https://api.selsup.ru/api/warehouse/cell/%7BcellId%7D?cellId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Cell
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
warehouseId integer · int64 Không Đơn vị kho.
passageId integer · int32 Không Đồ thông qua.
shelfId integer · int32 Không Thẻ danh sách.
rackId integer · int32 Không Đồ nhận dạng.
name string Không Tên.
fullName string Không Tên đầy đủ.
sortName string Không Tên gọi.
barcode string Không Mã vạch.
deleted boolean Không - Quá xóa.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
clientId integer · int64 Không - Đồ nhận khách hàng.
lastInventoryId integer · int32 Không Thẻ danh mục hàng tồn kho cuối cùng.
type stringNORMAL, NO_PLACE, REFUND Không Type.
{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}
Hầm lẫn5

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_cell_not_found
Không tìm thấy ô

error cụ thể cho điểm cuối. Sử dụng mã error_cell_not_found ổ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.

DELETE

Xóa tế bào

/api/warehouse/cell/{cellId}
Tấm mã với quyền truy cập viết

Xóa Cell bằng cách sử dụng DELETE /api/warehouse/cell/{cellId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
cellId integer · int32 - Hình số di động.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/cell/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ẫ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_cell_denied_delete
Sản phẩm được gắn vào ô, không thể xóa

error cụ thể cho điểm cuối. Sử dụng mã error_cell_denied_delete ổ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_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.

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.