ПланФикс API contact.updateCustomData
Материал из Planfix
								
												
				Функция обновления пользовательских полей контакта. Может использоваться, если у пользователя нет прав на изменение контакта и поэтому использовать функцию contact.update он не может, но при этом есть права на изменение пользовательских полей.
Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="contact.updateCustomData">
  <account></account>
  <sid></sid>
  <contact>
    <id></id>
    <general></general>
    <customData>
      <customValue>
        <id></id>
        <value></value>
      </customValue>
      <!-- ... -->
    </customData>
  </contact>
  <signature></signature>
</request>| Название | Тип | Значение | Примечание | 
|---|---|---|---|
| id | int | идентификатор обновляемого контакта | |
| general | int | номер обновляемого контакта (используется если не задан id) | |
| customData | значения пользовательских полей контакта | ||
| customData.customValue.id | идентификатор пользовательского поля контакта | ||
| customData.customValue.value | значение пользовательского поля контакта | (для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках) | |
| signature | string(32) | подпись | 
Результат успешного выполнения функции:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <contact>
    <id></id>
    <general></general>
  </contact>
  <actionid></actionid>
</response>| Название | Тип | Значение | Примечание | 
|---|---|---|---|
| contact.id | int | идентификатор обновляемого контакта | |
| contact.general | int | номер добавленного контакта | |
| actionid | int | идентификатор действия об изменении | 
В противном случае будет возвращен ответ с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>