This is possible when responding to a request from the Market POST order/accept The store confirmed acceptance of the order, however, due to a technical glitch, the store's response was not recorded by the Market. Since it is not known whether the order acceptance request has reached the store or not, the Market can repeat this request. A response is expected from the store confirming the acceptance of this order.
When a new order appears, the Market sends you a request. If you do not respond to it within 10 seconds, the Market will start repeating the request. The first 3 times — Every minute after that — every 10 minutes.
If you do not respond to four repeated requests, the Market will shut down the store and your products will disappear from the showcase. To connect again, correctly respond to all real or verification Market requests for order creation. — acceptance or cancellation. After that, your products will be returned to the showcase automatically.
Features of transferring data for orders to the Market pick-up point (DBS)
If the customer has chosen to deliver the order to a branded Market pick-up point, the request will be received without the parameter outlet. Type of delivery type corresponds to the value PICKUP. The address and date of delivery to the pick-up point will be shown in the elements address and dates.
The price of the product in the buyer's currency. The price already includes discounts on:
shares;
coupons;
promo codes.
Backward compatibility
The outdated parameter is also filled in. buyer-price. Use the parameter buyerPrice.
buyerPriceBeforeDiscount
Type: number
The cost of the product in the buyer's currency before applying the discounts.
count
Type: integer
The number of product units.
delivery
Type: boolean
For the model only FBS
Delivery of the product to the region specified in the request:
false — The product is not being delivered to the specified region.
true — The default value is that the product is delivered to the specified region.
Takes the value that you passed in the parameter delivery, embedded in items, in response to the request POST cart.
feedCategoryId
Type: string
For the model only DBS
The ID of the category specified in the folder.
Example:example
feedId
Type: integer
ID of the product catalog.
fulfilmentShopId
Type: integer
The product supplier's ID.
To find out, log in to the seller's account on the Market and click on its name. The ID is specified in the field Store ID in the row of the desired warehouse.
id
Type: integer
The product ID in the order.
Allows you to identify the product within the order.
instances
Type: object[]
cis
Type: string
The unit identification code in the system "An honest SIGN" without a cryptotail or «ASL BELGISI» (for sellers of the Yandex Go Market).
Example:example
cisFull
Type: string
The unit identification code in the system "An honest SIGN" with a cryptotail.
Example:example
countryCode
Type: string
The country of manufacture is in the ISO 3166-1 alpha-2 format. How to get
Min length:2
Max length:2
Pattern:^[A-Z]{2}$
Example:RU
gtd
Type: string
Cargo customs declaration.
It is a string of three numbers separated by a slash: XXXXXXXXXX/XXXXXXXX/XXXXXXXX.
The first part — the code of the customs office that registered the declaration for imported goods. Further — date and number of the declaration.
Example:example
rnpt
Type: string
The registration number of the product batch.
It is a string of four numbers separated by slashes: XXXXXXXXXX/XXXXXXXX/XXXXXXXX/XXX.
The first part — the code of the customs office that registered the declaration for the shipment. Further — the date, number of the declaration and the number of the marked product in the declaration.
Example:example
uin
Type: string
Jewelry's UIN (16-digit code)
The manufacturer receives a WIN when he registers the product in the control system for the turnover of precious metals and stones. — GIIS DMDK.
Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.
The ID of the warehouse in the store's system that the order was placed for.
Example:example
price
Type: number
The price of the product in the order currency, excluding remuneration to the seller for discounts on promo codes, coupons and promotions (parameter subsidy).
priceBeforeDiscount
Type: number
The cost of the product in the store's currency before applying the discounts.
promos
Type: object[]
type
Type: string
Discount type:
DIRECT_DISCOUNT — direct discount, which is set by the seller or the Market.
BLUE_SET — kits.
BLUE_FLASH — a flash promotion.
MARKET_COUPON — discount using the Yandex.Market promo code.
MARKET_PROMOCODE — discount on the store's promo code.
MARKET_BLUE — discount on Yandex. Market.
CHEAPEST_AS_GIFT — the cheapest item as a gift.
CASHBACK — cashback.
SPREAD_DISCOUNT_COUNT — discount for the number of identical items.
SPREAD_DISCOUNT_RECEIPT — discount on the receipt amount.
DISCOUNT_BY_PAYMENT_TYPE — direct discount when paying with a Plus card.
PERCENT_DISCOUNT — direct percentage discount.
DCO_EXTRA_DISCOUNT — an additional discount required to calculate the subsidy from the Market.
The identifier of the promotion within the framework of the agreement for the provision of services for the promotion of the service between the Market and the seller.
Example:example
subsidy
Type: number
Remuneration to the seller from the Market for the product sold as part of the promotion.
Information about the remuneration to the seller for discounts on goods using promo codes, coupons, and promotions.
Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.
Total remuneration to the seller for all discounts on the product:
by promo codes;
by coupons;
by Plus points;
on shares.
tags
Type: string[]
Product attributes.
Example
["ULTIMA"]
vat
Type: string
VAT on the product or delivery:
NO_VAT — VAT is not charged, it is used only for certain types of services.
VAT_0 — 0% VAT. For example, it is used for the sale of goods exported in the customs procedure of export, or for the provision of services for the international transportation of goods.
VAT_10 — 10% VAT. For example, it is used in the sale of certain food and medical products.
VAT_10_110 — VAT 10/110. 10% VAT, applicable only for prepayment.
VAT_20 — VAT 20%. Basic VAT from 2019 to January 1, 2026.
VAT_20_120 — VAT 20/120. VAT is 20%, applicable only for prepayment.
VAT_18 — VAT 18%. Basic VAT until 2019.
VAT_18_118 — VAT 18/118. VAT was used until January 1, 2019 for prepayment.
VAT_12 — VAT is 12%. It is used only in Uzbekistan.
VAT_05 — VAT is 5%. VAT for the simplified taxation system (USN).
VAT_07 — VAT is 7%. VAT for the simplified taxation system (USN).
VAT_22 — VAT is 22%. Basic VAT starting from January 1, 2026.
The total amount of the order in the order currency, excluding the cost of delivery and remuneration to the seller for discounts on promo codes, coupons and promotions (parameter subsidyTotal).
notes
Type: string
Comment on the order.
Example:example
paymentMethod
Type: string
Payment method for the order:
Values if payment is selected at checkout ("paymentType": "PREPAID"):
YANDEX — by bank card.
APPLE_PAY — Apple Pay (not in use).
GOOGLE_PAY — Google Pay (not in use).
CREDIT — on credit.
TINKOFF_CREDIT — on credit from Tinkoff Bank.
TINKOFF_INSTALLMENTS — installments at Tinkoff Bank.
EXTERNAL_CERTIFICATE — with a gift certificate (for example, from the Sberbank Online application).
SBP — through the fast payment system.
B2B_ACCOUNT_PREPAYMENT — The organization pays for the order.
Values if payment is selected upon receipt of the order ("paymentType": "POSTPAID"):
CARD_ON_DELIVERY — by bank card.
BOUND_CARD_ON_DELIVERY — with a linked bank card upon receipt.
BNPL_BANK_ON_DELIVERY — super Split.
BNPL_ON_DELIVERY — Split.
CASH_ON_DELIVERY — in cash.
B2B_ACCOUNT_POSTPAYMENT — the order is paid for by the organization after delivery.
Order processing stage (status PROCESSING) or the reason for the cancellation of the order (status CANCELLED).
Order values in the status PROCESSING:
STARTED — The order has been confirmed, and it can be processed.
READY_TO_SHIP — the order is assembled and ready for shipment.
Order values in the status CANCELLED:
RESERVATION_EXPIRED — The customer did not complete the reserved order within 10 minutes.
USER_NOT_PAID — the buyer did not pay for the order (for the payment type PREPAID) for 30 minutes.
USER_UNREACHABLE — couldn't contact the buyer. To cancel with this reason, the following conditions must be met:
at least 3 calls from 8 to 21 in the buyer's time zone;
the break between the first and third calls is at least 90 minutes;
the connection is no shorter than 5 seconds.
If at least one of these conditions is not met (except when the number is unavailable), you will not be able to cancel the order. A response with the error code 400 will be returned.
USER_CHANGED_MIND — the customer cancelled the order for personal reasons.
USER_REFUSED_DELIVERY — the buyer was not satisfied with the terms of delivery.
USER_REFUSED_PRODUCT — the product did not fit the buyer.
SHOP_FAILED — the store cannot complete the order.
USER_REFUSED_QUALITY — the buyer was not satisfied with the quality of the product.
REPLACING_ORDER — the buyer decided to replace the product with another one on his own initiative.
PROCESSING_EXPIRED — the value is no longer used.
PICKUP_EXPIRED — The shelf life of the order at the pick-up point has expired.
TOO_MANY_DELIVERY_DATE_CHANGES — the order has been postponed too many times.
TOO_LONG_DELIVERY — The order is taking too long to be delivered.
INCORRECT_PERSONAL_DATA — For an order from abroad, the recipient's information is incorrect, and the order will not be checked at customs.
TECHNICAL_ERROR — a technical error on the Market's side. Contact support.
Other values may also be returned. You don't need to process them.
The total amount of the order in the currency of the order, including the cost of delivery, but excluding remuneration to the seller for discounts on promo codes, coupons, cashback and promotions (parameter subsidyTotal).
totalWithSubsidy
Type: number
The sum of the cost of all the goods in the order and the remuneration for them in the store's currency (the sum of the parameters total and subsidyTotal).
A flag that indicates that the delivery date for the order has not been confirmed. It is transmitted for products on order with a long delivery time (31-60 days). The final delivery date must be sent to Yandex.Market within 7 days from the date the order was placed in the request. PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/date.
liftPrice
Type: number
For the model only DBS
The cost of going up to the floor.
liftType
Type: string
The type of lifting the order to the floor:
NOT_NEEDED — not required.
MANUAL — manual.
ELEVATOR — elevator.
CARGO_ELEVATOR — freight elevator.
FREE — any of the above, if the free lift option is enabled.
The pick-up point selected by the buyer to receive the order. It is not returned in the response if the customer has chosen to receive the order at a branded Market order pick-up point (value MARKET_BRANDED_OUTLET the parameter dispatchType).
Example
{"code":"example"}
price
Type: number
Do not use this option.
region
Type: object
name
Type: string
The name of the region.
Example:example
type
Type: string
Type of region:
CITY_DISTRICT — the area of the city.
CITY — a large city.
CONTINENT — the continent.
COUNTRY_DISTRICT — the federal district.
COUNTRY — country.
REGION — region.
METRO_STATION — the metro station.
MONORAIL_STATION — monorail station.
OVERSEAS_TERRITORY — a separate territory of a state located in another part of the world (for example, Anguilla, Greenland, Bermuda, etc.).
SECONDARY_DISTRICT — the second-level city district (for example, for the Moscow Autonomous District, the second-level districts are Izmailovo, Novokosino, Perovo, etc.).
SETTLEMENT — settlement.
SUBJECT_FEDERATION — the subject of the Federation.
SUBJECT_FEDERATION_DISTRICT — the district of the subject of the federation.
VILLAGE — city.
SUBURB — suburb.
OTHER — unknown region.
Enum:OTHER, CITY_DISTRICT, CITY, CONTINENT, COUNTRY_DISTRICT, COUNTRY, REGION, METRO_STATION, MONORAIL_STATION, OVERSEAS_TERRITORY, SECONDARY_DISTRICT, SETTLEMENT, SUBJECT_FEDERATION, SUBJECT_FEDERATION_DISTRICT, VILLAGE, SUBURB
id
Type: integer
ID of the region.
parent
Type: unknown
Information about the parent region.
Parent regions are specified up to the country level.
It is indicated if the order is delivered by the partner service of the Market (deliveryPartnerType=YANDEX_MARKET).
height
Type: integer
The height of the packed order in centimeters.
It is indicated if the order is delivered by the partner service of the Market (deliveryPartnerType=YANDEX_MARKET).
id
Type: integer
The parcel ID assigned by Yandex.Market.
shipmentDate
Type: string<date-dd-MM-yyyy>
Date format: DD-MM-YYYY.
Example:23-09-2022
shipmentTime
Type: string<time>
For the model only Express
The time by which the store must package the order and set it to the status READY_TO_SHIP. After the status change, a courier will arrive to pick up the order.
Time format: 24-hour, HH:MM.
If the order is made by an organization, the parameter is not returned until the delivery date is agreed.
Example:12:00:00
status
Type: string
Order status in the partner delivery service:
NEW — new.
CREATED — created in the delivery service.
READY_TO_SHIP — ready to transfer to the delivery service.
ERROR — order creation error.
UNKNOWN — unknown status.
Enum:NEW, CREATED, READY_TO_SHIP, ERROR, UNKNOWN
weight
Type: integer
The weight of the packed order in grams.
It is indicated if the order is delivered by the partner service of the Market (deliveryPartnerType=YANDEX_MARKET).
width
Type: integer
The width of the packed order in centimeters.
It is indicated if the order is delivered by the partner service of the Market (deliveryPartnerType=YANDEX_MARKET).
Information about parcels.
For the model DBS: is transmitted if the order was created at the Market pick-up point.
It is specified only if the store passed this identifier in the response to the request using the method POST cart in the parameter id, embedded in deliveryOptions.
Example:example
subsidy
Type: number
Subsidy for delivery.
type
Type: string
Order delivery method:
DELIVERY — courier delivery.
PICKUP — pickup.
POST — mail.
DIGITAL — for digital goods.
UNKNOWN — unknown type.
Enum:DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN
vat
Type: string
VAT on the product or delivery:
NO_VAT — VAT is not charged, it is used only for certain types of services.
VAT_0 — 0% VAT. For example, it is used for the sale of goods exported in the customs procedure of export, or for the provision of services for the international transportation of goods.
VAT_10 — 10% VAT. For example, it is used in the sale of certain food and medical products.
VAT_10_110 — VAT 10/110. 10% VAT, applicable only for prepayment.
VAT_20 — VAT 20%. Basic VAT from 2019 to January 1, 2026.
VAT_20_120 — VAT 20/120. VAT is 20%, applicable only for prepayment.
VAT_18 — VAT 18%. Basic VAT until 2019.
VAT_18_118 — VAT 18/118. VAT was used until January 1, 2019 for prepayment.
VAT_12 — VAT is 12%. It is used only in Uzbekistan.
VAT_05 — VAT is 5%. VAT for the simplified taxation system (USN).
VAT_07 — VAT is 7%. VAT for the simplified taxation system (USN).
VAT_22 — VAT is 22%. Basic VAT starting from January 1, 2026.
If you did not pass the parameter id, the order identifier on the Market is used.
Example:example
shipmentDate
Type: string<date-dd-MM-yyyy>
Date format: DD-MM-YYYY.
Example:23-09-2022
Example
{"id":"example","shipmentDate":"23-09-2022"}
400 Bad Request
If the store considers the request received from Yandex. Market to be incorrect, the store must return the response status 400 with a description of the reason for the error in the response body. Such responses will be analyzed for API violations and flaws on the part of the Market.
500 Internal Server Error
In case of a technical error on the store's side, it should return the response status 500. Stores with a large number of such responses may be disconnected from the Market.
No longer supported, please use an alternative and newer version.