Зміна статусу обробника угоди

Метод для зміни статусу обробника угоди, що призводить до зміни статусу самої угоди. Статус обробника можливо отримати у відповіді при виклику https://uapayua.atlassian.net/wiki/pages/createpage.action?spaceKey=AC&title=%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F%20%D0%B4%D0%B0%D0%BD%D0%B8%D1%85%20%D0%BF%D0%BE%20%D1%83%D0%B3%D0%BE%D0%B4%D1%96&linkCreation=true&fromPageId=914161665, в полі - data.handler.status. Змінювати статус обробника угоди можливо лише у випадку, коли в угоді вказано користувацький тип обробника (наприклад data.handler.type=”Custom”) та статус обробника угоди - ‘CREATED', 'SENT' або 'DELIVERED' (це можливо лише після https://uapayua.atlassian.net/wiki/pages/createpage.action?spaceKey=AC&title=%D0%9F%D1%96%D0%B4%D1%82%D0%B2%D0%B5%D1%80%D0%B4%D0%B6%D0%B5%D0%BD%D0%BD%D1%8F%20%D1%83%D0%B3%D0%BE%D0%B4%D0%B8&linkCreation=true&fromPageId=914161665). А змінити статус можливо лише на 'SENT', 'DELIVERED', 'FINISHED', 'CANCELED', 'REJECTED' або 'EXPIRED'.

Статуси обробника 'FINISHED', 'CANCELED', 'REJECTED' та 'EXPIRED' - фінальні, змінам не підлягають і призводять до зарахування/повернення грошей за товар і доставку.

Запит

Method

PATCH

URL

/handlers/{{handlerType}}/status

Параметри запиту

Поле

Обов'язковість

Тип

Опис

Приклад

Поле

Обов'язковість

Тип

Опис

Приклад

{{handlerType}}

Так

String

Тип обробника

"Custom"

dealId

Так

String

ID угоди

"L8M95ER"

status

Так

String

Статус обробника. Може бути:

  • "SENT" - товар відправлено;

  • "DELIVERED" - товар прибув;

  • "FINISHED" - покупець отримав товар, зараховано гроші за товар і доставку;

  • "CANCELED" - ТТН (або аналог) відмінено чи видалено, повернення грошей за товар і за доставку;

  • "REJECTED" - відмова покупцем від товар, повернення грошей лише за товар;

  • "EXPIRED" - перевищено час очікування для отримання товару, повернення грошей лише за товар

“SENT“

statusCode

Нет

String

Статус код обробника в системі клієнта

“123“

statusText

Нет

String

Текстовий статус обробника в системі клієнта

“Посилка знаходиться в сортувальному центрі“

 

1 PATCH /handlers/Custom/status
1 2 3 4 5 6 {   "dealId": "L8M95ER",   "status": “SENT“,   "statusCode": “123“,   "statusText": “Посилка знаходиться в сортувальному центрі“ }

Параметри відповіді

Поле

Опис

Поле

Опис

data

Об'єкт з відповіддю

data.id

ID угоди

data.externalId

Зовнішній ID угоди

Приклад:

1 2 3 4 5 6 {     "data": {         "id": "L8M95ER",         "externalId": "myExternalId537916"     } }