Добавление

Добавление контактного лица

POST https://do.freshoffice.ru/contact/insert

Создаёт контактное лицо у существующего контрагента — сразу со своими телефонами и email-адресами. Полное имя собирается из фамилии, имени и отчества автоматически.

Request Body

Name Type Description
company_id* Int ID контрагента
first_name String Имя
last_name String Фамилия
middle_name String Отчество
position String Должность
note String Примечание
status_id Int Код статуса контактного лица
Emails JSON Список email адресов [{ "email" }]
Phones JSON Список телефонов [{ "phone", "descr" }] 
{
    "company_id" : 368132,
    "first_name" : "Евгений",
    "last_name" : "Александров",
    "middle_name" : "Борисович",
    "position" : "Генеральный директор",
    "note" : "Принимает решения по закупкам",
    "status_id" : 1,
    "Emails": [
                {
                 "email": "eb@prodstar.ru"
                }
              ],
    "Phones": [
                {
                 "phone": "+7 921 123-45-67",
                 "descr": "Мобильный"
                }
              ]
}

Примечание

Обязательный параметр — только company_id. ID контрагента возвращается при добавлении компании или ищется через список контрагентов.

Телефон или email уже существующему контактному лицу добавляются методами со страницы Телефоны и Email, передав contact_id.

Пример

curl --location --request POST 'https://do.freshoffice.ru/contact/insert' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "company_id" : 368132,
    "first_name" : "Евгений",
    "last_name" : "Александров",
    "position" : "Генеральный директор"
  }
  '

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://do.freshoffice.ru/contact/insert',
  'headers': {
    'Authorization': 'Bearer XXXX-XXXXXXX-XXXXXXX',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "company_id": 368132,
    "first_name": "Евгений",
    "last_name": "Александров",
    "position": "Генеральный директор"
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Ответ

{
  "status": "success",
  "error": "",
  "code": null,
  "rows": 0,
  "pages": 0,
  "page": 0,
  "value": "{\"NEW_ID\":186442,\"TELEPHONES\":null,\"EMAILS\":null}"
}
// NEW_ID - ID нового контактного лица
Предыдущая
Список
Следующая
Обновление