метод REST scope: sale

sale.order.update

Изменить заказ

Кто может выполнять: администратор

Описание

Метод sale.order.update обновляет поля заказа.

Параметры

price double необязательный

Цена

discountValue double необязательный

Значение скидки

statusId sale_status.id необязательный

Идентификатор статуса заказа

empStatusId user.id необязательный

Идентификатор пользователя, изменившего статус заказа

dateInsert datetime необязательный

Дата создания заказа

marked string необязательный

Флаг маркировки. Признак того, является ли отгрузка отмеченной как проблемная. Значение Y ставится автоматически, если при сохранении произошла ошибка.

  • Y — да
  • N — нет

По умолчанию устанавливается N

empMarkedId user.id необязательный

Идентификатор пользователя, поставившего маркировку

reasonMarked string необязательный

Причина, по которой заказ был промаркирован

userDescription string необязательный

Комментарий покупателя к заказу

additionalInfo string необязательный

Устаревший.

Дополнительная информация

comments string необязательный

Комментарий менеджера к заказу

responsibleId user.id необязательный

Идентификатор пользователя, ответственного за заказ

recurringId integer необязательный

Идентификатор продления подписки

lockedBy user.id необязательный

Актуально только для коробочной версии.

Идентификатор пользователя, заблокировавшего заказ. Заказ блокируется в административной панели, когда пользователь открывает детальную карточку заказа

recountFlag string необязательный

Устаревший.

Флаг пересчёта.

  • Y — да
  • N — нет

По умолчанию устанавливается Y

affiliateId integer необязательный

Актуально только для коробочной версии.

Идентификатор аффилиата

updated1c string необязательный

Обновлён ли через 1С.

  • Y — да
  • N — нет

По умолчанию устанавливается N

orderTopic string необязательный

Устаревший.

Тема заказа

xmlId string необязательный

Внешний идентификатор

id1c string необязательный

Идентификатор в 1С

version1c string необязательный

Версия в 1с

externalOrder string необязательный

Заказ из внешней системы или нет.

  • Y — да
  • N — нет

По умолчанию устанавливается N

canceled string необязательный

Был ли отменен заказ.

  • Y — да
  • N — нет

По умолчанию устанавливается N

empCanceledId user.id необязательный

Идентификатор пользователя, отменившего заказ

reasonCanceled string необязательный

Причина отмены

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":300,"fields":{"price":100,"discountValue":10,"statusId":"N","empStatusId":1,"dateInsert":"2024-03-01T14:00:00","marked":"Y","empMarkedId":1,"reasonMarked":"","userDescription":"","additionalInfo":"","comments":"","companyId":1,"responsibleId":1,"recurringId":1,"lockedBy":1,"recountFlag":"N","affiliateId":1,"updated1c":"N","orderTopic":"","xmlId":"","id1c":"","version1c":"","externalOrder":"N","canceled":"Y","empCanceledId":1,"reasonCanceled":""}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.order.update

Ответ

HTTP-статус: 200

{
    "result": {
        "order": {
            "accountNumber": "456",
            "additionalInfo": "",
            "affiliateId": 1,
            "canceled": "Y",
            "clients": [],
            "comments": "",
            "companyId": 1,
            "currency": "RUB",
            "dateCanceled": "2024-04-12T14:06:05+03:00",
            "dateInsert": "2024-03-01T13:00:00+03:00",
            "dateLock": null,
            "dateMarked": "2024-04-15T10:21:14+03:00",
            "dateStatus": "2024-04-12T14:06:04+03:00",
            "dateUpdate": "2024-04-15T10:21:15+03:00",
            "deducted": "N",
            "discountValue": 10,
            "empCanceledId": 1,
            "empMarkedId": 1,
            "empStatusId": 1,
            "externalOrder": "N",
            "id": 300,
            "id1c": "",
            "lid": "s1",
            "lockedBy": "1",
            "marked": "N",
            "orderTopic": "",
            "payed": "N",
            "personTypeId": 1,
            "personTypeXmlId": "",
            "price": 100,
            "reasonCanceled": "",
            "reasonMarked": "",
            "recountFlag": "N",
            "recurringId": "1",
            "requisiteLink": [],
            "responsibleId": 1,
            "statusId": "N",
            "statusXmlId": "",
            "taxValue": null,
            "updated1c": "N",
            "userDescription": "",
            "userId": 1,
            "version": 3,
            "version1c": "",
            "xmlId": ""
        }
    },
    "time": {
        "start": 1713169274.29568,
        "finish": 1713169275.698528,
        "duration": 1.4028480052947998,
        "processing": 0.9852678775787354,
        "date_start": "2024-04-15T11:21:14+03:00",
        "date_finish": "2024-04-15T11:21:15+03:00"
    }
}

Возвращаемые данные

result object

Корневой элемент ответа

order sale_order

Объект с информацией об обновленном заказе

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":200540400001
    "error_description":"order is not exists"
}
Код Описание Значение
200540400001 Обновляемый заказ не найден
200040300020 Недостаточно прав для обновления заказа
100 Не указан параметр id
100 Не указан или пустой параметр fields
0 Другие ошибки (например, фатальные ошибки)

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.