API-метод обновления сделок

Запрос

POST: https://api.calltouch.ru/lead-service/v1/api/client-order/update

HTTP-заголовки:

• Access-Token – API-ключ
• SiteId – ID ЛК Calltouch

Тело запроса в формате JSON:

{
    "orders": [
    
        // Сделка 1

        {
            "orderNumber": "ID сделки 1 во внешней CRM",
            "funnel": "Название воронки",
            "status": "Новая сделка",
            "statusDate": "Дата и время перехода сделки на текущий статус",
            "updateDate": "Дата и время обновления сделки",
            "currency": "rub",
            "revenue": "100000.50",
            "margin": "100.50",
            "manager": "ФИО продавца",
            "orderLink": "https://site.ru/crm/deal/123/",
            "orderName": "Название сделки",
            "addNewComment": {
                "text": "Комментарий к сделке"
                },
            "addTags": {
                "overwrite": false,
                "tags":
                    [
                        {"tag": "Тег 1"},
                        {"tag": "Тег 2"},
                        {"tag": "Тег N"}
                    ]
            },
            "addTagsToLeads": {
                "overwrite": false,
                "tags":
                    [
                        {"tag": "Тег 1"},
                        {"tag": "Тег 2"},
                        {"tag": "Тег N"}
                    ]
            },
            "customFields": [
                {"field": "grossprofit", "value": "456.50"},
                {"field": "name", "value": "123"}
                ],
            "products": [
                {
                    "name": "Табурет",
                    "price": "500.25",
                    "brand": "ikea",
                    "category": "Столы, стулья",
                    "variant": "Черный",
                    "quantity": 10
                },
                {
                    "name": "Стол",
                    "price": "1500"
                }],
            "reMatching": [
                {
                    "type": "request",
                    "requestParams": {
                        "requestId": 1,
                        "tags": ["тег1", "тег2"],
                        "tagsLogic": "and"
                    }
                },
                {
                    "type": "call",
                    "callParams": {
                        "callId": 2 ,
                        "tags": ["тег"],
                        "tagsLogic": "and"
                    }
                },
                {
                    "type": "requestContact",
                    "requestContactParams": {
                        "emails": ["name@server.com"],
                        "phones": ["79157771122", "+7 (915) 888-11-22"],
                        "md5Phones": ["4fec00b25336e719d4a0b255ea5aa0f5"],
                        "date": "Дата и время заявки",
                        "tags": ["тег"],
                        "tagsLogic": "and",
                        "requestTypeToMatch": "nearest",
                        "searchDepth": 262800
                    }
                },
                {
                    "type": "callContact",
                    "callContactParams": {
                        "phones": ["84953338877"],
                        "md5Phones": ["4fec00b25336e719d4a0b255ea5aa0f5"],
                        "date": "Дата и время звонка",
                        "tags": ["тег"],
                        "tagsLogic": "and",
                        "callTypeToMatch": "nearest",
                        "searchDepth": 262800
                        }
                },
                {
                    "type": "call",
                    "callParams": {
                        "callId": 2,
                        "tags": ["тег"],
                        "tagsLogic": "and"
                    }
                },
                {
                    "type": "customSources",
                    "customSourceParams": {
                        "source": "Произвольный источник",
                        "medium": "Произвольный канал",
                        "campaign": "Произвольная кампания",
                        "content": "Произвольное объявление",
                        "term": "Произвольная ключевая фраза"
                    }
                },
                {
                    "type": "withoutSource"
                }
            ]
        },

        // Сделка N

        ...

    ]
}

Комментарии через // следует убрать из запроса перед его выполнением.

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

Ответ

Процесс обновления запускается сразу же после отправки запроса, после чего сразу же возвращается и ответ, пример:

{
    "meta": [],
    "data": {
        "orders": [
            {
                "orderNumber": "UdvPC9bBjjLnEJ9R",
                "updateStatus": "success",
                "error": null
            }
        ]
    }
}

Если API-токен не указан, то обновление не выполняется и выводится ошибка:

{
    "meta": [],
    "data": {
        "message": "Ошибка доступа"
    }
}

Если API-токен указан не верно, то обновление не выполняется и выводится ошибка:

{
    "message": "Access token не найден"
}

Параметры ответа

Если в запросе обнаруживаются ошибки валидации, то обновление не выполняется и выводится ошибка:

{
    "meta": [],
    "data": {
        "type": "validationError",
        "apiErrorData": null,
        "validationErrorData": {
            "violations": [
                {
                    "fieldPath": "orders[0].statusDate",
                    "message": "Значение даты и времени недопустимо."
                }
            ]
        }
    }
}