Метод для создание сделки. Cделка создается со статусом "NEW", Метод для створення угоди. Угода створюється зі статусом "NEW". Також, якщо вказано дані обробника, створюється обробник зі статусом "NEW" і платіж за доставку зі статусом "NEW"; якщо вказані дані по платежу за товар, то створюється платіж за товар зі статусм "NEW".
так же, если указаны данные по обработчику, то создаеться обработчик со статусом "NEW" и платеж за доставку со статусом "NEW", если указанные данные по платежу за товар, то создаеться платеж за товар со статусом "NEW". Обязательным, при создании, являеться только поле корзины, это позволяет обновлять сделку с помощью метода обновления сделки последующими итерациями и не указывать все необходимые данные сразу.При указании объявления, такие поля как Обов'язковим полем при створенні угоди ,є лише поле кошика, це дозволяє оновлювати угоду за допомогою методу оновлення угоди наступними ітераціями і не вказувати всі необхідні дані відразу
При вказуванні об'яви, такі поля як sellerFirstName, sellerLastName, sellerPatronymic, sellerPhone, sellerEmail, productTitle, productPrice, productWeight заполняються автоматически с полей объявления заповнюються автоматично із полів об'яви.
В сделке продавец не является обязательно отправителем, так же покупатель не являеться обязательно получателем.
...
угоді продавець не є обов'язково і відправником, також покупець не є обов'язково отримувачем.
Запит
| Method | POST |
| URL | /deals |
...
Параметри запиту
| ПолеОбязательное | Обов'язковість | Тип | ОписаниеОпис | ПримерПриклад | |
|---|---|---|---|---|---|
| externalId | НетНі | String | Внешний Зовнішній ID, должен быть уникальныммає бути унікальним | "myExternalId537916" | |
| adId | НетНі | String | ID объявления, объявления должно быть подтвержденнооголошення, оголошення має бути підтверджено (статус - "CONFIRMED") | "A-D7ZL93Z" | |
| cartId | ДаТак | Number | ID корзиныкошика | 338 | |
| cartExternalId | ДаТак, если якщо не указан вказано cartId | 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 | НетНі | StringString | Токен платежной карты продавца в выбранной платежной системе, куда будут зачислены деньги после успешной сделкиплатіжної картки продавця в обраній платіжній системі, на яку будуть зараховані гроші після успішної операції | "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 | ||
|---|---|---|
| ||
POST /deals |
...
| Code Block | ||
|---|---|---|
| ||
{
"externalId": "myExternalId537916",
"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"
}
} |
...