Различия

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

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

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
doc:dev:api:item [06.02.2017 12:41]
rlysov
doc:dev:api:item [28.04.2020 20:05] (текущий)
rlysov [Параметры запроса]
Строка 11: Строка 11:
  
 ==== Параметры запроса ==== ==== Параметры запроса ====
 +параметры,​ которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.
  
-  * **format** - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.+  * **format** ​(get only) - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.
  
-  * **id** - код товара,​ для которого надо вернуть данные. Если не указан,​ то возвращаются данные о всех товарах.+  * **id** ​(get only) - код товара,​ для которого надо вернуть данные. Если не указан,​ то возвращаются данные о всех товарах.
  
-  * **external_id** - код товара во внешней системе учета (например,​ в 1С)+  * **external_id** ​(get only) - код товара во внешней системе учета (например,​ в 1С)
   ​   ​
-  * **enabled_only** - опционально,​ 1 если нужно получить только активные товары,​ 0 если все. ​+  * **enabled_only** ​(get only) - опционально,​ 1 если нужно получить только активные товары,​ 0 если все. ​ 
 + 
 +  * **pricelist** - (опционально). В параметре можно передать Id прайслиста. Если ID прайслиста переден,​ то к каждому товару будут добавлены колонки с ценами из этого прайлиста. Чтобы вернуть цены из прайслиста для интернет-витрины,​ то вместо ID можно указать ключевое слово "​internet":​ &​pricelist=internet. 
 + 
 +  * **images** - опционально. Если указано значение "​1",​ то к каждому товару будет добавлен список файлов с изображениями. Имена файлов будут перечислены через запятую
  
 +  * **from_id** - опционально. Вернуть товары начиная с этого ID
  
 +  * **limit** - опционально. Максимальное количество товаров в ответе
 ==== Ответ сервера ==== ==== Ответ сервера ====
  
Строка 49: Строка 55:
  <​enabled>​1</​enabled>​  <​enabled>​1</​enabled>​
  <​sales_weight>​0</​sales_weight>​  <​sales_weight>​0</​sales_weight>​
- <​manufacturer_id/>​+ <​manufacturer_id>1</manufacturer_id>​ 
 + <​type>​G</​type>
  <​weight_good_flag>​N</​weight_good_flag>​  <​weight_good_flag>​N</​weight_good_flag>​
  <​not_show_in_shop>​1</​not_show_in_shop>​  <​not_show_in_shop>​1</​not_show_in_shop>​
 +                        <​html_template_id>​5</​html_template_id>​
  <​external_id/>​  <​external_id/>​
  <​group_ids>​1,​2</​group_ids>​  <​group_ids>​1,​2</​group_ids>​
  <​group_ext_ids>​{123-543},​{000-999}</​group_ext_ids>​  <​group_ext_ids>​{123-543},​{000-999}</​group_ext_ids>​
  <​barcodes>​4607092441788,​9785864153055</​barcodes>​  <​barcodes>​4607092441788,​9785864153055</​barcodes>​
 + <​vat_percent>​18</​vat_percent>​
  <​created_date>​2015-07-11 17:​16:​49</​created_date>​  <​created_date>​2015-07-11 17:​16:​49</​created_date>​
  <​last_update_date>​2015-07-11 17:​29:​25</​last_update_date>​  <​last_update_date>​2015-07-11 17:​29:​25</​last_update_date>​
Строка 65: Строка 74:
  <​enabled>​1</​enabled>​  <​enabled>​1</​enabled>​
  <​sales_weight>​0</​sales_weight>​  <​sales_weight>​0</​sales_weight>​
- <​manufacturer_id/>​+ <​manufacturer_id>1</manufacturer_id>​ 
 + <​type>​G</​type>
  <​weight_good_flag>​N</​weight_good_flag>​  <​weight_good_flag>​N</​weight_good_flag>​
  <​not_show_in_shop>​0</​not_show_in_shop>​  <​not_show_in_shop>​0</​not_show_in_shop>​
 +                        <​html_template_id>​5</​html_template_id>​
  <​external_id>​22222</​external_id>​  <​external_id>​22222</​external_id>​
  <​group_ids>​1,​2</​group_ids>​  <​group_ids>​1,​2</​group_ids>​
  <​group_ext_ids>​{123-543},​{000-999}</​group_ext_ids>​  <​group_ext_ids>​{123-543},​{000-999}</​group_ext_ids>​
  <​barcodes>​4607092441788,​9785864153055</​barcodes>​  <​barcodes>​4607092441788,​9785864153055</​barcodes>​
 + <​vat_percent>​18</​vat_percent>​
  <​created_date>​2015-07-11 17:​34:​58</​created_date>​  <​created_date>​2015-07-11 17:​34:​58</​created_date>​
  <​last_update_date>​2015-07-11 17:​36:​36</​last_update_date>​  <​last_update_date>​2015-07-11 17:​36:​36</​last_update_date>​
Строка 88: Строка 100:
  
 ==== Параметры запроса ==== ==== Параметры запроса ====
 +параметры,​ которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.
  
-  * **format** - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.+  * **format** ​(get only) - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.
  
-  * **id** - код товара,​ данные которого надо обновить+  * **id** ​(get only) - код товара,​ данные которого надо обновить
  
-  * **external_id** - код товара во внешней системе учета (например,​ в 1С), данные которого надо обновить+  * **external_id** ​(get only) - код товара во внешней системе учета (например,​ в 1С), данные которого надо обновить
  
-  * **create_if_not_exist** - Если истина,​ то при неудачном поиске товар будет добавлен в систему.+  * **create_if_not_exist** ​(get only) - Если истина,​ то при неудачном поиске товар будет добавлен в систему.
        
   * **manufacturer_name** - Название производителя. Если значение указано,​ то происходит проверка,​ есть ли производитель с таким именем в справочнике. Если нет, то он будет добавлен. Параметр игнорируется,​ если указан manufacturer_id   * **manufacturer_name** - Название производителя. Если значение указано,​ то происходит проверка,​ есть ли производитель с таким именем в справочнике. Если нет, то он будет добавлен. Параметр игнорируется,​ если указан manufacturer_id
Строка 110: Строка 122:
  
   * **volume** - объем ​   * **volume** - объем ​
 +
 +  * **manufacturer_id** - id производителя
 +
 +  * **type** - тип товара (G - товар, S - услуга,​ M - материальная ценность).
  
   * **weight_good_flag** - флаг весового товара. Значения "​Y"​ / "​N"​   * **weight_good_flag** - флаг весового товара. Значения "​Y"​ / "​N"​
  
   * **not_show_in_shop** - показывать или нет товар в интернет-витрине и мобильном приложении. Значения:​ "​0"​ / "​1"​   * **not_show_in_shop** - показывать или нет товар в интернет-витрине и мобильном приложении. Значения:​ "​0"​ / "​1"​
 +
 +  * **html_template_id** - id шаблона ценника
  
   * **category_id** - id товарной категории ("​1"​ - алкоголь / "​2"​ - товары18+ )   * **category_id** - id товарной категории ("​1"​ - алкоголь / "​2"​ - товары18+ )
  
   * **group_ids** - разделенный запятой список из id товарных групп, в которые входит товар   * **group_ids** - разделенный запятой список из id товарных групп, в которые входит товар
 +
 +  * **vat_percent** - ставка НДС
  
   * **attribute1**..**attribute15** - значения гибких полей   * **attribute1**..**attribute15** - значения гибких полей
Строка 163: Строка 183:
  
 ==== Параметры запроса ==== ==== Параметры запроса ====
 +параметры,​ которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.
  
-  * **format** - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.+  * **format** ​(get only) - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.
   ​   ​
-  * **create_if_not_exist** - Если истина,​ то при неудачном поиске товар будет добавлен в систему.+  * **create_if_not_exist** ​(get only) - Если истина,​ то при неудачном поиске товар будет добавлен в систему.
  
 ==== Параметры data ==== ==== Параметры data ====