Перейти к основному содержимому

Получить список сделок

Получает список сделок (50 шт. за запрос максимум) с фильтром или без (см. ПолучитьСтруктуруФильтраСделок)

Функция ПолучитьСписокСделок(Знач URL, Знач Фильтр = "", Знач Отступ = 0, Знач Токен = "") Экспорт

ПараметрCLI опцияТипОбяз.Назначение
URL--urlСтрока✔URL внешнего вебхука или адрес Bitrix24 при использовании токена
Фильтр--filterСтруктура из КлючИЗначение✖Структура отбора сделок (см. ПолучитьСтруктуруФильтраСделок)
Отступ--offsetЧисло, Строка✖Отступ от начала списка для получения сделок > 50 шт. рекурсивно
Токен--tokenСтрока✖Токен авторизации, если используется не вебхук

Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrix24


подсказка

Метод в документации API: crm.deal.list


Пример использования для 1С:Предприятие/OneScript
    URL = "https://b24-ar17wx.bitrix24.by/rest/1/yg2...";

    Результат = OPI_Bitrix24.ПолучитьСписокСделок(URL);

    URL    = "b24-ar17wx.bitrix24.by";
    Токен  = "7afc3e67006e9f06006b12e400000001000...";

    Фильтр = Новый Структура;
    Фильтр.Вставить("TITLE"      , "Продажа в RUB");
    Фильтр.Вставить("CURRENCY_ID", "RUB");

    Результат = OPI_Bitrix24.ПолучитьСписокСделок(URL, Фильтр, , Токен);
    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint bitrix24 ПолучитьСписокСделок \
      --url "b24-ar17wx.bitrix24.by" \
      --filter "{'TITLE':'Продажа в RUB','CURRENCY_ID':'RUB'}" \
      --token "***"
Результат
{
 "result": [
  {
   "ID": "52",
   "TITLE": "Продажа в RUB",
   "TYPE_ID": "GOODS",
   "STAGE_ID": "NEW",
   "PROBABILITY": "30",
   "CURRENCY_ID": "RUB",
   "OPPORTUNITY": "50000.00",
   "IS_MANUAL_OPPORTUNITY": "N",
   "TAX_VALUE": null,
   "LEAD_ID": null,
   "COMPANY_ID": "1",
   "CONTACT_ID": "3",
   "QUOTE_ID": null,
   "BEGINDATE": "2024-01-01T03:00:00+03:00",
   "CLOSEDATE": "2030-01-01T03:00:00+03:00",
   "ASSIGNED_BY_ID": "1",
   "CREATED_BY_ID": "1",
   "MODIFY_BY_ID": "1",
   "DATE_CREATE": "2024-08-25T11:26:58+03:00",
   "DATE_MODIFY": "2024-08-25T11:26:59+03:00",
   "OPENED": "Y",
   "CLOSED": "N",
   "COMMENTS": null,
   "ADDITIONAL_INFO": null,
   "LOCATION_ID": null,
   "CATEGORY_ID": "0",
   "STAGE_SEMANTIC_ID": "P",
   "IS_NEW": "Y",
   "IS_RECURRING": "N",
   "IS_RETURN_CUSTOMER": "N",
   "IS_REPEATED_APPROACH": "N",
   "SOURCE_ID": null,
   "SOURCE_DESCRIPTION": null,
   "ORIGINATOR_ID": null,
   "ORIGIN_ID": null,
   "MOVED_BY_ID": "1",
   "MOVED_TIME": "2024-08-25T11:26:58+03:00",
   "LAST_ACTIVITY_TIME": "2024-08-25T11:26:58+03:00",
   "UTM_SOURCE": null,
   "UTM_MEDIUM": null,
   "UTM_CAMPAIGN": null,
   "UTM_CONTENT": null,
   "UTM_TERM": null,
   "LAST_ACTIVITY_BY": "1"
  }
 ],
 "total": 1,
 "time": {
  "start": 1728409888.78084,
  "finish": 1728409888.8263,
  "duration": 0.0454578399658203,
  "processing": 0.0191719532012939,
  "date_start": "2024-10-08T20:51:28+03:00",
  "date_finish": "2024-10-08T20:51:28+03:00",
  "operating_reset_at": 1728410488,
  "operating": 0
 }
}