Versions Compared

Key

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

Метод для создание объявления створення оголошення в системе системі Escrow Box. Объявление создается со Оголошення створюється зі статусом "NEW". По сути объявление это просто предзаполненые Оголошення, насамперед, - це предзаповнені поля для сделки. Так же, есть возможность в объявлении указать несколько вариантов платежных систем для оплаты товара и несколько вариантов обработчиков. Объявление может использоваться много раз.

...

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

Запит

MethodPOST
URL/ads

...

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

ПолеОбязательноеОбов'язковістьТипОписаниеОписПримерПриклад
externalIdНетНіStringВнешний Зовнішній ID, должен быть уникальныммає бути унікальним"myExternalId209081"
sellerFirstNameНетНіStringИмя продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"ИванІм'я продавця, лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Іван"
sellerLastNameНетНіStringФамилия продавца, только кириллические символы украинского и русского алфавита, а так же Прізвище продавця,  лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 раз"Иванові того самого символу більш ніж 2 рази підряд"Іванов"
sellerPatronymicНетНіStringОтчество продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"ИвановичПо-батькові продавця,  лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Іванович"
sellerEmailНетНіStringЭлектронная почта продавцаЕлектронна пошта продавця"ivanov@mail.test"
sellerPhoneНетНіStringНомер телефона продавца телефону  продавця в формате форматі "380XXXXXXXXX""380123456789"
productTitleНетНіStringНазвание товараНазва товару"СтолСтіл"
productDescriptionНетНіStringОписание товара Опис товару"Стол дубовыйСтіл дубовий, б/ув"
productPriceНетНіNumberЦена товара Ціна товару в копейкахкопійках, валюта - гривнагривня, только целые  лише цілі числа, больше нулябільше нуля 100000
productWeightНетНіNumberВес товараВага товару, в граммахграмах, только целые  лише цілі числа, больше нулябільше нуля 15000
handlersConfigsНетНіArrayМассив возможных объектов с данными обработчика для этого объявленияМасив можливих об'єктів з даними обробника для цього оголошення
handlersConfigs[].{}.typeНетНіStringТип обработчика с помощью которого будет производиться доставка товараобробника за допомогою якого буде проводитися доставка товару"NovaPoshta"
handlersConfigs[].{}.senderFirstNameНетНіStringИмя отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"ИванІм'я відправника, лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Іван"
handlersConfigs[].{}.senderLastNameНетНіStringФамилия отправителя, только кириллические символы украинского и русского алфавита, а так же Прізвище відправника, лише кирилиця української та російської абетки, а також апостроф. Не разрешается повторение дозволяється повторення одного и того же символа более 2 раз"Иванові того самого символу більш ніж 2 рази підряд"Іванов"
handlersConfigs[].{}.senderPatronymicНетНіStringОтчество отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"ИвановичПо-батькові відправника, лише кирилиця української та російської абетки, а також апостроф. Не дозволяється повторення одного і того самого символу більш ніж 2 рази підряд"Іванович"
handlersConfigs[].{}.senderPhoneНетНіStringНомер телефона отправителя телефону відправника в формате форматі "380XXXXXXXXX""380123456789"
handlersConfigs[].{}.senderEmailНетНіStringЭлектронная почта отправителяЕлектронна пошта  відправника"ivanov@mail.test"
handlersConfigs[].{}.senderCityIdНетНіStringID города в системе выбранного обработчика с которого будет осуществлена отправкаміста в системі обраного обробника, з якогого буде виконана відправка "8d5a980d-391c-11dd-90d9-001a92567626"
handlersConfigs[].{}.senderOfficeIdНетНіStringID отделения/офиса в системе выбранного обработчика с которого будет осуществлена отправкавідділення/офісу в системі обраного обробника, з якого буде виконана відправка "7b2cc7fd-84ff-11e4-acce-0050568002cf"
paymentsConfigsНетНіArrayМассив возможных объектов с данными платежа Масив можливих об'єктів з даними платежу за товар для этого объявленияцього оголошення
paymentsConfigs[].{}.typeНетНіStringТип платежной системы с помощью которой будет производиться оплата товараплатіжної системи, за допомогою якої буде проводитися оплата товару"P2P"
paymentsConfigs[].{}.cardToIdНетНіStringТокен платежной карты продавца в выбранной платежной системе, куда будут зачислены деньги после успешной сделкиплатіжної картки продавця в обраній платіжній системі, на яку будуть зараховані гроші після успішної операції"058a2fa1-8dee-4c39-8796-574cdc573530"

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

Code Block
languagejs
POST /ads


Code Block
languagejs
{
  "externalId": "myExternalId209081",
  "sellerFirstName": "ИванІван",
  "sellerLastName": "ИвановІванов",
  "sellerPatronymic": "ИвановичІванович",
  "sellerPhone": "380123456789",
  "sellerEmail": "ivanov@mail.test",
  "productTitle": "СтолСтіл",
  "productDescription": "СтолСтіл дубовыйдубовий, б/ув",
  "productPrice": 100000,
  "productWeight": 15000,
  "handlersConfigs": [
    {
      "type": "NovaPoshta",
      "senderFirstName": "ИванІван",
      "senderLastName": "ИвановІванов",
      "senderPatronymic": "ИвановичІванович",
      "senderPhone": "380987654321",
      "senderEmail": "ivanov@mail.test",
      "senderCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
      "senderOfficeId": "7b2cc7fd-84ff-11e4-acce-0050568002cf"
    }
  ],
  "paymentsConfigs": [
    {
      "type": "P2P",
      "cardToId": "058a2fa1-8dee-4c39-8796-574cdc573530"
    }
  ]
}
Параметры ответа

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

ПолеОписаниеОпис
dataОбъект с ответомОб'єкт з відповіддю
data.idID объявленияоголошення
data.externalIdВнешний ID объявленияЗовнішній ID оголошення
data.urlURL на сделку угоду в системе системі Escrow Box

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

Code Block
languagejs
{
    "data": {
        "id": "A-D7ZL93Z",
        "externalId": "myExternalId209081",
        "url": "https://escrowbox.demo.uapay.ua/ads/A-D7ZL93Z"
    }
}