Последнее обновление
06.10.2026arts/scan
Тип метода
POST
Назначение
- Идентификация и получение объекта товара при сканировании ШК
- Идентификация и получение объекта товара при считывании RFID-метки
Где используется
- В документах
- В справочнике товаров
- В операции “Печать этикеток”
Запрос
Параметры
| Наименование | Тип | Описание |
|---|---|---|
| barcode | string | Штрихкод товара |
| username | string | Имя пользователя |
| device_id | string | Идентификатор устройства |
Тело
| Наименование | Тип | Описание | Значение |
|---|---|---|---|
| operation_type | int | Идентификатор строки | 0 – подбор 1 – размещение |
| barcode | string | ШК товара | |
| doc_id | string | Идентификатор документа | |
| cell_barcode | string | ШК ячейки | |
| gs1 | string | ШК GS1 | |
| kiz | object | Объект кода маркировки |
Пример запроса #1
Идентификация и получение объекта товара при сканировании ШК в обычных документах
Идентификация и получение объекта товара при считывании RFID-метки в обычных документах
http://192.168.1.1/DM/hs/DataMobileExch/api/arts/scan?device_id=1&username=Администратор
{
"gs1": "",
"cell_barcode": "",
"doc_id": "d82-d3424109-8589-11ec-8d95-6245b4e7a4ef",
"barcode": "2000000007786",
"operation_type": 0
}
Пример запроса #2
Идентификация и получение объекта товара при сканировании кода маркировки товара в документах маркировки
http://192.168.1.1/DM/hs/DataMobileExch/api/arts/scan?device_id=1&username=Администратор
{
"kiz": {
"raw_barcode": "04640030090662PJ2iWL%ACoA1JbQ",
"tnvd": "",
"raw_mrc": "ACoA",
"decoded_mrc": "16000",
"sn": "PJ2iWL%",
"ean": "",
"mark": "04640030090662PJ2iWL%",
"gtin": "4640030090662"
},
"gs1": "",
"cell_barcode": "",
"doc_id": "d82-d3424109-8589-11ec-8d95-6245b4e7a4ef",
"operation_type": 0
}
Пример запроса #3
Идентификация и получение объекта товара при сканировании ШК в справочнике товаров и в операции “Печать этикеток”
Идентификация и получение объекта товара при считывании RFID-метки в справочнике товаров и в операции “Печать этикеток”
http://192.168.1.1/DM/hs/DataMobileExch/api/arts/scan?barcode=1&device_id=1&username=Администратор
Ответ
Тело
| Наименование | Тип | Описание |
|---|---|---|
| art обязательное | object | Объект товара |
| barcode | object | Объект ШК товара |
| barcodes | object array | Массив объектов ШК товара |
| is_kit | boolean | Признак является ли товар набором (комплектом) |
| limit_qty | float | Остаток товара |
| weight_task | float | Допуск весового товара |
| sn | string | Значение серии товара. - Если в шаблоне is_multi_sn_logic выключен (template) - то строковое значение серии (например, "2312181").- Если is_multi_sn_logic включен (template) - то строковое значение массива списка серий в формате json.Если is_multi_sn_logic включен - тогда с карточкой товара (art) загружается sn_types (например, ["10","11","17"], где “10” - партия, “11” - дата производства, “17” - срок годности), значения в sn необходимо возвращать в аналогичном порядке строкой экранируя кавычки внутри (например, "[\"2312181\",\"18.12.23\",\"17.12.24\"]"). |
Пример ответа #1
[
{
"art": {
"id": "8U-cbcf493f-55bc-11d9-848a-00112f43529a00000000-0000-0000-0000-000000000000",
"name": "Вентилятор BINATONE ALPINE 160вт, напольный, оконный",
"price": 0,
"is_use_sn": false,
"measure_type": 1,
"mark_type": 0,
"attributes": {
"attr_1": "",
"attr_2": "",
"attr_3": "",
"attr_4": "",
"attr_5": "",
"attr_6": "",
"attr_7": "",
"attr_8": "",
"attr_9": "",
"attr_10": ""
}
},
"barcode": {
"value": "2000000007786",
"unit_name": "шт",
"unit_id": "GUID_UNIT_4",
"unit_coef": 1
},
"limit_qty": 9,
"sn": "2312181"
}
]
Пример ответа #2
[
{
"is_kit": false,
"art": {
"id": "8U-4e7d0975-d562-11ee-b0d3-50465db6e59900000000-0000-0000-0000-000000000000",
"name": "БАД к пище",
"price": 0,
"is_use_sn": true,
"measure_type": 0,
"mark_type": 32,
"attributes": {
"attr_1": "",
"attr_2": "",
"attr_3": "",
"attr_4": "",
"attr_5": "",
"attr_6": "",
"attr_7": "",
"attr_8": "",
"attr_9": "",
"attr_10": ""
},
"parent_id": "",
"type": 0,
"kit_parts": [],
"additional_prices": {
"price_1": 0
},
"sn_types": [
"10",
"11",
"17"
]
},
"barcode": {
"unit_name": "шт",
"unit_id": "",
"unit_coef": 1,
"use_sn_mode": 2
},
"sn": "[\"2312181\",\"18.12.23\",\"17.12.24\"]",
"limit_qty": 70
}
]
Пример ответа #3
Возвращаются объекты art
[
{
"id": "8U-cbcf493f-55bc-11d9-848a-00112f43529a00000000-0000-0000-0000-000000000000",
"name": "Вентилятор BINATONE ALPINE 160вт, напольный, оконный",
"price": 0,
"is_use_sn": false,
"measure_type": 1,
"mark_type": 0,
"attributes": {
"attr_1": "",
"attr_2": "",
"attr_3": "",
"attr_4": "",
"attr_5": "",
"attr_6": "",
"attr_7": "",
"attr_8": "",
"attr_9": "",
"attr_10": ""
},
"is_deleted": false,
"rest": 28,
"barcodes": [
{
"value": "2000000007786",
"unit_id": "GUID_UNIT_2",
"unit_name": "шт",
"unit_coef": 1,
"use_sn_mode": 2,
"is_deleted": false
}
]
}
]
см. art
см. barcode
см. kiz