PUT api/2.0/crm/opportunity/{opportunityid}

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

Описание

Обновляет выбранную возможную сделку с параметрами, указанными в запросе.

Параметры

НазваниеОписаниеТипПример
opportunityid

sent in url
Идентификатор возможной сделкиномер1234
contactid

sent in body
Новый идентификатор основного контактного лица возможной сделкиномер1234
members

sent in body
Участники новой возможной сделки

необязательно
Collection of numbers

collection
1234
title

sent in body
Название новой возможной сделкистроковыйтекст
description

sent in body
Описание новой возможной сделки

необязательно
строковыйтекст
responsibleid

sent in body
Новой идентификатор ответственного за возможную сделкуguid9924256A-739C-462b-AF15-E652A3B1B6EB
bidType

sent in body
Новый тип ставки

Допустимые значения: FixedBid, PerHour, PerDay,PerWeek, PerMonth, PerYear

FixedBid, PerHour, PerDay, PerWeek, PerMonth, PerYear
bidValue

sent in body
Новая сумма транзакций

необязательно
System.Decimal
bidCurrencyAbbr

sent in body
Новая валюта (аббревиатура)

Допустимые значения: EUR, RUB и т.д. Весь список доступных валют можно получить по API

необязательно
строковыйтекст
perPeriodValue

sent in body
Новая сумма за периодномер1234
stageid

sent in body
New stage IDномер1234
successProbability

sent in body
New opportunity success probability

необязательно
номер1234
actualCloseDate

sent in body
New actual opportunity closure date

необязательно
дата и времяRoundtrip format: 2008-04-10T06-30-00.000Z
expectedCloseDate

sent in body
New expected opportunity closure date

необязательно
дата и времяRoundtrip format: 2008-04-10T06-30-00.000Z
customFieldList

sent in body
Новый список пользовательских полей

необязательно
Collection of ASC.Api.Collections.ItemKeyValuePair`2[System.Int32,System.String]s

collection
isPrivate

sent in body
Новая конфиденциальность возможной сделки: частная или нетлогическийистина
accessList

sent in body
Новый список пользователей с правами доступа к возможным сделкам

необязательно
Collection of guids

collection
9924256A-739C-462b-AF15-E652A3B1B6EB
isNotify

sent in body
Уведомляет пользователей из списка доступа о возможных сделках

необязательно
логическийистина
Пример
PUT api/2.0/crm/opportunity/1234
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json

{
  "contactid": 1234,
  "members": [
    1234
  ],
  "title": "some text",
  "description": "some text",
  "responsibleid": "9924256A-739C-462b-AF15-E652A3B1B6EB",
  "bidType": "fixedbid",
  "bidValue": 0.0,
  "bidCurrencyAbbr": "some text",
  "perPeriodValue": 1234,
  "stageid": 1234,
  "successProbability": 1234,
  "actualCloseDate": "2008-04-10T06-30-00.000Z",
  "expectedCloseDate": "2008-04-10T06-30-00.000Z",
  "customFieldList": [
    {
      "Key": 0,
      "Value": null
    }
  ],
  "isPrivate": true,
  "accessList": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "isNotify": true
}
Возвращает

Обновленная возможная сделка/ обновленные возможные сделки

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

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-08T15:03:33.2100361Z",
    "contact": {
      "smallFotoUrl": "url to foto",
      "displayName": "Tadjeddine Bachir",
      "isCompany": false,
      "isPrivate": true,
      "isShared": false,
      "shareType": 0,
      "currency": null,
      "canEdit": false,
      "canDelete": false,
      "id": 0
    },
    "title": "Hotel catalogue",
    "description": "",
    "responsible": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "stage": {
      "successProbability": 20,
      "stageType": 0,
      "title": "Discussion",
      "description": "The potential buyer showed his\/her interest and sees how your offering meets his\/her goal",
      "color": "#B9AFD3",
      "sortOrder": 2,
      "id": 30
    },
    "successProbability": 65,
    "expectedCloseDate": "2022-10-08T15:03:33.2100361Z",
    "isPrivate": false,
    "canEdit": false,
    "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-08T15:03:33.2100361Z</created>
    <contact>
      <smallFotoUrl>url to foto</smallFotoUrl>
      <displayName>Tadjeddine Bachir</displayName>
      <isCompany>false</isCompany>
      <isPrivate>true</isPrivate>
      <isShared>false</isShared>
      <shareType>0</shareType>
      <currency />
      <canEdit>false</canEdit>
      <canDelete>false</canDelete>
      <id>0</id>
    </contact>
    <title>Hotel catalogue</title>
    <description></description>
    <responsible>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </responsible>
    <stage>
      <successProbability>20</successProbability>
      <stageType>0</stageType>
      <title>Discussion</title>
      <description>The potential buyer showed his/her interest and sees how your offering meets his/her goal</description>
      <color>#B9AFD3</color>
      <sortOrder>2</sortOrder>
      <id>30</id>
    </stage>
    <successProbability>65</successProbability>
    <expectedCloseDate>2022-10-08T15:03:33.2100361Z</expectedCloseDate>
    <isPrivate>false</isPrivate>
    <canEdit>false</canEdit>
    <id>0</id>
  </response>
</result>