Информация о невыкупе или возврате

Метод доступен для всех моделей.

Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке

Получает информацию по одному невыкупу или возврату.

Подключите API-уведомления

Маркет отправит вам запрос POST notification, когда появится новый невыкуп или возврат.

Как работать с уведомлениями

⚙️ Лимит: 10 000 запросов в час

Request

GET

https://api.partner.market.yandex.ru/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}

Path parameters

Name

Description

campaignId*

Type: integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

Min value: 1

orderId*

Type: integer<int64>

Идентификатор заказа.

returnId*

Type: integer<int64>

Идентификатор возврата.

Responses

200 OK

Детали возврата.

Body

application/json
{
    "status": "OK",
    "result": {
        "id": 0,
        "orderId": 0,
        "creationDate": "2020-02-02T14:30:30+03:00",
        "updateDate": "2020-02-02T14:30:30+03:00",
        "refundStatus": "STARTED_BY_USER",
        "logisticPickupPoint": {
            "id": 0,
            "name": "string",
            "address": {
                "country": "Россия",
                "city": "Москва",
                "street": "Стрелецкая улица",
                "house": "9к2",
                "postcode": 123518
            },
            "instruction": "string",
            "type": "WAREHOUSE",
            "logisticPartnerId": 0
        },
        "shipmentRecipientType": "SHOP",
        "shipmentStatus": "CREATED",
        "refundAmount": 0,
        "amount": {
            "value": 0,
            "currencyId": "RUR"
        },
        "items": [
            {
                "marketSku": 0,
                "shopSku": "string",
                "count": 0,
                "decisions": [
                    {
                        "returnItemId": 0,
                        "count": 0,
                        "comment": "string",
                        "reasonType": "BAD_QUALITY",
                        "subreasonType": "USER_DID_NOT_LIKE",
                        "decisionType": "REFUND_MONEY",
                        "refundAmount": 0,
                        "amount": {
                            "value": 0,
                            "currencyId": "RUR"
                        },
                        "partnerCompensation": 0,
                        "partnerCompensationAmount": {
                            "value": 0,
                            "currencyId": "RUR"
                        },
                        "images": [
                            "string"
                        ]
                    }
                ],
                "instances": [
                    {
                        "stockType": "FIT",
                        "status": "CREATED",
                        "cis": "string",
                        "imei": "string"
                    }
                ],
                "tracks": [
                    {
                        "trackCode": "string"
                    }
                ]
            }
        ],
        "returnType": "UNREDEEMED",
        "fastReturn": false
    }
}

Name

Description

result

Type: ReturnDTO

Возврат заказа.

Параметров logisticPickupPoint, shipmentRecipientType и shipmentStatus может не быть в случае возврата:

  • С опцией Быстрый возврат денег за дешевый брак, когда товар остается у покупателя (fastReturn=true).
  • По заказу от бизнеса, если:
    • статус возврата STARTED_BY_USER или WAITING_FOR_DECISION;
    • возврат отменен до передачи товара.

Статус возврата денег refundStatus актуален только для returnType=RETURN.

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

ReturnDTO

Возврат заказа.

Параметров logisticPickupPoint, shipmentRecipientType и shipmentStatus может не быть в случае возврата:

  • С опцией Быстрый возврат денег за дешевый брак, когда товар остается у покупателя (fastReturn=true).
  • По заказу от бизнеса, если:
    • статус возврата STARTED_BY_USER или WAITING_FOR_DECISION;
    • возврат отменен до передачи товара.

Статус возврата денег refundStatus актуален только для returnType=RETURN.

Name

Description

id*

Type: integer<int64>

Идентификатор возврата.

items*

Type: ReturnItemDTO[]

Список товаров в возврате.
Список товаров в возврате.

orderId*

Type: integer<int64>

Номер заказа.

returnType*

Type: ReturnType

Тип заказа для фильтрации:

  • UNREDEEMED — невыкуп.

  • RETURN — возврат.

Если не указать, в ответе будут и невыкупы, и возвраты.

Enum: UNREDEEMED, RETURN

amount

Type: CurrencyValueDTO

Сумма возврата.

creationDate

Type: string<date-time>

Дата создания возврата клиентом.

Формат даты: ISO 8601 со смещением относительно UTC.

Example: 2020-02-02T14:30:30+03:00

fastReturn

Type: boolean

Используется ли опция Быстрый возврат денег за дешевый брак.

Актуально только для returnType=RETURN.

logisticPickupPoint

Type: LogisticPickupPointDTO

Пункт вывоза.

refundAmount

⦸

Type: integer<int64>

Этот параметр устарел

Вместо него используйте amount.

Сумма возврата в копейках.

refundStatus

Type: RefundStatusType

Статус возврата денег:

  • STARTED_BY_USER — создан клиентом из личного кабинета.

  • REFUND_IN_PROGRESS — ждет решение о возврате денег.

  • REFUNDED — по возврату проведены все возвратные денежные транзакции.

  • FAILED — невозможно провести возврат покупателю.

  • WAITING_FOR_DECISION — ожидает решения.

  • DECISION_MADE — по возврату принято решение.

  • REFUNDED_WITH_BONUSES — возврат осуществлен баллами Плюса или промокодом.

  • REFUNDED_BY_SHOP — магазин сделал самостоятельно возврат денег.

  • COMPLETE_WITHOUT_REFUND — возврат денег не требуется.

  • CANCELLED — возврат отменен.

  • UNKNOWN — неизвестный статус.

Enum: STARTED_BY_USER, REFUND_IN_PROGRESS, REFUNDED, FAILED, WAITING_FOR_DECISION, DECISION_MADE, REFUNDED_WITH_BONUSES, REFUNDED_BY_SHOP, CANCELLED, COMPLETE_WITHOUT_REFUND, UNKNOWN

shipmentRecipientType

Type: RecipientType

Способ возврата товара покупателем.

Enum: SHOP, DELIVERY_SERVICE, POST

shipmentStatus

Type: ReturnShipmentStatusType

Статус передачи возврата.

Enum: CREATED, RECEIVED, IN_TRANSIT, READY_FOR_PICKUP, PICKED, LOST, EXPIRED, CANCELLED, FULFILMENT_RECEIVED, PREPARED_FOR_UTILIZATION, NOT_IN_DEMAND, UTILIZED, READY_FOR_EXPROPRIATION, RECEIVED_FOR_EXPROPRIATION, UNKNOWN

updateDate

Type: string<date-time>

Дата обновления возврата.

Формат даты: ISO 8601 со смещением относительно UTC.

Example: 2020-02-02T14:30:30+03:00

ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

ReturnItemDTO

Список товаров в возврате.

Name

Description

count*

Type: integer<int64>

Количество единиц товара.

shopSku*

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

decisions

Type: ReturnDecisionDTO[]

Список решений по возврату.
Решения по возвратам.

instances

Type: ReturnInstanceDTO[]

Список логистических позиций возврата.
Логистическая информация по возврату.

marketSku

Type: integer<int64>

SKU товара на Маркете.

Min value: 1

tracks

Type: TrackDTO[]

Список трек-кодов для почтовых отправлений.
Информация о трек-номерах.

ReturnType

Тип заказа для фильтрации:

  • UNREDEEMED — невыкуп.

  • RETURN — возврат.

Если не указать, в ответе будут и невыкупы, и возвраты.

Type

Description

ReturnType

Enum: UNREDEEMED, RETURN

CurrencyValueDTO

Значение с валютой.

Name

Description

currencyId*

Type: CurrencyType

Валюта.

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

value*

Type: number

Значение.

LogisticPickupPointDTO

Описание пункта вывоза для возврата.

Name

Description

address

Type: PickupAddressDTO

Адрес пункта вывоза.

id

Type: integer<int64>

Идентификатор пункта вывоза.

instruction

Type: string

Дополнительные инструкции к вывозу.

logisticPartnerId

Type: integer<int64>

Идентификатор логистического партнера, к которому относится логистическая точка.

name

Type: string

Название пункта вывоза.

type

Type: LogisticPointType

Тип логистической точки.

Enum: WAREHOUSE, PICKUP_POINT, PICKUP_TERMINAL, PICKUP_POST_OFFICE, PICKUP_MIXED, PICKUP_RETAIL

RefundStatusType

Статус возврата денег:

  • STARTED_BY_USER — создан клиентом из личного кабинета.

  • REFUND_IN_PROGRESS — ждет решение о возврате денег.

  • REFUNDED — по возврату проведены все возвратные денежные транзакции.

  • FAILED — невозможно провести возврат покупателю.

  • WAITING_FOR_DECISION — ожидает решения.

  • DECISION_MADE — по возврату принято решение.

  • REFUNDED_WITH_BONUSES — возврат осуществлен баллами Плюса или промокодом.

  • REFUNDED_BY_SHOP — магазин сделал самостоятельно возврат денег.

  • COMPLETE_WITHOUT_REFUND — возврат денег не требуется.

  • CANCELLED — возврат отменен.

  • UNKNOWN — неизвестный статус.

Type

Description

RefundStatusType

Enum: STARTED_BY_USER, REFUND_IN_PROGRESS, REFUNDED, FAILED, WAITING_FOR_DECISION, DECISION_MADE, REFUNDED_WITH_BONUSES, REFUNDED_BY_SHOP, CANCELLED, COMPLETE_WITHOUT_REFUND, UNKNOWN

RecipientType

Способ возврата товара покупателем:

  • SHOP — в точку возврата магазина.

  • DELIVERY_SERVICE — отправить курьером.

  • POST — почта.

Type

Description

RecipientType

Enum: SHOP, DELIVERY_SERVICE, POST

ReturnShipmentStatusType

Статус передачи возврата:

  • CREATED — возврат создан.

  • RECEIVED — принят у покупателя.

  • IN_TRANSIT — возврат в пути.

  • READY_FOR_PICKUP — возврат готов к выдаче магазину.

  • PICKED — возврат выдан магазину.

  • LOST — возврат утерян при транспортировке.

  • EXPIRED — покупатель не принес товар на возврат вовремя.

  • CANCELLED — возврат отменен.

  • FULFILMENT_RECEIVED — возврат принят на складе Маркета.

  • PREPARED_FOR_UTILIZATION — возврат передан в утилизацию.

  • NOT_IN_DEMAND — возврат не забрали с почты.

  • UTILIZED — возврат утилизирован.

  • READY_FOR_EXPROPRIATION — товары в возврате направлены на перепродажу.

  • RECEIVED_FOR_EXPROPRIATION — товары в возврате приняты для перепродажи.

  • UNKNOWN — неизвестный статус.

Type

Description

ReturnShipmentStatusType

Enum: CREATED, RECEIVED, IN_TRANSIT, READY_FOR_PICKUP, PICKED, LOST, EXPIRED, CANCELLED, FULFILMENT_RECEIVED, PREPARED_FOR_UTILIZATION, NOT_IN_DEMAND, UTILIZED, READY_FOR_EXPROPRIATION, RECEIVED_FOR_EXPROPRIATION, UNKNOWN

ReturnDecisionDTO

Решения по возвратам.

Name

Description

amount

Type: CurrencyValueDTO

Сумма возврата.

comment

Type: string

Комментарий.

count

Type: integer<int32>

Количество единиц товара.

decisionType

Type: ReturnDecisionType

Решение по возврату:

  • REFUND_MONEY — вернуть деньги покупателю.

  • REFUND_MONEY_INCLUDING_SHIPMENT — вернуть деньги за товар и пересылку.

  • REPAIR — отремонтировать товар.

  • REPLACE — заменить товар.

  • SEND_TO_EXAMINATION — взять товар на экспертизу.

  • DECLINE_REFUND — отказать в возврате.

  • OTHER_DECISION — другое решение.

  • UNKNOWN — не указано.

Enum: REFUND_MONEY, REFUND_MONEY_INCLUDING_SHIPMENT, REPAIR, REPLACE, SEND_TO_EXAMINATION, DECLINE_REFUND, OTHER_DECISION, UNKNOWN

images

Type: string[]

Список хеш-кодов фотографий товара от покупателя.

partnerCompensation

⦸

Type: integer<int64>

Этот параметр устарел

Вместо него используйте partnerCompensationAmount.

Компенсация за обратную доставку в копейках.

partnerCompensationAmount

Type: CurrencyValueDTO

Компенсация за обратную доставку.

reasonType

Type: ReturnDecisionReasonType

Причины возврата:

  • BAD_QUALITY — бракованный товар (есть недостатки).

  • DOES_NOT_FIT — товар не подошел.

  • WRONG_ITEM — привезли не тот товар.

  • DAMAGE_DELIVERY — товар поврежден при доставке.

  • LOYALTY_FAIL — невозможно установить виновного в браке/пересорте.

  • CONTENT_FAIL — ошибочное описание товара по вине Маркета.

  • DELIVERY_FAIL — товар не привезли.

  • UNKNOWN — причина не известна.

Enum: BAD_QUALITY, DOES_NOT_FIT, WRONG_ITEM, DAMAGE_DELIVERY, LOYALTY_FAIL, CONTENT_FAIL, DELIVERY_FAIL, UNKNOWN

refundAmount

⦸

Type: integer<int64>

Этот параметр устарел

Вместо него используйте amount.

Сумма возврата в копейках.

returnItemId

Type: integer<int64>

Идентификатор товара в возврате.

subreasonType

Type: ReturnDecisionSubreasonType

Детали причин возврата:

  • DOES_NOT_FIT:

    • USER_DID_NOT_LIKE — товар не понравился.
    • USER_CHANGED_MIND — передумал покупать.
    • DELIVERED_TOO_LONG — передумал покупать из-за длительного срока доставки.

  • BAD_QUALITY:

    • BAD_PACKAGE — заводская упаковка повреждена.
    • DAMAGED — царапины, сколы.
    • NOT_WORKING — не включается, не работает.
    • INCOMPLETENESS — некомплект (не хватает детали в наборе, к товару).
    • WRAPPING_DAMAGED — транспортная упаковка повреждена.
    • ITEM_WAS_USED — следы использования на товаре.
    • BROKEN — товар разбит.
    • BAD_FLOWERS — некачественные цветы.

  • WRONG_ITEM:

    • WRONG_ITEM — не тот товар.
    • WRONG_COLOR — цвет не соответствует заявленному.
    • DID_NOT_MATCH_DESCRIPTION — описание или характеристики не соответствуют заявленным.
    • WRONG_ORDER — доставили чужой заказ.
    • WRONG_AMOUNT_DELIVERED — неверное количество товара.
    • PARCEL_MISSING — часть заказа отсутствует.
    • INCOMPLETE — заказ не привезли полностью.

  • UNKNOWN — детали причины не указаны.

Enum: USER_DID_NOT_LIKE, USER_CHANGED_MIND, DELIVERED_TOO_LONG, BAD_PACKAGE, DAMAGED, NOT_WORKING, INCOMPLETENESS, WRONG_ITEM, WRONG_COLOR, DID_NOT_MATCH_DESCRIPTION, WRONG_ORDER, WRONG_AMOUNT_DELIVERED, WRAPPING_DAMAGED, ITEM_WAS_USED, BROKEN, BAD_FLOWERS, PARCEL_MISSING, INCOMPLETE, UNKNOWN

ReturnInstanceDTO

Логистическая информация по возврату.

Name

Description

cis

Type: string

Код идентификации единицы товара в системе «Честный ЗНАК» или «ASL BELGISI» (для продавцов Market Yandex Go).

imei

Type: string

Международный идентификатор мобильного оборудования.

status

Type: ReturnInstanceStatusType

Логистический статус конкретного товара.

Enum: CREATED, RECEIVED, IN_TRANSIT, READY_FOR_PICKUP, PICKED, RECEIVED_ON_FULFILLMENT, CANCELLED, LOST, UTILIZED, PREPARED_FOR_UTILIZATION, EXPROPRIATED, NOT_IN_DEMAND

stockType

Type: ReturnInstanceStockType

Тип остатка на складе.

Enum: FIT, DEFECT, ANOMALY, SURPLUS, EXPIRED, MISGRADING, UNDEFINED, INCORRECT_IMEI, INCORRECT_SERIAL_NUMBER, INCORRECT_CIS, PART_MISSING, NON_COMPLIENT, NOT_ACCEPTABLE, SERVICE, MARKDOWN, DEMO, REPAIR, FIRMWARE, UNKNOWN

TrackDTO

Информация о трек-номерах.

Name

Description

trackCode

Type: string

Трек-код почтового отправления.

CurrencyType

Коды валют. Возможные значения:

  • RUR — российский рубль.
  • UAH — украинская гривна.
  • BYR — белорусский рубль.
  • KZT — казахстанский тенге.
  • UZS — узбекский сум.

Type

Description

CurrencyType

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

PickupAddressDTO

Адрес доставки.

Name

Description

city

Type: string

Город.

Example: Москва

country

Type: string

Страна.

Example: Россия

house

Type: string

Номер дома.

Example: 9к2

postcode

Type: string

Почтовый индекс.

Example: 123518

street

Type: string

Улица.

Example: Стрелецкая улица

LogisticPointType

Тип логистической точки:

  • WAREHOUSE — склад.
  • PICKUP_POINT — обычная точка выдачи заказов (ПВЗ).
  • PICKUP_TERMINAL — постамат.
  • PICKUP_POST_OFFICE — отделение почтовой связи (ОПС).
  • PICKUP_MIXED — торговый зал и пункт выдачи заказов.
  • PICKUP_RETAIL — торговый зал.

Type

Description

LogisticPointType

Enum: WAREHOUSE, PICKUP_POINT, PICKUP_TERMINAL, PICKUP_POST_OFFICE, PICKUP_MIXED, PICKUP_RETAIL

ReturnDecisionType

Решение по возврату:

  • REFUND_MONEY — вернуть деньги покупателю.

  • REFUND_MONEY_INCLUDING_SHIPMENT — вернуть деньги за товар и пересылку.

  • REPAIR — отремонтировать товар.

  • REPLACE — заменить товар.

  • SEND_TO_EXAMINATION — взять товар на экспертизу.

  • DECLINE_REFUND — отказать в возврате.

  • OTHER_DECISION — другое решение.

  • UNKNOWN — не указано.

Type

Description

ReturnDecisionType

Enum: REFUND_MONEY, REFUND_MONEY_INCLUDING_SHIPMENT, REPAIR, REPLACE, SEND_TO_EXAMINATION, DECLINE_REFUND, OTHER_DECISION, UNKNOWN

ReturnDecisionReasonType

Причины возврата:

  • BAD_QUALITY — бракованный товар (есть недостатки).

  • DOES_NOT_FIT — товар не подошел.

  • WRONG_ITEM — привезли не тот товар.

  • DAMAGE_DELIVERY — товар поврежден при доставке.

  • LOYALTY_FAIL — невозможно установить виновного в браке/пересорте.

  • CONTENT_FAIL — ошибочное описание товара по вине Маркета.

  • DELIVERY_FAIL — товар не привезли.

  • UNKNOWN — причина не известна.

Type

Description

ReturnDecisionReasonType

Enum: BAD_QUALITY, DOES_NOT_FIT, WRONG_ITEM, DAMAGE_DELIVERY, LOYALTY_FAIL, CONTENT_FAIL, DELIVERY_FAIL, UNKNOWN

ReturnDecisionSubreasonType

Детали причин возврата:

  • DOES_NOT_FIT:

    • USER_DID_NOT_LIKE — товар не понравился.
    • USER_CHANGED_MIND — передумал покупать.
    • DELIVERED_TOO_LONG — передумал покупать из-за длительного срока доставки.

  • BAD_QUALITY:

    • BAD_PACKAGE — заводская упаковка повреждена.
    • DAMAGED — царапины, сколы.
    • NOT_WORKING — не включается, не работает.
    • INCOMPLETENESS — некомплект (не хватает детали в наборе, к товару).
    • WRAPPING_DAMAGED — транспортная упаковка повреждена.
    • ITEM_WAS_USED — следы использования на товаре.
    • BROKEN — товар разбит.
    • BAD_FLOWERS — некачественные цветы.

  • WRONG_ITEM:

    • WRONG_ITEM — не тот товар.
    • WRONG_COLOR — цвет не соответствует заявленному.
    • DID_NOT_MATCH_DESCRIPTION — описание или характеристики не соответствуют заявленным.
    • WRONG_ORDER — доставили чужой заказ.
    • WRONG_AMOUNT_DELIVERED — неверное количество товара.
    • PARCEL_MISSING — часть заказа отсутствует.
    • INCOMPLETE — заказ не привезли полностью.

  • UNKNOWN — детали причины не указаны.

Type

Description

ReturnDecisionSubreasonType

Enum: USER_DID_NOT_LIKE, USER_CHANGED_MIND, DELIVERED_TOO_LONG, BAD_PACKAGE, DAMAGED, NOT_WORKING, INCOMPLETENESS, WRONG_ITEM, WRONG_COLOR, DID_NOT_MATCH_DESCRIPTION, WRONG_ORDER, WRONG_AMOUNT_DELIVERED, WRAPPING_DAMAGED, ITEM_WAS_USED, BROKEN, BAD_FLOWERS, PARCEL_MISSING, INCOMPLETE, UNKNOWN

ReturnInstanceStatusType

Логистический статус конкретного товара:

  • CREATED — возврат создан.

  • RECEIVED — возврат принят у отправителя.

  • IN_TRANSIT — возврат в пути.

  • READY_FOR_PICKUP — возврат готов к выдаче магазину.

  • PICKED — возврат выдан магазину.

  • RECEIVED_ON_FULFILLMENT — возврат принят на складе Маркета.

  • CANCELLED — возврат отменен.

  • LOST — возврат утерян.

  • UTILIZED — возврат утилизирован.

  • PREPARED_FOR_UTILIZATION — возврат готов к утилизации.

  • EXPROPRIATED — товары в возврате направлены на перепродажу.

  • NOT_IN_DEMAND — возврат не забрали с почты.

Type

Description

ReturnInstanceStatusType

Enum: CREATED, RECEIVED, IN_TRANSIT, READY_FOR_PICKUP, PICKED, RECEIVED_ON_FULFILLMENT, CANCELLED, LOST, UTILIZED, PREPARED_FOR_UTILIZATION, EXPROPRIATED, NOT_IN_DEMAND

ReturnInstanceStockType

Тип остатка на складе:

  • FIT — годный.

  • DEFECT — бракованный.

  • ANOMALY — аномалия.

  • SURPLUS — лишний.

  • EXPIRED — просроченный.

  • MISGRADING — пересортица.

  • UNDEFINED — с неизвестным статусом.

  • INCORRECT_IMEI — товар с некорректным IMEI.

  • INCORRECT_SERIAL_NUMBER — товар с некорректным серийным номером.

  • INCORRECT_CIS — товар с некорректным кодом идентификации единицы товара в системе «Честный ЗНАК» или «ASL BELGISI» (для продавцов Market Yandex Go).

  • PART_MISSING — недостача.

  • NON_COMPLIENT — товар с множественными несоответствиями.

  • NOT_ACCEPTABLE — товар, который Маркет не принимает.

  • SERVICE — сервисный сток.

  • MARKDOWN — уценка.

  • DEMO — демо.

  • REPAIR — ремонт.

  • FIRMWARE — прошивка.

  • UNKNOWN — неизвестный тип товара.

Type

Description

ReturnInstanceStockType

Enum: FIT, DEFECT, ANOMALY, SURPLUS, EXPIRED, MISGRADING, UNDEFINED, INCORRECT_IMEI, INCORRECT_SERIAL_NUMBER, INCORRECT_CIS, PART_MISSING, NON_COMPLIENT, NOT_ACCEPTABLE, SERVICE, MARKDOWN, DEMO, REPAIR, FIRMWARE, UNKNOWN

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

ApiErrorDTO

Общий формат ошибки.

Name

Description

code*

Type: string

Код ошибки.

message

Type: string

Описание ошибки.

401 Unauthorized

В запросе не указаны данные для авторизации.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

420 Method Failure

Превышено ограничение на доступ к ресурсу.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR
Предыдущая
Список невыкупов и возвратов
Следующая
Заявление покупателя