获得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<int64>

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

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

Min value: 1

Query parameters

Name

Description

limit

Type: integer<int32>

每页的值数。

Min value: 1
Example: 20

page_token

Type: string

结果页面的ID。

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

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

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

Responses

200 OK

有关订单提货点的信息。

Body

application/json

{
    "status": "OK",
    "result": {
        "logisticPoints": [
            {
                "logisticPointId": 0,
                "brand": "MARKET",
                "address": {
                    "fullAddress": "string",
                    "gps": {
                        "latitude": 0,
                        "longitude": 0
                    },
                    "regionId": 0,
                    "city": "string",
                    "street": "string",
                    "house": "string",
                    "building": "string",
                    "block": "string",
                    "km": 0,
                    "additional": "string"
                },
                "workingSchedule": {
                    "schedule": [
                        {
                            "day": "MONDAY",
                            "startTime": "string",
                            "endTime": "string"
                        }
                    ],
                    "holidays": [
                        "string"
                    ]
                },
                "deliveryRestrictions": {
                    "dimensionsRestrictions": {
                        "weight": 0,
                        "height": 0,
                        "width": 0,
                        "length": 0,
                        "dimensionsSum": 0
                    }
                },
                "features": [
                    "RETURN_ALLOWED"
                ],
                "paymentTypes": [
                    "PREPAID"
                ],
                "storagePeriod": 0
            }
        ],
        "paging": {
            "nextPageToken": "string"
        }
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

result

Type: GetLogisticsPointsDTO

有关订单提货点的信息。

ApiResponseStatusType

响应的类型。可能的值:

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

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

GetLogisticsPointsDTO

有关订单提货点的信息。

Name

Description

logisticPoints*

Type: LogisticPointDTO[]

订购上门收件点。
接点的信息。

paging

Type: ForwardScrollingPagerDTO

下一页的ID。

LogisticPointDTO

接点的信息。

Name	Description
address*	Type: LogisticPointAddressDTO 取点的地址。
brand*	Type: LogisticPointBrandType 接送点类型: `MARKET` — 市场回升点。 Enum: `MARKET`
deliveryRestrictions*	Type: LogisticPointDeliveryRestrictionDTO 运送到取货点的限制。
logisticPointId*	Type: integer<int64> 取件点的ID。使用该方法可以找到 POST v1/businesses/{businessId}/logistics-points. Min value: `1`
paymentTypes*	Type: DeliveryPaymentType[] 在这个提货点可用的付款方法。订购付款类别: `PREPAID` — 结账时付款。 Enum: `PREPAID` Min items: `1` Unique items
storagePeriod*	Type: integer<int64> 取货点订单的保质期。以天为单位指定。
workingSchedule*	Type: LogisticPointScheduleDTO 接送点的开放时间。
features	Type: LogisticPointFeatureType[] 拾取点的属性。接送点的财产: `RETURN_ALLOWED` — 可用于退货。 Enum: `RETURN_ALLOWED` Min items: `1` Unique items

ForwardScrollingPagerDTO

下一页的ID。

Name

Description

nextPageToken

Type: string

下一个结果页面的ID。

LogisticPointAddressDTO

取点的地址。

Name	Description
fullAddress*	Type: string 详细地址。 Min length: `1` Max length: `512`
gps*	Type: GpsDTO 纬度和经度的GPS坐标。
regionId*	Type: integer<int64> 区域的ID。有关区域的信息可以使用该方法获得 GET v2/regions.
additional	Type: string 其他资料。 Min length: `1` Max length: `1024`
block	Type: string 建筑物编号。 Min length: `1` Max length: `16`
building	Type: string 建筑物编号。 Min length: `1` Max length: `16`
city	Type: string 城市。 Min length: `1` Max length: `128`
house	Type: string 门牌号。 Min length: `1` Max length: `16`
km	Type: integer<int32> 取点所在公里的序数。如果地址中没有街道，则表示。 Min value: `0`
street	Type: string 街道。 Min length: `1` Max length: `128`

LogisticPointBrandType

接送点类型:

MARKET — 市场回升点。

Type	Description
LogisticPointBrandType	Enum: `MARKET`

LogisticPointDeliveryRestrictionDTO

运送到取货点的限制。

Name

Description

dimensionsRestrictions*

Type: LogisticPointDimensionRestrictionsDTO

单个产品尺寸的限制。

DeliveryPaymentType

订购付款类别:

PREPAID — 结账时付款。

Type	Description
DeliveryPaymentType	Enum: `PREPAID`

LogisticPointScheduleDTO

接送点的开放时间。

Name

Description

schedule*

Type: ScheduleDayDTO[]

工作时间表。
工作的日子和时间。

Min items: 1

holidays

Type: string[]

假期的时间表。
公共假期。

日期格式: YYYY-MM-DD.

Min items: 1

Unique items

LogisticPointFeatureType

接送点的财产:

RETURN_ALLOWED — 可用于退货。

Type	Description
LogisticPointFeatureType	Enum: `RETURN_ALLOWED`

GpsDTO

纬度和经度的GPS坐标。

Name

Description

latitude*

Type: number

宽度。

longitude*

Type: number

经度。

LogisticPointDimensionRestrictionsDTO

单个产品尺寸的限制。

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

ScheduleDayDTO

工作的日子和时间。

Name	Description
day*	Type: DayOfWeekType 星期几: `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]<code>\|</code>2[0-3]):[0-5][0-9]$`
startTime*	Type: string 工作日的开始时间。格式: `HH：MM`. Pattern: `^([0-1][0-9]<code>\|</code>2[0-3]):[0-5][0-9]$`

DayOfWeekType

星期几:

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

Type	Description
DayOfWeekType	Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`

400 Bad Request

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

401 Unauthorized

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

403 Forbidden

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

420 Method Failure

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

500 Internal Server Error

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

获得PVZ积分

Request

Path parameters

Query parameters

Responses

200 OK

Body

ApiResponseStatusType

GetLogisticsPointsDTO

LogisticPointDTO

ForwardScrollingPagerDTO

LogisticPointAddressDTO

LogisticPointBrandType

LogisticPointDeliveryRestrictionDTO

DeliveryPaymentType

LogisticPointScheduleDTO

LogisticPointFeatureType

GpsDTO

LogisticPointDimensionRestrictionsDTO

ScheduleDayDTO

DayOfWeekType

400 Bad Request

Body

ApiErrorDTO

401 Unauthorized

Body

403 Forbidden

Body

420 Method Failure

Body

500 Internal Server Error

Body

这篇文章是否有用？