younifyd
Menu

businessUnits

Query business units — supports a `where` predicate, `sort`, and `limit`/`offset` paging.

Use it in a workflow

  1. Add a step and choose the Commercetools connector.
  2. Pick the businessUnits action (under Business).
  3. Fill in the fields below, then reference the result from later steps as {{businessunits.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 BusinessUnits($where: String, $sort: [String!], $limit: Int, $offset: Int) {
  businessUnits(where: $where, sort: $sort, limit: $limit, offset: $offset) {
    offset
    count
    total
    exists
    results {
      id
      key
      name
      contactEmail
      addresses {
        id
        streetName
        streetNumber
        additionalStreetInfo
        postalCode
        city
        region
        state
        country
        company
        department
        building
        apartment
        pOBox
        additionalAddressInfo
        externalId
        key
        phone
        mobile
        email
        fax
        title
        salutation
        firstName
        lastName
        custom
      }
      defaultShippingAddress {
        id
        streetName
        streetNumber
        additionalStreetInfo
        postalCode
        city
        region
        state
        country
        company
        department
        building
        apartment
        pOBox
        additionalAddressInfo
        externalId
        key
        phone
        mobile
        email
        fax
        title
        salutation
        firstName
        lastName
        custom
      }
      defaultBillingAddress {
        id
        streetName
        streetNumber
        additionalStreetInfo
        postalCode
        city
        region
        state
        country
        company
        department
        building
        apartment
        pOBox
        additionalAddressInfo
        externalId
        key
        phone
        mobile
        email
        fax
        title
        salutation
        firstName
        lastName
        custom
      }
      defaultShippingAddressId
      defaultBillingAddressId
      shippingAddresses {
        id
        streetName
        streetNumber
        additionalStreetInfo
        postalCode
        city
        region
        state
        country
        company
        department
        building
        apartment
        pOBox
        additionalAddressInfo
        externalId
        key
        phone
        mobile
        email
        fax
        title
        salutation
        firstName
        lastName
        custom
      }
      billingAddresses {
        id
        streetName
        streetNumber
        additionalStreetInfo
        postalCode
        city
        region
        state
        country
        company
        department
        building
        apartment
        pOBox
        additionalAddressInfo
        externalId
        key
        phone
        mobile
        email
        fax
        title
        salutation
        firstName
        lastName
        custom
      }
      shippingAddressIds
      billingAddressIds
      status
      storesRef {
        typeId
        key
      }
      stores {
        id
        version
        key
        nameAllLocales
        languages
        countries
        productSelections
        distributionChannelsRef
        distributionChannels
        supplyChannelsRef
        supplyChannels
        storefront
        createdAt
        lastModifiedAt
        custom
        createdBy
        lastModifiedBy
      }
      storeMode
      unitType
      associates {
        associateRoleAssignments
        customerRef
        customer
      }
      associateMode
      inheritedAssociates {
        associateRoleAssignments
        customerRef
        customer
      }
      custom {
        typeRef
        type
      }
      parentUnitRef {
        typeId
        key
      }
      parentUnit
      ancestors
      inheritedStores {
        store
        storeRef
      }
      topLevelUnitRef {
        typeId
        key
      }
      topLevelUnit
      approvalRuleMode
      customerGroupAssignments {
        customerGroupRef
        customerGroup
      }
      version
      createdAt
      lastModifiedAt
      createdBy {
        isPlatformClient
        clientId
        externalUserId
        anonymousId
        customerRef
        userRef
        associateRef
        attributedTo
      }
      lastModifiedBy {
        isPlatformClient
        clientId
        externalUserId
        anonymousId
        customerRef
        userRef
        associateRef
        attributedTo
      }
    }
  }
}

Variables

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

wherestring
sortarray<string>
limitnumber
offsetnumber
json
{
  "where": "string",
  "sort": [
    "string"
  ],
  "limit": 0,
  "offset": 0
}

Response

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

offsetnumber
countnumber
totalstring
existsboolean
resultsarray<object>
idobject
keyobject
nameobject
contactEmailobject
addressesobject
defaultShippingAddressobject
defaultBillingAddressobject
defaultShippingAddressIdobject
defaultBillingAddressIdobject
shippingAddressesobject
billingAddressesobject
shippingAddressIdsobject
billingAddressIdsobject
statusobject
storesRefobject
storesobject
storeModeobject
unitTypeobject
associatesobject
associateModeobject
inheritedAssociatesobject
customobject
parentUnitRefobject
parentUnitobject
ancestorsobject
inheritedStoresobject
topLevelUnitRefobject
topLevelUnitobject
approvalRuleModeobject
customerGroupAssignmentsobject
versionobject
createdAtobject
lastModifiedAtobject
createdByobject
lastModifiedByobject

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

Was this page helpful?
businessUnits — Commercetools — Documentation