Створення угоди

Метод для створення угоди. Угода створюється зі статусом "NEW". Також, якщо вказано дані обробника, створюється обробник зі статусом "NEW" і платіж за доставку зі статусом "NEW"; якщо вказані дані по платежу за товар, то створюється платіж за товар зі статусм "NEW". 

так же, если указаны данные по обработчику, то создаеться обработчик со статусом "NEW" и платеж за доставку со статусом "NEW", если указанные данные по платежу за товар, то создаеться платеж за товар со статусом "NEW". Обов'язковим полем при створенні угоди ,є лише поле кошика, це дозволяє оновлювати угоду за допомогою методу оновлення угоди наступними ітераціями і не вказувати всі необхідні дані відразу

При вказуванні об'яви, такі поля як sellerFirstNamesellerLastNamesellerPatronymicsellerPhonesellerEmailproductTitleproductPriceproductWeight заповнюються автоматично із полів об'яви. 

В угоді продавець не є обов'язково і відправником, також покупець не є обов'язково отримувачем. 

Запит

MethodPOST
URL/deals

Параметри запиту

ПолеОбов'язковістьТипОписПриклад
externalIdНіStringЗовнішній ID, має бути унікальним"myExternalId537916"
adIdНіStringID оголошення, оголошення має бути підтверджено (статус - "CONFIRMED")"A-D7ZL93Z"
cartIdТакNumberID кошика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Ні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НіString

ID міста в системі обраного обробника, в яке буде виконана відправка

"8d5a980d-391c-11dd-90d9-001a92567626"
handler.recipientOfficeIdНіStringID відділення/офісу  в системі обраного обробника, в яке буде виконана відправка"1ec09d88-e1c2-11e3-8c4a-0050568002cf"

Приклад:

Параметри відповіді

ПолеОпис
dataОб'єкт з відповіддю
data.idID угоди
data.externalId

Зовнішній ID угоди

Приклад: