- Request
- Body
- ShopOrderAcceptDTO
- OrderBuyerWithoutPersonalDataDTO
- CurrencyType
- OrderAcceptDeliveryDTO
- ShopOrderItemDTO
- OrderPaymentMethodType
- OrderPaymentType
- OrderStatusType
- OrderSubsidyDTO
- OrderSubstatusType
- OrderTag
- OrderTaxSystemType
- OrderBuyerType
- DeliveryAddressWithoutPersonalDataDTO
- OrderDeliveryDatesDTO
- OrderDeliveryPartnerType
- OrderDeliveryDispatchType
- OrderDeliveryEacType
- OrderLiftType
- ShopOutletDTO
- ShopRegionDTO
- ShopOrderShipmentDTO
- OrderDeliveryType
- OrderVatType
- OrderItemInstanceDTO
- OrderItemPromoDTO
- OrderItemSubsidyDTO
- ItemTag
- OrderSubsidyType
- ShopOutletScheduleItemDTO
- ShopRegionType
- ShopOrderParcelBoxDTO
- OrderParcelStatusType
- OrderPromoType
- OrderItemSubsidyType
- DayOfWeekType
- ShopOrderBoxItemDTO
- Responses
- 200 OK
- 400 Bad Request
- 500 Internal Server Error
从12月31日开始,push API方法将不可用。 从10月1日开始,它们可能不稳定。
要接收有关新订单的信息,请启用API通知。 怎么做
订单的转让和接受订单的请求
向商店提交新订单并请求确认订单接受。
要取消订单,请使用请求 PUT v2/campaigns/{campaignId}/orders/{orderId}/status.
请求可以执行多次
当响应市场的要求时,这是可能的 POST order/accept 该商店确认接受订单,但由于技术故障,该商店的回应未被市场记录。 由于不知道订单接受请求是否已到达商店,市场可以重复此请求。 预计商店将回复确认接受此订单。
当新订单出现时,市场会向您发送请求。 如果您在10秒内没有回复,市场将开始重复请求。 前3次 — 之后的每一分钟 — 每10分钟一班。
如果您没有回应四个重复的请求,市场将关闭商店,您的产品将从展柜中消失。 要再次连接,请正确响应所有真实或验证市场请求以创建订单。 — 接受或取消。 之后,您的产品将自动返回到展示柜。
- 将订单数据传输到市场提货点的功能(DBS)
-
如果客户选择将订单交付到品牌市场提货点,则将在没有参数的情况下收到请求
outlet. 交付类型类型对应的值PICKUP. 送货地点的地址和日期将显示在元素中address和dates.有关送货到市场提货点的更多信息,请参阅 在市场对卖家的帮助.
例子:
为了便于阅读,示例代码以缩写格式提供。
{ ... "delivery": { "type": "PICKUP", "dispatchType": "MARKET_BRANDED_OUTLET", "deliveryPartnerType": "SHOP", "deliveryServiceId": 99, "price": 1200, "serviceName": "СПСР", "liftType": "NOT_NEEDED", "liftPrice": 0, "vat": "VAT_20", "dates": { "fromDate": "15-02-2022", "toDate": "15-02-2022", "fromTime": "10:00", "toTime": "21:00" } }, ... }
Request
POST
/order/accept
Body
application/json
{
"order": {
"businessId": 0,
"id": 0,
"status": "PLACING",
"substatus": "RESERVATION_EXPIRED",
"creationDate": "23-09-2022 09:12:41",
"currency": "RUR",
"itemsTotal": 0,
"total": 0,
"deliveryTotal": 0,
"subsidyTotal": 0,
"totalWithSubsidy": 0,
"subsidies": [
{
"type": "YANDEX_CASHBACK",
"amount": 0
}
],
"buyerItemsTotal": 0,
"buyerTotal": 0,
"buyerItemsTotalBeforeDiscount": 0,
"buyerTotalBeforeDiscount": 0,
"paymentType": "PREPAID",
"paymentMethod": "SHOP_PREPAID",
"fake": false,
"shopOrderId": "string",
"items": [
{
"id": 0,
"feedId": 0,
"offerId": "string",
"feedCategoryId": "string",
"offerName": "string",
"fulfilmentShopId": 0,
"price": 0,
"buyerPrice": 0,
"buyerPriceBeforeDiscount": 0,
"priceBeforeDiscount": 0,
"count": 0,
"delivery": false,
"vat": "NO_VAT",
"shopSku": "string",
"sku": "string",
"subsidy": 0,
"subsidies": [
{
"type": "YANDEX_CASHBACK",
"amount": 0
}
],
"warehouseId": 0,
"partnerWarehouseId": "string",
"params": "string",
"promos": [
{
"type": "DIRECT_DISCOUNT",
"subsidy": 0,
"marketPromoId": "string"
}
],
"instances": [
{
"cis": "string",
"cisFull": "string",
"uin": "string",
"rnpt": "string",
"gtd": "string",
"countryCode": "RU"
}
],
"tags": [
"ULTIMA"
]
}
],
"notes": "string",
"taxSystem": "OSN",
"expiryDate": "23-09-2022",
"electronicAcceptanceCertificateCode": "string",
"tags": [
"ULTIMA"
],
"buyer": {
"type": "PERSON"
},
"delivery": {
"shopDeliveryId": "string",
"type": "DELIVERY",
"serviceName": "string",
"price": 0,
"subsidy": 0,
"deliveryPartnerType": "SHOP",
"dates": {
"fromDate": "23-09-2022",
"toDate": "23-09-2022",
"fromTime": "string",
"toTime": "string",
"realDeliveryDate": "23-09-2022"
},
"region": {
"id": 0,
"name": "string",
"type": "OTHER"
},
"vat": "NO_VAT",
"deliveryServiceId": 0,
"liftType": "NOT_NEEDED",
"liftPrice": 0,
"outlet": {
"code": "string"
},
"dispatchType": "UNKNOWN",
"shipments": [
{
"id": 0,
"status": "NEW",
"shipmentDate": "23-09-2022",
"shipmentTime": "string",
"weight": 0,
"width": 0,
"height": 0,
"depth": 0,
"boxes": [
{
"id": 0,
"weight": 0,
"width": 0,
"height": 0,
"depth": 0,
"items": [
{
"id": 0,
"count": 0
}
]
}
]
}
],
"estimated": false,
"eacType": "MERCHANT_TO_COURIER",
"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",
"lat": 0,
"lon": 0,
"notes": "string",
"outletPhones": [
"string"
],
"schedule": [
{
"fromDay": "MONDAY",
"toDay": "MONDAY",
"fromTime": "string",
"toTime": "string"
}
]
}
}
}
}
|
Name |
Description |
|
order* |
Type: ShopOrderAcceptDTO 秩序。 |
ShopOrderAcceptDTO
|
Name |
Description |
|
businessId |
Type: integer<int64> 内阁ID。 |
|
buyer |
Type: OrderBuyerWithoutPersonalDataDTO Информация о покупателе. |
|
buyerItemsTotal |
Type: number<decimal> 订单中所有物品的成本在应用折扣后以买方的货币计算,不包括运费。 |
|
buyerItemsTotalBeforeDiscount |
Type: number<decimal> 在应用折扣和不包括运输成本之前,订单中所有项目的成本以买方的货币计算。 |
|
buyerTotal |
Type: number<decimal> 在应用折扣并考虑到运输成本后,订单中所有项目的成本以买方的货币计算。 |
|
buyerTotalBeforeDiscount |
Type: number<decimal> 在应用折扣之前,订单中所有项目的成本以买方的货币计算,包括运费。 |
|
creationDate |
Type: string<date-dd-MM-yyyy-HH-mm-ss> 订单的日期和时间。 日期和时间格式: Example: |
|
currency |
Type: CurrencyType Валюта, в которой указаны цены на товары в заказе. Принимает значение Enum: |
|
delivery |
Type: OrderAcceptDeliveryDTO 交付信息。 |
|
deliveryTotal |
Type: number<decimal> 以订单货币交付的成本。 |
|
electronicAcceptanceCertificateCode |
Type: string 只适用于型号 FBS 一个六位数的确认代码:
提供了有关使用代码的详细信息 在市场对卖家的帮助. |
|
expiryDate |
Type: string<date-dd-MM-yyyy> Дата, после которой заказ будет отменен, если не сменит статус. Формат даты: Example: |
|
fake |
Type: boolean 订单类型:
|
|
id |
Type: integer<int64> 的订单ID。 |
|
items |
Type: ShopOrderItemDTO[] 订单中的产品列表。 |
|
itemsTotal |
Type: number<decimal> 订单货币中的订单总额,不包括促销代码,优惠券和促销折扣的交付成本和报酬(参数 |
|
notes |
Type: string 对订单进行评论。 |
|
paymentMethod |
Type: OrderPaymentMethodType 订购付款方法:
默认值: Enum: |
|
paymentType |
Type: OrderPaymentType 订购付款类别:
如果省略此参数,订单将在收到时支付。 Enum: |
|
shopOrderId |
Type: string 商店中的订单ID。 |
|
status |
Type: OrderStatusType 订单状况:
也可以返回其他值。 您不需要处理它们。 Enum: |
|
subsidies |
Type: OrderSubsidyDTO[] 按类型划分的补贴清单。
|
|
subsidyTotal |
Type: number<decimal> 给卖方折扣的报酬总额:
|
|
substatus |
Type: OrderSubstatusType 订单处理的阶段(如果它具有状态
也可以返回其他值。 您不需要处理它们。 Enum: |
|
tags |
Type: OrderTag[] 命令的迹象。
Enum: |
|
taxSystem |
Type: OrderTaxSystemType 下订单时商店的税收制度:
Enum: |
|
total |
Type: number<decimal> 以订单货币计算的订单总额,包括交货成本,但不包括对促销代码、优惠券、现金回赠和促销折扣的报酬(参数) |
|
totalWithSubsidy |
Type: number<decimal> 订单中所有商品的成本和商店货币的报酬之和(参数之和) |
OrderBuyerWithoutPersonalDataDTO
有关买方的信息。
|
Name |
Description |
|
type |
Type: OrderBuyerType Тип покупателя: физическое лицо или организация. Этот параметр используется FBS- и FBY-магазинами, размещающими товары на витрине business.market.yandex.ru. Enum: |
CurrencyType
货币代码:
RUR— 俄罗斯卢布。UAH— 乌克兰格里夫纳。BYR— 白俄罗斯卢布。KZT— 哈萨克斯坦坚戈。UZS— 乌兹别克总和。
|
Type |
Description |
|
Enum: |
OrderAcceptDeliveryDTO
|
Name |
Description |
|
address |
Type: DeliveryAddressWithoutPersonalDataDTO Только для модели DBS Адрес доставки. Передается, если параметр |
|
dates |
Type: OrderDeliveryDatesDTO Только для модели DBS Диапазон дат доставки. |
|
deliveryPartnerType |
Type: OrderDeliveryPartnerType Тип сотрудничества со службой доставки в рамках конкретного заказа. Enum: |
|
deliveryServiceId |
Type: integer<int64> 送服务ID。 有关派递服务的资料,可透过要求 GET delivery/services. |
|
dispatchType |
Type: OrderDeliveryDispatchType Только для модели DBS Способ отгрузки. Enum: |
|
eacType |
Type: OrderDeliveryEacType Только для модели Express Тип кода подтверждения ЭАПП. Enum: |
|
estimated |
Type: boolean 只适用于型号 DBS 指示订单的交货日期尚未确认的标志。 它是根据订单发送的产品,交货时间很长(31-60天)。 最终交货日期必须发送给Yandex。自订单提交请求之日起7天内上市。 PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/date. |
|
liftPrice |
Type: number<decimal> 只适用于型号 DBS 上地板的费用。 |
|
liftType |
Type: OrderLiftType Только для модели DBS Тип подъема заказа на этаж. Enum: |
|
outlet |
Type: ShopOutletDTO Только для модели DBS Пункт самовывоза, выбранный покупателем для получения заказа. Не возвращается в ответе, если покупатель выбрал получение заказа в брендированном пункте выдачи заказов Маркета (значение |
|
price ⦸
|
Type: number<decimal> 请勿使用此选项。 |
|
region |
Type: ShopRegionDTO 的输送区域。 |
|
serviceName |
Type: string 送货服务的名称。 |
|
shipments |
Type: ShopOrderShipmentDTO[] 有关包裹的信息。 **对于模型 DBS:**如果订单是在市场提货点创建的,则会发送。
|
|
shopDeliveryId |
Type: string 只适用于型号 DBS 店分配的配送ID。 仅当存储使用该方法在对请求的响应中传递此标识符时,才指定此标识符 POST cart 在参数中 |
|
subsidy |
Type: number<decimal> 交付补贴。 |
|
type |
Type: OrderDeliveryType 订单交付方法:
Enum: |
|
vat |
Type: OrderVatType Только для модели DBS Налог на добавленную стоимость (НДС) на услугу доставки заказа. Enum: |
ShopOrderItemDTO
订单中的产品列表。
|
Name |
Description |
|
buyerPrice |
Type: number<decimal> 以买方货币计算的产品价格。 价格已经包括折扣:
向后兼容性 过时的参数也被填写。 |
|
buyerPriceBeforeDiscount |
Type: number<decimal> 在应用折扣之前,以买方货币计算的产品成本。 |
|
count |
Type: integer 积单元的数量。 |
|
delivery |
Type: boolean 只适用于型号 FBS 将产品交付到请求中指定的区域:
接受在参数中传递的值 |
|
feedCategoryId |
Type: string 只适用于型号 DBS 文件夹中指定的类别的ID。 |
|
feedId |
Type: integer<int64> 产品目录的ID。 |
|
fulfilmentShopId |
Type: integer<int64> 产品供应商的ID。 要找到答案,请登录市场上的卖家帐户并点击其名称。 ID在字段中指定 商店ID 在所需仓库的行中。 |
|
id |
Type: integer<int64> 订单中的产品ID。 允许您在此订单范围内识别产品。 |
|
instances |
Type: OrderItemInstanceDTO[] 品单元的标签的信息。 请求中传递的标记数据返回。 PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers. 如果商店尚未发送此订单的代码, |
|
offerId |
Type: string 你的 SKU — 系统中的产品ID。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: |
|
offerName |
Type: string 只适用于型号 DBS 产品名称。 |
|
params |
Type: string 品特性(例如,其颜色)。 |
|
partnerWarehouseId ⦸
|
Type: string 只适用于型号 FBS 为其下订单的商店系统中仓库的ID。 |
|
price |
Type: number<decimal> 以订单货币计算的产品价格,不包括促销代码、优惠券和促销折扣给卖方的报酬(参数) |
|
priceBeforeDiscount |
Type: number<decimal> 在应用折扣之前,以商店货币计算的产品成本。 |
|
promos |
Type: OrderItemPromoDTO[] 有关使用促销代码,优惠券和促销活动向卖家提供商品折扣的奖励的信息。 |
|
shopSku |
Type: string 你的 SKU — 系统中的产品ID。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: |
|
sku |
Type: string SKU 在市场上 — 市场上当前产品卡的ID。 |
|
subsidies |
Type: OrderItemSubsidyDTO[] 按类型划分的补贴清单。
|
|
subsidy ⦸
|
Type: number<decimal> 相反,使用 对产品的所有折扣给卖方的总报酬:
|
|
tags |
Type: ItemTag[] 产品属性。
Enum: |
|
vat |
Type: OrderVatType Налог на добавленную стоимость (НДС) на товар. Используется только совместно с параметром Enum: |
|
warehouseId |
Type: integer<int64> 只适用于型号 FBS 市场上仓库的ID。 |
OrderPaymentMethodType
订购付款方法:
-
如果在结账时选择付款,则值(
"paymentType": "PREPAID"):-
YANDEX— 通过银行卡。 -
APPLE_PAY— 苹果支付。 -
GOOGLE_PAY— 谷歌支付。 -
CREDIT— 信贷。 -
TINKOFF_CREDIT— 从廷科夫银行贷到的。 -
TINKOFF_INSTALLMENTS— 分期付款在廷科夫银行。 -
EXTERNAL_CERTIFICATE— 与礼券(例如,从Sberbank在线应用程序)。 -
SBP— 通过快速支付系统。 -
B2B_ACCOUNT_PREPAYMENT— 组织支付订单。
-
-
如果在收到订单时选择付款的值(
"paymentType": "POSTPAID"):-
CARD_ON_DELIVERY— 通过银行卡。 -
BOUND_CARD_ON_DELIVERY— 收到时附有连结的银行卡。 -
BNPL_BANK_ON_DELIVERY— 超级分裂。 -
BNPL_ON_DELIVERY— 分裂。 -
CASH_ON_DELIVERY— 现金。 -
B2B_ACCOUNT_POSTPAYMENT— 订单在交货后由组织支付。
-
-
UNKNOWN— 未知类型。
默认值: CASH_ON_DELIVERY.
|
Type |
Description |
|
Enum: |
OrderPaymentType
订购付款类别:
-
PREPAID— 结账时付款。 -
POSTPAID— 在收到订单后付款。 -
UNKNOWN— 未知类型。
如果省略此参数,订单将在收到时支付。
|
Type |
Description |
|
Enum: |
OrderStatusType
订单状况:
-
PLACING— 它正在处理中,正在准备预订。 -
RESERVED— 预订,但预订不足。 -
UNPAID— 已发出,但尚未付款(如果在结账时选择付款)。 -
PROCESSING— 它正在处理中。 -
DELIVERY— 转移到送货服务。 -
PICKUP— 送到取件点。 -
DELIVERED— 由买方接收。 -
CANCELLED— 取消。 -
PENDING— 等待卖方处理。 -
PARTIALLY_RETURNED— 部分退款。 -
RETURNED— 全额回来了。 -
UNKNOWN— 状态不明。
也可以返回其他值。 您不需要处理它们。
|
Type |
Description |
|
Enum: |
OrderSubsidyDTO
向卖方支付的总报酬 DBS-交货和产品的所有折扣:
- 通过促销代码、优惠券和促销;
- 按加分;
- 交货时(DBS).
|
Name |
Description |
|
amount |
Type: number<decimal> 补助金额。 |
|
type |
Type: OrderSubsidyType 资助类别:
Enum: |
OrderSubstatusType
订单处理的阶段(如果它具有状态 PROCESSING)或取消订单的原因(如果它具有状态 CANCELLED).
-
状态中的订单值
PROCESSING:-
STARTED— 订单已确认,可以处理。 -
READY_TO_SHIP— 订单已组装并准备装运。
-
-
状态中的订单值
CANCELLED:-
RESERVATION_EXPIRED— 客户未在10分钟内完成预订订单。 -
USER_NOT_PAID— 买方没有为订单付款(对于付款类型PREPAID)30分钟。 -
USER_UNREACHABLE— 无法联系买家。 为此取消,必须满足以下条件:- 至少3个电话从8到21在买方的时区;
- 第一次和第三次通话之间的休息时间至少为90分钟;
- 连接不短于5秒。
如果不满足其中至少一个条件(号码不可用时除外),您将无法取消订单。 将返回带有错误代码400的响应。
-
USER_CHANGED_MIND— 客户因个人原因取消了订单。 -
USER_REFUSED_DELIVERY— 买方对交货条件不满意. -
USER_REFUSED_PRODUCT— 该产品不适合买方。 -
SHOP_FAILED— 商店无法完成订单。 -
USER_REFUSED_QUALITY— 买方对产品的质量不满意。 -
REPLACING_ORDER— 买方决定主动更换另一种产品。 -
PROCESSING_EXPIRED— 值不再使用。 -
PICKUP_EXPIRED— 订单在PVZ中的存储期已过期。 -
TOO_MANY_DELIVERY_DATE_CHANGES— 订单被推迟了太多次。 -
TOO_LONG_DELIVERY— 订单太长时间无法交付。 -
INCORRECT_PERSONAL_DATA— 对于来自国外的订单,收件人的信息不正确,订单将不会在海关检查。
-
-
TECHNICAL_ERROR— 市场方面的技术错误。 联系支持。
也可以返回其他值。 您不需要处理它们。
|
Type |
Description |
|
Enum: |
OrderTaxSystemType
下订单时商店的税收制度:
-
ECHN— 统一农业税(UST)。 -
ENVD— 统一计算所得税(UTII)。 -
OSN— 一般税收制度。 -
PSN— 专利税制(PSN)。 -
USN— 简化税制(STS)。 -
USN_MINUS_COST— 简化的税收制度,收入减少的费用数额(USN"收入减去费用")。 -
NPD— 专业收入税(NAP)。 -
UNKNOWN_VALUE— 未知值。 仅与参数结合使用付款方法=氨纶.
|
Type |
Description |
|
Enum: |
OrderBuyerType
买方类型:
-
PERSON— 一个自然人。 -
BUSINESS— 组织。
|
Type |
Description |
|
Enum: |
DeliveryAddressWithoutPersonalDataDTO
送货地址。 如果参数传递 type 这很重要 DELIVERY.
|
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 地板。 |
|
house |
Type: string 房屋或财产的编号。 所需参数。 |
|
lat |
Type: number<decimal> 宽度。 如果客户选择将订单交付到品牌市场提货点,则指定此参数。 我们不保证它会被填写,因为这是一个可选字段。 |
|
lon |
Type: number<decimal> 经度。 如果客户选择将订单交付到品牌市场提货点,则指定此参数。 我们不保证它会被填写,因为这是一个可选字段。 |
|
notes |
Type: string 地址的注释。 例如, 如果客户选择将订单交付到品牌市场提货点,则指定此参数。 |
|
outletPhones |
Type: string[] 接机点的电话号码格式 如果客户选择将订单交付到品牌市场提货点,则指定此参数。
|
|
postcode |
Type: string 邮政编码。 如果选择了邮件传递,则表示( |
|
schedule |
Type: ShopOutletScheduleItemDTO[] 接送点的开放时间。 如果客户选择将订单交付到品牌市场提货点,则指定此参数。
|
|
street |
Type: string 街道。 |
|
subway |
Type: string 地铁站。 |
OrderDeliveryDatesDTO
交货日期的范围。
|
Name |
Description |
|
fromDate* |
Type: string<date-dd-MM-yyyy> Ближайшая дата доставки. Формат даты: Example: |
|
fromTime |
Type: string<time> 送时间间隔的开始。 它仅与参数一起传递 时间格式:24小时, 最小值: |
|
realDeliveryDate |
Type: string<date-dd-MM-yyyy> Дата, когда товар доставлен до пункта выдачи заказа (в случае самовывоза) или до покупателя (если заказ доставляет курьер). Example: |
|
toDate |
Type: string<date-dd-MM-yyyy> Самая поздняя дата доставки. Если параметр Формат даты: Example: |
|
toTime |
Type: string<time> 送时间间隔的结束。 它仅与参数一起传递 时间格式:24小时, 最大值: |
OrderDeliveryPartnerType
在特定订单内与送货服务的合作类型:
-
SHOP— 商店直接与送货服务合作或独立交付订单。 -
YANDEX_MARKET— 这家商店通过市场提供送货服务. -
UNKNOWN— 未知类型。
|
Type |
Description |
|
Enum: |
OrderDeliveryDispatchType
装运方法:
-
BUYER— 快递交付给买方。 -
MARKET_BRANDED_OUTLET— 送到市场的取货点。 -
SHOP_OUTLET— 送货到商店的订单提货点. -
UNKNOWN— 未知类型。
|
Type |
Description |
|
Enum: |
OrderDeliveryEacType
EAPP确认码的类型:
-
MERCHANT_TO_COURIER(暂时不退款) — 卖方将代码传送给快递员以接收非购买。 -
COURIER_TO_MERCHANT— 快递员将代码传送给卖方以接收订单。 -
CHECKING_BY_MERCHANT— 卖方检查他身边的代码。
|
Type |
Description |
|
Enum: |
OrderLiftType
将订单提升到地板的类型:
-
NOT_NEEDED— 不需要。 -
MANUAL— 手册。 -
ELEVATOR— 电梯。 -
CARGO_ELEVATOR— 货运电梯。 -
FREE— 上述任何一项,如果启用了自由升降选项。 -
UNKNOWN— 未知类型。
|
Type |
Description |
|
Enum: |
ShopOutletDTO
买方为接收订单而选择的提货点。 如果买方选择在品牌市场订单提货点(价值)接收订单,则不会在响应中返回 MARKET_BRANDED_OUTLET 参数 dispatchType).
|
Name |
Description |
|
code |
Type: string 店分配的取件点ID。 |
ShopRegionDTO
的输送区域。
|
Name |
Description |
|
name* |
Type: string 区域的名称。 |
|
type* |
Type: ShopRegionType Тип региона. Enum: |
|
id |
Type: integer<int64> 区域的ID。 |
|
parent |
Type: ShopRegionDTO 的输送区域。 |
ShopOrderShipmentDTO
的包列表。
|
Name |
Description |
|
boxes |
Type: ShopOrderParcelBoxDTO[] 货物位置列表。 |
|
depth |
Type: integer<int64> 以厘米为单位的包装顺序的深度。 如果订单是由市场的合作伙伴服务( |
|
height |
Type: integer<int64> 以厘米为单位的包装顺序的高度。 如果订单是由市场的合作伙伴服务( |
|
id |
Type: integer<int64> Yandex分配的包裹ID。市场。 |
|
shipmentDate |
Type: string<date-dd-MM-yyyy> День, в который нужно отгрузить заказ службе доставки. Формат даты: Для модели FBS: если заказ сделан организацией, параметр не возвращается до согласования даты доставки. Для модели DBS: если вы не передали параметр Example: |
|
shipmentTime |
Type: string<time> 只适用于型号 Express 商店必须打包订单并将其设置为状态的时间 时间格式:24小时, 如果订单是由组织发出的,则在商定交货日期之前不会返回参数。 |
|
status ⦸
|
Type: OrderParcelStatusType 合作伙伴送货服务中的订单状态:
Enum: |
|
weight |
Type: integer<int64> 以克为单位的包装订单的重量。 如果订单是由市场的合作伙伴服务( |
|
width |
Type: integer<int64> 以厘米为单位的包装订单的宽度。 如果订单是由市场的合作伙伴服务( |
OrderDeliveryType
订单交付方法:
-
DELIVERY— 快递送货。 -
PICKUP— 皮卡。 -
POST— 邮件。 -
DIGITAL— 用于数字商品。 -
UNKNOWN— 未知类型。
|
Type |
Description |
|
Enum: |
OrderVatType
产品的增值税(VAT):
-
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. 增值税用于预付款,直到2019年1月1日。 -
VAT_12— 增值税是12%。 它仅在乌兹别克斯坦使用。 -
VAT_05— 增值税是5%。 简化税制(USN)的增值税。 -
VAT_07— 增值税是7%。 简化税制(USN)的增值税。 -
UNKNOWN_VALUE— 未知类型。
仅与参数结合使用 付款方法=氨纶.
|
Type |
Description |
|
Enum: |
OrderItemInstanceDTO
您为此职位提供的标记或故障代码。 "公平标志"代码以两个版本返回 — 有和没有密码。
|
Name |
Description |
|
cis |
Type: string 系统中的单元识别码 "诚实的标志" 没有密码或 "ASL BELGISI" (对于Yandex Go市场的卖家)。 |
|
cisFull |
Type: string 系统中的单元识别码 "诚实的标志" 用一个密码。 |
|
countryCode |
Type: string 生产国采用ISO3166-1alpha-2格式。 如何获得 Example: Min length: Max length: Pattern: |
|
gtd |
Type: string 货物报关。 它是由斜杠分隔的三个数字组成的字符串:XXXXXXX/XXXXXXXXX/XXXXXXXXXXX。 第一部分 — 登记进口货物申报的海关代码。 进一步 — 声明的日期和编号。 |
|
rnpt |
Type: string 品批次的注册号。 它是由斜杠分隔的四个数字组成的字符串:XXXXXXX/XXXXXXX/XXXXXXX/XXX。 第一部分 — 登记货物申报的海关办公室的代码。 进一步 — 声明的日期、编号和声明中标记产品的编号。 |
|
uin |
Type: string 珠宝的UIN(16位数字代码) 当制造商在贵金属和宝石的周转控制系统中注册产品时,他就会获得胜利。 — GIIS DMDK。 |
OrderItemPromoDTO
有关使用促销代码,优惠券和促销活动向卖家提供商品折扣的奖励的信息。
|
Name |
Description |
|
type* |
Type: OrderPromoType Тип скидки. Enum: |
|
marketPromoId |
Type: string 在市场和卖方之间提供服务以促进服务的协议框架内的促销标识符。 |
|
subsidy |
Type: number<decimal> 作为促销活动的一部分销售的产品从市场上向卖方支付报酬。 |
OrderItemSubsidyDTO
对产品的所有折扣给卖方的总报酬:
- 通过促销代码、优惠券和促销;
- 加分。
|
Name |
Description |
|
amount |
Type: number<decimal> 补助金额。 |
|
type |
Type: OrderItemSubsidyType 资助类别:
Enum: |
ItemTag
产品属性:
ULTIMA— 优质产品。SAFE_TAG— 有安全标签的物品。 它有助于消除退货时商品的替代。 如果没有购买时存在的保护标签,您将无法退回产品。TURBO— 迅速售罄的产品。
|
Type |
Description |
|
Enum: |
OrderSubsidyType
资助类别:
-
YANDEX_CASHBACK— Yandex Plus订阅折扣。 -
SUBSIDY— 燕基科斯. 市场折扣(促销、促销代码、优惠券等)) -
DELIVERY— 航运折扣(DBS).
|
Type |
Description |
|
Enum: |
ShopOutletScheduleItemDTO
销售点的开放时间。
|
Name |
Description |
|
fromDay* |
Type: DayOfWeekType День недели, в который пункт выдачи начинает работать:
Обязательный параметр. Enum: |
|
fromTime* |
Type: string 接点的开始时间。 时间格式:24小时, 所需参数。 Min length: |
|
toDay* |
Type: DayOfWeekType День недели, в который пункт выдачи заканчивает работать:
Обязательный параметр. Enum: |
|
toTime* |
Type: string 取点的结束时间。 时间格式:24小时, 所需参数。 Min length: |
ShopRegionType
地区类型:
-
CITY_DISTRICT— 城市的面积。 -
CITY— 一个大城市。 -
CONTINENT— 大陆。 -
COUNTRY_DISTRICT— 联邦区。 -
COUNTRY— 国家。 -
REGION— 地区。 -
METRO_STATION— 地铁站。 -
MONORAIL_STATION— 单轨铁路站。 -
OVERSEAS_TERRITORY— 位于世界另一地区的一个国家的一个单独领土(例如安圭拉、格陵兰、百慕大等)。). -
SECONDARY_DISTRICT— 二级市辖区(例如,对于莫斯科自治区,二级区是Izmailovo,Novokosino,Perovo等。). -
SETTLEMENT— 结算。 -
SUBJECT_FEDERATION— 联的主体。 -
SUBJECT_FEDERATION_DISTRICT— 联的主体的区。 -
VILLAGE— 城市。 -
SUBURB— 郊区。 -
OTHER— 未知区域。
|
Type |
Description |
|
Enum: |
ShopOrderParcelBoxDTO
有关货物位置的信息。
|
Name |
Description |
|
depth |
Type: integer<int64> 厘米为单位的货物区域的深度。 |
|
height |
Type: integer<int64> 以厘米为单位的货物区域的高度。 |
|
id |
Type: integer<int64> 货物区的ID。 |
|
items |
Type: ShopOrderBoxItemDTO[] 箱的信息。 |
|
weight |
Type: integer<int64> 以克为单位的货物空间的重量。 |
|
width |
Type: integer<int64> 以厘米为单位的货物区域的宽度。 |
OrderParcelStatusType
合作伙伴送货服务中的订单状态:
-
NEW— 新的。 -
CREATED— 交付服务中创建的。 -
READY_TO_SHIP— 准备转移到送货服务。 -
ERROR— 订单创建错误。 -
UNKNOWN— 状态不明。
|
Type |
Description |
|
Enum: |
OrderPromoType
折扣类型:
-
DIRECT_DISCOUNT— 直接折扣,这是由卖方或市场设置。 -
BLUE_SET— 工具包。 -
BLUE_FLASH— 一个闪光的促销。 -
MARKET_COUPON— 使用Yandex的折扣。市场促销代码。 -
MARKET_PROMOCODE— 商店促销代码的折扣。 -
MARKET_BLUE— Yandex的折扣。 市场。 -
CHEAPEST_AS_GIFT— 作为礼物最便宜的项目。 -
CASHBACK— 现金返还。 -
SPREAD_DISCOUNT_COUNT— 相同商品数量的折扣。 -
SPREAD_DISCOUNT_RECEIPT— 收据金额的折扣. -
DISCOUNT_BY_PAYMENT_TYPE— 使用Plus卡付款时可享受直接折扣。 -
PERCENT_DISCOUNT— 直接百分比折扣。 -
DCO_EXTRA_DISCOUNT— 从市场计算补贴所需的额外折扣。 -
UNKNOWN— 未知类型。
过时的类型:
-
GENERIC_BUNDLE. -
MARKET_COIN. -
PRICE_DROP_AS_YOU_SHOP. -
SECRET_SALE.
|
Type |
Description |
|
Enum: |
OrderItemSubsidyType
资助类别:
-
YANDEX_CASHBACK— Yandex Plus订阅折扣。 -
SUBSIDY— 燕基科斯. 市场折扣(促销、促销代码、优惠券等)).
|
Type |
Description |
|
Enum: |
DayOfWeekType
星期几:
MONDAY— 星期一。TUESDAY— 星期二。WEDNESDAY— 星期三。THURSDAY— 星期四。FRIDAY— 星期五。SATURDAY— 星期六。SUNDAY— 星期天。
|
Type |
Description |
|
Enum: |
ShopOrderBoxItemDTO
箱的信息。
|
Name |
Description |
|
count |
Type: integer 箱内产品的数量。 |
|
id |
Type: integer<int64> 箱的ID。 |
Responses
200 OK
商店关于接受订单的回应。
Body
application/json
{
"order": {
"id": "string",
"shipmentDate": "23-09-2022"
}
}
|
Name |
Description |
|
order |
Type: OrderAcceptResponseDTO 订单描述。 |
OrderAcceptResponseDTO
|
Name |
Description |
|
id |
Type: string 店分配的订单ID。
|
|
shipmentDate |
Type: string<date-dd-MM-yyyy> Только для модели DBS День, в который вы будете отгружать заказы службе доставки. Формат даты: Example: |
400 Bad Request
如果商店考虑从Yandex收到的请求。 如果不正确,商店必须返回响应状态400,其中包含响应正文中错误原因的描述。 这些回应将被分析为API违规和市场上的缺陷。
500 Internal Server Error
如果商店一侧出现技术错误,它应该返回响应状态500。 具有大量此类响应的商店可能与市场脱节。
No longer supported, please use an alternative and newer version.