Интеграция с winechef

Winechef предоставляет возможность сбора и анализа данных об остатках вин на складе и их продажам. Переданная информация отображается в группе в вашей винной карте, на сайте, и в выгруженных документах DOCX, XLS
Важно! Данная функция доступна только на заведении с тарифом E-WineList

Варианты передачи данных

Есть два варианта передачи данных:

Ключи доступа

После того как выбора варианты передачи данных, необходимо сгенерировать ключи доступа. Заходим на сайт winechef.com под своим логином и паролем. Далее заходим в раздел Настройки → API Если вы выбрали вариант передачи данных для всего аккаунта, то вам необходимо сгенерировать ключ для всего аккаунта. Если вы выбрали вариант передачи данных только для одного заведения, вам необходимо сперва выбрать заведение в выпадающем списке, затем сгенерировать для него ключ.
Важно! Срок действия ключа ограничиваются 1 годом с момента его генерации, и после истечения срока становиться недействительным.

Передача данных

Все данные передаются по ссылке winechef.com/api/warehouse Для передачи данных необходимо авторизоваться, для этого используйте сгенерированный ключ. Установите заголовок запроса Authorization: Bearer XXX, где XXX - ключ. Данные на сервер передаются в формате XML, который помещается в тело запроса.
Важно! Даты должны передаваться в UTC формате. Если у вас нет возможности сделать это, добавьте "UTC" в конец строки даты. Пример: 2019-03-26T00:00:00UTC
<?xml version="1.0" encoding="UTF-8"?>
<Data>
    <Warehouse Id="123">
        <Line Article="12345" PurchasePrice="1250.5" Currency="RUB">
            <Remainder ResidueBottle="10" ResidueLiter="5.2"/>
            <Selling SoldBottle="1" SoldLiter="2" SoldDateTimeFrom="2019-03-26T00:00:00"
                    SoldDateTimeTo="2019-03-26T23:59:59"/>
        </Line>
    </Warehouse>
</Data>
                
Блок Warehouse
Параметр Тип Описание
Id
Int Идентификатор заведения. Передается только в том случае, если для доступа используется ключ, сгенерированный на весь аккаунт
Блок Line
Параметр Тип Описание
Article
String Артикул товарной позиции
PurchasePrice
Float Цена закупки товарной позиции
Currency
String Валюта по стандарту ISO 4217 (RUB)
Блок Remainder
Параметр Тип Описание
ResidueBottle
Int Количество бутылок товарной позиции на складе
ResidueLiter
Float Количество литров товарной позиции на складе
Блок Selling
Параметр Тип Описание
SoldBottle
Int Количество проданных Бутылок товарной позиции за период
SoldLiter
                    
Float Количество проданных литров товарной позиции за период
SoldDateTimeFrom
DateTime Начало периода
SoldDateTimeTo
DateTime Конец периода

Примеры

Передача данных об одном заведении

<?xml version="1.0" encoding="UTF-8"?>
<Data>
    <Warehouse>
        <Line Article="129567" PurchasePrice="1000.5" Currency="RUB">
            <Remainder ResidueBottle="10" ResidueLiter="5.2"/>
            <Selling SoldBottle="1" SoldLiter="2" SoldDateTimeFrom="2019-03-26T00:00:00"
                     SoldDateTimeTo="2019-01-01T23:59:59"/>
        </Line>
        <Line Article="0521069" PurchasePrice="1550.5" Currency="RUB">
            <Remainder ResidueBottle="15" ResidueLiter="5.2"/>
            <Selling SoldBottle="1" SoldLiter="2" SoldDateTimeFrom="2019-03-26T00:00:00"
                     SoldDateTimeTo="2019-01-01T23:59:59"/>
        </Line>
    </Warehouse>
</Data>
            

Передача данных нескольких заведений

<?xml version="1.0" encoding="UTF-8"?>
<Data>
    <Warehouse Id=”1”>
        <Line Article="129567" PurchasePrice="1000.5" Currency="RUB">
<Remainder ResidueBottle="10" ResidueLiter="5.2"/>
            <Selling SoldBottle="1" SoldLiter="2" SoldDateTimeFrom="2019-03-26T00:00:00"
                SoldDateTimeTo="2019-01-01T23:59:59"/>
        </Line>
                <Line Article="0521069" PurchasePrice="1550.5" Currency="RUB">
                    <Remainder ResidueBottle="15" ResidueLiter="5.2"/>
                    <Selling SoldBottle="1" SoldLiter="2" SoldDateTimeFrom="2019-03-26T00:00:00"
                         SoldDateTimeTo="2019-01-01T23:59:59"/>
                </Line>
            </Warehouse>
            <Warehouse Id=”2”>
                <Line Article="129567" PurchasePrice="1000.5" Currency="RUB">
                    <Remainder ResidueBottle="10" ResidueLiter="5.2"/>
                    <Selling SoldBottle="1" SoldLiter="2" SoldDateTimeFrom="2019-03-26T00:00:00"
                         SoldDateTimeTo="2019-01-01T23:59:59"/>
                </Line>
                <Line Article="0521069" PurchasePrice="1550.5" Currency="RUB">
                    <Remainder ResidueBottle="15" ResidueLiter="5.2"/>
                    <Selling SoldBottle="1" SoldLiter="2" SoldDateTimeFrom="2019-03-26T00:00:00"
                         SoldDateTimeTo="2019-01-01T23:59:59"/>
        </Line>
    </Warehouse>
</Data>
            

Ответ сервера

Мы используем cookie-файлы для наилучшего представления нашего сайта. Продолжая использовать этот сайт, вы соглашаетесь с использованием cookie-файлов.

Подробнее