younifyd
Menu

taxCategory

A single Tax Category by ID or key — the tax rates that apply per country.

Use it in a workflow

  1. Add a step and choose the Commercetools connector.
  2. Pick the taxCategory action (under Tax).
  3. Fill in the fields below, then reference the result from later steps as {{taxcategory.response.data}}.

Query

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

graphql
query TaxCategory($id: String, $key: String) {
  taxCategory(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.

idstring

Queries with specified ID

keystring

Queries with specified key

json
{
  "id": "string",
  "key": "string"
}

Response

Read the result with {{taxcategory.response.data.data.taxCategory}}. If the API returns errors, the step fails and they are at {{taxcategory.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
isPlatformClientboolean
clientIdstring
externalUserIdstring
anonymousIdstring
customerRefobject2 fields
userRefobject2 fields
associateRefobject2 fields
attributedToobject3 fields

Need more? See the Commercetools guide for connection setup and behaviour shared by every action.

Was this page helpful?
taxCategory — Commercetools — Documentation