updateTaxCategory

Update an existing tax category — pass its current version and an array of update actions.

Use it in a workflow

Add a step and choose the Commercetools connector.
Pick the updateTaxCategory action (under Update).
Fill in the fields below, then reference the result from later steps as {{updatetaxcategory.response.data}}.

Query

This is the mutation the action sends by default. Edit it in the step's Query field to change which fields come back.

graphql

mutation UpdateTaxCategory($version: Long!, $actions: [TaxCategoryUpdateAction!]!, $id: String, $key: String) {
  updateTaxCategory(version: $version, actions: $actions, id: $id, key: $key) {
    name
    description
    rates {
      name
      amount
      includedInPrice
      country
      state
      id
      key
      subRates {
        name
        amount
      }
    }
    key
    id
    version
    createdAt
    lastModifiedAt
    createdBy {
      isPlatformClient
      clientId
      externalUserId
      anonymousId
      customerRef {
        typeId
        id
      }
      userRef {
        typeId
        id
      }
      associateRef {
        typeId
        id
      }
      attributedTo {
        clientId
        source
        userRef
      }
    }
    lastModifiedBy {
      isPlatformClient
      clientId
      externalUserId
      anonymousId
      customerRef {
        typeId
        id
      }
      userRef {
        typeId
        id
      }
      associateRef {
        typeId
        id
      }
      attributedTo {
        clientId
        source
        userRef
      }
    }
  }
}

Variables

Pass these as a JSON object in the step's Variables field.

versionstringrequired

actionsarray<object>required

changeNameobject1 fields

setDescriptionobject1 fields

addTaxRateobject1 fields

replaceTaxRateobject3 fields

removeTaxRateobject2 fields

setKeyobject1 fields

idstring

Queries with specified ID

keystring

Queries with specified key

json

{
  "version": "string",
  "actions": [
    {
      "changeName": {
        "name": "string"
      },
      "setDescription": {
        "description": "string"
      },
      "addTaxRate": {
        "taxRate": "string"
      },
      "replaceTaxRate": {
        "taxRate": "string",
        "taxRateId": "string",
        "taxRateKey": "string"
      },
      "removeTaxRate": {
        "taxRateId": "string",
        "taxRateKey": "string"
      },
      "setKey": {
        "key": "string"
      }
    }
  ],
  "id": "string",
  "key": "string"
}

Response

Read the result with {{updatetaxcategory.response.data.data.updateTaxCategory}}. If the API returns errors, the step fails and they are at {{updatetaxcategory.response.data.errors}}.

namestring

descriptionstring

ratesarray<object>

nameobject

amountobject

includedInPriceobject

countryobject

stateobject

idobject

keyobject

subRatesobject

keystring

idstring

versionstring

createdAtstring

lastModifiedAtstring

createdByobject

isPlatformClientboolean

clientIdstring

externalUserIdstring

anonymousIdstring

customerRefobject2 fields

userRefobject2 fields

associateRefobject2 fields

attributedToobject3 fields

lastModifiedByobject