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

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

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

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

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

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

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

Все данные передаются по ссылке https://winechef.com/api/warehouse Для передачи данных необходимо авторизоваться, для этого используйте сгенерированный ключ. Установите заголовок запроса Authorization: Bearer XXX, где XXX - ключ.
Необходимо создать текстовое поле (окно), в которое пользователь сможет ввести ключ доступа самостоятельно и заменить его при необходимости.
<?xml version="1.0" encoding="UTF-8"?>
<Data>
    <Warehouse Id="123">
        <Line Article="1234" egais="1234" Barcode="1234"  PurchasePrice="1250.5" Currency="RUB">
            <Remainder ResidueBottle="10" ResidueLiter="5.2"/>
            <Egais_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>
			
Важно! Даты должны передаваться в UTC формате. Если у вас нет возможности сделать это, добавьте ваш часовой пояс в конец строки даты. Пример: 2019-03-26T00:00:00 Europe/Moscow
Если ваша бухгалтерия сохраняет цены не за бутылку а за литр, вы можете отправить её так -
...
	<Line Article="12345" PurchasePriceForLitre="1250.5" Currency="RUB">
...
			
и в вашей винной карте она будет указана уже с учётом литража бутылки. Блок Warehouse
Параметр Тип Описание
Id
Int Идентификатор заведения. Передается только в том случае, если для доступа используется ключ, сгенерированный на весь аккаунт
Блок Line
Параметр Тип Описание
Article
String Артикул товарной позиции
egais
String Код ЕГАИС товарной позиции
Barcode
String Штрихкод товарной позиции
PurchasePrice
Float Цена закупки товарной позиции
Currency
String Валюта по стандарту ISO 4217 (RUB)
Блок Remainder
Параметр Тип Описание
ResidueBottle
Int Количество бутылок товарной позиции на складе
ResidueLiter
Float Количество литров товарной позиции на складе
Блок Egais_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-файлов.

Подробнее