Метод для створення угоди. Угода створюється зі статусом "NEW". Також, якщо вказано дані обробника, створюється обробник зі статусом "NEW" і платіж за доставку зі статусом "NEW"; якщо вказані дані по платежу за товар, то створюється платіж за товар зі статусм "NEW".
так же, если указаны данные по обработчику, то создаеться обработчик со статусом "NEW" и платеж за доставку со статусом "NEW", если указанные данные по платежу за товар, то создаеться платеж за товар со статусом "NEW". Обов'язковим полем при створенні угоди ,є лише поле кошика, це дозволяє оновлювати угоду за допомогою методу оновлення угоди наступними ітераціями і не вказувати всі необхідні дані відразу
...
| Поле | Обов'язковість | Тип | Опис | Приклад |
|---|---|---|---|---|
| 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 рази підряд | "Іван" |
| 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 | Ні | String | ID міста в системі обраного обробника, з якогого буде виконана відправка | "8d5a980d-391c-11dd-90d9-001a92567626" |
| handler.senderOfficeId | Ні | String | ID відділення/офісу в системі обраного обробника, з якого буде виконана відправка | "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 | Ні | String | ID міста в системі обраного обробника, в яке буде виконана відправка | "8d5a980d-391c-11dd-90d9-001a92567626" |
| handler.recipientOfficeId | Ні | String | ID відділення/офісу в системі обраного обробника, в яке буде виконана відправка | "1ec09d88-e1c2-11e3-8c4a-0050568002cf" |
...