Модуль расширяет некоторые API методы ядра системы. Ниже перечислены соответствующие изменения:

• Метод получения классов типов дополнительно возвращает типы PRODUCT_GENERAL_TYPE, PRODUCT_SUB_TYPE и PRODUCT_SUB_SUB_TYPE.

• Параметр class метода создания типов дополнительно принимает значения PRODUCT_GENERAL_TYPE, PRODUCT_SUB_TYPE и PRODUCT_SUB_SUB_TYPE.

• Метод получения классов статусов дополнительно возвращает статус OFFER_STATUS.

• Параметр class метода создания статусов дополнительно принимает значение OFFER_STATUS.

• Метод создания календарных событий принимает дополнительное поле orders.

  Пример поля orders

  "orders": [ // Массив сделок, которые должны быть привязаны к создаваемому календарному событию.
        {
            "title": "Тестовая услуга", // Произвольное название сделки (обязательно при отсутствии поля `offer_id`)
            "is_paid": false, // Флаг оплаты сделки
            "status_id": 4, // Статус оказания сделки
            "price": 1000 // Цена сделки
        },
        {
            "offer_id": 1, // Идентификатор коммерческого предложения, по которому оказывается сделка.
            "is_paid": false, // Флаг оплаты сделки
            "status_id": 4, // Статус оказания сделки
            "price": 1000 // Цена сделки
        }
  ]
  

• Метод обновления календарных событий принимает дополнительное поле orders:

  Пример поля orders

  "orders": [ // Массив сделок, которые должны быть привязаны к создаваемому календарному событию.
        {
            "id": 1, // Идентификатор ранее привязанной сделки. Для создания новой сделки необходимо оставить это поле пустым.
            "title": "Тестовая услуга", // Произвольное название сделки (обязательно при отсутствии поля `offer_id`)
            "is_paid": false, // Флаг оплаты сделки
            "status_id": 4, // Статус оказания сделки
            "price": 1000 // Цена сделки
        },
        {
            "id": 2, // Идентификатор ранее привязанной сделки. Для создания новой сделки необходимо оставить это поле пустым.
            "offer_id": 1, // Идентификатор коммерческого предложения, по которому оказывается сделка.
            "is_paid": false, // Флаг оплаты сделки
            "status_id": 4, // Статус оказания сделки
            "price": 1000 // Цена сделки
        }
  ]
  

• Метод просмотра данных календарного события, метод создания календарных событий и метод обновления календарных событий, Метод просмотра календарных событий за период, Метод просмотра календарных событий и других календарных сущностей за период возвращает дополнительное поле orders:

  Пример поля orders

  "orders": [
      {
          "id": 1, // Идентификатор сделки, привязанной к календарному событию.
          "title": "Тестовая услуга", // Заголовок сделки, привязанной к календарному событию.
          "is_paid": false, // Признак оплаты сделки, привязанной к календарному событию.
          "price": 1000, // Цена сделки, привязанной к календарному событию.
          "status": { // Статус сделки, привязанной к календарному событию.
              "id": 4,
              "title": "Запланировано",
              "class": "OFFER_STATUS",
              "position": 1,
              "color": "#cccccc",
              "icon": null,
              "is_system": true,
              "created_at": "2024-09-20T07:21:44.000000Z",
              "updated_at": "2024-09-20T07:21:44.000000Z"
          },
          "offer": null, // Коммерческое предложение, привязанное к сделке.
          "created_at": "2024-09-25T13:08:01.000000Z", // Дата и время привязки сделки к календарному событию.
          "updated_at": "2024-09-25T13:08:01.000000Z" // Дата и время обновления сделки, привязанной к календарному событию.
      },
      {
          "id": 2, // Идентификатор сделки, привязанной к календарному событию.
          "title": "Тестовое предложение", // Заголовок сделки, привязанной к календарному событию.
          "is_paid": true, // Признак оплаты сделки, привязанной к календарному событию.
          "price": 311299.2, // Цена сделки, привязанной к календарному событию.
          "status": { // Статус сделки, привязанной к календарному событию.
              "id": 4,
              "title": "Запланировано",
              "class": "OFFER_STATUS",
              "position": 1,
              "color": "#cccccc",
              "icon": null,
              "is_system": true,
              "created_at": "2024-09-20T07:21:44.000000Z",
              "updated_at": "2024-09-20T07:21:44.000000Z"
          },
          "offer": { // Коммерческое предложение, привязанное к сделке.
              "id": 1,
              "title": "Тестовое предложение",
              "base_price": 346388,
              "total_price": 311299.2,
              "discount_type": null,
              "discount_value": null,
              "created_at": "2024-09-23T08:53:53.000000Z",
              "updated_at": "2024-09-24T12:20:55.000000Z"
          },
          "created_at": "2024-09-25T13:08:01.000000Z", // Дата и время привязки сделки к календарному событию.
          "updated_at": "2024-09-25T13:08:01.000000Z" // Дата и время обновления сделки, привязанной к календарному событию.
      }
  ]
  

• В поле result->calendar_event_types->statuses фоновой задачи, созданной методом генерации статистики обращений, добавлено поле orders_total_price с суммой всех сделок календарных событий с соответствующим статусом.

• Метод получения списка клиентов принимает дополнительные параметры фильтрации:

  • offers_created_at_from string - клиент должен иметь коммерческое приложение, созданное после указанной даты (включительно)
  • offers_created_at_to string - клиент должен иметь коммерческое приложение, созданное до указанной даты (включительно)
  • offers_price_from string - клиент должен иметь коммерческое приложение, итоговая сумма которого начинается от указанного числа (включительно)
  • offers_price_to string - клиент должен иметь коммерческое приложение, итоговая сумма которого не превышает указанное число (включительно)
  • offers_has_products integer[] - массив идентификаторов товаров/услуг - клиент должен иметь коммерческое приложение, СОДЕРЖАЩЕЕ любой из указанных товаров/услуг
  • offers_has_no_products integer[] - массив идентификаторов товаров/услуг - клиент должен иметь коммерческое приложение, НЕ СОДЕРЖАЩЕЕ ни одно из указанные товаров/услуг
  • offers_has_price_lists integer[] - массив идентификаторов прайс-листов - клиент должен иметь коммерческое приложение, СВЯЗАННОЕ с одним из указанных прайс-листов
  • offers_has_no_price_lists integer[] - массив идентификаторов прайс-листов - клиент должен иметь коммерческое приложение, НЕ СВЯЗАННОЕ ни с одним из указанных прайс-листов
  • offers_has_lead_statuses integer[] - массив идентификаторов статусов - клиент должен иметь коммерческое приложение, ИМЕЮЩЕЕ один из указанных статусов
  • offers_has_no_lead_statuses integer[] - массив идентификаторов статусов - клиент должен иметь коммерческое приложение, НЕ ИМЕЮЩЕЕ ни один из указанных статусов

  Указанные параметры фильтрации дополняют друг друга, т.е. каждый из этих параметров при передаче добавляет к условию на наличие коммерческих предложений соответствующее ограничение.

Модуль расширяет некоторые API методы других модулей. Ниже перечислены соответствующие изменения:

• Метод получения доступных команд клиентского Telegram - бота дополнительно возвращает команды /bonus_balance и /ref_code.
• В поля result->calendar_event_types->old_chats->statuses и result->calendar_event_types->new_chats->statuses фоновой задачи, созданной методом генерации статистики чатов, добавлено поле orders_total_price с суммой всех сделок календарных событий с соответствующим статусом.

Описание методов для взаимодействия с прайс-листами.

Описание методов для взаимодействия с товарами/услугами.

Описание методов для взаимодействия с группами товаров/услуг.