Versions Compared

Key

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

Метод для обновления объявления. Обновлять поля объявления можно только когда оно в статусе , який дозволяє оновити оголошення. Оновити поля оголошення дозволяється лише в тому випадку, коли оголошення має статус "NEW".

...

Запит

MethodPATCH
URL/ads/{{adId}}

...

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

ПолеОбязательноеОбов'язковістьТипОписаниеОписПримерПриклад
{{adId}}ДаТакStringID объявленияоголошення"A-D7ZL93Z"
byExternalIdНетНіBooleanДля поиска объявления по externalId нужно передать пошуку оголошення по externalId необхідно передати true true
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Цена товара Ціна товару в копейкахкопійках, валюта - гривнагривня, только целые  лише цілі числа, больше нулябільше нуля 1000001
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
PATCH /ads/A-D7ZL93Z


Code Block
languagejs
{
  "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"
    }
}