获得PVZ积分

Info

Console

目前不适用于卖家Market Yandex Go.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

inventory-and-order-processing — 订单处理和商品核算
inventory-and-order-processing:read-only — 查看订单信息
pricing — 价格管理
pricing:read-only — 查看价格
offers-and-cards-management — 商品和卡片管理
offers-and-cards-management:read-only — 查看商品和卡片
promotion — 商品推广
promotion:read-only — 查看商品推广信息
finance-and-accounting — 查看财务信息和报告
communication — 与买家沟通
settings-management — 店铺设置
supplies-management:read-only — 获取有关FBY应用程序的信息
all-methods — 全面管理账户
all-methods:read-only — 查看所有数据

返回订单提货点列表。

定期请求此信息以保持商店系统中的最新数据。例如，每天一次。

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

Request

POST

https://api.partner.market.yandex.ru/v1/businesses/{businessId}/logistics-points

Path parameters

Name

Description

businessId

Type: integer

内阁ID。要找到答案，请使用请求 GET v2/campaigns.

ℹ️ 什么是市场上的橱柜和商店？

Min value: 1

Query parameters

Name

Description

limit

Type: integer

每页的值数。

Min value: 1

page_token

Type: string

结果页面的ID。

如果省略该参数，则返回第一页。

我们建议传输输出参数的值 nextPageToken，在最后一次请求期间接收。

如果设置 page_token 并且请求有参数 page 和 pageSize 它们被忽略了。

Example: eyBuZXh0SWQ6IDIzNDIgfQ==

Responses

200 OK

有关订单提货点的信息。

Body

application/json

{
  "status": "OK",
  "result": {
    "logisticPoints": [
      {
        "logisticPointId": 1,
        "brand": "MARKET",
        "address": {},
        "workingSchedule": {},
        "deliveryRestrictions": {},
        "features": [
          null
        ],
        "paymentTypes": [
          null
        ],
        "storagePeriod": 0
      }
    ],
    "paging": {
      "nextPageToken": "example"
    }
  }
}

Type: object

All of 2 types

Type: object
status

Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

result

Type: object

logisticPoints

Type: object[]

address

Type: object

fullAddress

Type: string

详细地址。

Min length: 1

Max length: 512

Example: example

gps

Type: object

latitude

Type: number

宽度。

longitude

Type: number

经度。

纬度和经度的GPS坐标。

Example

{
  "latitude": 0.5,
  "longitude": 0.5
}

regionId

Type: integer

区域的ID。

有关区域的信息可以使用该方法获得 GET v2/regions.

additional

Type: string

其他资料。

Min length: 1

Max length: 1024

Example: example

block

Type: string

建筑物编号。

Min length: 1

Max length: 16

Example: example

building

Type: string

建筑物编号。

Min length: 1

Max length: 16

Example: example

city

Type: string

城市。

Min length: 1

Max length: 128

Example: example

house

Type: string

门牌号。

Min length: 1

Max length: 16

Example: example

Type: integer

取点所在公里的序数。

如果地址中没有街道，则表示。

Min value: 0

street

Type: string

街道。

Min length: 1

Max length: 128

Example: example

取点的地址。

Example

{
  "fullAddress": "example",
  "gps": {
    "latitude": 0.5,
    "longitude": 0.5
  },
  "regionId": 0,
  "city": "example",
  "street": "example",
  "house": "example",
  "building": "example",
  "block": "example",
  "km": 0,
  "additional": "example"
}

brand

Type: string

接送点类型:

MARKET — 市场回升点。

Const: MARKET

Example: example

deliveryRestrictions

Type: object

dimensionsRestrictions

Type: object

dimensionsSum	Type: integer 以厘米为单位的最大测量量。 Min value: `1`
height	Type: integer 厘米为单位的最大高度。 Min value: `1`
length	Type: integer 以厘米为单位的最大长度。 Min value: `1`
weight	Type: integer 以克为单位的最大重量。 Min value: `1`
width	Type: integer 最大宽度以厘米为单位。 Min value: `1`

单个产品尺寸的限制。

Example

{
  "weight": 1,
  "height": 1,
  "width": 1,
  "length": 1,
  "dimensionsSum": 1
}

运送到取货点的限制。

Example

{
  "dimensionsRestrictions": {
    "weight": 1,
    "height": 1,
    "width": 1,
    "length": 1,
    "dimensionsSum": 1
  }
}

logisticPointId

Type: integer

取件点的ID。

使用该方法可以找到 POST v1/businesses/{businessId}/logistics-points.

Min value: 1

paymentTypes

Type: string[]

在这个提货点可用的付款方法。

Min items: 1

Unique items: true

Example

[
  "example"
]

storagePeriod

Type: integer

取货点订单的保质期。

以天为单位指定。

workingSchedule

Type: object

schedule

Type: object[]

day

Type: string

星期几:

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

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

endTime

Type: string

工作日结束的时间。

格式: HH：MM.

Pattern: ^([0-1][0-9]|2[0-3]):[0-5][0-9]$

Example: example

startTime

Type: string

工作日的开始时间。

格式: HH：MM.

Pattern: ^([0-1][0-9]|2[0-3]):[0-5][0-9]$

Example: example

工作时间表。

Min items: 1

Example

[
  {
    "day": "MONDAY",
    "startTime": "example",
    "endTime": "example"
  }
]

holidays

Type: string<date>[] | null

公众假期的时间表。

Min items: 1

Unique items: true

Example

[
  "2025-01-01"
]

接送点的开放时间。

Example

{
  "schedule": [
    {
      "day": "MONDAY",
      "startTime": "example",
      "endTime": "example"
    }
  ],
  "holidays": [
    "2025-01-01"
  ]
}

features

Type: string[] | null

拾取点的属性。

Min items: 1

Unique items: true

Example

[
  "example"
]

订购上门收件点。

Example

[
  {
    "logisticPointId": 1,
    "brand": "MARKET",
    "address": {
      "fullAddress": "example",
      "gps": {
        "latitude": 0.5,
        "longitude": 0.5
      },
      "regionId": 0,
      "city": "example",
      "street": "example",
      "house": "example",
      "building": "example",
      "block": "example",
      "km": 0,
      "additional": "example"
    },
    "workingSchedule": {
      "schedule": [
        {
          "day": "MONDAY",
          "startTime": "example",
          "endTime": "example"
        }
      ],
      "holidays": [
        "2025-01-01"
      ]
    },
    "deliveryRestrictions": {
      "dimensionsRestrictions": {
        "weight": 1,
        "height": 1,
        "width": 1,
        "length": 1,
        "dimensionsSum": 1
      }
    },
    "features": [
      "RETURN_ALLOWED"
    ],
    "paymentTypes": [
      "PREPAID"
    ],
    "storagePeriod": 0
  }
]

paging

Type: object

nextPageToken

Type: string

下一个结果页面的ID。

Example: example

下一页的ID。

Example

{
  "nextPageToken": "example"
}

有关订单提货点的信息。

Example

{
  "logisticPoints": [
    {
      "logisticPointId": 1,
      "brand": "MARKET",
      "address": {
        "fullAddress": "example",
        "gps": {
          "latitude": 0.5,
          "longitude": 0.5
        },
        "regionId": 0,
        "city": "example",
        "street": "example",
        "house": "example",
        "building": "example",
        "block": "example",
        "km": 0,
        "additional": "example"
      },
      "workingSchedule": {
        "schedule": [
          {}
        ],
        "holidays": [
          "2025-01-01"
        ]
      },
      "deliveryRestrictions": {
        "dimensionsRestrictions": {
          "weight": 1,
          "height": 1,
          "width": 1,
          "length": 1,
          "dimensionsSum": 1
        }
      },
      "features": [
        "RETURN_ALLOWED"
      ],
      "paymentTypes": [
        "PREPAID"
      ],
      "storagePeriod": 0
    }
  ],
  "paging": {
    "nextPageToken": "example"
  }
}

Example

{
  "result": {
    "logisticPoints": [
      {
        "logisticPointId": 1,
        "brand": "MARKET",
        "address": {
          "fullAddress": "example",
          "gps": {},
          "regionId": 0,
          "city": "example",
          "street": "example",
          "house": "example",
          "building": "example",
          "block": "example",
          "km": 0,
          "additional": "example"
        },
        "workingSchedule": {
          "schedule": [
            null
          ],
          "holidays": [
            null
          ]
        },
        "deliveryRestrictions": {
          "dimensionsRestrictions": {}
        },
        "features": [
          "RETURN_ALLOWED"
        ],
        "paymentTypes": [
          "PREPAID"
        ],
        "storagePeriod": 0
      }
    ],
    "paging": {
      "nextPageToken": "example"
    }
  }
}

400 Bad Request

请求包含不正确的数据。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

获得PVZ积分

Request

Path parameters

Query parameters

Responses

200 OK

Body

400 Bad Request

Body

401 Unauthorized

Body

403 Forbidden

Body

420 Method Failure

Body

500 Internal Server Error

Body

这篇文章是否有用？