API Источник Бэттэрис

API Источник Бэттэрис - специальный веб-сервис для клиентов компании, для получения персонализированной актуальной информации от компании.

В настоящее время -реализована возможность получения ценового предложения и информирования об уровне складских остатков доступных для заказа.

Строки доступа и описание выводимых полей приведены ниже. Обратите внимание, что в запросах используется Ваш персональный ключ доступа , ниже приведен под псевдонимом @apikey (замените на Ваш персональный в реальных запросах !!). Он передается сервису по защищенному соединению, однако рекомендуем Вам побеспокоиться о невозможности попадания его в чужие руки.
При подозрении о компрометации ключа - обратитесь к менеджеру за заменой на новый.
Как правило , работа с Вашим ключом возможна только на следующий день после его получения.

 

Возможен выбор трех вариантов формата ответа: xls (скачивание файла Эксель), JSON и XML.
Последние 2 варианта должны быть интересны Вам, если Вы планируете программный доступ к этим данным. Выбор формата осуществляется указанием его в строке запроса.

И наконец, имеется опция сократить выдачу отбором по одной или нескольким торговым маркам.
Примеры обращений к сервису приведены ниже.

Цены на все товары в формате скачиваемого файла Excel:

https://direct.istochnik.ru/istapi/1.0.0/contragents/prices?api_key=@apikey&format=xls

Цены на ANSMANN и ROBITON в формате скачиваемого файла Excel:

https://direct.istochnik.ru/istapi/1.0.0/contragents/prices?api_key=@apikey&format=xls&brands=Ansmann,Robiton

Специальные форматы. Для тестирования можно посмотреть вывод в окно браузера.

Цены на все товары в формате XML:

https://direct.istochnik.ru/istapi/1.0.0/contragents/prices?api_key=@apikey&format=xml

Цены на все товары в формате JSON:

https://direct.istochnik.ru/istapi/1.0.0/contragents/prices?api_key=@apikey&format=json

В сервисе предусмотрена возможность вывода некоторых значений полей  в контексте в основной учетной единицы, используемой Вами (штуки или розничные упаковки: например одна батарейка или блистер из четырех штук, являющийся розничной упаковкой).
По умолчанию привязка идет к типу используемой Вами основной единицы, который прописан у нас  в базе . Контролировать эту установку можно по значению поля PPA в шапке. Если эта установка некорректна, Вы можете принудительно получить данные с привязкой к нужному Вам типу единицы добавив в строку запроса дополнительный ключ &units=retailPacks (при использовании в качестве основной единицы розничных упаковок).
В избежании разночтений в толковании розничной упаковки, дополнительно по каждому товару приводится значение кратности в штуках единицы, понимаемой нами как розничная упаковка (поле retailPack).

Состав выводимых полей и их описание

Шапка

priceDateFinish Дата, размещение заказа до которой гарантирует указанные цены
PPA основная единица покупателя

Табличная часть

Базовый набор
istCode уникальный код в учете Поставщика
productName наименование номенклатуры
retailPack кратность розничной упаковки
salePrice цена за основную единицу покупателя (см Поле PPA в шапке)
minSalePack кратность минимально отгружаемой упаковки в основных единицах покупателя (см Поле PPA в шапке)
stock округленные складские остатки доступные к заказу в основных единицах покупателя (см Поле PPA в шапке)
productType название
category товарное направление
subcategory подгруппа внутри товарного направления
manufacturer торговая марка
artikul артикул
image ссылка на картинку
EANcode штрихкод розничной упаковки 
packLine Кратность возможных единиц измерения
inSaledate Дата появления товара в продаже у поставщика
saleStatus Статусы:
0 -товар был продаже до даты вашего последнего заказа, но Вами никогда не закупался (предположительно , не интересен для Вас)
1 -Этот товар Вами уже закупался (кандидаты на повторную закупку)
2 -Товар появился в продаже после даты вашего последнего заказа (рекомендуем для рассмотрения целесообразности закупок)
lastOrderPrice Цена вашей последней закупки данного товара 
lastOrderDate Дата вашей последней закупки данного товара 
lastOrderQty Количество вашей последней закупки данного товара
minSaleWeight Вес (граммы) минимально отгружаемой упаковки (ее кратность смотрите в поле minSalePack)