Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Разрешенные поля для обновления при статусе сделки Метод для оновлення угоди. Оновлювати поля угоди можливо лише тоді, коли вона має статус "NEW" або"PAID".

Дозволені поля для оновлення при статусі угоди "NEW": cartIdcartExternalIdproductTitleproductPrice, productWeight, sellerFirstName, sellerLastName, sellerPatronymic, sellerPhone, sellerEmail, buyerFirstName, buyerLastName, buyerPatronymic, buyerPhone, buyerEmail, lg, adId, payment.typepayment.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, sellerEmailpayment.cardToIdhandler.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 раз"ИванІм'я продавця, лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Іван"
sellerLastNameНетНіStringФамилия продавца, только кириллические символы украинского и русского алфавита, а так же Прізвище продавця, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 раз"Иванові того самого символу більш ніж 2 рази підряд"Іванов"
sellerPatronymicНетНіStringОтчество продавца, только кириллические символы украинского и русского алфавита, а так же По батькові продавця, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 раз"Ивановичі того самого символу більш ніж 2 рази підряд"Іванович"
sellerPhoneНетНіStringНомер телефона продавца телефону продавця в формате форматі "380XXXXXXXXX""380123456789"
sellerEmailНетНіStringЭлектронная почта продавцаЕлектронна пошта продавця"ivanov@mail.test"
buyerFirstNameНетНіStringИмя покупателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 разІм'я покупця, лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Петро"
buyerLastNameНетНіStringФамилия покупателя, только кириллические символы украинского и русского алфавита, а так же Прізвище покупця, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 разі того самого символу більш ніж 2 рази підряд"Петров"
buyerPatronymicНетНіStringОтчество покупателя, только кириллические символы украинского и русского алфавита, а так же По батькові покупця, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 разі того самого символу більш ніж 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 раз"ИванІм'я відправника, лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Іван"
handler.senderLastNameНетНіStringФамилия отправителя, только кириллические символы украинского и русского алфавита, а так же Прізвище відправника, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 раз"Иванові того самого символу більш ніж 2 рази підряд"Іванов"
handler.senderPatronymicНетНіStringОтчество отправителя, только кириллические символы украинского и русского алфавита, а так же По батькові відправника, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 раз"Ивановичі того самого символу більш ніж 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 разІм'я отримувача, лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Петро"
handler.recipientLastNameНетНіStringФамилия получателя, только кириллические символы украинского и русского алфавита, а так же Прізвище отримувача, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 разі того самого символу більш ніж 2 рази підряд"Петров"
handler.recipientPatronymicНетНіStringОтчество получателя, только кириллические символы украинского и русского алфавита, а так же По батькові отримувача, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 разі того самого символу більш ніж 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"

ПримерПриклад:


Code Block
languagejs
PATCH /deals/L8M95ER

...

Code Block
languagejs
{
  "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 сделкиугоди

ПримерПриклад:

Code Block
languagejs
{
    "data": {
        "id": "L8M95ER",
        "externalId": "myExternalId537916"
    }
}

...