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 | Новой идентификатор ответственного за возможную сделку | guid | 9924256A-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>