Различия

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

--- doc:dev:api:pricelistadjustment [05.06.2017 16:46]
mkuklin создано
+++ doc:dev:api:pricelistadjustment [02.06.2018 10:42] (текущий)
@@ Строка 1: / Строка 1: @@
-====== API :: PricelistAdjustment. API для документа "Корректировка розничных цен" ======
+====== API :: PricelistAdjustment. Документ "Корректировка розничных цен" ======
 В системе реализован программный интерфейс для получения и обновления данных о документе "Корректировка розничных цен". Данные выгружаются по http протоколу. Формат на выбор - xml или json.
+===== Получение данных о ценах =====
+Получение существующего документа "корректировка розничных цен"
+ http://mycompany.virtpos.ru/api/pricelistadjustment?apikey=MySecret&format=xml&id=1&item_id=3
+Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
+Параметры:
+  * int  **id** (get only) - внутренний ID документа
+  * int  **item_id** (get only) - ID товара (необязательный)
+  * int  **item_ext_id** (get only) - внешний ID товара (необязательный)
+===== Создание/обновление документа =====
+http://mycompany.virtpos.ru/api/pricelistadjustment/update?apikey=MySecret&format=xml
+Создает или обновляет документ "Корректировка розничных цен".
+Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
+Параметры:
+  * **id** (get only) - ID документа
+  * **pricelist_id** (get only) - id прайслиста, к которому применять изменения
+  * **create_if_not_exist** (get only) - если "1", то запись будет создана при неуспешном поиске
+  * **status** (get only) - применить "Корректировку розничных цен" (сменить статус)
+===== Массовое обновление цен ======
+http://mycompany.virtpos.ru/api/price/batchUpdate?&format=xml&apikey=d41&batch=
+<root>
+<id_price>2</id_price>
+<items>
+<item>
+<ext_item_code>a33c45e3-e4f1-11e4-b00e-005056a7771f</ext_item_code>
+<price>234234</price>
+<is_action>true</is_action>
+<is_printable>false</is_printable>
+</item>
+<item>
+<ext_item_code>yyyy</ext_item_code>
+<price>22222</price>
+<is_action>true</is_action>
+<is_printable>false</is_printable>
+</item>
+</items>
+</root>
+Массово обновляет цены на товары. Параметры:
+  * batch - xml документ для описания новых цен
+===== Создание/обновление цены в документе =====
+ http://mycompany.virtpos.ru/api/pricelistadjustment/update?apikey=MySecret&format=xml&item_id=1&price=12.34
+Обновляет цену в документе "Корректировка розничных цен".
+Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
+Параметры:
+  * **id** (get only) - ID прайслиста
+  * **item_id** (get only) - ID товара
+  * **item_ext_id** (get only) - внешний ID товара
+  * **price** (get only) - новая цена товара
+===== Применение цен в документе к товарам =====
+http://mycompany.virtpos.ru/api/pricelistadjustment/accept?apikey=MySecret&format=xml&id=1
+Применяет цены, заданные в документе "Корректировка розничных цен".
+Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
+Параметры:
+  * **id** (get only) - ID прайслиста