Метод для обновления сделки. Обновлять поля сделки можно только когда она в статусе "NEW" или "PAID".

Разрешенные поля для обновления при статусе сделки "NEW": cartId, cartExternalId, productTitle, productPrice, productWeight, sellerFirstName, sellerLastName, sellerPatronymic, sellerPhone, sellerEmail, buyerFirstName, buyerLastName, buyerPatronymic, buyerPhone, buyerEmail, lg, adId, payment.type, payment.cardToId, handler.type, handler.senderFirstName, handler.senderLastName, handler.senderPatronymic, handler.senderPhone, handler.senderEmail, handler.senderCityId, handler.senderOfficeId, handler.recipientFirstName, handler.recipientLastName, handler.recipientPatronymic, handler.recipientPhone, handler.recipientEmail, handler.recipientCityId, handler.recipientOfficeId.

Разрешенные поля для обновления при статусе сделки "PAID": sellerFirstName, sellerLastName, sellerPatronymic, sellerPhone, sellerEmail, payment.cardToId, handler.senderFirstName, handler.senderLastName, handler.senderPatronymic, handler.senderPhone, handler.senderEmail, handler.senderOfficeId, handler.recipientFirstName, handler.recipientLastName, handler.recipientPatronymic, handler.recipientPhone, handler.recipientEmail, handler.recipientOfficeId.

Запрос

MethodPATCH
URL/deals/{{dealId}}

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

ПолеОбязательноеТипОписаниеПример
{{dealId}}ДаStringID сделки(либо externalId, если byExternalId=true), которую нужно обновить"L8M95ER"
byExternalIdНетBooleanДля поиска сделки по externalId нужно передать truetrue
adIdНетStringID объявления, объявления должно быть подтвержденно(статус - "CONFIRMED")"A-D7ZL93Z"
cartIdНетNumberID корзины338
cartExternalIdНетStringВнешний ID корзины"myExternalId478454"
productTitleНетStringНазвание товара"Стол"
productWeightНетNumberВес товара, в граммах, только целые числа, больше нуля15000
productPriceНетNumberЦена товара в копейках, валюта - гривна, только целые числа, больше нуля100000
sellerFirstNameНетStringИмя продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иван"
sellerLastNameНетStringФамилия продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванов"
sellerPatronymicНетStringОтчество продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванович"
sellerPhoneНетStringНомер телефона продавца в формате "380XXXXXXXXX""380123456789"
sellerEmailНетStringЭлектронная почта продавца"ivanov@mail.test"
buyerFirstNameНетStringИмя покупателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петро"
buyerLastNameНетStringФамилия покупателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петров"
buyerPatronymicНетStringОтчество покупателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петрович"
buyerPhoneНетStringНомер телефона покупателя в формате "380XXXXXXXXX""380987654321"
buyerEmailНетStringЭлектронная почта покупателя"petrov@mail.test"
paymentНетObjectОбъект с данными платежа за товар
payment.typeНетStringТип платежной системы с помощью которой будет производиться оплата товара"P2P"
payment.cardToIdНетStringТокен платежной карты продавца в выбранной платежной системе, куда будут зачислены деньги после успешной сделки"b0be0af6-9c7e-4b62-bf16-9957b34549c9"
handlerНетObjectОбъект с данными обработчика
handler.typeНетStringТип обработчика с помощью которого будет производиться доставка товара"NovaPoshta"
handler.senderFirstNameНетStringИмя отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иван"
handler.senderLastNameНетStringФамилия отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванов"
handler.senderPatronymicНетStringОтчество отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванович"
handler.senderPhoneНетStringНомер телефона отправителя в формате "380XXXXXXXXX""380987654321"
handler.senderEmailНетStringЭлектронная почта отправителя"ivanov@mail.test"
handler.senderCityIdНетStringID города в системе выбранного обработчика с которого будет осуществлена отправка"8d5a980d-391c-11dd-90d9-001a92567626"
handler.senderOfficeIdНетStringID отделения/офиса в системе выбранного обработчика с которого будет осуществлена отправка

"7b2cc7fd-84ff-11e4-acce-0050568002cf"

handler.recipientFirstNameНетStringИмя получателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петро"
handler.recipientLastNameНетStringФамилия получателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петров"
handler.recipientPatronymicНетStringОтчество получателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петрович"
handler.recipientPhoneНетStringНомер телефона получателя в формате "380XXXXXXXXX""380987654321"
handler.recipientEmailНетStringЭлектронная почта получателя"petrov@mail.test"
handler.recipientCityIdНетStringID города в системе выбранного обработчика в который будет осуществлена отправка"8d5a980d-391c-11dd-90d9-001a92567626"
handler.recipientOfficeIdНетStringID отделения/офиса в системе выбранного обработчика в который будет осуществлена отправка"1ec09d88-e1c2-11e3-8c4a-0050568002cf"

Пример:


PATCH /deals/L8M95ER


{
  "adId": "A-D7ZL93Z",
  "cartId": 338,
  "productTitle": "Стол",
  "productWeight": 15000,
  "productPrice": 100000,
  "sellerFirstName": "Иван",
  "sellerLastName": "Иванов",
  "sellerPatronymic": "Иванович",
  "sellerPhone": "380123456789",
  "sellerEmail": "ivanov@mail.test",
  "buyerFirstName": "Петро",
  "buyerLastName": "Петров",
  "buyerPatronymic": "Петрович",
  "buyerPhone": "380987654321",
  "buyerEmail": "petrov@mail.test",
  "payment": {
    "type": "P2P",
    "cardToId": "058a2fa1-8dee-4c39-8796-574cdc573530"
  },
  "handler": {
    "type": "NovaPoshta",
    "senderFirstName": "Иван",
    "senderLastName": "Иванов",
    "senderPatronymic": "Иванович",
    "senderPhone": "380987654321",
    "senderEmail": "ivanov@mail.test",
    "senderCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
    "senderOfficeId": "7b2cc7fd-84ff-11e4-acce-0050568002cf",
    "recipientFirstName": "Петро",
    "recipientLastName": "Петров",
    "recipientPatronymic": "Петрович",
    "recipientPhone": "380987654321",
    "recipientEmail": "petrov@mail.test",
    "recipientCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
    "recipientOfficeId": "1ec09d88-e1c2-11e3-8c4a-0050568002cf"
  }
}

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

ПолеОписание
dataОбъект с ответом
data.idID сделки
data.externalIdВнешний ID сделки

Пример:

{
    "data": {
        "id": "L8M95ER",
        "externalId": "myExternalId537916"
    }
}