Информация о заказе

Возвращает информацию о заказе.

Получить более подробную информацию о покупателе и его номере телефона можно с помощью запроса GET campaigns/{campaignId}/orders/{orderId}/buyer.

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

Request

GET

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

Path parameters

Name

Description

campaignId*

Type: integer<int64>

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

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

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

orderId*

Type: integer<int64>

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

Responses

200 OK

Информация о заказе.

Body

application/json
{
    "order": {
        "id": 0,
        "status": "PLACING",
        "substatus": "RESERVATION_EXPIRED",
        "creationDate": "23-09-2022 09:12:41",
        "currency": "RUR",
        "itemsTotal": 0,
        "deliveryTotal": 0,
        "buyerItemsTotal": 0,
        "buyerTotal": 0,
        "buyerItemsTotalBeforeDiscount": 0,
        "buyerTotalBeforeDiscount": 0,
        "paymentType": "PREPAID",
        "paymentMethod": "CASH_ON_DELIVERY",
        "fake": false,
        "items": [
            {
                "id": 0,
                "offerId": "string",
                "offerName": "string",
                "price": 0,
                "buyerPrice": 0,
                "buyerPriceBeforeDiscount": 0,
                "priceBeforeDiscount": 0,
                "count": 0,
                "vat": "NO_VAT",
                "shopSku": "string",
                "subsidy": 0,
                "partnerWarehouseId": "string",
                "promos": [
                    {
                        "type": "DIRECT_DISCOUNT",
                        "discount": 0,
                        "subsidy": 0,
                        "shopPromoId": "string",
                        "marketPromoId": "string"
                    }
                ],
                "instances": [
                    {
                        "cis": "string",
                        "cisFull": "string",
                        "uin": "string",
                        "rnpt": "string",
                        "gtd": "string"
                    }
                ],
                "details": [
                    {
                        "itemCount": 0,
                        "itemStatus": "REJECTED",
                        "updateDate": "23-09-2022"
                    }
                ],
                "subsidies": [
                    {
                        "type": "YANDEX_CASHBACK",
                        "amount": 0
                    }
                ],
                "requiredInstanceTypes": [
                    "CIS"
                ]
            }
        ],
        "subsidies": [
            {
                "type": "YANDEX_CASHBACK",
                "amount": 0
            }
        ],
        "delivery": {
            "id": "string",
            "type": "DELIVERY",
            "serviceName": "string",
            "price": 0,
            "deliveryPartnerType": "SHOP",
            "courier": {
                "fullName": "string",
                "phone": "string",
                "phoneExtension": "string",
                "vehicleNumber": "string",
                "vehicleDescription": "string"
            },
            "dates": {
                "fromDate": "23-09-2022",
                "toDate": "23-09-2022",
                "fromTime": "string",
                "toTime": "string",
                "realDeliveryDate": "23-09-2022"
            },
            "region": {
                "id": 0,
                "name": "string",
                "type": "OTHER",
                "parent": {
                    "id": 0,
                    "name": "string",
                    "type": "OTHER",
                    "children": [
                        null
                    ]
                },
                "children": [
                    null
                ]
            },
            "address": {
                "country": "string",
                "postcode": "string",
                "city": "string",
                "district": "string",
                "subway": "string",
                "street": "string",
                "house": "string",
                "block": "string",
                "entrance": "string",
                "entryphone": "string",
                "floor": "string",
                "apartment": "string",
                "phone": "string",
                "recipient": "string",
                "gps": {
                    "latitude": 0,
                    "longitude": 0
                }
            },
            "vat": "NO_VAT",
            "deliveryServiceId": 0,
            "liftType": "NOT_NEEDED",
            "liftPrice": 0,
            "outletCode": "string",
            "outletStorageLimitDate": "23-09-2022",
            "dispatchType": "UNKNOWN",
            "tracks": [
                {
                    "trackCode": "string",
                    "deliveryServiceId": 0
                }
            ],
            "shipments": [
                {
                    "id": 0,
                    "shipmentDate": "23-09-2022",
                    "shipmentTime": "string",
                    "tracks": [
                        {
                            "trackCode": "string",
                            "deliveryServiceId": 0
                        }
                    ],
                    "boxes": [
                        {
                            "id": 0,
                            "fulfilmentId": "string"
                        }
                    ]
                }
            ],
            "estimated": false,
            "eacType": "MERCHANT_TO_COURIER",
            "eacCode": "string"
        },
        "buyer": {
            "id": "string",
            "lastName": "string",
            "firstName": "string",
            "middleName": "string",
            "type": "PERSON"
        },
        "notes": "string",
        "taxSystem": "OSN",
        "cancelRequested": false,
        "expiryDate": "23-09-2022 09:12:41"
    }
}

Name

Description

order

Type: OrderDTO

Заказ.

OrderDTO

Заказ.

Name

Description

buyer

Type: OrderBuyerDTO

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

Параметры id, lastName, firstName и middleName возвращаются, только если вы работаете по модели DBS.
Информация о покупателе с базовыми полями.

buyerItemsTotal

Type: number<decimal>

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

Стоимость всех товаров в заказе в валюте покупателя после применения скидок и без учета стоимости доставки.

buyerItemsTotalBeforeDiscount

Type: number<decimal>

Цена продажи. Стоимость всех товаров в заказе в валюте покупателя до применения скидок и без учета стоимости доставки.

buyerTotal

Type: number<decimal>

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

Стоимость всех товаров в заказе в валюте покупателя после применения скидок и с учетом стоимости доставки.

buyerTotalBeforeDiscount

Type: number<decimal>

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

Стоимость всех товаров в заказе в валюте покупателя до применения скидок и с учетом стоимости доставки (buyerItemsTotalBeforeDiscount + стоимость доставки).

cancelRequested

Type: boolean

Только для модели DBS

Запрошена ли отмена.

creationDate

Type: string<date-dd-MM-yyyy-HH-mm-ss>

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

Формат даты и времени: ДД-ММ-ГГГГ ЧЧ:ММ:СС. Часовой пояс — UTC+03:00 (Москва).

Example: 23-09-2022 09:12:41

currency

Type: CurrencyType

Валюта, в которой указаны цены на товары в заказе.

Принимает значение RUR — российский рубль.

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

delivery

Type: OrderDeliveryDTO

Информация о доставке.

deliveryTotal

Type: number<decimal>

Стоимость доставки.

expiryDate

Type: string<date-dd-MM-yyyy-HH-mm-ss>

Дата, после которой заказ будет отменен, если не сменит статус.

Формат даты: ДД-ММ-ГГГГ.

Example: 23-09-2022 09:12:41

fake

Type: boolean

Тип заказа:

  • false — настоящий заказ покупателя.

  • trueтестовый заказ Маркета.

id

Type: integer<int64>

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

items

Type: OrderItemDTO[]

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

itemsTotal

Type: number<decimal>

Платеж покупателя.

notes

Type: string

Комментарий к заказу.

paymentMethod

Type: OrderPaymentMethodType

Способ оплаты заказа:

  • Значения, если выбрана оплата при оформлении заказа ("paymentType": "PREPAID"):

    • YANDEX — банковской картой.

    • APPLE_PAY — Apple Pay.

    • GOOGLE_PAY — Google Pay.

    • CREDIT — в кредит.

    • TINKOFF_CREDIT — в кредит в Тинькофф Банке.

    • TINKOFF_INSTALLMENTS — рассрочка в Тинькофф Банке.

    • EXTERNAL_CERTIFICATE — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»).

    • SBP — через систему быстрых платежей.

    • B2B_ACCOUNT_PREPAYMENT — заказ оплачивает организация.

  • Значения, если выбрана оплата при получении заказа ("paymentType": "POSTPAID"):

    • CARD_ON_DELIVERY — банковской картой.

    • CASH_ON_DELIVERY — наличными.

    • B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

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

Значение по умолчанию: CASH_ON_DELIVERY.

Enum: CASH_ON_DELIVERY, CARD_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

paymentType

Type: OrderPaymentType

Тип оплаты заказа:

  • PREPAID — оплата при оформлении заказа.

  • POSTPAID — оплата при получении заказа.

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

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

Enum: PREPAID, POSTPAID, UNKNOWN

status

Type: OrderStatusType

Статус заказа:

  • CANCELLED — отменен.

  • DELIVERED — получен покупателем.

  • DELIVERY — передан в службу доставки.

  • PICKUP — доставлен в пункт самовывоза.

  • PROCESSING — находится в обработке.

  • PENDING — ожидает обработки со стороны продавца.

  • UNPAID — оформлен, но еще не оплачен (если выбрана оплата при оформлении).

  • PLACING — оформляется, подготовка к резервированию.

  • RESERVED — зарезервирован, но недооформлен.

  • PARTIALLY_RETURNED — возвращен частично.

  • RETURNED — возвращен полностью.

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

Также могут возвращаться другие значения. Обрабатывать их не требуется.

Enum: PLACING, RESERVED, UNPAID, PROCESSING, DELIVERY, PICKUP, DELIVERED, CANCELLED, PENDING, PARTIALLY_RETURNED, RETURNED, UNKNOWN

subsidies

Type: OrderSubsidyDTO[]

Список субсидий по типам.
Общее вознаграждение партнеру за DBS-доставку и все скидки на товар:

  • по промокодам, купонам и акциям;
  • по баллам Плюса;
  • по доставке (DBS).

Передается в валюте заказа.

substatus

Type: OrderSubstatusType

Этап обработки заказа (если он имеет статус PROCESSING) или причина отмены заказа (если он имеет статус CANCELLED).

  • Значения для заказа в статусе PROCESSING:

    • STARTED — заказ подтвержден, его можно начать обрабатывать.

    • READY_TO_SHIP — заказ собран и готов к отправке.

  • Значения для заказа в статусе CANCELLED:

    • PROCESSING_EXPIRED — значение более не используется.

    • REPLACING_ORDER — покупатель решил заменить товар другим по собственной инициативе.

    • RESERVATION_EXPIRED — покупатель не завершил оформление зарезервированного заказа в течение 10 минут.

    • SHOP_FAILED — магазин не может выполнить заказ.

    • USER_CHANGED_MIND — покупатель отменил заказ по личным причинам.

    • USER_NOT_PAID — покупатель не оплатил заказ (для типа оплаты PREPAID) в течение 30 минут.

    • USER_REFUSED_DELIVERY — покупателя не устроили условия доставки.

    • USER_REFUSED_PRODUCT — покупателю не подошел товар.

    • USER_REFUSED_QUALITY — покупателя не устроило качество товара.

    • USER_UNREACHABLE — не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия:

      • не менее 3 звонков с 8 до 21 в часовом поясе покупателя;
      • перерыв между первым и третьим звонком не менее 90 минут;
      • соединение не короче 5 секунд.

      Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400.

  • TECHNICAL_ERROR — техническая ошибка на стороне Маркета. Обратитесь в поддержку.

Также могут возвращаться другие значения. Обрабатывать их не требуется.

Enum: RESERVATION_EXPIRED, USER_NOT_PAID, USER_UNREACHABLE, USER_CHANGED_MIND, USER_REFUSED_DELIVERY, USER_REFUSED_PRODUCT, SHOP_FAILED, USER_REFUSED_QUALITY, REPLACING_ORDER, PROCESSING_EXPIRED, PENDING_EXPIRED, SHOP_PENDING_CANCELLED, PENDING_CANCELLED, USER_FRAUD, RESERVATION_FAILED, USER_PLACED_OTHER_ORDER, USER_BOUGHT_CHEAPER, MISSING_ITEM, BROKEN_ITEM, WRONG_ITEM, PICKUP_EXPIRED, DELIVERY_PROBLEMS, LATE_CONTACT, CUSTOM, DELIVERY_SERVICE_FAILED, WAREHOUSE_FAILED_TO_SHIP, DELIVERY_SERIVCE_UNDELIVERED, DELIVERY_SERVICE_UNDELIVERED, PREORDER, AWAIT_CONFIRMATION, STARTED, PACKAGING, READY_TO_SHIP, SHIPPED, ASYNC_PROCESSING, USER_REFUSED_TO_PROVIDE_PERSONAL_DATA, WAITING_USER_INPUT, WAITING_BANK_DECISION, BANK_REJECT_CREDIT_OFFER, CUSTOMER_REJECT_CREDIT_OFFER, CREDIT_OFFER_FAILED, AWAIT_DELIVERY_DATES_CONFIRMATION, SERVICE_FAULT, DELIVERY_SERVICE_RECEIVED, USER_RECEIVED, WAITING_FOR_STOCKS, AS_PART_OF_MULTI_ORDER, READY_FOR_LAST_MILE, LAST_MILE_STARTED, ANTIFRAUD, DELIVERY_USER_NOT_RECEIVED, DELIVERY_SERVICE_DELIVERED, DELIVERED_USER_NOT_RECEIVED, USER_WANTED_ANOTHER_PAYMENT_METHOD, USER_RECEIVED_TECHNICAL_ERROR, USER_FORGOT_TO_USE_BONUS, RECEIVED_ON_DISTRIBUTION_CENTER, DELIVERY_SERVICE_NOT_RECEIVED, DELIVERY_SERVICE_LOST, SHIPPED_TO_WRONG_DELIVERY_SERVICE, DELIVERED_USER_RECEIVED, WAITING_TINKOFF_DECISION, COURIER_SEARCH, COURIER_FOUND, COURIER_IN_TRANSIT_TO_SENDER, COURIER_ARRIVED_TO_SENDER, COURIER_RECEIVED, COURIER_NOT_FOUND, COURIER_NOT_DELIVER_ORDER, COURIER_RETURNS_ORDER, COURIER_RETURNED_ORDER, WAITING_USER_DELIVERY_INPUT, PICKUP_SERVICE_RECEIVED, PICKUP_USER_RECEIVED, CANCELLED_COURIER_NOT_FOUND, COURIER_NOT_COME_FOR_ORDER, DELIVERY_NOT_MANAGED_REGION, INCOMPLETE_CONTACT_INFORMATION, INCOMPLETE_MULTI_ORDER, INAPPROPRIATE_WEIGHT_SIZE, TECHNICAL_ERROR, SORTING_CENTER_LOST, COURIER_SEARCH_NOT_STARTED, LOST, AWAIT_PAYMENT, AWAIT_LAVKA_RESERVATION, USER_WANTS_TO_CHANGE_ADDRESS, FULL_NOT_RANSOM, PRESCRIPTION_MISMATCH, DROPOFF_LOST, DROPOFF_CLOSED, DELIVERY_TO_STORE_STARTED, USER_WANTS_TO_CHANGE_DELIVERY_DATE, WRONG_ITEM_DELIVERED, DAMAGED_BOX, AWAIT_DELIVERY_DATES, LAST_MILE_COURIER_SEARCH, PICKUP_POINT_CLOSED, LEGAL_INFO_CHANGED, USER_HAS_NO_TIME_TO_PICKUP_ORDER, DELIVERY_CUSTOMS_ARRIVED, DELIVERY_CUSTOMS_CLEARED, FIRST_MILE_DELIVERY_SERVICE_RECEIVED, AWAIT_AUTO_DELIVERY_DATES, AWAIT_USER_PERSONAL_DATA, NO_PERSONAL_DATA_EXPIRED, CUSTOMS_PROBLEMS, AWAIT_CASHIER, WAITING_POSTPAID_BUDGET_RESERVATION, AWAIT_SERVICEABLE_CONFIRMATION, POSTPAID_BUDGET_RESERVATION_FAILED, AWAIT_CUSTOM_PRICE_CONFIRMATION, UNKNOWN

taxSystem

Type: OrderTaxSystemType

Система налогообложения (СНО) магазина на момент оформления заказа:

  • ECHN — единый сельскохозяйственный налог (ЕСХН).

  • ENVD — единый налог на вмененный доход (ЕНВД).

  • OSN — общая система налогообложения (ОСН).

  • PSN — патентная система налогообложения (ПСН).

  • USN — упрощенная система налогообложения (УСН).

  • USN_MINUS_COST — упрощенная система налогообложения, доходы, уменьшенные на величину расходов (УСН «Доходы минус расходы»).

  • NPD — налог на профессиональный доход (НПД).

  • UNKNOWN_VALUE — неизвестное значение. Используется только совместно с параметром payment-method=YANDEX.

Enum: OSN, USN, USN_MINUS_COST, ENVD, ECHN, PSN, NPD, UNKNOWN_VALUE

OrderBuyerDTO

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

Параметры id, lastName, firstName и middleName возвращаются, только если вы работаете по модели DBS.

Name

Description

firstName

Type: string

Имя покупателя.

id

Type: string

Идентификатор покупателя.

lastName

Type: string

Фамилия покупателя.

middleName

Type: string

Отчество покупателя.

type

Type: OrderBuyerType

Тип покупателя: физическое лицо или организация. Этот параметр используется FBS- и FBY-магазинами, размещающими товары на витрине business.market.yandex.ru.

Enum: PERSON, BUSINESS

CurrencyType

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

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

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

OrderDeliveryDTO

Информация о доставке.

Name

Description

address

Type: OrderDeliveryAddressDTO

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

Указывается, если type=DELIVERY, type=POST или type=PICKUP (адрес пункта выдачи).

courier

Type: OrderCourierDTO

Информация о курьере.

dates

Type: OrderDeliveryDatesDTO

Диапазон дат доставки.

deliveryPartnerType

Type: OrderDeliveryPartnerType

Тип сотрудничества со службой доставки в рамках конкретного заказа.

Enum: SHOP, YANDEX_MARKET, UNKNOWN

deliveryServiceId

Type: integer<int64>

Идентификатор службы доставки.

dispatchType

Type: OrderDeliveryDispatchType

Способ отгрузки:

  • BUYER — доставка покупателю.

  • MARKET_PARTNER_OUTLET — доставка в пункт выдачи партнера.

  • MARKET_BRANDED_OUTLET — доставка в пункт выдачи заказов Маркета.

  • SHOP_OUTLET — доставка в пункт выдачи заказов магазина.

  • DROPOFF — доставка в пункт выдачи, который принимает заказы от продавцов и передает их курьерам.

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

Enum: UNKNOWN, BUYER, MARKET_PARTNER_OUTLET, MARKET_BRANDED_OUTLET, SHOP_OUTLET, DROPOFF

eacCode

Type: string

Код подтверждения ЭАПП (для типа MERCHANT_TO_COURIER).

eacType

Type: OrderDeliveryEacType

Тип кода подтверждения ЭАПП.

Enum: MERCHANT_TO_COURIER, COURIER_TO_MERCHANT, CHECKING_BY_MERCHANT

estimated

Type: boolean

Приблизительная ли дата доставки.

id

Type: string

Идентификатор доставки, присвоенный магазином.

Указывается, только если магазин передал данный идентификатор в ответе на запрос методом POST cart.

liftPrice

Type: number<decimal>

Стоимость подъема на этаж.

liftType

Type: OrderLiftType

Тип подъема заказа на этаж:

  • NOT_NEEDED — не требуется.

  • MANUAL — ручной.

  • ELEVATOR — лифт.

  • CARGO_ELEVATOR — грузовой лифт.

  • FREE — любой из перечисленных выше, если включена опция бесплатного подъема.

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

Enum: NOT_NEEDED, MANUAL, ELEVATOR, CARGO_ELEVATOR, FREE, UNKNOWN

outletCode

Type: string

Идентификатор пункта самовывоза, присвоенный магазином.

outletStorageLimitDate

Type: string<date-dd-MM-yyyy>

Дата, до которой заказ будет храниться в пункте выдачи. Возвращается, когда заказ переходит в статус PICKUP.

Один раз дату можно поменять с помощью метода PUT campaigns/{campaignId}/orders/{orderId}/delivery/storage-limit.

Example: 23-09-2022

price

Type: number<decimal>

Этот параметр устарел. Стоимость доставки смотрите в параметре deliveryTotal.

Стоимость доставки в валюте заказа.

region

Type: RegionDTO

Регион доставки.

serviceName

Type: string

Наименование службы доставки.

shipments

Type: OrderShipmentDTO[]

Информация о посылках.
Список посылок.

В параметре может указываться несколько посылок.

tracks

Type: OrderTrackDTO[]

Информация для отслеживания перемещений посылки.
Информация о трек-номере посылки (DBS).

type

Type: OrderDeliveryType

Способ доставки заказа.

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

vat

Type: OrderVatType

Ставка налога на добавленную стоимость (НДС) на товар:

  • NO_VAT — НДС не облагается, используется только для отдельных видов услуг.

  • VAT_0 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.

  • VAT_10 — НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.

  • VAT_10_110 — НДС 10/110. Расчетная ставка НДС 10%, применяется только при предоплате.

  • VAT_20 — НДС 20%. Основная ставка с 2019 года.

  • VAT_20_120 — НДС 20/120. Расчетная ставка НДС 20%, применяется только при предоплате.

  • VAT_18 — НДС 18%. Основная ставка до 2019 года.

  • VAT_18_118 — НДС 18/118. Ставка использовалась до 1 января 2019 года при предоплате.

  • UNKNOWN_VALUE — неизвестный тип.

Используется только совместно с параметром payment-method=YANDEX.

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, UNKNOWN_VALUE

OrderItemDTO

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

Name

Description

buyerPrice

Type: number<decimal>

Цена на товар в валюте покупателя. В цене уже учтены скидки по:

  • акциям;
  • купонам;
  • промокодам.

buyerPriceBeforeDiscount

Type: number<decimal>

Цена продажи. Стоимость товара в валюте покупателя до применения скидок.

count

Type: integer

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

details

Type: OrderItemDetailDTO[]

Информация об удалении товара из заказа.
Детали по товару в заказе.

id

Type: integer<int64>

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

Позволяет идентифицировать товар в рамках данного заказа.

instances

Type: OrderItemInstanceDTO[]

Информация о маркировке единиц товара.

Возвращаются данные для маркировки, переданные в запросе PUT campaigns/{campaignId}/orders/{orderId}/cis.

Если магазин еще не передавал коды для этого заказа, instances отсутствует.
Переданные вами для данной позиции коды маркировки или УИНы. Коды «Честного знака» возвращаются в двух вариантах — с криптохвостом и без.

offerId

Type: string

Идентификатор вашего товарного предложения для определенного товара. Описание поля в Справке Маркета для продавцов

Min length: 1

Max length: 255

Pattern: ^[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

offerName

Type: string

Название товара.

partnerWarehouseId

Type: string

Этот параметр устарел. Не используйте его.

Идентификатор склада в системе партнера, на который сформирован заказ.

price

Type: number<decimal>

Цена на товар в валюте заказа без учета вознаграждения партнеру за скидки по промокодам, купонам и акциям (параметр subsidies).

priceBeforeDiscount

Type: number<decimal>

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

Стоимость товара в валюте магазина до применения скидок.

promos

Type: OrderItemPromoDTO[]

Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.
Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.

requiredInstanceTypes

Type: OrderItemInstanceType[]

Список необходимых маркировок товара.
Вид маркировки товара:

  • CIS — КИЗ, идентификатор единицы товара в системе «Честный ЗНАК».

  • UIN — УИН, уникальный идентификационный номер.

  • RNPT — РНПТ, регистрационный номер партии товара.

  • GTD — номер ГТД, грузовой таможенной декларации.

Enum: CIS, UIN, RNPT, GTD

shopSku

Type: string

Этот параметр устарел. Вместо него используйте offerId.

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

Min length: 1

Max length: 255

Pattern: ^[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

subsidies

Type: OrderItemSubsidyDTO[]

Список субсидий по типам.
Общее вознаграждение партнеру за все скидки на товар:

  • по промокодам, купонам и акциям;
  • по баллам Плюса.

Передается в валюте заказа.

subsidy

Type: number<decimal>

Этот параметр устарел. Вместо него используйте subsidies.

Общее вознаграждение партнеру за DBS-доставку и все скидки на товар:

  • по промокодам;
  • по купонам;
  • по баллам Плюса;
  • по акциям.

Передается в валюте заказа.

vat

Type: OrderVatType

Ставка налога на добавленную стоимость (НДС) на товар.

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, UNKNOWN_VALUE

OrderPaymentMethodType

Способ оплаты заказа:

  • Значения, если выбрана оплата при оформлении заказа ("paymentType": "PREPAID"):

    • YANDEX — банковской картой.

    • APPLE_PAY — Apple Pay.

    • GOOGLE_PAY — Google Pay.

    • CREDIT — в кредит.

    • TINKOFF_CREDIT — в кредит в Тинькофф Банке.

    • TINKOFF_INSTALLMENTS — рассрочка в Тинькофф Банке.

    • EXTERNAL_CERTIFICATE — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»).

    • SBP — через систему быстрых платежей.

    • B2B_ACCOUNT_PREPAYMENT — заказ оплачивает организация.

  • Значения, если выбрана оплата при получении заказа ("paymentType": "POSTPAID"):

    • CARD_ON_DELIVERY — банковской картой.

    • CASH_ON_DELIVERY — наличными.

    • B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

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

Значение по умолчанию: CASH_ON_DELIVERY.

Type

Description

OrderPaymentMethodType

Enum: CASH_ON_DELIVERY, CARD_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

OrderPaymentType

Тип оплаты заказа:

  • PREPAID — оплата при оформлении заказа.

  • POSTPAID — оплата при получении заказа.

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

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

Type

Description

OrderPaymentType

Enum: PREPAID, POSTPAID, UNKNOWN

OrderStatusType

Статус заказа:

  • CANCELLED — отменен.

  • DELIVERED — получен покупателем.

  • DELIVERY — передан в службу доставки.

  • PICKUP — доставлен в пункт самовывоза.

  • PROCESSING — находится в обработке.

  • PENDING — ожидает обработки со стороны продавца.

  • UNPAID — оформлен, но еще не оплачен (если выбрана оплата при оформлении).

  • PLACING — оформляется, подготовка к резервированию.

  • RESERVED — зарезервирован, но недооформлен.

  • PARTIALLY_RETURNED — возвращен частично.

  • RETURNED — возвращен полностью.

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

Также могут возвращаться другие значения. Обрабатывать их не требуется.

Type

Description

OrderStatusType

Enum: PLACING, RESERVED, UNPAID, PROCESSING, DELIVERY, PICKUP, DELIVERED, CANCELLED, PENDING, PARTIALLY_RETURNED, RETURNED, UNKNOWN

OrderSubsidyDTO

Общее вознаграждение партнеру за DBS-доставку и все скидки на товар:

  • по промокодам, купонам и акциям;
  • по баллам Плюса;
  • по доставке (DBS).

Передается в валюте заказа.

Name

Description

amount

Type: number<decimal>

Сумма субсидии.

type

Type: OrderSubsidyType

Тип субсидии:

  • YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.

  • SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.)

  • DELIVERY — скидка за доставку (DBS).

Enum: YANDEX_CASHBACK, SUBSIDY, DELIVERY

OrderSubstatusType

Этап обработки заказа (если он имеет статус PROCESSING) или причина отмены заказа (если он имеет статус CANCELLED).

  • Значения для заказа в статусе PROCESSING:

    • STARTED — заказ подтвержден, его можно начать обрабатывать.

    • READY_TO_SHIP — заказ собран и готов к отправке.

  • Значения для заказа в статусе CANCELLED:

    • PROCESSING_EXPIRED — значение более не используется.

    • REPLACING_ORDER — покупатель решил заменить товар другим по собственной инициативе.

    • RESERVATION_EXPIRED — покупатель не завершил оформление зарезервированного заказа в течение 10 минут.

    • SHOP_FAILED — магазин не может выполнить заказ.

    • USER_CHANGED_MIND — покупатель отменил заказ по личным причинам.

    • USER_NOT_PAID — покупатель не оплатил заказ (для типа оплаты PREPAID) в течение 30 минут.

    • USER_REFUSED_DELIVERY — покупателя не устроили условия доставки.

    • USER_REFUSED_PRODUCT — покупателю не подошел товар.

    • USER_REFUSED_QUALITY — покупателя не устроило качество товара.

    • USER_UNREACHABLE — не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия:

      • не менее 3 звонков с 8 до 21 в часовом поясе покупателя;
      • перерыв между первым и третьим звонком не менее 90 минут;
      • соединение не короче 5 секунд.

      Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400.

  • TECHNICAL_ERROR — техническая ошибка на стороне Маркета. Обратитесь в поддержку.

Также могут возвращаться другие значения. Обрабатывать их не требуется.

Type

Description

OrderSubstatusType

Enum: RESERVATION_EXPIRED, USER_NOT_PAID, USER_UNREACHABLE, USER_CHANGED_MIND, USER_REFUSED_DELIVERY, USER_REFUSED_PRODUCT, SHOP_FAILED, USER_REFUSED_QUALITY, REPLACING_ORDER, PROCESSING_EXPIRED, PENDING_EXPIRED, SHOP_PENDING_CANCELLED, PENDING_CANCELLED, USER_FRAUD, RESERVATION_FAILED, USER_PLACED_OTHER_ORDER, USER_BOUGHT_CHEAPER, MISSING_ITEM, BROKEN_ITEM, WRONG_ITEM, PICKUP_EXPIRED, DELIVERY_PROBLEMS, LATE_CONTACT, CUSTOM, DELIVERY_SERVICE_FAILED, WAREHOUSE_FAILED_TO_SHIP, DELIVERY_SERIVCE_UNDELIVERED, DELIVERY_SERVICE_UNDELIVERED, PREORDER, AWAIT_CONFIRMATION, STARTED, PACKAGING, READY_TO_SHIP, SHIPPED, ASYNC_PROCESSING, USER_REFUSED_TO_PROVIDE_PERSONAL_DATA, WAITING_USER_INPUT, WAITING_BANK_DECISION, BANK_REJECT_CREDIT_OFFER, CUSTOMER_REJECT_CREDIT_OFFER, CREDIT_OFFER_FAILED, AWAIT_DELIVERY_DATES_CONFIRMATION, SERVICE_FAULT, DELIVERY_SERVICE_RECEIVED, USER_RECEIVED, WAITING_FOR_STOCKS, AS_PART_OF_MULTI_ORDER, READY_FOR_LAST_MILE, LAST_MILE_STARTED, ANTIFRAUD, DELIVERY_USER_NOT_RECEIVED, DELIVERY_SERVICE_DELIVERED, DELIVERED_USER_NOT_RECEIVED, USER_WANTED_ANOTHER_PAYMENT_METHOD, USER_RECEIVED_TECHNICAL_ERROR, USER_FORGOT_TO_USE_BONUS, RECEIVED_ON_DISTRIBUTION_CENTER, DELIVERY_SERVICE_NOT_RECEIVED, DELIVERY_SERVICE_LOST, SHIPPED_TO_WRONG_DELIVERY_SERVICE, DELIVERED_USER_RECEIVED, WAITING_TINKOFF_DECISION, COURIER_SEARCH, COURIER_FOUND, COURIER_IN_TRANSIT_TO_SENDER, COURIER_ARRIVED_TO_SENDER, COURIER_RECEIVED, COURIER_NOT_FOUND, COURIER_NOT_DELIVER_ORDER, COURIER_RETURNS_ORDER, COURIER_RETURNED_ORDER, WAITING_USER_DELIVERY_INPUT, PICKUP_SERVICE_RECEIVED, PICKUP_USER_RECEIVED, CANCELLED_COURIER_NOT_FOUND, COURIER_NOT_COME_FOR_ORDER, DELIVERY_NOT_MANAGED_REGION, INCOMPLETE_CONTACT_INFORMATION, INCOMPLETE_MULTI_ORDER, INAPPROPRIATE_WEIGHT_SIZE, TECHNICAL_ERROR, SORTING_CENTER_LOST, COURIER_SEARCH_NOT_STARTED, LOST, AWAIT_PAYMENT, AWAIT_LAVKA_RESERVATION, USER_WANTS_TO_CHANGE_ADDRESS, FULL_NOT_RANSOM, PRESCRIPTION_MISMATCH, DROPOFF_LOST, DROPOFF_CLOSED, DELIVERY_TO_STORE_STARTED, USER_WANTS_TO_CHANGE_DELIVERY_DATE, WRONG_ITEM_DELIVERED, DAMAGED_BOX, AWAIT_DELIVERY_DATES, LAST_MILE_COURIER_SEARCH, PICKUP_POINT_CLOSED, LEGAL_INFO_CHANGED, USER_HAS_NO_TIME_TO_PICKUP_ORDER, DELIVERY_CUSTOMS_ARRIVED, DELIVERY_CUSTOMS_CLEARED, FIRST_MILE_DELIVERY_SERVICE_RECEIVED, AWAIT_AUTO_DELIVERY_DATES, AWAIT_USER_PERSONAL_DATA, NO_PERSONAL_DATA_EXPIRED, CUSTOMS_PROBLEMS, AWAIT_CASHIER, WAITING_POSTPAID_BUDGET_RESERVATION, AWAIT_SERVICEABLE_CONFIRMATION, POSTPAID_BUDGET_RESERVATION_FAILED, AWAIT_CUSTOM_PRICE_CONFIRMATION, UNKNOWN

OrderTaxSystemType

Система налогообложения (СНО) магазина на момент оформления заказа:

  • ECHN — единый сельскохозяйственный налог (ЕСХН).

  • ENVD — единый налог на вмененный доход (ЕНВД).

  • OSN — общая система налогообложения (ОСН).

  • PSN — патентная система налогообложения (ПСН).

  • USN — упрощенная система налогообложения (УСН).

  • USN_MINUS_COST — упрощенная система налогообложения, доходы, уменьшенные на величину расходов (УСН «Доходы минус расходы»).

  • NPD — налог на профессиональный доход (НПД).

  • UNKNOWN_VALUE — неизвестное значение. Используется только совместно с параметром payment-method=YANDEX.

Type

Description

OrderTaxSystemType

Enum: OSN, USN, USN_MINUS_COST, ENVD, ECHN, PSN, NPD, UNKNOWN_VALUE

OrderBuyerType

Тип покупателя:

  • PERSON — физическое лицо.

  • BUSINESS — организация.

Type

Description

OrderBuyerType

Enum: PERSON, BUSINESS

OrderDeliveryAddressDTO

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

Указывается, если type=DELIVERY, type=POST или type=PICKUP (адрес пункта выдачи).

Name

Description

apartment

Type: string

Квартира или офис.

block

Type: string

Корпус или строение.

city

Type: string

Город или населенный пункт.

Обязательный параметр.

country

Type: string

Страна.

Обязательный параметр.

district

Type: string

Район.

entrance

Type: string

Подъезд.

entryphone

Type: string

Код домофона.

floor

Type: string

Этаж.

gps

Type: GpsDTO

GPS-координаты.

house

Type: string

Дом или владение.

Обязательный параметр.

phone

Type: string

Телефон получателя заказа.

Обязательный параметр.

postcode

Type: string

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

Указывается, если выбрана доставка почтой (delivery type=POST).

recipient

Type: string

Фамилия, имя и отчество получателя заказа.

Обязательный параметр.

street

Type: string

Улица.

Обязательный параметр.

subway

Type: string

Станция метро.

OrderCourierDTO

Информация о курьере.

Name

Description

fullName

Type: string

Полное имя курьера.

phone

Type: string

Номер телефона курьера.

phoneExtension

Type: string

Добавочный номер телефона.

vehicleDescription

Type: string

Описание машины. Например, модель и цвет.

vehicleNumber

Type: string

Номер транспортного средства.

OrderDeliveryDatesDTO

Диапазон дат доставки.

Name

Description

fromDate

Type: string<date-dd-MM-yyyy>

Ближайшая дата доставки.

Формат даты: ДД-ММ-ГГГГ.

Example: 23-09-2022

fromTime

Type: string<time>

Начало интервала времени доставки.

Передается только совместно с параметром type=DELIVERY.

Формат времени: 24-часовой, ЧЧ:ММ. В качестве минут всегда должно быть указано 00 (исключение — 23:59).

Минимальное значение: 00:00.

realDeliveryDate

Type: string<date-dd-MM-yyyy>

Дата, когда товар доставлен до пункта выдачи заказа (в случае самовывоза) или до покупателя (если заказ доставляет курьер).

Example: 23-09-2022

toDate

Type: string<date-dd-MM-yyyy>

Самая поздняя дата доставки.

Если параметр toDate не указан, единственно возможной датой доставки считается дата, указанная в параметре fromDate.

Формат даты: ДД-ММ-ГГГГ.

Example: 23-09-2022

toTime

Type: string<time>

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

Передается только совместно с параметром type=DELIVERY.

Формат времени: 24-часовой, ЧЧ:ММ. В качестве минут всегда должно быть указано 00 (исключение — 23:59).

Максимальное значение: 23:59.

OrderDeliveryPartnerType

Тип сотрудничества со службой доставки в рамках конкретного заказа:

  • SHOP — магазин работает со службой доставки напрямую или доставляет заказы самостоятельно.

  • YANDEX_MARKET — магазин работает со службой доставки через Маркет.

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

Type

Description

OrderDeliveryPartnerType

Enum: SHOP, YANDEX_MARKET, UNKNOWN

OrderDeliveryDispatchType

Способ отгрузки:

  • BUYER — доставка покупателю.

  • MARKET_PARTNER_OUTLET — доставка в пункт выдачи партнера.

  • MARKET_BRANDED_OUTLET — доставка в пункт выдачи заказов Маркета.

  • SHOP_OUTLET — доставка в пункт выдачи заказов магазина.

  • DROPOFF — доставка в пункт выдачи, который принимает заказы от продавцов и передает их курьерам.

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

Type

Description

OrderDeliveryDispatchType

Enum: UNKNOWN, BUYER, MARKET_PARTNER_OUTLET, MARKET_BRANDED_OUTLET, SHOP_OUTLET, DROPOFF

OrderDeliveryEacType

Тип кода подтверждения ЭАПП:

  • MERCHANT_TO_COURIER — продавец передает код курьеру.

  • COURIER_TO_MERCHANT — курьер передает код продавцу.

  • CHECKING_BY_MERCHANT — продавец проверяет код на своей стороне.

Type

Description

OrderDeliveryEacType

Enum: MERCHANT_TO_COURIER, COURIER_TO_MERCHANT, CHECKING_BY_MERCHANT

OrderLiftType

Тип подъема заказа на этаж:

  • NOT_NEEDED — не требуется.

  • MANUAL — ручной.

  • ELEVATOR — лифт.

  • CARGO_ELEVATOR — грузовой лифт.

  • FREE — любой из перечисленных выше, если включена опция бесплатного подъема.

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

Type

Description

OrderLiftType

Enum: NOT_NEEDED, MANUAL, ELEVATOR, CARGO_ELEVATOR, FREE, UNKNOWN

RegionDTO

Регион доставки.

Name

Description

name*

Type: string

Название региона.

type*

Type: RegionType

Тип региона.

Enum: OTHER, CONTINENT, REGION, COUNTRY, COUNTRY_DISTRICT, REPUBLIC, CITY, VILLAGE, CITY_DISTRICT, SUBWAY_STATION, REPUBLIC_AREA

children

Type: RegionDTO[]

Дочерние регионы.
Регион доставки.

id

Type: integer<int64>

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

parent

Type: RegionDTO

Информация о родительском регионе.

Указываются родительские регионы до уровня страны.

OrderShipmentDTO

Список посылок.

В параметре может указываться несколько посылок.

Name

Description

boxes

Type: OrderParcelBoxDTO[]

Список грузовых мест.
Информация о грузоместе.

id

Type: integer<int64>

Идентификатор посылки, присвоенный Маркетом.

shipmentDate

Type: string<date-dd-MM-yyyy>

День, в который нужно отгрузить заказ службе доставки.

Формат даты: ДД-ММ-ГГГГ.

Если заказ сделан организацией, параметр не возвращается до согласования даты доставки.

Example: 23-09-2022

shipmentTime

Type: string

Только для модели Экспресс

Время, к которому магазин должен упаковать заказ и перевести его в статус READY_TO_SHIP. После смены статуса за заказом приедет курьер.

Поле может появиться не сразу. Запрашивайте информацию о заказе в течении 5–10 минут, пока оно не вернется.

Формат времени: 24-часовой, ЧЧ:ММ.

Если заказ сделан организацией, параметр не возвращается до согласования даты доставки.

tracks

Type: OrderTrackDTO[]

Только для модели DBS

Информация для отслеживания перемещений посылки.
Информация о трек-номере посылки (DBS).

OrderTrackDTO

Информация о трек-номере посылки (DBS).

Name

Description

deliveryServiceId

Type: integer<int64>

Идентификатор службы доставки. Информацию о службе доставки можно получить с помощью запроса GET delivery/services.

trackCode

Type: string

Трек‑номер посылки.

OrderDeliveryType

Способ доставки заказа:

  • DELIVERY — курьерская доставка.

  • PICKUP — самовывоз.

  • POST — почта.

  • DIGITAL — для цифровых товаров.

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

Type

Description

OrderDeliveryType

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

OrderVatType

Ставка налога на добавленную стоимость (НДС) на товар:

  • NO_VAT — НДС не облагается, используется только для отдельных видов услуг.

  • VAT_0 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.

  • VAT_10 — НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.

  • VAT_10_110 — НДС 10/110. Расчетная ставка НДС 10%, применяется только при предоплате.

  • VAT_20 — НДС 20%. Основная ставка с 2019 года.

  • VAT_20_120 — НДС 20/120. Расчетная ставка НДС 20%, применяется только при предоплате.

  • VAT_18 — НДС 18%. Основная ставка до 2019 года.

  • VAT_18_118 — НДС 18/118. Ставка использовалась до 1 января 2019 года при предоплате.

  • UNKNOWN_VALUE — неизвестный тип.

Используется только совместно с параметром payment-method=YANDEX.

Type

Description

OrderVatType

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, UNKNOWN_VALUE

OrderItemDetailDTO

Детали по товару в заказе.

Name

Description

itemCount

Type: integer<int64>

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

itemStatus

Type: OrderItemStatusType

Возвращенный или невыкупленный товар:

  • REJECTED — невыкупленный.

  • RETURNED — возвращенный.

Enum: REJECTED, RETURNED

updateDate

Type: string<date-dd-MM-yyyy>

Формат даты: ДД-ММ-ГГГГ.

Example: 23-09-2022

OrderItemInstanceDTO

Переданные вами для данной позиции коды маркировки или УИНы. Коды «Честного знака» возвращаются в двух вариантах — с криптохвостом и без.

Name

Description

cis

Type: string

Код идентификации единицы товара в системе «Честный ЗНАК» без криптохвоста.

cisFull

Type: string

Код идентификации единицы товара в системе «Честный ЗНАК» с криптохвостом.

gtd

Type: string

Грузовая таможенная декларация.

Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

rnpt

Type: string

Регистрационный номер партии товара.

Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.

uin

Type: string

УИН ювелирного изделия (16-значный код) Производитель получает УИН, когда регистрирует изделие в системе контроля за оборотом драгоценных металлов и камней — ГИИС ДМДК.

OrderItemPromoDTO

Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.

Name

Description

type*

Type: OrderPromoType

Тип скидки.

Enum: DIRECT_DISCOUNT, BLUE_SET, BLUE_FLASH, GENERIC_BUNDLE, MARKET_COUPON, MARKET_PROMOCODE, MARKET_DEAL, MARKET_BLUE, MARKET_PRIME, YANDEX_PLUS, BERU_PLUS, MARKET_COIN, YANDEX_EMPLOYEE, LIMITED_FREE_DELIVERY_PROMO, FREE_DELIVERY_THRESHOLD, MULTICART_DISCOUNT, PRICE_DROP_AS_YOU_SHOP, FREE_DELIVERY_FOR_LDI, FREE_DELIVERY_FOR_LSC, SECRET_SALE, FREE_PICKUP, CHEAPEST_AS_GIFT, CASHBACK, SUPPLIER_MULTICART_DISCOUNT, SPREAD_DISCOUNT_COUNT, SPREAD_DISCOUNT_RECEIPT, ANNOUNCEMENT_PROMO, DISCOUNT_BY_PAYMENT_TYPE, PERCENT_DISCOUNT, DCO_EXTRA_DISCOUNT, EMPTY_PROMO, BLOCKING_PROMO, UNKNOWN

discount

Type: number<decimal>

Размер пользовательской скидки в валюте покупателя.

marketPromoId

Type: string

Идентификатор акции в рамках соглашения на оказание услуг по продвижению сервиса между Маркетом и партнером.

Параметр передается, только если параметр type=MARKET_DEAL.

shopPromoId

Type: string

Идентификатор акции поставщика.

subsidy

Type: number<decimal>

Вознаграждение партнеру от Маркета за товар, проданный в рамках акции.

Передается в валюте заказа.

OrderItemInstanceType

Вид маркировки товара:

  • CIS — КИЗ, идентификатор единицы товара в системе «Честный ЗНАК».

  • UIN — УИН, уникальный идентификационный номер.

  • RNPT — РНПТ, регистрационный номер партии товара.

  • GTD — номер ГТД, грузовой таможенной декларации.

Type

Description

OrderItemInstanceType

Enum: CIS, UIN, RNPT, GTD

OrderItemSubsidyDTO

Общее вознаграждение партнеру за все скидки на товар:

  • по промокодам, купонам и акциям;
  • по баллам Плюса.

Передается в валюте заказа.

Name

Description

amount

Type: number<decimal>

Сумма субсидии.

type

Type: OrderItemSubsidyType

Тип субсидии:

  • YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.

  • SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.).

Enum: YANDEX_CASHBACK, SUBSIDY

OrderSubsidyType

Тип субсидии:

  • YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.

  • SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.)

  • DELIVERY — скидка за доставку (DBS).

Type

Description

OrderSubsidyType

Enum: YANDEX_CASHBACK, SUBSIDY, DELIVERY

GpsDTO

GPS-координаты широты и долготы.

Name

Description

latitude*

Type: number<decimal>

Широта.

longitude*

Type: number<decimal>

Долгота.

RegionType

Тип региона.

Возможные значения:

  • CITY_DISTRICT — район города.

  • CITY — крупный город.

  • CONTINENT — континент.

  • COUNTRY_DISTRICT — область.

  • COUNTRY — страна.

  • REGION — регион.

  • REPUBLIC_AREA — район субъекта федерации.

  • REPUBLIC — субъект федерации.

  • SUBWAY_STATION — станция метро.

  • VILLAGE — город.

  • OTHER — неизвестный регион.

Type

Description

RegionType

Enum: OTHER, CONTINENT, REGION, COUNTRY, COUNTRY_DISTRICT, REPUBLIC, CITY, VILLAGE, CITY_DISTRICT, SUBWAY_STATION, REPUBLIC_AREA

OrderParcelBoxDTO

Информация о грузоместе.

Name

Description

fulfilmentId

Type: string

Идентификатор грузового места в информационной системе магазина.

id

Type: integer<int64>

Идентификатор грузоместа.

OrderItemStatusType

Возвращенный или невыкупленный товар:

  • REJECTED — невыкупленный.

  • RETURNED — возвращенный.

Type

Description

OrderItemStatusType

Enum: REJECTED, RETURNED

OrderPromoType

Тип скидки:

  • DIRECT_DISCOUNT — прямая скидка, которую устанавливает продавец или Маркет.

  • BLUE_SET — комплекты.

  • BLUE_FLASH — флеш-акция.

  • MARKET_COUPON — скидка по промокоду Маркета.

  • MARKET_PROMOCODE — скидка по промокоду магазина.

  • MARKET_BLUE — скидка на Маркете.

  • YANDEX_PLUS — бесплатная доставка с подпиской Яндекс Плюс.

  • YANDEX_EMPLOYEE — бесплатная доставка по определенным адресам.

  • LIMITED_FREE_DELIVERY_PROMO — бесплатная доставка по ограниченному предложению.

  • FREE_DELIVERY_THRESHOLD — бесплатная доставка при достижении определенной суммы заказа.

  • MULTICART_DISCOUNT — скидка за то, что оформлена мультикорзина.

  • FREE_DELIVERY_FOR_LDI — бесплатная доставка за то, что один из товаров крупногабаритный.

  • FREE_DELIVERY_FOR_LSC — бесплатная доставка за то, что одна из корзин в мультикорзине крупногабаритная.

  • FREE_PICKUP — бесплатная доставка в пункт выдачи заказов.

  • CHEAPEST_AS_GIFT — самый дешевый товар в подарок.

  • CASHBACK — кешбэк.

  • SUPPLIER_MULTICART_DISCOUNT — скидка за доставку.

  • SPREAD_DISCOUNT_COUNT — скидка за количество одинаковых товаров.

  • SPREAD_DISCOUNT_RECEIPT — скидка от суммы чека.

  • ANNOUNCEMENT_PROMO — информационная акция, скидка не применяется к товарам.

  • DISCOUNT_BY_PAYMENT_TYPE — прямая скидка при оплате картой Плюса.

  • PERCENT_DISCOUNT — прямая скидка в процентах.

  • DCO_EXTRA_DISCOUNT — дополнительная скидка, необходимая для расчета субсидии от Маркета.

  • EMPTY_PROMO — скрытые промокоды.

  • BLOCKING_PROMO — блокирующее промо.

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

Неактуальные типы:

  • GENERIC_BUNDLE.

  • MARKET_DEAL.

  • MARKET_PRIME.

  • MARKET_COIN.

  • BERU_PLUS.

  • PRICE_DROP_AS_YOU_SHOP.

  • SECRET_SALE.

Type

Description

OrderPromoType

Enum: DIRECT_DISCOUNT, BLUE_SET, BLUE_FLASH, GENERIC_BUNDLE, MARKET_COUPON, MARKET_PROMOCODE, MARKET_DEAL, MARKET_BLUE, MARKET_PRIME, YANDEX_PLUS, BERU_PLUS, MARKET_COIN, YANDEX_EMPLOYEE, LIMITED_FREE_DELIVERY_PROMO, FREE_DELIVERY_THRESHOLD, MULTICART_DISCOUNT, PRICE_DROP_AS_YOU_SHOP, FREE_DELIVERY_FOR_LDI, FREE_DELIVERY_FOR_LSC, SECRET_SALE, FREE_PICKUP, CHEAPEST_AS_GIFT, CASHBACK, SUPPLIER_MULTICART_DISCOUNT, SPREAD_DISCOUNT_COUNT, SPREAD_DISCOUNT_RECEIPT, ANNOUNCEMENT_PROMO, DISCOUNT_BY_PAYMENT_TYPE, PERCENT_DISCOUNT, DCO_EXTRA_DISCOUNT, EMPTY_PROMO, BLOCKING_PROMO, UNKNOWN

OrderItemSubsidyType

Тип субсидии:

  • YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.

  • SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.).

Type

Description

OrderItemSubsidyType

Enum: YANDEX_CASHBACK, SUBSIDY

400 Bad Request

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

ApiErrorDTO

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

Name

Description

code*

Type: string

Код ошибки.

message

Type: string

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

ApiResponseStatusType

Тип ответа.

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

401 Unauthorized

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

403 Forbidden

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

404 Not Found

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

420 Method Failure

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

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

Тип ответа.

Enum: OK, ERROR