---
title: "inventoryBulkToggleActivation"
description: "调整库存项在各个地点的激活状态。 1. 在特定地点激活库存项，则允许该地点存储该库存项 2. 在特定地点停用库存项，将清空该地点的库存数量并关闭该库存商品的使用"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/mutations/inventory-bulk-toggle-activation'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/mutations/inventory-bulk-toggle-activation.md'
---
# inventoryBulkToggleActivation

调整库存项在各个地点的激活状态。
1. 在特定地点激活库存项，则允许该地点存储该库存项
2. 在特定地点停用库存项，将清空该地点的库存数量并关闭该库存商品的使用

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`InventoryBulkToggleActivationPayload!`

## Arguments

* `inventoryItemId`

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

  要修改激活状态的库存项的ID

* `inventoryItemUpdates`

  [[InventoryBulkToggleActivationInput!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/inputs/inventory-bulk-toggle-activation-input.md)

  输入字段用来确定库存项在指定地点是否被激活，最多支持输入100个更新项

## Returns

* `inventoryItem`

  [InventoryItem](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-item.md)

  已更新的库存对象。

* `inventoryLevels`

  [[InventoryLevel]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-level.md)

  已经被激活或启用的具体库存数量

* `userErrors`

  [[UserError!]!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/user-error.md)

  执行更改时发生的错误列表。

## Code Example

```graphql
mutation inventoryBulkToggleActivation($inventoryItemId: ID! $inventoryItemUpdates: [InventoryBulkToggleActivationInput!] ) {
	inventoryBulkToggleActivation(inventoryItemId: $inventoryItemId, inventoryItemUpdates: $inventoryItemUpdates ) 
		 {
			# InventoryBulkToggleActivationPayload fields
		}
		
	}

```

## Variables

```json
{
  "inventoryItemId": {},
  "inventoryItemUpdates": {
    "activate": {},
    "locationId": {}
  }
}
```

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