Метод для обновления сделки. Обновлять поля сделки можно только когда она в статусе "NEW" или "PAID".
Разрешенные поля для обновления при статусе сделки Метод для оновлення угоди. Оновлювати поля угоди можливо лише тоді, коли вона має статус "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.
...
Запит
Method | PATCH |
URL | /deals/{{dealId}} |
...
Параметри запиту
ПолеОбязательное | Обов'язковість | Тип | ОписаниеОпис | ПримерПриклад | |
---|---|---|---|---|---|
{{dealId}} | ДаТак | String | ID сделкиугоди (либо або externalId, если або byExternalId=true), которую нужно обновитьяку необхідно оновити | "L8M95ER" | |
byExternalId | НетНі | Boolean | Для поиска сделки пошуку угоди по externalId нужно передать потрібно передавати true | true | |
adId | НетНі | String | ID объявления, объявления должно быть подтвержденнооголошення, оголошення має бути підтверджено (статус - "CONFIRMED") | "A-D7ZL93Z" | |
cartId | НетНі | Number | ID корзиныкошику | 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 | НетНі | String | ID города в системе выбранного обработчика с которого будет осуществлена отправкаміста в системі обраного обробника, з якогого буде виконана відправка | "8d5a980d-391c-11dd-90d9-001a92567626" | |
handler.senderOfficeId | НетНі | String | ID отделения/офиса в системе выбранного обработчика с которого будет осуществлена отправкавідділення/офісу в системі обраного обробника, з якого буде виконана відправка | "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 | НетНі | String | ID города в системе выбранного обработчика в который будет осуществлена отправкаміста в системі обраного обробника, в яке буде виконана відправка | "8d5a980d-391c-11dd-90d9-001a92567626" | |
handler.recipientOfficeId | НетНі | String | ID отделения/офиса в системе выбранного обработчика в который будет осуществлена отправкавідділення/офісу в системі обраного обробника, в яке буде виконана відправка | "1ec09d88-e1c2-11e3-8c4a-0050568002cf" |
ПримерПриклад:
Code Block | ||
---|---|---|
| ||
PATCH /deals/L8M95ER |
...
Code Block | ||
---|---|---|
| ||
{ "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.id | ID сделкиугоди |
data.externalId | Внешний Зовнішній ID сделкиугоди |
ПримерПриклад:
Code Block | ||
---|---|---|
| ||
{ "data": { "id": "L8M95ER", "externalId": "myExternalId537916" } } |
...