Перейти к содержаниюСправка

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
doc:dev:api:store [25.04.2015 13:50] – doc:dev:api:store [26.09.2026 14:03] (текущий) – внешнее изменение
Строка 1: Строка 1:
-====== API :: Store. Получение данных об остатках товара ======+====== Store. Остатки товара ======
  
-В системе реализован программный интерфейс для получения данных об остатках товаров в магазинах. Данные выгружаются по http протоколу. Формат на выбор - xml или json.+Статья перенесена: [[hc:api:store]]
  
- 
-===== Пример запроса ===== 
- 
-Пример запроса на получение данных об остатках товаров: 
- 
- http://mycompany.virtpos.ru/api/store?apikey=MySecret&format=xml&warehouseid=1&fields=itemname:article 
- 
-==== Параметры запроса ==== 
- 
-  * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр. 
- 
-  * **format** - формат, в котором сервер отдаст данные. Может принимать значения "xml" или "json". Необязательный параметр. 
- 
-  * **stockonly** - если "1", то возвращает только те товары, которые есть в наличии (остаток больше нуля) 
- 
-  * **warehouseid** - код магазина, для которого надо вернуть данные об остатках. Если не указан, то возвращаются данные обо всех магазинах. 
- 
-  * **itemid** - код товара, данные о котором надо вернуть. Если не задан, то будут отданы данные обо всех товарах. 
- 
-  * **article** - артикул товара, данные о котором надо вернуть. Если не задан, то будут отданы данные обо всех товарах. 
- 
-  * **itemname** - название товара, данные о котором надо вернуть. Если не задан, то будут отданы данные обо всех товарах. 
- 
-  * **fields** - список дополнительных полей, которые будут добавлены в ответ сервера. Имена полей разделены символом ":". Необязательный параметр. Поддерживаются следующие поля:  
-    * itemname - название товара 
-    * article - артикул товара 
-    * cogs - себестоимость товара 
-    * price - цена продажи по основному прайслисту 
-    * optionalprices - цены товара по дополнительным прайслистам  
- 
- 
-==== Ответ сервера ==== 
- 
-В ответ получаем XML или JSON. В ответе обязательно присутствует поле success. Если success=1, то операция выполнена успешно. Если success=0, то произошла ошибка. Дополнительная информация об ошибке содержится в поле info 
- 
- 
- 
-==== Пример ответа сервера ==== 
- 
-Ниже приведен пример ответа сервера в формате XML 
- 
-<file xml> 
-<?xml version="1.0" encoding="UTF-8"?> 
-<root> 
-    <success>1</success> 
-    <type>store</type> 
-    <stockonly>1</stockonly> 
-    <count>1</count> 
-    <warehouses> 
-        <warehouse> 
-            <id>3</id> 
-            <name>Магазин 1</name> 
-            <count>1</count> 
-            <items> 
-                <item> 
-                    <id>17007</id> 
-                    <quantity>1.000</quantity> 
-                    <name>63838 Корм для собак 2кг</name> 
-                    <article>63838</article> 
-                    <cogs>0.00</cogs> 
-                    <price>1126.00</price> 
-                    <prices> 
-                        <price> 
-                            <pricelistid>4</pricelistid> 
-                            <price>1126.00</price> 
-                        </price> 
-                        <price> 
-                            <pricelistid>3</pricelistid> 
-                            <price>866.00</price> 
-                        </price> 
-                    </prices> 
-                </item> 
-            </items> 
-        </warehouse> 
-    </warehouses> 
-</root> 
-</file>