PUT ItemRoles/UpdateItemRoleForSubCats?itemRoleId={itemRoleId}

Associates Sub Categories with an Item Role


Parameters

NameDescriptionAdditional information
request
A list of SubCatItemRoles.

Define this parameter in the request body.

itemRoleId
The id of the item role to associate the sub categories with.

Define this parameter in the request URI.

Request body formats

application/json, text/json

Sample:
[
  {
    "ItemRoleSubCatId": 1,
    "SubCatId": 2,
    "AddToTemplate": true,
    "MaximumAllowedWithReceipt": 4.0,
    "MaximumAllowedWithoutReceipt": 5.0
  },
  {
    "ItemRoleSubCatId": 1,
    "SubCatId": 2,
    "AddToTemplate": true,
    "MaximumAllowedWithReceipt": 4.0,
    "MaximumAllowedWithoutReceipt": 5.0
  },
  {
    "ItemRoleSubCatId": 1,
    "SubCatId": 2,
    "AddToTemplate": true,
    "MaximumAllowedWithReceipt": 4.0,
    "MaximumAllowedWithoutReceipt": 5.0
  }
]

application/xml, text/xml

Sample:
<ArrayOfSubCatItemRole xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types">
  <SubCatItemRole>
    <AddToTemplate>true</AddToTemplate>
    <ItemRoleSubCatId>1</ItemRoleSubCatId>
    <MaximumAllowedWithReceipt>4</MaximumAllowedWithReceipt>
    <MaximumAllowedWithoutReceipt>5</MaximumAllowedWithoutReceipt>
    <SubCatId>2</SubCatId>
  </SubCatItemRole>
  <SubCatItemRole>
    <AddToTemplate>true</AddToTemplate>
    <ItemRoleSubCatId>1</ItemRoleSubCatId>
    <MaximumAllowedWithReceipt>4</MaximumAllowedWithReceipt>
    <MaximumAllowedWithoutReceipt>5</MaximumAllowedWithoutReceipt>
    <SubCatId>2</SubCatId>
  </SubCatItemRole>
  <SubCatItemRole>
    <AddToTemplate>true</AddToTemplate>
    <ItemRoleSubCatId>1</ItemRoleSubCatId>
    <MaximumAllowedWithReceipt>4</MaximumAllowedWithReceipt>
    <MaximumAllowedWithoutReceipt>5</MaximumAllowedWithoutReceipt>
    <SubCatId>2</SubCatId>
  </SubCatItemRole>
</ArrayOfSubCatItemRole>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response body formats

The outcome of the action ItemRole where 1 is success and 0 is fail

application/json, text/json

Sample:
{
  "Item": 1,
  "ResponseInformation": {
    "Errors": [
      {
        "ErrorCode": "sample string 1",
        "Message": "sample string 2"
      },
      {
        "ErrorCode": "sample string 1",
        "Message": "sample string 2"
      },
      {
        "ErrorCode": "sample string 1",
        "Message": "sample string 2"
      }
    ],
    "Status": 0,
    "Links": [
      {
        "Rel": "sample string 1",
        "Href": "sample string 2",
        "Title": "sample string 3",
        "IsTemplated": true
      },
      {
        "Rel": "sample string 1",
        "Href": "sample string 2",
        "Title": "sample string 3",
        "IsTemplated": true
      },
      {
        "Rel": "sample string 1",
        "Href": "sample string 2",
        "Title": "sample string 3",
        "IsTemplated": true
      }
    ]
  }
}

application/xml, text/xml

Sample:
<NumericResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Responses">
  <ResponseInformation xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Common">
    <Errors>
      <ApiErrorDetail>
        <ErrorCode>sample string 1</ErrorCode>
        <Message>sample string 2</Message>
      </ApiErrorDetail>
      <ApiErrorDetail>
        <ErrorCode>sample string 1</ErrorCode>
        <Message>sample string 2</Message>
      </ApiErrorDetail>
      <ApiErrorDetail>
        <ErrorCode>sample string 1</ErrorCode>
        <Message>sample string 2</Message>
      </ApiErrorDetail>
    </Errors>
    <Links>
      <Link>
        <Href>sample string 2</Href>
        <IsTemplated>true</IsTemplated>
        <Rel>sample string 1</Rel>
        <Title>sample string 3</Title>
      </Link>
      <Link>
        <Href>sample string 2</Href>
        <IsTemplated>true</IsTemplated>
        <Rel>sample string 1</Rel>
        <Title>sample string 3</Title>
      </Link>
      <Link>
        <Href>sample string 2</Href>
        <IsTemplated>true</IsTemplated>
        <Rel>sample string 1</Rel>
        <Title>sample string 3</Title>
      </Link>
    </Links>
    <Status>Failure</Status>
  </ResponseInformation>
  <Item xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Common">1</Item>
</NumericResponse>
URI parameters
=
Headers | Add header
: Delete
Body
Samples:
Status
Headers
Body