Versions Compared

Key

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

...

Пример:

Code Block
languagejs
GET /deals/L8M95ER

Параметры ответа

ПолеОписание
dataОбъект с ответом
data.idID сделки
data.externalIdВнешний ID сделки
data.cartIdID корзины
data.productTitleНазвание товара
data.productPriceЦена товара, в копейках
data.productWeightВес товара, в граммах
data.handlerPriceРассчитанная цена доставки обработчиком, в копейках
data.status

Статус сделки, есть всегда и отображает в каком состоянии в данный момент находиться сделка. Может быть:

  • "NEW" - новая сделка, первоначальный статус;
  • "PAID" - сделка оплаченная;
  • "CONFIRMED" - сделка подтверждена продавцом;
  • "SENT" - обработчик оповестил о отправке товара;
  • "DELIVERED" - обработчик оповестил о прибытии товара;
  • "FINISHED" - сделка успешно завершена;
  • "REJECTED" - сделка отклонена по какой-либо причине;
  • "EXPIRED" - сделка просрочена на каком-либо этапе
data.reasonStep

Поле которое показывает на каком этапе сделка перейшла в статус "REJECTED" или "EXPIRED". Может быть:

  • "PAID" - этап когда сделка была оплачена, но продавец не успел подтвердить её за отведенный срок(2 дня) или отказался был отказ от сделки;
  • "CONFIRMED" - этап когда сделка была подтверждена, но продавец не успел отправить товар за отведенный срок(7 дней) или отказался был отказ от сделки;
  • "DELIVERED" - этап когда товар пришел, но покупатель его не успел забарть за отведенный срок(у каждого обработчика может быть свой срок) или отказался от товара
data.sellerFirstNameИмя продавца
data.sellerLastNameФамилия продавца
data.sellerPatronymicОтчество продавца
data.sellerPhoneНомер телефона продавца в формате "380XXXXXXXXX"
data.sellerEmailЭлектронная почта продавца
data.buyerFirstNameИмя покупателя
data.buyerLastNameФамилия покупателя
data.buyerPatronymicОтчество покупателя
data.buyerPhoneНомер телефона покупателя в формате "380XXXXXXXXX"
data.buyerEmailЭлектронная почта покупателя
data.lgЯзык локализации
data.createdAtДата создания сделки
data.adIdID объявления
data.handlerОбъект с данными обработчика
data.handler.typeТип обработчика с помощью которого будет производиться доставка товара
data.handler.status

Статус обработчика, есть всегда и отображает в каком состоянии в данный момент находиться обработчик. Может быть:

  • "NEW" - новый обработчик, первоначальный статус;
  • "CREATED" - создан ТТН(или что-то подобное) по которому будет отправлен товар;
  • "SENT" - товар отправлен;
  • "DELIVERED" - товар прибыл;
  • "FINISHED" - покупатель забрал товар;
  • "CANCELED" - ТТН(или что-то подобное) отменен и удален;
  • "REJECTED" - товар отклонен покупателем;
  • "EXPIRED" - превышен срок ожидания, для того чтобы забрать товар
data.handler.statusCodeСтатус код обработчика в системе выбранного обработчика
data.handler.statusTextТекстовый статус обработчика в системе выбранного обработчика
data.handler.waybillNumberНомер ТТН(или что-то подобного) в системе выбранного обработчика
data.handler.senderCityIdID города в системе выбранного обработчика с которого будет/была осуществлена отправка
data.handler.senderCityNameТекстовое название города в системе выбранного обработчика с которого будет/была осуществлена отправка
data.handler.senderOfficeIdID отделения/офиса в системе выбранного обработчика с которого будет/была осуществлена отправка
data.handler.senderOfficeNameТекстовое название отделения/офиса в системе выбранного обработчика с которого будет/была осуществлена отправка
data.handler.recipientCityIdID города в системе выбранного обработчика в который будет/была осуществлена отправка
data.handler.recipientCityNameТекстовое название города в системе выбранного обработчика в который будет/была осуществлена отправка
data.handler.recipientOfficeIdID отделения/офиса в системе выбранного обработчика в который будет/была осуществлена отправка
data.handler.recipientOfficeNameТекстовое название отделения/офиса в системе выбранного обработчика в который будет/была осуществлена отправка
data.productPaymentОбъект с данными платежа за товар
data.productPayment.typeТип платежной системы платежа
data.productPayment.idID платежа
data.productPayment.amountСумма
data.productPayment.commissionAmountСумма комисси платежа
data.productPayment.status

Статус платежа, есть всегда и отображает в каком состоянии в данный момент находиться платеж. Может быть:

  • "NEW" - новый платеж, первоначальный статус;
  • "PAID" - платеж оплачен покупателем, деньги находятся у платежной системы;
  • "FINISHED" - платеж завершен, деньги зачислены продавцу;
  • "REVERSED" - платеж возвращен, деньги возвращены покупателю; 
  • "REJECTED" - платеж не совершен, ошибка оплаты
data.productPayment.statusCodeСтатус код платежа выбранной платежной системы
data.productPayment.statusTextТекстовый статус платежа выбранной платежной системы
data.productPayment.waitingFor

Статус означающий, что платеж ожидает определенного действия. Может быть:

  • "PAY_PROCESSING" - платеж ожидает пока платежная система совершит оплату(перевод денег платежной системе);
  • "REVERSE_PROCESSING" - платеж ожидает пока платежная система совершит возврат(возврат денег покупателю);
  • "FINISH_PROCESSING" - платеж ожидает пока платежная система совершит завершения(перевод денег продавцу);
  • "CONFIRMATION" - платеж ожидает подтверждения платежа покупателем, шаг перед оплатой 
data.productPayment.detailsОбъект, хранящий дополнительную информацию для платежа. Например: объект для проведения подтверждения платежа пользователем(details.confirmation)
data.productPayment.payReceiptСсылка на квитанцию оплаты платежа
data.productPayment.reverseReceiptСсылка на квитанцию возврата платежа
data.productPayment.finishReceiptСсылка на квитанцию завершения платежа
data.handlerPaymentОбъект с данными платежа за доставку
data.handlerPayment.typeТип платежной системы платежа
data.handlerPayment.idID платежа
data.handlerPayment.amountСумма платежа
data.handlerPayment.commissionAmountСумма комисси платежа
data.handlerPayment.status

Статус платежа, есть всегда и отображает в каком состоянии в данный момент находиться платеж. Может быть:

  • "NEW" - новый платеж, первоначальный статус;
  • "PAID" - платеж оплачен покупателем, деньги находятся у платежной системы;
  • "FINISHED" - платеж завершен, деньги зачислены обработчику;
  • "REVERSED" - платеж возвращен, деньги возвращены покупателю; 
  • "REJECTED" - платеж не совершен, ошибка оплаты
data.handlerPayment.statusCodeСтатус код платежа выбранной платежной системы
data.handlerPayment.statusTextТекстовый статус платежа выбранной платежной системы
data.handlerPayment.waitingFor

Статус означающий, что платеж ожидает определенного действия. Может быть:

  • "PAY_PROCESSING" - платеж ожидает пока платежная система совершит оплату(перевод денег платежной системе);
  • "REVERSE_PROCESSING" - платеж ожидает пока платежная система совершит возврат(возврат денег покупателю);
  • "FINISH_PROCESSING" - платеж ожидает пока платежная система совершит завершения(перевод денег обработчику);
  • "CONFIRMATION" - платеж ожидает подтверждения платежа покупателем, шаг перед оплатой 
data.handlerPayment.detailsОбъект, хранящий дополнительную информацию для платежа. Например: объект для проведения подтверждения платежа пользователем(details.confirmation)
data.handlerPayment.payReceiptСсылка на квитанцию оплаты платежа
data.handlerPayment.reverseReceiptСсылка на квитанцию возврата платежа
data.handlerPayment.finishReceiptСсылка на квитанцию завершения платежа

Пример:

Code Block
languagejs
{
    "data": {
        "id": "L8M95ER",
        "externalId": "myExternalId537916",
        "cartId": 338,
        "productTitle": "Стол",
        "productPrice": 100000,
        "productWeight": 15000,
        "handlerPrice": null,
        "status": "NEW",
        "reasonStep": null,
        "buyerFirstName": "Петро",
        "buyerLastName": "Петров",
        "buyerPatronymic": "Петрович",
        "buyerPhone": "380987654321",
        "buyerEmail": "petrov@mail.test",
        "sellerFirstName": "Иван",
        "sellerLastName": "Иванов",
        "sellerPatronymic": "Иванович",
        "sellerPhone": "380123456789",
        "sellerEmail": "ivanov@mail.test",
        "lg": "uk",
        "createdAt": "2018-10-08T09:18:45.000Z",
        "adId": null,
        "handler": {
            "status": "NEW",
            "statusCode": null,
            "statusText": null,
            "waybillNumber": null,
            "senderCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
            "senderCityName": null,
            "senderOfficeId": "7b2cc7fd-84ff-11e4-acce-0050568002cf",
            "senderOfficeName": null,
            "recipientCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
            "recipientCityName": null,
            "recipientOfficeId": "1ec09d88-e1c2-11e3-8c4a-0050568002cf",
            "recipientOfficeName": null,
            "type": "NovaPoshta"
        },
        "productPayment": {
            "id": 594,
            "amount": null,
            "commissionAmount": null,
            "status": "NEW",
            "statusCode": null,
            "statusText": null,
            "type": "P2P",
            "waitingFor": null,
            "details": null,
            "payReceipt": null,
            "reverseReceipt": null,
            "finishReceipt": null
        },
        "handlerPayment": {
            "id": 593,
            "amount": null,
            "commissionAmount": null,
            "status": "NEW",
            "statusCode": null,
            "statusText": null,
            "type": "ECOM",
            "waitingFor": null,
            "details": null,
            "payReceipt": null,
            "reverseReceipt": null,
            "finishReceipt": null
        }
    }
}