webhookУведомления во внешние системы (webhook)

Webhook — уведомление, которое облако само отправляет во внешнюю систему, когда в VirtualPos что-то произошло: пробит чек или изменился остаток товара. Внешней системе не нужно опрашивать API по расписанию — она получает данные сразу после события. Так подключают учётные системы, сайты, сервисы аналитики и рассылок.

Для каждого события можно настроить несколько адресов: уведомление уйдёт на каждый.

1. Откройте Администрирование → API и обмен с 1С и в блоке Отправка уведомлений (webhook) нажмите «Настроить webhook».
2. Нажмите «Добавить».
3. Выберите Событие.
4. В поле URL для отправки уведомления укажите адрес вашей системы, например https://erp.example.com/hooks/virtualpos/receipt.
5. Выберите Тип авторизации и заполните Логин и Пароль (токен) — см. Авторизация.

1. В поле Включено выберите Да (включено) и нажмите «Сохранить».

Все настроенные уведомления видны в списке: включено ли, событие, адрес.

Облако отправляет POST-запрос с заголовком Content-Type: application/json. Тело запроса — объект JSON. Поле event содержит вид события, account — имя вашей учётной записи VirtualPos.

{
  "event": "receipt",
  "id": 15840,
  "guid": "5f0c9a52-7d1e-4a7b-9a3e-2b6d1c4e8f10",
  "datetime": "2026-10-10 12:35:08",
  "account": "mycompany",
  "type": "sale",
  "checknum": 27,
  "globalchecknum": 1042,
  "session": 118,
  "customer": {
    "id": 512,
    "ext_id": "C-000512",
    "first_name": "Иван",
    "last_name": "Петров",
    "middle_name": "Сергеевич",
    "email": "petrov@example.com",
    "phone": "+79000000001"
  },
  "card": {
    "id": 731,
    "ext_id": null,
    "uid": null,
    "barcode": "2900000007310"
  },
  "warehouse_id": 2,
  "warehouse_ext_id": "W-02",
  "warehouse_name": "Магазин на Ленина",
  "warehouse_address": "г. Примерск, ул. Ленина, 1",
  "user_id": 14,
  "user_name": "Смирнова Ольга Николаевна",
  "amount": 1180,
  "cost": 760,
  "discount": 120,
  "items": [
    {
      "line_id": 90211,
      "id": 1052,
      "ext_id": "A-1052",
      "name": "Чайник заварочный, 800 мл",
      "barcode": "4600000010526",
      "quantity": 1,
      "price": 1300,
      "discount": 120,
      "cost": 760,
      "motivation_bonus": 0,
      "motivation_bonus_description": null
    }
  ]
}

{
  "event": "onhand",
  "account": "mycompany",
  "id": 48213,
  "warehouse_id": 2,
  "warehouse_ext_id": "W-02",
  "item_id": 1052,
  "item_ext_id": "A-1052",
  "quantity": 7,
  "quantity_before": 8,
  "quantity_after": 7,
  "lot_number": null,
  "manufacture_date": null,
  "expire_date": "2027-03-01",
  "cost": 760
}

Откройте настроенное уведомление и нажмите «Протестировать». Облако отправит на указанный адрес пробный запрос и покажет, куда он ушёл.

Результат отправки записывается в системные журналы: успешные запросы — в серверный журнал информации, ошибки — в серверный журнал ошибок с адресом, кодом ответа и текстом ошибки.