---
title: "discountCodeBulkDeactivate"
description: "使用搜索查询或者折扣码 ID 异步批量停用代码折扣。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/mutations/discount-code-bulk-deactivate'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/mutations/discount-code-bulk-deactivate.md'
---
# discountCodeBulkDeactivate

使用搜索查询或者折扣码 ID 异步批量停用代码折扣。

- **Required Scopes:** `write_discounts`
- **API Version:** v20260901
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`DiscountCodeBulkDeactivatePayload`

## Required Permissions

* `write_discounts`

接口访问需要令牌，具体如何获取令牌请参考：[身份认证](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md)

## Arguments

* `search`

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

  用于筛选代码折扣的搜索查询

* `ids`

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

  要停用的代码折扣 ID

## Returns

* `job`

  [Job](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/job.md)

  停用代码折扣的异步作业

* `userErrors`

  [[DiscountUserError!]!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-user-error.md)

  执行突变时发生的错误列表

## Code Example

```graphql
mutation discountCodeBulkDeactivate($search: String $ids: [ID] ) {
	discountCodeBulkDeactivate(search: $search, ids: $ids ) 
		 {
			# DiscountCodeBulkDeactivatePayload fields
		}
		
	}

```

## Variables

```json
{
  "ids": {},
  "search": {}
}
```

## 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)。