Запись опубликована:10.10.2022
Post category:Задачи
Запись изменена:03.11.2022

POST api/2.0/crm/task

Для этой функции требуется аутентификация.

Описание

Создает задачу с указанными в запросе параметрами (название, описание, срок выполнения и т.д.).

Параметры

Название	Описание	Тип	Пример
title sent in body	Название задачи	строковый	текст
description sent in body	Описание задания необязательно	строковый	текст
deadline sent in body	Срок выполнения задачи	Date and Time	Roundtrip format: 2008-04-10T06-30-00.000Z
responsibleId sent in body	Идентификатор ответственного за выполнение задачи	guid	9924256A-739C-462b-AF15-E652A3B1B6EB
categoryId sent in body	Идентификатор категории задачи	номер	1234
contactId sent in body	Идентификатор контакта необязательно	номер	1234
entityType sent in body	Связанный тип сущности Допустимые значения: opportunity or case необязательно	строковый	текст
entityId sent in body	Идентификатор связанной сущности необязательно	номер	1234
isNotify sent in body	Уведомляет ответственного о задаче необязательно	логический	истина
alertValue sent in body	Период времени в минутах для напоминания ответственному о задаче необязательно	номер	1234

Пример

POST api/2.0/crm/task
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json

{
  "title": "some text",
  "description": "some text",
  "deadline": "2008-04-10T06-30-00.000Z",
  "responsibleId": "9924256A-739C-462b-AF15-E652A3B1B6EB",
  "categoryId": 1234,
  "contactId": 1234,
  "entityType": "some text",
  "entityId": 1234,
  "isNotify": true,
  "alertValue": 1234
}

Возвращает
Задача

Пример ответа

application/json

{
  "status": 0,
  "response": {
    "createBy": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "created": "2022-10-09T20:03:09.6137431Z",
    "title": "Send a commercial offer",
    "deadLine": "2022-10-09T20:03:09.6137431Z",
    "responsible": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "category": {
      "imagePath": "path to image",
      "title": "Appointment",
      "description": "",
      "sortOrder": 2,
      "id": 30
    },
    "canEdit": true,
    "id": 0
  }
}

text/xml

<result>
  <status>0</status>
  <response>
    <createBy>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </createBy>
    <created>2022-10-09T20:03:09.6137431Z</created>
    <title>Send a commercial offer</title>
    <deadLine>2022-10-09T20:03:09.6137431Z</deadLine>
    <responsible>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </responsible>
    <category>
      <imagePath>path to image</imagePath>
      <title>Appointment</title>
      <description></description>
      <sortOrder>2</sortOrder>
      <id>30</id>
    </category>
    <canEdit>true</canEdit>
    <id>0</id>
  </response>
</result>