从12月31日开始,push API方法将不可用。 从10月1日起,它们可能不稳定。

用于传输信息的请求:

要接收有关订单的信息,请启用API通知。 怎么做

索取有关产品的资料

市场验证客户放入篮子的产品在商店中可用。 在 DBS-商店也被要求提供有关交货可能性和可用付款方式的信息。

响应时间:5.5秒。

Request

POST

/cart

Body

application/json
{
  "cart": {
    "businessId": 0,
    "currency": "RUR",
    "deliveryCurrency": "RUR",
    "buyer": {
      "id": "example",
      "lastName": "example",
      "firstName": "example",
      "middleName": "example",
      "email": "example",
      "type": "PERSON",
      "phone": "example",
      "uid": 0
    },
    "delivery": {
      "region": {
        "id": 0,
        "name": "example",
        "type": "OTHER",
        "parent": null
      },
      "address": {
        "country": "example",
        "postcode": "example",
        "city": "example",
        "district": "example",
        "subway": "example",
        "street": "example",
        "house": "example",
        "block": "example",
        "entrance": "example",
        "entryphone": "example",
        "floor": "example",
        "apartment": "example",
        "lat": 0.5,
        "lon": 0.5,
        "phone": "example",
        "recipient": "example",
        "notes": "example",
        "outletPhones": [
          null
        ],
        "schedule": [
          null
        ]
      },
      "estimated": true,
      "outlet": {
        "code": "example"
      }
    },
    "items": [
      {
        "id": 0,
        "feedId": 0,
        "offerId": "example",
        "feedCategoryId": "example",
        "offerName": "example",
        "price": 0.5,
        "subsidy": 0.5,
        "count": 0,
        "shopSku": "example",
        "warehouseId": 0,
        "partnerWarehouseId": "example",
        "fulfilmentShopId": 0,
        "priceBeforeDiscount": 0.5,
        "promos": [
          {}
        ]
      }
    ]
  }
}

Name

Description

cart

Type: object

businessId

Type: integer

内阁ID。

buyer

All of 2 types
  • Type: object

    All of 2 types
    • Type: object

      type

      Type: string

      买方类型:

      • PERSON — 一个自然人。

      • BUSINESS — 组织。

      Enum: PERSON, BUSINESS

      firstName

      Type: string

      姓名。

      Example: example

      id

      Type: string

      买方的ID。

      Example: example

      lastName

      Type: string

      姓。

      Example: example

      middleName

      Type: string

      中间名。

      Example: example

      有关买方的基本字段的信息。

      Example
      {
        "id": "example",
        "lastName": "example",
        "firstName": "example",
        "middleName": "example",
        "type": "PERSON"
      }
      
    • Type: object

      phone

      Type: string

      买家的电话号码。

      数字格式: +<国家代码><region_code><电话号码>.

      Example: example

      Example
      {
        "phone": "example"
      }
      

    有关买方的信息。

    参数 id, lastName, firstNamemiddleName 只有当您根据模型工作时,才会返回它们。 DBS.

    Example
    {
      "id": "example",
      "lastName": "example",
      "firstName": "example",
      "middleName": "example",
      "type": "PERSON",
      "phone": "example"
    }
    
  • Type: object

    uid

    Type: integer

    用户的UID

    Example
    {
      "uid": 0
    }
    
Example
{
  "id": "example",
  "lastName": "example",
  "firstName": "example",
  "middleName": "example",
  "type": "PERSON",
  "phone": "example",
  "uid": 0
}

currency

Type: string

货币代码:

  • RUR — 俄罗斯卢布。
  • UAH — 乌克兰格里夫纳。
  • BYR — 白俄罗斯卢布。
  • KZT — 哈萨克斯坦坚戈。
  • UZS — 乌兹别克总和。

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: object

address

All of 2 types
  • Type: object

    apartment

    Type: string

    公寓或办公室号码。

    Example: example

    block

    Type: string

    建筑物或建筑物。

    Example: example

    city

    Type: string

    一个城市或地方。

    所需参数。

    Example: example

    country

    Type: string

    一个国家。

    如果选择了订单交付到提货点,则可选参数。

    Example: example

    district

    Type: string

    区。

    Example: example

    entrance

    Type: string

    入口号码。

    Example: example

    entryphone

    Type: string

    的对讲代码。

    Example: example

    floor

    Type: string

    地板。

    Example: example

    house

    Type: string

    房屋或财产的编号。

    所需参数。

    Example: example

    postcode

    Type: string

    邮政编码。

    如果选择了邮件传递,则表示(交货类型=POST).

    Example: example

    street

    Type: string

    街道。

    Example: example

    subway

    Type: string

    地铁站。

    Example: example

    地址。

    Example
    {
      "country": "example",
      "postcode": "example",
      "city": "example",
      "district": "example",
      "subway": "example",
      "street": "example",
      "house": "example",
      "block": "example",
      "entrance": "example",
      "entryphone": "example",
      "floor": "example",
      "apartment": "example"
    }
    
  • Type: object

    lat

    Type: number

    宽度。

    如果客户选择将订单交付到品牌市场提货点,则指定此参数。

    我们不保证它会被填写,因为这是一个可选字段。

    lon

    Type: number

    经度。

    如果客户选择将订单交付到品牌市场提货点,则指定此参数。

    我们不保证它会被填写,因为这是一个可选字段。

    notes

    Type: string

    地址的注释。 例如, 从庭院入口.

    如果客户选择将订单交付到品牌市场提货点,则指定此参数。

    Example: example

    outletPhones

    Type: string[]

    接机点的电话号码格式 8 812 123-45-67 890 (890 — 延伸)。

    如果客户选择将订单交付到品牌市场提货点,则指定此参数。

    Example
    [
      "example"
    ]
    

    schedule

    Type: object[]

    fromDay

    Type: string

    星期几:

    • MONDAY — 星期一。
    • TUESDAY — 星期二。
    • WEDNESDAY — 星期三。
    • THURSDAY — 星期四。
    • FRIDAY — 星期五。
    • SATURDAY — 星期六。
    • SUNDAY — 星期天。

    Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

    fromTime

    Type: string

    接点的开始时间。 时间格式:24小时, HH:MM.

    所需参数。

    Min length: 1

    Example: example

    toDay

    Type: string

    星期几:

    • MONDAY — 星期一。
    • TUESDAY — 星期二。
    • WEDNESDAY — 星期三。
    • THURSDAY — 星期四。
    • FRIDAY — 星期五。
    • SATURDAY — 星期六。
    • SUNDAY — 星期天。

    Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

    toTime

    Type: string

    取点的结束时间。 时间格式:24小时, HH:MM.

    所需参数。

    Min length: 1

    Example: example

    接送点的开放时间。

    如果客户选择将订单交付到品牌市场提货点,则指定此参数。

    Example
    [
      {
        "fromDay": "MONDAY",
        "toDay": "MONDAY",
        "fromTime": "example",
        "toTime": "example"
      }
    ]
    
    Example
    {
      "lat": 0.5,
      "lon": 0.5,
      "notes": "example",
      "outletPhones": [
        "example"
      ],
      "schedule": [
        {
          "fromDay": "MONDAY",
          "toDay": "MONDAY",
          "fromTime": "example",
          "toTime": "example"
        }
      ]
    }
    

送货地址。 如果参数传递 type 这很重要 DELIVERY.

Example
{
  "country": "example",
  "postcode": "example",
  "city": "example",
  "district": "example",
  "subway": "example",
  "street": "example",
  "house": "example",
  "block": "example",
  "entrance": "example",
  "entryphone": "example",
  "floor": "example",
  "apartment": "example",
  "lat": 0.5,
  "lon": 0.5,
  "notes": "example",
  "outletPhones": [
    "example"
  ],
  "schedule": [
    {
      "fromDay": "MONDAY",
      "toDay": "MONDAY",
      "fromTime": "example",
      "toTime": "example"
    }
  ]
}

estimated

Type: boolean

只适用于型号 DBS

指示订单的交货日期尚未确认的标志。 它是根据订单发送的产品,交货时间很长(31-60天)。 最终交货日期必须发送给Yandex。自订单提交请求之日起7天内上市。 PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/date.

outlet

Type: object

code

Type: string

店分配的取件点ID。

Example: example

买方为接收订单而选择的提货点。 如果客户选择在品牌市场订单提货点(价值)接收订单,则不会在响应中返回 MARKET_BRANDED_OUTLET 参数 dispatchType).

Example
{
  "code": "example"
}

region

Type: object

name

Type: string

区域的名称。

Example: example

type

Type: string

地区类型:

  • 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 — 未知区域。

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。

parent

Type: unknown

有关父区域的信息。

父区域指定到国家级别。

Example: null

的输送区域。

Example
{
  "id": 0,
  "name": "example",
  "type": "OTHER",
  "parent": null
}

交付信息。

Example
{
  "region": {
    "id": 0,
    "name": "example",
    "type": "OTHER",
    "parent": null
  },
  "address": {
    "country": "example",
    "postcode": "example",
    "city": "example",
    "district": "example",
    "subway": "example",
    "street": "example",
    "house": "example",
    "block": "example",
    "entrance": "example",
    "entryphone": "example",
    "floor": "example",
    "apartment": "example",
    "lat": 0.5,
    "lon": 0.5,
    "notes": "example",
    "outletPhones": [
      "example"
    ],
    "schedule": [
      {
        "fromDay": "MONDAY",
        "toDay": "MONDAY",
        "fromTime": "example",
        "toTime": "example"
      }
    ]
  },
  "estimated": true,
  "outlet": {
    "code": "example"
  }
}

deliveryCurrency

Type: string

货币代码:

  • RUR — 俄罗斯卢布。
  • UAH — 乌克兰格里夫纳。
  • BYR — 白俄罗斯卢布。
  • KZT — 哈萨克斯坦坚戈。
  • UZS — 乌兹别克总和。

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

items

Type: object[]

count

Type: integer

积单元的数量。

feedCategoryId

Type: string

文件夹中指定的类别的ID。

商店不应在响应中传输此标识符。 让它空着。

Example: example

feedId

Type: integer

产品目录的ID。

存储必须在响应中指定相同的标识符。

fulfilmentShopId

Type: integer

只适用于型号 DBS

产品供应商的ID。

要找到答案,请登录市场上的卖家帐户并点击其名称。 ID在字段中指定 商店ID 在所需仓库的行中。

id

Type: integer

商品在购物车中的ID。

offerId

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

  • 对于每个产品 SKU 一定有一个。

  • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.

重要

值开头和结尾的空格会自动删除。 例如, " SKU123 ""SKU123" 它们将被视为相同的值。

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Example: example

offerName

Type: string

只适用于型号 DBS

产品名称。

Example: example

partnerWarehouseId

Type: string

只适用于型号 FBS

为其下订单的商店系统中仓库的ID。

Example: example

price

Type: number

以订单货币计算的产品价格,不包括促销代码、优惠券和促销折扣给卖方的报酬(参数) subsidy).

promos

Type: object[]

type

Type: string

折扣类型:

  • 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.

Enum: DIRECT_DISCOUNT, BLUE_SET, BLUE_FLASH, GENERIC_BUNDLE, MARKET_COUPON, MARKET_PROMOCODE, MARKET_BLUE, MARKET_COIN, PRICE_DROP_AS_YOU_SHOP, SECRET_SALE, CHEAPEST_AS_GIFT, CASHBACK, SPREAD_DISCOUNT_COUNT, SPREAD_DISCOUNT_RECEIPT, DISCOUNT_BY_PAYMENT_TYPE, PERCENT_DISCOUNT, DCO_EXTRA_DISCOUNT, UNKNOWN

marketPromoId

Type: string

在市场和卖方之间提供服务以促进服务的协议框架内的促销标识符。

Example: example

subsidy

Type: number

作为促销活动的一部分销售的产品从市场上向卖方支付报酬。

Example
[
  {
    "type": "DIRECT_DISCOUNT",
    "subsidy": 0.5,
    "marketPromoId": "example"
  }
]

shopSku

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

  • 对于每个产品 SKU 一定有一个。

  • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.

重要

值开头和结尾的空格会自动删除。 例如, " SKU123 ""SKU123" 它们将被视为相同的值。

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Example: example

subsidy

Type: number

对产品的所有折扣给卖方的总报酬:

  • 通过促销代码;
  • 通过优惠券;
  • 按加分;
  • 在股票上。

warehouseId

Type: integer

只适用于型号 FBS

市场上仓库的ID。

Example
[
  {
    "id": 0,
    "feedId": 0,
    "offerId": "example",
    "feedCategoryId": "example",
    "offerName": "example",
    "price": 0.5,
    "subsidy": 0.5,
    "count": 0,
    "shopSku": "example",
    "warehouseId": 0,
    "partnerWarehouseId": "example",
    "fulfilmentShopId": 0,
    "promos": [
      {
        "type": "DIRECT_DISCOUNT",
        "subsidy": 0.5,
        "marketPromoId": "example"
      }
    ]
  }
]

篮子。

Example
{
  "businessId": 0,
  "currency": "RUR",
  "deliveryCurrency": "RUR",
  "buyer": {
    "id": "example",
    "lastName": "example",
    "firstName": "example",
    "middleName": "example",
    "type": "PERSON",
    "phone": "example",
    "uid": 0
  },
  "delivery": {
    "region": {
      "id": 0,
      "name": "example",
      "type": "OTHER",
      "parent": null
    },
    "address": {
      "country": "example",
      "postcode": "example",
      "city": "example",
      "district": "example",
      "subway": "example",
      "street": "example",
      "house": "example",
      "block": "example",
      "entrance": "example",
      "entryphone": "example",
      "floor": "example",
      "apartment": "example",
      "lat": 0.5,
      "lon": 0.5,
      "notes": "example",
      "outletPhones": [
        "example"
      ],
      "schedule": [
        {}
      ]
    },
    "estimated": true,
    "outlet": {
      "code": "example"
    }
  },
  "items": [
    {
      "id": 0,
      "feedId": 0,
      "offerId": "example",
      "feedCategoryId": "example",
      "offerName": "example",
      "price": 0.5,
      "subsidy": 0.5,
      "count": 0,
      "shopSku": "example",
      "warehouseId": 0,
      "partnerWarehouseId": "example",
      "fulfilmentShopId": 0,
      "promos": [
        {
          "type": "DIRECT_DISCOUNT",
          "subsidy": 0.5,
          "marketPromoId": "example"
        }
      ]
    }
  ]
}

Responses

200 OK

关于转移的篮子和指定的交货区域的货物可用性的最新信息。

如何在不同情况下传输产品数据
商店不将订单交付到转移的地区或买方的地址(DBS)

指定空传递选项: "deliveryOptions":[]. 在参数中 items 对于每个产品,参数 delivery 你不必传送它。

篮子里有商店没有送到转移地区或买家地址的物品(DBS)

对于此类产品,请指定 "delivery": false 在参数中 items.

该产品不可出售(DBS)

指定产品的参数 "count": 0. 如果购物车中的所有物品都不在销售中,请传递参数 items 空的。

您已收到产品缺货的信息

10-15分钟后,此优惠停止按型号在市场上显示。 DBS 直到服务上的数据的下一次更新(索引每4小时进行一次)。

该产品目前缺货

指定参数 计数="0",嵌套在参数中 items. 如果篮子中的所有物品都没有出售,请传递参数 items 空的。

例子:

为了便于阅读,示例代码以缩写格式提供。

{
  "cart":
  {
    "items":
    [
      {
        "feedId": {int64},
        "offerId": "{string}",
        "count": {int32},
        "delivery": {boolean}
      },
      ...
    ]
  }
}
如何将派递资料传送至提货点(DBS)

在参数中指定 outlets 产品已有库存的所有提货点的id,如果产品尚未存在,您可以将产品交付给该提货点。 您需要在参数中指定请求中指定的区域中的所有合适的拾取点 region (即使参数包含一个不完整的地址:例如,只有一个城市或地区)。

如果不同的提货点的交货条件不同(例如,订单将在明天交付到某些点,而其他点 — 后天),在参数 deliveryOptions 为具有相同条件的每组点指定一个嵌套参数,并在每组点中列出适当的点。

如何传输有关数字商品的数据(DBS)

如果您已禁用使用该方法 POST cart,则不需要传输数据。

使用数字商品的说明

寄什么作为运费(DBS)

市场对客户有单一的交货率。 交付成本自动从统一的关税表中取代. 您可以传输任何数字。 — 不考虑通过API传输的运费数据。 提供了有关统一关税的详细信息 在市场对卖家的帮助.

日期范围和交货间隔(DBS)

在参数中指定 fromDatetoDate,嵌套在 dates,最早和最晚的可能交货日期,分别,并在参数 intervals — 日期和(如果可能的话,为快递递送)递送间隔, 用户可以选择.

一组嵌套在 dates,取决于订单交付方式:

  • 以速递派递方式订购("type": "DELIVERY")要么所有三个参数都应该传递(fromDate, toDate, intervals),或只有提前交货日期(fromDate).
  • 对于具有提货送货方式的订单("type": "PICKUP")只应传递参数 fromDatetoDate. 参数 intervals 你不能为这样的订单转移它。
例子:

为了便于阅读,示例代码以缩写格式提供。

你会在你的回应传达什么 POST cart

用户可以选择什么

"type": "DELIVERY",
"dates":
{
  "fromDate": "10-03-2021"
}

3月10日00:00-23:59

"type": "PICKUP",
"dates":
{
  "fromDate": "01-03-2021",
  "toDate": "03-03-2021"
}

3月1日00:00 — 3月3日23:59

Body

application/json
{
  "cart": {
    "paymentMethods": [
      "SHOP_PREPAID"
    ],
    "deliveryCurrency": "RUR",
    "items": [
      {
        "feedId": 0,
        "offerId": "example",
        "count": 0,
        "delivery": true,
        "sellerInn": "example"
      }
    ],
    "deliveryOptions": [
      {
        "id": "example",
        "price": 0.5,
        "deliveryServiceId": 0,
        "serviceName": "example",
        "type": "DELIVERY",
        "dates": {
          "fromDate": "23-09-2022",
          "toDate": "23-09-2022",
          "intervals": [
            null
          ]
        },
        "outlets": [
          {}
        ],
        "paymentMethods": [
          "SHOP_PREPAID"
        ]
      }
    ]
  }
}

Name

Description

cart

Type: object

deliveryCurrency

Type: string

货币代码:

  • RUR — 俄罗斯卢布。
  • UAH — 乌克兰格里夫纳。
  • BYR — 白俄罗斯卢布。
  • KZT — 哈萨克斯坦坚戈。
  • UZS — 乌兹别克总和。

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

deliveryOptions

Type: object[]

serviceName

Type: string

送货服务的名称。 所需参数。 最大长度:50个字符。

Example: example

dates

Type: object

fromDate

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

日期格式: DD-MM-YYYY.

Example: 23-09-2022

intervals

Type: object[]

fromTime

Type: string<time>

送时间间隔的开始。 所需参数。

时间格式:24小时, HH:MM. 而不是 毫米 始终指定 00 (例外 — 23:59).

最大值: 21:00.

Example: 12:00:00

toTime

Type: string<time>

送时间间隔的结束。 所需参数。

时间格式:24小时, HH:MM. 而不是 毫米 始终指定 00 (例外 — 23:59).

最大值: 23:59.

Example: 12:00:00

date

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

日期格式: DD-MM-YYYY.

Example: 23-09-2022

指定日期可能的交货日期和时间间隔的列表。 该参数最多可为每个日期指定7个间隔。 此参数是快递递送所必需的("type": "DELIVERY"). 必须与参数一起指定 toDatefromDate.

Max items: 7

Example
[
  {
    "date": "23-09-2022",
    "fromTime": "12:00:00",
    "toTime": "12:00:00"
  }
]

toDate

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

日期格式: DD-MM-YYYY.

Example: 23-09-2022

Example
{
  "fromDate": "23-09-2022",
  "toDate": "23-09-2022",
  "intervals": [
    {
      "date": "23-09-2022",
      "fromTime": "12:00:00",
      "toTime": "12:00:00"
    }
  ]
}

id

Type: string

商店分配的交付选项ID。 如果指定了ID,它将在请求中传递回存储。 POST order/accept. 最大长度:50个字符。

Example: example

outlets

Type: object[]

code

Type: string

店分配的取件点ID。

如果指定了不存在的标识符,则在下订单时不会向买方显示这样的提货点。

Example: example

接送点。 如果选择了拾音器,则表示("type": "PICKUP"). 在参数中指定 outlets 所有拾取点的id。 如果指定不存在的取件点Id,则传递选项将被忽略,其ID将不包含在请求中。 POST order/accept.

Example
[
  {
    "code": "example"
  }
]

paymentMethods

Type: string[]

Example
[
  "SHOP_PREPAID"
]

price

Type: number

以订单货币交付的成本。 从2021年7月1日起,将为客户推出统一的运费。 无论如何,运费都是一样的 这取决于谁交付订单:市场或卖家自己。 它将自动从统一的关税表中取代. 通过API传输的运费数据将不会被考虑在内。 但是,仍然需要向市场提供有关交货时间的信息。 有关更多信息,请参阅Yandex。对卖家的市场帮助

type

Type: string

订单交付方法:

  • DELIVERY — 快递送货。

  • PICKUP — 皮卡。

  • POST — 邮件。

  • DIGITAL — 用于数字商品。

  • UNKNOWN — 未知类型。

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

只适用于型号 DBS

送货选项可用于购物车.

Example
[
  {
    "id": "example",
    "price": 0.5,
    "serviceName": "example",
    "type": "DELIVERY",
    "dates": {
      "fromDate": "23-09-2022",
      "toDate": "23-09-2022",
      "intervals": [
        {
          "date": "23-09-2022",
          "fromTime": "12:00:00",
          "toTime": "12:00:00"
        }
      ]
    },
    "outlets": [
      {
        "code": "example"
      }
    ],
    "paymentMethods": [
      "SHOP_PREPAID"
    ]
  }
]

items

Type: object[]

count

Type: integer

可供订购的产品数量。

我应该发送什么值:

在参数中的请求中 count 市场发送买家需要的商品数量。

根据可用性,请返回:

  • 买方要求的货物数量或更多 — 如果货物过剩.

  • 可供选择的货物数量 — 如果它是少于必要的买方。 购物车中的信息将被更新,买方将能够下订单,只有可用的商品数量。

  • 0 — 如果产品缺货。 你买不到。

如果您启用了通过支持忽略余额的选项,请返回任何值,包括 0. 买方将根据购物车中指定的产品数量下订单。

delivery

Type: boolean

只适用于型号 DBS

将产品交付到请求中指定的区域:

  • false — 产品没有交付到指定的区域。
  • true — 默认值是产品交付到指定区域。

feedId

Type: integer

产品目录的ID。

您需要指定与Yandex请求中相同的标识符。市场。

offerId

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

  • 对于每个产品 SKU 一定有一个。

  • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.

重要

值开头和结尾的空格会自动删除。 例如, " SKU123 ""SKU123" 它们将被视为相同的值。

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Example: example

sellerInn

Type: string

只适用于型号 DBS

品的卖方的INN。

Example: example

购物车中的物品。

Example
[
  {
    "feedId": 0,
    "offerId": "example",
    "count": 0,
    "delivery": true,
    "sellerInn": "example"
  }
]

paymentMethods

Type: string[]

Example
[
  "SHOP_PREPAID"
]
Example
{
  "paymentMethods": [
    "SHOP_PREPAID"
  ],
  "deliveryCurrency": "RUR",
  "items": [
    {
      "feedId": 0,
      "offerId": "example",
      "count": 0,
      "delivery": true,
      "sellerInn": "example"
    }
  ],
  "deliveryOptions": [
    {
      "id": "example",
      "price": 0.5,
      "serviceName": "example",
      "type": "DELIVERY",
      "dates": {
        "fromDate": "23-09-2022",
        "toDate": "23-09-2022",
        "intervals": [
          {}
        ]
      },
      "outlets": [
        {
          "code": "example"
        }
      ],
      "paymentMethods": [
        "SHOP_PREPAID"
      ]
    }
  ]
}

400 Bad Request

如果商店考虑从Yandex收到的请求。 如果不正确,商店必须返回响应状态400,其中包含响应正文中错误原因的描述。 这些回应将被分析为API违规和市场上的缺陷。

500 Internal Server Error

如果商店一侧出现技术错误,它应该返回响应状态500。 具有大量此类响应的商店可能与市场脱节。

No longer supported, please use an alternative and newer version.