Integration

Модель, описывающая интеграцию

Название Тип данных Описание параметра
id Int64 ID интеграции
name string Название интеграции
description string Описание интеграции
is_active bool Активна или нет
last_update Int64 Дата последнего изменения записи в формате unixtime в секундах

Важно: Интеграции не создаются пользователем, они добавляются вручную из списка доступных.
Каждая интеграция имеет свои настройки.

Достпные интеграции:

1. Express24 (id = 1)

Настройки для Express24:

  • USER_LOGIN - логин пользователя в системе Express24;
  • USER_PASSWORD - пароль пользователя в системе Express24;
  • PRICE_TYPE - id вида цены в системе Regos;
  • STOCK_IDS - id складов (пока один склад), id перечисляются через запятую;
  • ENABLE_ORDERS - возможность принимать заказы от Express24 (0 - включено, 1 - выключео);
  • ORDER_FROM_ID - источник заказа (значение из справочника Источники заказов);
  • ORDER_DELIVERY_TYPE_ID - тип доставки (значение из справочника Способы доставки).

Модели для выгрузки соответствуют документации Express24 https://documentation.express24.uz/external

2. Выгрузка на сервер (id = 2)

Настройки для выгрузки на сервер:
AUTHORIZATION_REQUIRED - требуется авторизация. Значения 0 или 1. В случае если значение 1, то на сервере клиента будет происходить авторизация по методу HTTP Basic Authorization;
FIRM - id предприятия в системе Regos;
USER_LOGIN - логин, используется для HTTP Basic Authorization;
USER_PASSWORD - пароль, используется для HTTP Basic Authorization;
PRICE_TYPE - id вида цены в системе Regos;
ENDPOINT - url на который будет осуществляться выгрузка;
STOCK_IDS - id складов в системе;
IMAGE_SIZE - размер изображения: Default = 0, Large = 1, Medium = 2, Small = 3.

Требования к серверу, на который происходит выгрузка:
Поддержка HTTP Basic Authorization (если эта функция задействована).

Модель выгрузки на сервер

Название Тип данных Описание параметра
code UInt64 Код номенклатуры
name string Наименование номенклатуры
articul string артикул номенклатуры
icps string ИКПУ
package_code string Код маркировки
base_barcode string Основной штрихкод
price decimal Цена
image_url string URL изображения
quantity array of ItemQuantity массив обьектов количества номенклатуры на складах

Модель ItemQuantity, описывающая количество номенклатуры по складам

Название Тип данных Описание параметра
stock_id int64 ID склада
value decimal Значение

Пример выгрузки

[
    {
        "code": 11407,
        "name": "Fleur Alpine Taralli \u0441\u0443\u0448\u043A\u0438",
        "articul": "",
        "icps": "01905012001000000",
        "package_code": "104579",
        "base_barcode": "8000832705038",
        "price": 47000.000,
        "image_url": "https://localhost:44383/e9673c65-0d7c-4d8f-9a89-994d83bea17b/i_1648281571_10ebe517-fd0b-4012-b7a2-c2389e0b5fdc.png",
        "quantity": [
            {
                "stock_id": 1,
                "value": 0.000
            }
        ]
    },
    {
        "code": 11408,
        "name": "\u0411\u0430\u0442\u043E\u043D\u0447\u0438\u043A Fleur Alpine \u041E\u0440\u0433\u0430\u043D\u0438\u043A \u0437\u043B\u0430\u043A\u043E\u0432\u044B\u0439 \u043E\u0432\u0441\u044F\u043D\u044B\u0439 \u042F\u0411\u041B\u041E\u041A\u041E \u0438 \u0410\u0411\u0420\u0418\u041A\u041E\u0421",
        "articul": "",
        "icps": "02008001018000000",
        "package_code": "",
        "base_barcode": "7610121611158",
        "price": 16000.000,
        "image_url": "https://localhost:44383/e9673c65-0d7c-4d8f-9a89-994d83bea17b/i_1648187141_7db7b749-df6e-41a6-a3ab-26d168c9c889.png",
        "quantity": [
            {
                "stock_id": 1,
                "value": 0
            }
        ]
    },
]