naftiko: 1.0.0-alpha2
info:
  label: Avalara AvaTax APIs — Items
  description: 'Avalara AvaTax APIs — Items. 32 operations. Lead operation: Avalara CreateTaxCodeClassificationRequest. Self-contained
    Naftiko capability covering one Avalara business surface.'
  tags:
  - Avalara
  - Items
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AVALARA_API_KEY: AVALARA_API_KEY
capability:
  consumes:
  - type: http
    namespace: avatax-apis-items
    baseUri: http://{{baseurl}}
    description: Avalara AvaTax APIs — Items business capability. Self-contained, no shared references.
    resources:
    - name: api-v2-companies-companyId-classificationrequests-taxcode
      path: /api/v2/companies/{companyId}/classificationrequests/taxcode
      operations:
      - name: post
        method: POST
        description: Avalara CreateTaxCodeClassificationRequest
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: get
        method: GET
        description: Avalara GetClassificationStatus
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-classificationrequests-taxcode-requestId-recommendati
      path: /api/v2/companies/{companyId}/classificationrequests/taxcode/{requestId}/recommendations
      operations:
      - name: get
        method: GET
        description: Avalara GetTaxCodeRecommendations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: requestId
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-itemcatalogue
      path: /api/v2/companies/{companyId}/itemcatalogue
      operations:
      - name: post
        method: POST
        description: Avalara SyncItemCatalogue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v2-companies-companyId-itemcatalogue-itemCode
      path: /api/v2/companies/{companyId}/itemcatalogue/{itemCode}
      operations:
      - name: delete
        method: DELETE
        description: Avalara DeleteCatalogueItem
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemCode
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items
      path: /api/v2/companies/{companyId}/items
      operations:
      - name: post
        method: POST
        description: Avalara CreateItems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: get
        method: GET
        description: Avalara ListItemsByCompany
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items-bytags-tag
      path: /api/v2/companies/{companyId}/items/bytags/{tag}
      operations:
      - name: get
        method: GET
        description: Avalara QueryItemsByTag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: tag
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items-sync
      path: /api/v2/companies/{companyId}/items/sync
      operations:
      - name: post
        method: POST
        description: Avalara SyncItems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v2-companies-companyId-items-upload
      path: /api/v2/companies/{companyId}/items/upload
      operations:
      - name: post
        method: POST
        description: Avalara BulkUploadItems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v2-companies-companyId-items-id
      path: /api/v2/companies/{companyId}/items/{id}
      operations:
      - name: delete
        method: DELETE
        description: Avalara DeleteItem
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
      - name: get
        method: GET
        description: Avalara GetItem
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
      - name: put
        method: PUT
        description: Avalara UpdateItem
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v2-companies-companyId-items-itemCode-premiumClassification-systemCode
      path: /api/v2/companies/{companyId}/items/{itemCode}/premiumClassification/{systemCode}
      operations:
      - name: get
        method: GET
        description: Avalara GetPremiumClassification
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemCode
          in: path
          type: string
          required: true
        - name: systemCode
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items-itemCode-restrictions-import-countryOfImport
      path: /api/v2/companies/{companyId}/items/{itemCode}/restrictions/import/{countryOfImport}
      operations:
      - name: get
        method: GET
        description: Avalara ListImportRestrictions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemCode
          in: path
          type: string
          required: true
        - name: countryOfImport
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items-itemId-classifications
      path: /api/v2/companies/{companyId}/items/{itemId}/classifications
      operations:
      - name: delete
        method: DELETE
        description: Avalara BatchDeleteItemClassifications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
      - name: post
        method: POST
        description: Avalara CreateItemClassifications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: get
        method: GET
        description: Avalara ListItemClassifications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items-itemId-classifications-id
      path: /api/v2/companies/{companyId}/items/{itemId}/classifications/{id}
      operations:
      - name: delete
        method: DELETE
        description: Avalara DeleteItemClassification
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
      - name: get
        method: GET
        description: Avalara GetItemClassification
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
      - name: put
        method: PUT
        description: Avalara UpdateItemClassification
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v2-companies-companyId-items-itemId-parameters
      path: /api/v2/companies/{companyId}/items/{itemId}/parameters
      operations:
      - name: delete
        method: DELETE
        description: Avalara BatchDeleteItemParameters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
      - name: post
        method: POST
        description: Avalara CreateItemParameters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: get
        method: GET
        description: Avalara ListItemParameters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items-itemId-parameters-id
      path: /api/v2/companies/{companyId}/items/{itemId}/parameters/{id}
      operations:
      - name: delete
        method: DELETE
        description: Avalara DeleteItemParameter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
      - name: get
        method: GET
        description: Avalara GetItemParameter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
      - name: put
        method: PUT
        description: Avalara UpdateItemParameter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v2-companies-companyId-items-itemId-tags
      path: /api/v2/companies/{companyId}/items/{itemId}/tags
      operations:
      - name: post
        method: POST
        description: Avalara CreateItemTags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: delete
        method: DELETE
        description: Avalara DeleteItemTags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
      - name: get
        method: GET
        description: Avalara GetItemTags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
    - name: api-v2-companies-companyId-items-itemId-tags-itemTagDetailId
      path: /api/v2/companies/{companyId}/items/{itemId}/tags/{itemTagDetailId}
      operations:
      - name: delete
        method: DELETE
        description: Avalara DeleteItemTag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
        - name: companyId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: itemTagDetailId
          in: path
          type: string
          required: true
    - name: api-v2-items
      path: /api/v2/items
      operations:
      - name: get
        method: GET
        description: Avalara QueryItems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Avalara-Client
          in: header
          type: string
          description: Identifies the software you are using to call this API. For more information on the client header,
            see [Client Headers](https://developer.avalara.com/avatax/cli
    authentication:
      type: basic
      username: '{{env.AVALARA_USER}}'
      password: '{{env.AVALARA_PASS}}'
  exposes:
  - type: rest
    namespace: avatax-apis-items-rest
    port: 8080
    description: REST adapter for Avalara AvaTax APIs — Items. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/v2/companies/{companyid}/classificationrequests/taxcode
      name: api-v2-companies-companyid-classificationrequests-taxcode
      description: REST surface for api-v2-companies-companyId-classificationrequests-taxcode.
      operations:
      - method: POST
        name: post
        description: Avalara CreateTaxCodeClassificationRequest
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara GetClassificationStatus
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/classificationrequests/taxcode/{requestid}/recommendations
      name: api-v2-companies-companyid-classificationrequests-taxcode-requestid-recommendati
      description: REST surface for api-v2-companies-companyId-classificationrequests-taxcode-requestId-recommendati.
      operations:
      - method: GET
        name: get
        description: Avalara GetTaxCodeRecommendations
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          requestId: rest.requestId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/itemcatalogue
      name: api-v2-companies-companyid-itemcatalogue
      description: REST surface for api-v2-companies-companyId-itemcatalogue.
      operations:
      - method: POST
        name: post
        description: Avalara SyncItemCatalogue
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/itemcatalogue/{itemcode}
      name: api-v2-companies-companyid-itemcatalogue-itemcode
      description: REST surface for api-v2-companies-companyId-itemcatalogue-itemCode.
      operations:
      - method: DELETE
        name: delete
        description: Avalara DeleteCatalogueItem
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemCode: rest.itemCode
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items
      name: api-v2-companies-companyid-items
      description: REST surface for api-v2-companies-companyId-items.
      operations:
      - method: POST
        name: post
        description: Avalara CreateItems
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara ListItemsByCompany
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/bytags/{tag}
      name: api-v2-companies-companyid-items-bytags-tag
      description: REST surface for api-v2-companies-companyId-items-bytags-tag.
      operations:
      - method: GET
        name: get
        description: Avalara QueryItemsByTag
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          tag: rest.tag
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/sync
      name: api-v2-companies-companyid-items-sync
      description: REST surface for api-v2-companies-companyId-items-sync.
      operations:
      - method: POST
        name: post
        description: Avalara SyncItems
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/upload
      name: api-v2-companies-companyid-items-upload
      description: REST surface for api-v2-companies-companyId-items-upload.
      operations:
      - method: POST
        name: post
        description: Avalara BulkUploadItems
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{id}
      name: api-v2-companies-companyid-items-id
      description: REST surface for api-v2-companies-companyId-items-id.
      operations:
      - method: DELETE
        name: delete
        description: Avalara DeleteItem
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara GetItem
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: put
        description: Avalara UpdateItem
        call: avatax-apis-items.put
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemcode}/premiumclassification/{systemcode}
      name: api-v2-companies-companyid-items-itemcode-premiumclassification-systemcode
      description: REST surface for api-v2-companies-companyId-items-itemCode-premiumClassification-systemCode.
      operations:
      - method: GET
        name: get
        description: Avalara GetPremiumClassification
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemCode: rest.itemCode
          systemCode: rest.systemCode
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemcode}/restrictions/import/{countryofimport}
      name: api-v2-companies-companyid-items-itemcode-restrictions-import-countryofimport
      description: REST surface for api-v2-companies-companyId-items-itemCode-restrictions-import-countryOfImport.
      operations:
      - method: GET
        name: get
        description: Avalara ListImportRestrictions
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemCode: rest.itemCode
          countryOfImport: rest.countryOfImport
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemid}/classifications
      name: api-v2-companies-companyid-items-itemid-classifications
      description: REST surface for api-v2-companies-companyId-items-itemId-classifications.
      operations:
      - method: DELETE
        name: delete
        description: Avalara BatchDeleteItemClassifications
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: post
        description: Avalara CreateItemClassifications
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara ListItemClassifications
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemid}/classifications/{id}
      name: api-v2-companies-companyid-items-itemid-classifications-id
      description: REST surface for api-v2-companies-companyId-items-itemId-classifications-id.
      operations:
      - method: DELETE
        name: delete
        description: Avalara DeleteItemClassification
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara GetItemClassification
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: put
        description: Avalara UpdateItemClassification
        call: avatax-apis-items.put
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemid}/parameters
      name: api-v2-companies-companyid-items-itemid-parameters
      description: REST surface for api-v2-companies-companyId-items-itemId-parameters.
      operations:
      - method: DELETE
        name: delete
        description: Avalara BatchDeleteItemParameters
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: post
        description: Avalara CreateItemParameters
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara ListItemParameters
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemid}/parameters/{id}
      name: api-v2-companies-companyid-items-itemid-parameters-id
      description: REST surface for api-v2-companies-companyId-items-itemId-parameters-id.
      operations:
      - method: DELETE
        name: delete
        description: Avalara DeleteItemParameter
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara GetItemParameter
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: put
        description: Avalara UpdateItemParameter
        call: avatax-apis-items.put
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemid}/tags
      name: api-v2-companies-companyid-items-itemid-tags
      description: REST surface for api-v2-companies-companyId-items-itemId-tags.
      operations:
      - method: POST
        name: post
        description: Avalara CreateItemTags
        call: avatax-apis-items.post
        with:
          Content-Type: rest.Content-Type
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete
        description: Avalara DeleteItemTags
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get
        description: Avalara GetItemTags
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/companies/{companyid}/items/{itemid}/tags/{itemtagdetailid}
      name: api-v2-companies-companyid-items-itemid-tags-itemtagdetailid
      description: REST surface for api-v2-companies-companyId-items-itemId-tags-itemTagDetailId.
      operations:
      - method: DELETE
        name: delete
        description: Avalara DeleteItemTag
        call: avatax-apis-items.delete
        with:
          X-Avalara-Client: rest.X-Avalara-Client
          companyId: rest.companyId
          itemId: rest.itemId
          itemTagDetailId: rest.itemTagDetailId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/items
      name: api-v2-items
      description: REST surface for api-v2-items.
      operations:
      - method: GET
        name: get
        description: Avalara QueryItems
        call: avatax-apis-items.get
        with:
          X-Avalara-Client: rest.X-Avalara-Client
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: avatax-apis-items-mcp
    port: 9090
    transport: http
    description: MCP adapter for Avalara AvaTax APIs — Items. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: avalara-createtaxcodeclassificationrequest
      description: Avalara CreateTaxCodeClassificationRequest
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-getclassificationstatus
      description: Avalara GetClassificationStatus
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-gettaxcoderecommendations
      description: Avalara GetTaxCodeRecommendations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        requestId: tools.requestId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-syncitemcatalogue
      description: Avalara SyncItemCatalogue
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-deletecatalogueitem
      description: Avalara DeleteCatalogueItem
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemCode: tools.itemCode
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-createitems
      description: Avalara CreateItems
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-listitemsbycompany
      description: Avalara ListItemsByCompany
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-queryitemsbytag
      description: Avalara QueryItemsByTag
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        tag: tools.tag
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-syncitems
      description: Avalara SyncItems
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-bulkuploaditems
      description: Avalara BulkUploadItems
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-deleteitem
      description: Avalara DeleteItem
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-getitem
      description: Avalara GetItem
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-updateitem
      description: Avalara UpdateItem
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: avatax-apis-items.put
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-getpremiumclassification
      description: Avalara GetPremiumClassification
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemCode: tools.itemCode
        systemCode: tools.systemCode
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-listimportrestrictions
      description: Avalara ListImportRestrictions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemCode: tools.itemCode
        countryOfImport: tools.countryOfImport
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-batchdeleteitemclassifications
      description: Avalara BatchDeleteItemClassifications
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-createitemclassifications
      description: Avalara CreateItemClassifications
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-listitemclassifications
      description: Avalara ListItemClassifications
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-deleteitemclassification
      description: Avalara DeleteItemClassification
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-getitemclassification
      description: Avalara GetItemClassification
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-updateitemclassification
      description: Avalara UpdateItemClassification
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: avatax-apis-items.put
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-batchdeleteitemparameters
      description: Avalara BatchDeleteItemParameters
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-createitemparameters
      description: Avalara CreateItemParameters
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-listitemparameters
      description: Avalara ListItemParameters
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-deleteitemparameter
      description: Avalara DeleteItemParameter
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-getitemparameter
      description: Avalara GetItemParameter
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-updateitemparameter
      description: Avalara UpdateItemParameter
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: avatax-apis-items.put
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-createitemtags
      description: Avalara CreateItemTags
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: avatax-apis-items.post
      with:
        Content-Type: tools.Content-Type
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-deleteitemtags
      description: Avalara DeleteItemTags
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-getitemtags
      description: Avalara GetItemTags
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-deleteitemtag
      description: Avalara DeleteItemTag
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: avatax-apis-items.delete
      with:
        X-Avalara-Client: tools.X-Avalara-Client
        companyId: tools.companyId
        itemId: tools.itemId
        itemTagDetailId: tools.itemTagDetailId
      outputParameters:
      - type: object
        mapping: $.
    - name: avalara-queryitems
      description: Avalara QueryItems
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: avatax-apis-items.get
      with:
        X-Avalara-Client: tools.X-Avalara-Client
      outputParameters:
      - type: object
        mapping: $.