Телефоны и Email

Эндпоинты для дополнения уже созданного контрагента средствами связи: телефоны и email-адреса добавляются к существующей карточке по её ID — или к контактному лицу, если передать contact_id. Контактные лица (люди) — в разделе Контакты; изменение полей самой карточки — на странице Обновление.

Примечание

ID контрагента возвращается в поле value при добавлении, либо его можно найти через список контрагентов.

Добавление телефона

POST https://do.freshoffice.ru/company/phone/insert

Request Body

Name Type Description
company_id* Int ID контрагента
phone* String Телефон
descr String Тип телефона (Приемная, Мобильный, Заказы)
contact_id Int ID контактного лица — телефон привяжется к нему 
{
    "company_id" : 368132,
    "phone" : "+7 812 438-16-00",
    "descr" : "Офис"
}

Добавление email

POST https://do.freshoffice.ru/company/email/insert

Request Body

Name Type Description
company_id* Int ID контрагента
email* String Email
contact_id Int ID контактного лица — адрес привяжется к нему 
{
    "company_id" : 368132,
    "email" : "info@prodstar.ru"
}

Примечание

Добавление и обновление самих контактных лиц (людей) — в разделе Контакты.

Пример

curl --location --request POST 'https://do.freshoffice.ru/company/phone/insert' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "company_id" : 368132,
    "phone" : "+7 812 438-16-00",
    "descr" : "Офис"
  }
  '

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://do.freshoffice.ru/company/phone/insert',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "company_id" : 368132,
    "phone" : "+7 812 438-16-00",
    "descr" : "Офис"
  }
  ',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer XXXXX-XXXXXXX-XXXXXXXXX',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://do.freshoffice.ru/company/phone/insert',
  'headers': {
    'Authorization': 'Bearer XXXX-XXXXXXX-XXXXXXX',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "company_id": 368132,
    "phone": "+7 812 438-16-00",
    "descr": "Офис"
  })

};
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": "193769"
}
// value - ID идентификатор новой записи (телефона или email)
Предыдущая
Добавление
Следующая
Обновление