创建销售点

方法适用于模式DBS.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
  • settings-management — 店铺设置
  • all-methods — 全面管理账户

在市场上创建商店的销售点。

⚙️ 限制: 每小时100,000次请求

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/outlets

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:

  • 座 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

Min value: 1

Body

application/json
{
    "name": "string",
    "type": "DEPOT",
    "coords": "string",
    "isMain": false,
    "shopOutletCode": "string",
    "visibility": "HIDDEN",
    "address": {
        "regionId": 0,
        "street": "string",
        "number": "string",
        "building": "string",
        "estate": "string",
        "block": "string",
        "additional": "string",
        "km": 0,
        "city": "string"
    },
    "phones": [
        "string"
    ],
    "workingSchedule": {
        "workInHoliday": false,
        "scheduleItems": [
            {
                "startDay": "MONDAY",
                "endDay": "MONDAY",
                "startTime": "09:59",
                "endTime": "23:59"
            }
        ]
    },
    "deliveryRules": [
        {
            "minDeliveryDays": 0,
            "maxDeliveryDays": 0,
            "deliveryServiceId": 0,
            "orderBefore": 0,
            "priceFreePickup": 0,
            "unspecifiedDeliveryInterval": false
        }
    ],
    "storagePeriod": 0
}

Name

Description

address*
Type: object

regionId*

Type: integer<int64>

区域的ID。

您可以使用请求获取ID GET v2/regions.

创建和编辑销售点时的区域类型

仅指定以下类型的区域 TOWN (城市), CITY (大城市)及 REPUBLIC_AREA （联邦主体区）。 区域的类型在输出参数中指定 type 请求 GET v2/regions 和 GET v2/regions/{regionId}.

additional

Type: string

其他资料。

block

Type: string

建筑物编号。

Max length: 16

building

Type: string

建筑物编号。

Max length: 16

city

⦸

Type: string

在响应中，参数中返回城市和城镇 regionId.

Max length: 200

estate

Type: string

所有权号码。

Max length: 16

km

Type: integer<int32>

销售点所在道路的公里数的序数，如果没有街道。

number

Type: string

门牌号。

Max length: 256

street

Type: string

街道。

Max length: 512

销售点的地址。

name*

Type: string

销售点的名称。

phones*

Type: string[]

销售点的电话号码。 格式发送: +7 (999) 999-99-99.

Min length: 1

Min items: 1

Unique items  

type*

Type: string

销售点的类型。

可能的值:

  • DEPOT — 接单点。
  • MIXED — 混合类型的销售点（销售楼层和订单提货点）。
  • RETAIL — 零售销售点（销售楼层）。
  • NOT_DEFINED — 未知类型的销售点。 确定类型时出错。

Enum: DEPOT, MIXED, RETAIL, NOT_DEFINED

workingSchedule*
Type: object

scheduleItems*

Type: object[]

销售点的开放时间列表。
销售点的开放时间。

Min items: 1

workInHoliday

Type: boolean

指示销售点是否在公众假期开放。

可能的值:

  • false — 销售点在公众假期休息。
  • true — 销售点在公众假期开放。

销售点的操作模式列表。

coords

Type: string

销售点的坐标。

格式：经度，纬度。 分隔符：逗号和/或空格。 例如, 20.4522144, 54.7104264.

如果没有传递参数，则坐标将由嵌套在其中的参数的值确定 address.

deliveryRules

Type: object[]

有关此销售点的交货条款的信息。

必需的参数，如果参数 类型=仓库 或 类型=混合.
有关此销售点的交货条款的信息。

Min items: 1

isMain

Type: boolean

表示主要销售点。

可能的值:

  • false — 非主要销售点。
  • true — 的主要销售点。

shopOutletCode

Type: string

店分配的销售点的ID。

storagePeriod

Type: integer<int64>

订单在自己的订单提货点的存储期。 它以天计算。

visibility

Type: string

销售点的状态。

可能的值:

  • HIDDEN — 销售点被禁用。
  • VISIBLE — 销售点已启用。
  • UNKNOWN — 销售点状况不明。 确定状态时发生错误。

Enum: HIDDEN, VISIBLE, UNKNOWN

Responses

200 OK

有关创建的销售点的信息。

Body

application/json
{
    "status": "OK",
    "result": {
        "id": 0
    }
}

Name

Description

status*

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

result
Type: object

id

Type: integer<int64>

Yandex分配的销售点的ID。市场。

请求执行的结果。 输出if 状态="OK".

400 Bad Request

资料描述 解释说明 解决方法
datediff-is-to-big-local 对于您所在地区的交货，最长和最短交货时间之间的差异不应超过两天。 确保两者之间的区别 maxDeliveryDays 和 minDeliveryDays 不超过两天。
datediff-is-to-big-remote 对于交付到其他地区，最长和最短交付时间之间的差异不应超过四天。 确保两者之间的区别 maxDeliveryDays 和 minDeliveryDays 不超过四天。
datediff-is-to-big-long-period 配送至最短配送时间超过18天的其他地区时，最长配送时间与最短配送时间之差不应超过最短配送时间。 确保两者之间的区别 maxDeliveryDays 和 minDeliveryDays 不超过 minDeliveryDays.

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

市场的内部错误。 有关错误的更多信息

Body

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

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

上一篇
多个销售点
下一篇
改变