---
title: "PointsRedemptionRule"
description: "积分兑换规则的详细信息。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/points-redemption-rule'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/points-redemption-rule.md'
---
# PointsRedemptionRule

积分兑换规则的详细信息。

- **API Version:** v20260901
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Fields

* `id`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  规则 ID。

* `name`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  规则名称。

* `customisedDescription`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  规则的自定义描述。

* `icon`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  规则的图标 URL。

* `channel`

  [PointRuleChannel](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/point-rule-channel.md)

  规则适用渠道。

* `allowRevokeRedemption`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  是否允许撤销兑换。
  - `true`：允许
  - `false`：不允许

* `ruleType`

  [RuleType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/rule-type.md)

  积分扣减的类型。

* `point`

  [RedemptionRulePoint](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/redemption-rule-point.md)

  积分兑换权益配置。

* `pointsAutoDeduct`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  结账时是否自动使用积分抵扣现金。仅当 `ruleType` 为 `CASHBACK` 时有效。
  - `true`：自动抵扣
  - `false`：不自动抵扣

* `disablePointsRefund`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  退款时积分是否不可退回。仅当 `ruleType` 为 `CASHBACK` 时有效。
  - `true`：退款时积分不可退回。
  - `false`：退款时积分可退回。

* `benefitRedemptionCondition`

  [BenefitRedemptionCondition](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/benefit-redemption-condition.md)

  权益兑换条件配置。

* `cashbackbenefitsUsageThreshold`

  [CashbackBenefitsUsageThreshold](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/cashback-benefits-usage-threshold.md)

  积分抵现权益的使用门槛与限制。

* `couponUsageScope`

  [CouponUsageScope](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/coupon-usage-scope.md)

  优惠券使用者范围。

* `productsApplicableType`

  [ProductsApplicableType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/products-applicable-type.md)

  适用商品范围。

* `autoStackLimit`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  是否允许与自动折扣叠加使用。
  - `true`：允许
  - `false`：不允许

* `codeStackLimit`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  是否允许与折扣码叠加使用。
  - `true`：允许
  - `false`：不允许

* `expiryRule`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md)

  积分兑换后，权益的有效期（天）。返回 `null` 表示权益永久有效。

* `redemptionLimit`

  [RedemptionLimit](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/redemption-limit.md)

  兑换次数限制。

* `specificCategoryIds`

  [[ID]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  适用的商品分类 ID 列表。仅当 `productsApplicableType` 为 `SPECIFIC_CATEGORY` 时有效。

* `specificProductIds`

  [[ID]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  适用的商品 ID 列表。仅当 `productsApplicableType` 为 `SPECIFIC_PRODUCT` 时有效。

## Field from

* [CustomerPointsRedemptionRuleInfoEdge](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/customer-points-redemption-rule-info-edge.md).node

* [CustomerPointsRedemptionRuleConnection](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/customer-points-redemption-rule-connection.md).nodes