POST {YourHost}/method/referencebook/rbGoods/get
Для получения списка товарных групп использовать АПИ по этой ссылке
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"RemaindersByStockID" : "ID текущего склада авторизации/сессии",
"isRemainsOnly" : "{0,1} при включении опции только с наличием, передаем 1, иначе 0",
"filter" : "GroupsArrayID",
"value" : "ID одной или нескольких групп/категорий, разделенных через запятую",
"limit" : "показ количества позиций, например 100",
"limitPos" : "номер страницы результируещего набора, начиная с 1"
}
}
]
}
Для получения списка полок использовать АПИ по этой ссылке
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных},
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"RemaindersByStockID" : "ID текущего склада авторизации/сессии",
"RemainsByShelfs" : "ID одной или нескольких полок, разделенных через запятую ",
"limit" : "показ количества позиций, например 100",
"limitPos" : "номер страницы результируещего набора, начиная с 1"
}
}
]
}
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"RemaindersByStockID" : "ID текущего склада авторизации/сессии",
"isRemainsOnly" : "Если нужно посмотреть только карточки с наличием, то передаем 1, иначе если все, то 0",
"filter" : "GoodsMultiSearch",
"multivalue" : "Здесь передаем поисковую фразу",
"limit" : "показ количества позиций, например 100",
"limitPos" : "номер страницы результируещего набора, начиная с 1"
}
}
]
}
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных},
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"RemaindersByStockID" : "ID текущего склада авторизации/сессии",
"isRemainsOnly" : "Если нужно посмотреть только карточки с наличием, то передаем 1, иначе если все, то 0",
"filter" : "GoodsMultiSearch",
"multivalue" : "Здесь передаем поисковую фразу",
"RemainsByShelfs" : "ID одной или нескольких полок, разделенных через запятую ",
"filter2" : "GroupsArrayID",
"value2" : "ID одной или нескольких групп/категорий, разделенных через запятую",
"limit" : 100,
"limitPos" : 1
}
}
]
}
POST {YourHost}/method/referencebook/rbGoods/get
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"RemaindersByStockID" : "ID магазина, по которому нужно показать кол-ва товара в остатке, офис текущей сессии",
"isRemainsOnly" : 0,
"filter" : "id",
"id" : "ID карточки товара "
}
}
]
}
[
{
"YourReferenceOperationID": 1,
"result": [
{
"id": "ID карточки товара",
"id_rbUsers": "ID пользователя вносивший последнее изменение",
"data": "Дата и время создания карточки",
"date_upd": "Дата и время последнего изменения карточки",
"isMarked": "Если равно Y, то карточка помечена на удаление",
"name": "Наименование карточки товара/услуги",
"id_rbGroups": "ID группы, в которой находится товар/услуга",
"GroupsName": "Название группы, в которой находится товар/услуга",
"id_rbUnits": "ID единицы измерения",
"id_rbArticles": "ID артикула товара",
"isILLiquid": "0 - ликвидный, 1 - неликвидный товар",
"id_rbTax": "ID налоговой ставки",
"TaxName": "Название налоговой ставки",
"caption": "Описание",
"isTaxSystemUsn": "1 - Если товар продается по УСН при смешанном СНО",
"id_rbGoodsUnionByName": "не используется",
"isKit": "1 - Комплект, иначе 0",
"properties": "Свойства товара",
"isAutoUpdateCost": "Если 1 - выполнять автоматический расчет цен роботом, иначе 0",
"isAutoUpdateCostByTariff": "Если 1 - выполнить перерасчет цен по тарифной сетке",
"round_method": "округление цен, варианты: {'-1' без округления,'0'-до целого,'5' до 5 единиц,'10' до 10,'50' до 50,'100' до 100,'1000' до 1000,'9' до 9,'99' до 99,'999' до 999}",
"data_in_last": "дата последней закупки",
"cost_in_last": "последня закупочная цена",
"cost_in_fix": "контрольная цена закупки",
"cost_in_max_part": "максимальная цена закупки из партий в наличии",
"AutoUpdateCostFrom": "От какой цены делать пересчет цен при обновлении роботом, два варианта {'CostInMaxPart' - от максимал.цены по партиям находящихся в наличии,'CostInLast' - от последней закупочной цены}",
"AutoUpdateCostIfUpper": "Если 1 - нужно обновлять цены только, при увеличении закупочной, иначе будет 0",
"AutoUpdateNoRest": "Если 1 - нужно обновлять цены, только если товара нет в наличии, иначе будет 0",
"isHide": "Если 1 - то скрытый товар, иначе 0",
"flagHide": "флаг основания скрытой карточки товара",
"id_list_GoodsType": "ID типа товара",
"AssortimentQty": "Настроенное количество для робота автоматической закупки",
"isLabeledControl": "Если 1 - то это торва с маркировкой",
"cost_min_suppliers": "Минимальная цена закупки у поставщиков после последнего анализа",
"data_search_min_cost": "Дата последнего поиска минимальных цен у поставщиков",
"data_sale_last": "Дата последней продажи",
"part": "Количество кратности отгрузки товара",
"coat_retail_previous": "Предыдущая розничная цена",
"coat_retail_previous_date": "Дата предыдущей розничной цены",
"rtime": "Норма-часов для работ и услуг",
"id_rbBarcode_main": "ID базового штрих-кода",
"code": "Артикул товара, очищенный (без пробела, точек, тире, слешов)",
"code_display": "Артикул товара полный",
"brand": "Бренд",
"id_rbBrands": "ID бренда",
"isUnion": "не используется",
"cost_retail": "Цена розничная",
"qty": "Количество по складам, указанным в параметре запроса",
"id_rbGoodsWebCategory": "ID категории для интернет-магазина",
"WebCategoryNames": "Название веб-категории в которой находится товар",
"id_out": "внешний код товара",
"StoragePlaces": "Полки, места хранения товара",
"PhotoUrl": "Линки фото товара",
"barcode": "Базовый штрихкод товара",
"unitName": "Название единицы измерения"
}
]
}
]
POST {YourHost}/method/referencebook/rbGoodsCost/get
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"filter" : "CostByGoodsId",
"id" : "ID карточки товара, по которой нужно получить уровни цен"
}
}
]
}
Ответ сервера
[
{
"YourReferenceOperationID": 1,
"result": [
{
"id": "ID записи",
"id_rbUsers": "Изменено пользователем",
"data": "Дата и время изменения цены",
"id_rbGoods": "ID карточки товара",
"id_rbPriceLevels": "ID уровня цены",
"qty": "Цена для указанного количества товара",
"cost": "Цена",
"isManual": "Если 0 - цена установлена роботом, 1 - цена установлена вручную",
"name": "Наименование уровня цены",
"proc": "105"
},
.....
]
}
]
Запрашиваем список фото для товара
POST {YourHost}/method/referencebook/rbPhoto/get
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"filter" : "PhotoByArtId",
"id" : "поле id_rbArticles из карточки товара",
"GoodsID" : "ID карточки товара"
}
}
]
}
Ответ сервера
[
{
"YourReferenceOperationID": 1,
"result": [
{
"id": "ID записи фото",
"name": "url-адрес фото",
},
.....
]
}
]
Важно:
1.Добавляем фото в хранилище через АПИ
2.Затем, полученную веб-ссылку добавляем к паре Артику-бренд, через указанное ниже АПИ
POST {YourHost}/method/referencebook/rbPhoto/ins
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"code" : "Артикул товара",
"rbBrands_id_rbBrands" : "Бренд товара",
"name" : "Веб-ссылка на фото товара",
"GoodsID" : "ID карточки товара"
}
}
]
}
Ответ сервера
[
{
"YourReferenceOperationID":1,
"result":
[
{
"isError" : "0",
"mess" : "",
"newRecId" : "ID записи добавленного фото",
"AnyID" : "0"
}
]
}
]
Важно: необходимо сперва удалить файл из хранилища через АПИ
POST {YourHost}/method/referencebook/rbPhoto/del
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"id": "ID записи фото товара",
"delForever": 1
}
}
]
}
POST {YourHost}/method/reports/ReportTMC
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"RemainderByGoodsID" : "ID карточки товара",
"ByStockID" : "ID склада по которому нужно получить остатки по полкам"
}
}
]
}
Ответ сервера
[
{
"YourReferenceOperationID":1,
"result":
[
{
"id_rbStock" : "Id склада, если передали ByStockID, то совпадает с ним",
"id_rbStockStoragePlace" : "Id полки места хранения на складе",
"StockName" : "Название склада хранения",
"StockStorageName" : "Название полки места хранения",
"qty" : "Кол-во остатка на полке"
}
]
}
]
POST {YourHost}/method/any/ShiftGoodsToAnotherStorage
Для получения списка полок по складу, использовать текущее API
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"GoodsID" : "ID карточки товара",
"StoragesID" : "ID новой полки куда переместить",
"id_rbFirms" : "ID фирмы текущей авторизации/сессии",
"qty" : "требуемое количество для перемещения",
"StoragesFromID" : "ID с какой полки взять товар",
"LanguageCode" : "ru"
}
}
]
}
POST {YourHost}/method/any/ShiftGoodsToAnotherStorage
Для получения списка полок по складу, использовать текущее API
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"AllRemaiders" : 1,
"StoragesID" : "ID новой полки куда переместить",
"id_rbFirms" : "ID фирмы текущей авторизации/сессии",
"ArrayGoodsID" : "ID товаров для перемещения через запятую, например: 1454,1467 ",
"LanguageCode" : "ru"
}
}
]
}
POST {YourHost}/method/referencebook/rbBarcode/get
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"filter" : "BarcodeByGoodsId",
"id" : "ID карточки товара"
}
}
]
}
Ответ сервера
[
{
"YourReferenceOperationID":1,
"result":
[
{
"id" : "ID записи штрихкода",
"name" : "штрихкод",
"isBase" : "1-основной штрихкод, 0-дополнительный"
}
]
}
]
POST {YourHost}/method/referencebook/rbBarcode/ins
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"name" : "штрихкод товара",
"id_rbGoods" : "ID карточки товара"
}
}
]
}
Ответ сервера
[
{
"YourReferenceOperationID":1,
"result":
[
{
"isError" : "0",
"mess" : "",
"newRecId" : "ID записи добавленного штрихкода",
"AnyID" : "0"
}
]
}
]
POST {YourHost}/method/referencebook/rbBarcode/del
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"id" : "ID записи штрихкода",
"delForever" : 1
}
}
]
}
POST {YourHost}/method/referencebook/rbGoods/ins
АПИ для получения товарных групп можно посмотреть здесь
АПИ для получения списка мест хранения/полок можно посмотреть здесь
АПИ для получения списка единиц измерения можно посмотреть здесь
АПИ для получения списка налоговых ставок можно посмотреть здесь
АПИ для получения списка брендов можно посмотреть здесь
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"name": "Наименование товара",
"GroupsID": "Категория/группа в которую нужно добавить товар, если передать пустое значение, то по умолчанию будет добавлена в группу `На обработку`",
"id_list_GoodsType": "тип, передаем один из вариантов {товар, услуга, работа}",
"id_rbUnits": "ID единицы измерения. Если не передавать параметр, то будет установлено по умолчанию системы из констант",
"id_rbTax": "ID налоговой ставки. Если не передавать параметр, то будет установлено по умолчанию системы из констант",
"caption": "тут можно передать описание",
"isAutoUpdateCost": "0 - передаем если нужно установить нашу цену продажи, 1 - если нужно, чтобы цена продажи расчиталась роботом правил ценообразования",
"isAutoUpdateCostByTariff": 1,
"cost_retail": "розничная цена продажи",
"AutoUpdateCostFrom": "CostInMaxPart",
"AutoUpdateCostIfUpper": 1,
"part": "1 - кратность отгрузки товара, можно не передавать параметр, по умолчанию будет 1шт",
"code": "артикульный номер товара",
"brand": "бренд товара",
"id_out": "можно передать уникальный внешний код товара",
"isCreateArticleIfNotExits": 1,
"importData": 1,
"acceptQty": "Количество для ввода в остатки. Если указали больше нуля, то нужно будет передать также закупочную цену и ID полки",
"cost_in_last": "закупочная цена",
"StockStoragePlaceID": "ID полки приемки товара на складе, в случае если передали количество",
"FirmID":"ID текущей фирмы авторизации (нужен, если указали количество для ввода в остатки)"
}
}
]
}
Ответ сервера при успешном создании карточки товара
[
{
"YourReferenceOperationID": 1,
"result": [
{
"isError": "0",
"mess": "",
"newRecId": "ID новой карточки товара",
"AnyID": "0"
}
]
}
]
POST {YourHost}/method/referencebook/rbGoods/upd
АПИ для получения товарных групп можно посмотреть здесь
АПИ для получения списка мест хранения/полок можно посмотреть здесь
АПИ для получения списка единиц измерения можно посмотреть здесь
АПИ для получения списка налоговых ставок можно посмотреть здесь
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"id": "ID карточки товара",
"name": "Наименование товара",
"id_rbGroups": "Категория/группа в которую нужно добавить товар. Если не передавать параметр, то не будет изменено",
"id_rbUnits": "ID единицы измерения. Если не передавать параметр, то не будет изменено",
"id_rbTax": "ID налоговой ставки. Если не передавать параметр, то не будет изменено",
"caption": "тут можно изменить описание",
"isAutoUpdateCost": "0 - передаем, чтобы отключить робота формирования цены, иначе указываем 1",
"isAutoUpdateCostByTariff": 1,
"AutoUpdateCostFrom": "CostInMaxPart",
"AutoUpdateCostIfUpper": 1,
"part": "1 - кратность отгрузки товара, можно не передавать параметр, по умолчанию будет 1шт",
"code": "артикульный номер товара",
"brand": "бренд товара",
"id_out": "можно передать уникальный внешний код товара",
"cost_retail":"Розничная цена. Если не передать параметр или передать 0, то цена останется прежней",
"isCreateArticleIfNotExits": 1
}
}
]
}
Ответ сервера при успешном изменении карточки товара
[
{
"YourReferenceOperationID": 1,
"result": [
{
"isError": "0",
"mess": "",
"newRecId": "0",
"AnyID": "0"
}
]
}
]
POST {YourHost}/method/referencebook/rbBrands/get
Параметр в JSON-формате
{
"db" : "{Здесь_передаем_имя_вашей_базы_данных}",
"params" :
[
{
"YourReferenceOperationID" :1,
"jparams":
{
"filter": "nameLikeLeft",
"value": "первые буквы бренда, указывать как минимум 1 букву",
"limit": "показать кол-во позиций удовлетворяющих фильтру, рекомендуем штук 30",
"limitPos": "номер показа страницы результатов, начиная с 1"
}
}
]
}
Ответ сервера
[
{
"YourReferenceOperationID":1,
"result":
[
{
"id": "ID бренда",
"name": "наименование бренда"
},
......
]
}
]