Загрузка сделок

Метод	upload.deals_history
Описание	Загрузка сделок
Кому доступен	Агент, Клиент

Метод позволяет загружать историю сделки, переходы между этапами, стоимость.
Для правильного построения отчета "Сквозная аналитика" минимально у сделки должны быть заполнены такие параметры как "дата создания сделки, стоимость, контакт (с контактными данными - дата создания, email, phone)".
По контактным данным ищем все обращения контакта (звонок, заявка, чат)
Отсеиваем обращения которые попадают под фильтр

• время между обращением и созданием сущности более 30 дней.

Ограничения

Название	Описание
created_date_time	Дата и время не может быть в будущем
modified_stage_date_time	Больше creation_date. modified_stage_date_time загружаемого этапа должен быть больше или равен modified_stage_date_time последнего загруженного этапа
closed_date_time	Не может быть меньше даты создания сделки. Учитывается в расчетах только для сделок на этапе со статусом "success" или "failed"

При некорректном заполнении данных по одной из сделок, запрос завершается ошибкой и после его исправления необходимо весь запрос передавать заново.

Параметры запроса

Название	Тип	Обязательный	Описание
access_token	string	да	Ключ сессии аутентификации
user_id	number	нет	Уникальный идентификатор пользователя клиента агента от имени которого делается запрос Является обязательным для агента Для получения списка пользователей клиента необходимо использовать метод "get.customer_users"
deals	array	да	Список сделок. Лимит 1000 сделок
ext_id	string	да	Идентификатор сделки во внешней системе
name	string	да	Имя сделки
created_date_time	iso8601	да	Дата и время создания сделки (YYYY-MM-DD hh:mm:ss)
modified_date_time	iso8601	нет	Дата и время изменения сделки (YYYY-MM-DD hh:mm:ss) Если параметр не передан, будет проставлена дата и время вызова метода
modified_stage_date_time	iso8601	да	Дата и время перехода сделки в текущий этап (YYYY-MM-DD hh:mm:ss)
closed_date_time	iso8601	нет	Дата и время закрытия сделки (YYYY-MM-DD hh:mm:ss)
contact_ext_ids	array	нет	Контакт привязанный к сделке. Обязательный если указан main_contact_ext_id.
main_contact_ext_id	string	нет	Главный контакт сделки из списка contact_ext_ids. Обязательный если передается contact_ext_ids.
employee_ext_id	string	нет	Ответственный сотрудник за сделку
revenue	number	нет	Выручка по сделке
sales_funnel_ext_id	string	да	Идентификатор воронки продаж
stage_ext_id	string	да	Идентификатор этапа воронки продаж
comments	string	нет	Комментарий к сделке
source	string	нет	Источник сделки
user_fields	array	нет	Пользовательские поля проставленные у сделки. Перед тем как передать, нужно создать пользовательское поле через метод "create.deal_user_field")
ext_id	string	да	Внешний идентификатор пользовательского поля сделки
value	string	да	значение пользовательского поля сделки

JSON структура запроса

{
    "jsonrpc": "2.0",
    "id": "number",
    "method": "upload.deals_history",
    "params": {
        "access_token": "string",
        "user_id": "number",
        "deals": [
            {
                "ext_id": "string",
                "name": "string",
                "created_date_time": "iso8601",
                "modified_date_time":"iso8601",
                "modified_stage_date_time": "iso8601",
                "closed_date_time": "iso8601",
                "contact_ext_ids": [
                    "string"
                ],
                "main_contact_ext_id": "string",
                "employee_ext_id": "string",
                "revenue": "number",
                "sales_funnel_ext_id": "string",
                "stage_ext_id": "string",
                "comments": "string",
                "source": "string",
                "user_fields":[
                    {
                        "ext_id": "string",
                        "value": "string"
                    },
                    {
                        "ext_id": "string",
                        "value": "string"
                    }
                ]
            }
        ]
    }
}

JSON структура ответа

{
    "jsonrpc": "2.0",
    "id": "number",
    "result": {
        "data": {},
        "metadata": "object"
    }
}

Список возвращаемых ошибок

Смотрим раздел "Список ошибок для методов с глаголом upload"