Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
doc:dev:api:pricelistadjustment [05.06.2017 16:51] mkuklin |
doc:dev:api:pricelistadjustment [02.06.2018 10:42] (текущий) |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | ====== API :: PricelistAdjustment. API для документа "Корректировка розничных цен" ====== | + | ====== API :: PricelistAdjustment. Документ "Корректировка розничных цен" ====== |
В системе реализован программный интерфейс для получения и обновления данных о документе "Корректировка розничных цен". Данные выгружаются по http протоколу. Формат на выбор - xml или json. | В системе реализован программный интерфейс для получения и обновления данных о документе "Корректировка розничных цен". Данные выгружаются по http протоколу. Формат на выбор - xml или json. | ||
Строка 7: | Строка 7: | ||
Получение существующего документа "корректировка розничных цен" | Получение существующего документа "корректировка розничных цен" | ||
- | http://mycompany.virtpos.ru/api/pricelistadjustment?apikey=MySecret&format=xml&id=1 | + | http://mycompany.virtpos.ru/api/pricelistadjustment?apikey=MySecret&format=xml&id=1&item_id=3 |
+ | |||
+ | Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры. | ||
Параметры: | Параметры: | ||
- | * int **id** - внутренний ID документа | + | * 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 прайслиста | ||
+ | |||