--- title: "BenefitsInfo" description: "会员等级下权益的基本信息" doc_type: graphql doc_category: adminGraphQL doc_version: v20270301 source_url: html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/benefits-info' md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/benefits-info.md' --- # BenefitsInfo 会员等级下权益的基本信息 - **API Version:** v20270301 - **API Type:** Admin - **API Protocol:** GraphQL - **Operation Type:** Object ## Type Signature `BenefitsInfo` ## Fields * `autoStackLimit` [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md) 是否允许与自动折扣叠加使用。 * `benefitsDescription` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 权益描述。 仅当 membershipType = PAID 时有效。 最多500个字符。 * `benefitsDetails` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 当 rewardType 为 PERCENTAGE_DISCOUNT,CASH_VOUCHER，FREE_SHIPPING 或 POINTS 时，表示这些优惠对应的折扣值，比如优惠x% * `benefitsExpiryDateType` [BenefitsExpiryDateType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/benefits-expiry-date-type.md) 权益的有效期类型。 仅当 membershipType = PAID 时有效。 * `benefitsExpiryDateValue` [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md) 权益下发后x天失效，返回数值x。 仅当 benefitsExpiryDateType = SPECIFIC_DATE 时有效。 * `benefitsIcon` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 权益icon的URL * `benefitsIssuranceType` [BenefitsIssuranceType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/benefits-issurance-type.md) 权益下发时间。 仅当 membershipType = PAID 时有效。 * `benefitsName` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 权益名称。 仅当 membershipType = PAID 时有效。 最多25个字符 * `benefitsStatus` [BenefitsStatus](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/benefits-status.md) 权益是否有效。 * `benefitsUsageInstructionType` [BenefitsUsageInstructionType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/benefits-usage-instruction-type.md) 权益使用条件类型 * `benefitsUsageInstructionValue` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 当rewardType = PERCENTAGE_DISCOUNT 或 CASH_VOUCHER 或 FREE_SHIPPING 时有效。表示 benefitsUsageInstructionType 对应的数值。 * `birthBenefitsReleaseType` [BirthBenefitsReleaseType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/birth-benefits-release-type.md) 生日月权益发放时间类型。 当 rewardScene = BIRTH_BENEFITS 有效。 * `codeStackLimit` [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md) 是否允许与折扣码叠加使用。 * `daysBefore` [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md) 仅当 birthBenefitsReleaseType = FIXED_BEFORE 时有效 * `fixedDate` [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md) 每月发放的日期。 仅当 birthBenefitsReleaseType = FIXED_DATE 时有效 * `periodicallyDays` [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md) 权益每x天发放一次，返回数值x。 仅当 benefitsIssuranceType = PERIODICALLY 时有效。 * `periodicallyMonths` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 权益每x个自然月发放一次，返回数值x。 仅当 benefitsIssuranceType = PERIODICALLY 时有效。 * `productsApplicableType` [ProductsApplicableType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/products-applicable-type.md) 当 rewardScene = BIRTH_BENEFITS, 或 rewardType = PERCENTAGE_DISCOUNT 或 CASH_VOUCHER 或 FREE_SHIPPING 时有效。 * `rewardType` [RewardType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/reward-type.md) 奖励类型。 * `specificCategoryList` [[String]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 适用的商品分类ID集合列表。仅当 productsApplicableType = SPECIFIC_CATEGORY 时有效。 * `specificDate` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 权益下发日期。格式为：MM-DD。 仅当 benefitsIssuranceType = SPECIFIC_DATE 时有效。 * `specificProductIds` [[String]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 适用的商品ID。仅当 productsApplicableType = SPECIFIC_PRODUCT 时有效。 * `usageLimitsTimes` [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md) 限制的使用次数。仅当 usageLimitsType = LIMITS 时有效。 * `usageLimitsType` [UsageLimitsType](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/usage-limits-type.md) 是否有使用次数限制。 ## Schema Definition ```graphql type BenefitsInfo { autoStackLimit: Boolean benefitsDescription: String benefitsDetails: String benefitsExpiryDateType: BenefitsExpiryDateType benefitsExpiryDateValue: Int benefitsIcon: String benefitsIssuranceType: BenefitsIssuranceType benefitsName: String benefitsStatus: BenefitsStatus benefitsUsageInstructionType: BenefitsUsageInstructionType benefitsUsageInstructionValue: String birthBenefitsReleaseType: BirthBenefitsReleaseType codeStackLimit: Boolean daysBefore: Int fixedDate: Int periodicallyDays: Int periodicallyMonths: String productsApplicableType: ProductsApplicableType rewardType: RewardType specificCategoryList: [String] specificDate: String specificProductIds: [String] usageLimitsTimes: Int usageLimitsType: UsageLimitsType } ``` ## Field from * [Benefits](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/benefits.md).benefitsInfo 会员等级下权益的基本信息 ## Error Handling 关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes)。