Получение информации о ценах и наличии товара
Для просмотра персональных цен и формирования заказа Вы можете установить на свой компьютер Еxcel Клиент - книгу Excel c набором макросов (только для Windows), либо клиент LibreOffice (бесплатная альтернатива Excel для Windows, Linux и MacOS). Далее требуется сделать разрешение запуска встроенных скриптов и обновление данных по кнопке "Обновить данные"
Для Эксель клиента, также возможно скачивание уже заполненного данными файла по ссылке :
https://direct.istochnik.ru/excelClient?api_key=@apikey&type=EC
(замените @аpikey на код полученный от вашего персонального менеджера, если вы не авторизованы (кнопка "Войти"+обновить страницу))
API Источник Бэттэрис - специальный веб-сервис для клиентов компании, для получения персонализированной актуальной информации от компании.
В настоящее время -реализована возможность получения ценового предложения и информирования об уровне складских остатков доступных для заказа.
Строки доступа и описание выводимых полей приведены ниже. Обратите внимание, что в запросах используется Ваш персональный ключ доступа , ниже приведен под псевдонимом @apikey (замените на Ваш персональный в реальных запросах , если вы не авторизованы (кнопка "Войти"+обновить страницу)). Он передается сервису по защищенному соединению, однако рекомендуем Вам побеспокоиться о невозможности попадания его в чужие руки.
При подозрении о компрометации ключа - обратитесь к менеджеру за заменой на новый.
Как правило , работа с Вашим ключом возможна только на следующий день после его получения.
Возможен выбор трех вариантов формата ответа: xls (скачивание файла Эксель), JSON и XML.
Последние 2 варианта должны быть интересны Вам, если Вы планируете программный доступ к этим данным. Выбор формата осуществляется указанием его в строке запроса.
И наконец, имеется опция сократить выдачу отбором по одной или нескольким торговым маркам.
Примеры обращений к сервису приведены ниже.
Цены на все товары в формате скачиваемого файла Excel:
https://direct.istochnik.ru/istapi/1.0.0/contragents/prices?api_key=@apikey&format=xls
Цены на ANSMANN и Panasonic в формате скачиваемого файла Excel:
!!! Внимание написание наименование бренда чувствительно к регистру , используйте вариант наименования бренда используемый нами (например строго Panasonic , а не PANASONIC или panasonic)
Специальные форматы. Для тестирования можно посмотреть вывод в окно браузера.
Цены на все товары в формате 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 | Кратность возможных единиц измерения |
| dateInSale | Дата появления товара в продаже у поставщика |
| saleStatus | Статусы: 0 -товар был продаже до даты вашего последнего заказа, но Вами никогда не закупался (предположительно , не интересен для Вас) 1 -Этот товар Вами уже закупался (кандидаты на повторную закупку) 2 -Товар появился в продаже после даты вашего последнего заказа (рекомендуем для рассмотрения целесообразности закупок) |
| lastOrderPrice | Цена вашей последней закупки данного товара |
| lastOrderDate | Дата вашей последней закупки данного товара |
| lastOrderQty | Количество вашей последней закупки данного товара |
| minSaleWeight | Вес (граммы) минимально отгружаемой упаковки (ее кратность смотрите в поле minSalePack) |