Jump to

• Request
• Response
• Examples

Get All Pricing Matrix Template Columns

get

/rest/v19/pricingSetup/matrixTemplates/{templateVariableName}/columns

Use this endpoint to retrieve a list of columns for the specified pricing matrix template.

Request

Path Parameters

• templateVariableName(required): string

Query Parameters

• fields: string
  This parameter filters the resource attributes. Only the specified attributes are returned, which means that if no attributes are specified, all attributes are returned.
• finder: string
  Used as a predefined finder to search the collection.
  
  Format: ?finder=<finderName>;<variableName>=<variableValue>
  The following are the available finder names and corresponding finder variables:

  • findByKeyword: Find rate card template column using name, variableName and description
    Finder Variable:
    • keyword;string:The search text. The character '%' if present will be treated as a wild card otherwise, the default is 'contains' search
• limit: integer
  This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
• offset: integer
  Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
• onlyData: boolean
  The resource item payload will be filtered in order to contain only data (no links section, for example).
• orderby: string
  This parameter orders a resource collection based on the specified attributes. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "ASC" or "DESC". Specify "ASC" for ascending and "DESC" for descending. The default value is "ASC". For example, ?orderby=field1:ASC,field2:DESC.
• q: string
  Filter (a ???where???clause) to restrict the items returned in the collection. By default, no filtering is applied.
• totalResults: boolean
  The resource collection representation will include the total row count when "?totalResults=true", otherwise the count is not included. The default value is "false".

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success

Body ()

Root Schema : PricingResourceCollection_PricingMatrixTemplateColumn

Type: object

Show Source

• count: integer()
  Title: Count

  Read Only: true

  The number of resource instances returned in the current range.
• createdBy: Created By
  Title: Created By

  Read Only: true

  The details of the user who created the record.
• groupAccessEnabled: boolean()
  Title: Group Access Enabled

  Read Only: true

  Indicates whether the user has access to the groups segment
• hasMore: boolean()
  Title: HasMore

  Read Only: true

  Indicates whether more resources are available on the server than the subset returned in the response. If the value is true, then there are more resources to retrieve from the server. The default value is false.
• items: array items
• lastModifiedBy: Last Modified By
  Title: Last Modified By

  Read Only: true

  The details of the user who modified the record.
• limit: integer()
  Title: Limit

  Read Only: true

  The actual paging size used by the server.
• links: array Links
  Title: Links

  Read Only: true

  The link relations associated with the resource instance.
• offset: integer()
  Title: OffSet

  Read Only: true

  The offset value used in the current page.
• segmentLevelAccessType: string()
  Title: Segment-level Access Type

  Read Only: true

  Segment-level Access Type
• totalResults: integer()
  Title: Total Results

  Read Only: true

  Captures the total count of the resource instances, which not only includes the instances in the current range, but all instances on the server that satisfy the request.

{
    "properties":{
        "segmentLevelAccessType":{
            "type":"string",
            "format":"",
            "description":"Segment-level Access Type",
            "title":"Segment-level Access Type",
            "readOnly":true
        },
        "groupAccessEnabled":{
            "type":"boolean",
            "format":"",
            "description":"Indicates whether the user has access to the groups segment",
            "title":"Group Access Enabled",
            "readOnly":true
        },
        "createdBy":{
            "format":"",
            "description":"The details of the user who created the record.",
            "title":"Created By",
            "readOnly":true,
            "allOf":[
                {
                    "$ref":"#/definitions/UserDetails"
                }
            ]
        },
        "lastModifiedBy":{
            "format":"",
            "description":"The details of the user who modified the record.",
            "title":"Last Modified By",
            "readOnly":true,
            "allOf":[
                {
                    "$ref":"#/definitions/UserDetails"
                }
            ]
        },
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/PricingMatrixTemplateColumn"
            }
        },
        "offset":{
            "type":"integer",
            "format":"",
            "description":"The offset value used in the current page.",
            "title":"OffSet",
            "readOnly":true
        },
        "limit":{
            "type":"integer",
            "format":"",
            "description":"The actual paging size used by the server.",
            "title":"Limit",
            "readOnly":true
        },
        "count":{
            "type":"integer",
            "format":"",
            "description":"The number of resource instances returned in the current range.",
            "title":"Count",
            "readOnly":true
        },
        "totalResults":{
            "type":"integer",
            "format":"",
            "description":"Captures the total count of the resource instances, which not only includes the instances in the current range, but all instances on the server that satisfy the request.",
            "title":"Total Results",
            "readOnly":true
        },
        "hasMore":{
            "type":"boolean",
            "format":"",
            "description":"Indicates whether more resources are available on the server than the subset returned in the response. If the value is true, then there are more resources to retrieve from the server. The default value is false.",
            "title":"HasMore",
            "readOnly":true
        },
        "links":{
            "type":"array",
            "format":"",
            "description":"The link relations associated with the resource instance.",
            "title":"Links",
            "readOnly":true,
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    }
}

Nested Schema : Created By

Title: Created By

Read Only: true

The details of the user who created the record.

Match All

The details of the user who created the record.

Show Source

• object UserDetails

{
    "format":"",
    "description":"The details of the user who created the record.",
    "title":"Created By",
    "readOnly":true,
    "allOf":[
        {
            "$ref":"#/definitions/UserDetails"
        }
    ]
}

Nested Schema : items

Type: array

Show Source

• Array of: object PricingMatrixTemplateColumn

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/PricingMatrixTemplateColumn"
    }
}

Nested Schema : Last Modified By

Title: Last Modified By

Read Only: true

The details of the user who modified the record.

Match All

The details of the user who modified the record.

Show Source

• object UserDetails

{
    "format":"",
    "description":"The details of the user who modified the record.",
    "title":"Last Modified By",
    "readOnly":true,
    "allOf":[
        {
            "$ref":"#/definitions/UserDetails"
        }
    ]
}

Nested Schema : Links

Type: array

Title: Links

Read Only: true

The link relations associated with the resource instance.

Show Source

• Array of: object Link

{
    "type":"array",
    "format":"",
    "description":"The link relations associated with the resource instance.",
    "title":"Links",
    "readOnly":true,
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : UserDetails

Type: object

Show Source

• emailId: string()
  Title: Email Id

  Email Id of the user
• firstName: string()
  Title: First Name

  First Name of the user
• lastName: string()
  Title: Last Name

  Last Name of the user

{
    "properties":{
        "firstName":{
            "type":"string",
            "format":"",
            "description":"First Name of the user",
            "title":"First Name"
        },
        "lastName":{
            "type":"string",
            "format":"",
            "description":"Last Name of the user",
            "title":"Last Name"
        },
        "emailId":{
            "type":"string",
            "format":"",
            "description":"Email Id of the user",
            "title":"Email Id"
        }
    }
}

Nested Schema : PricingMatrixTemplateColumn

Type: object

Show Source

• active: boolean()
  Title: Active

  Indicates if the rate card template column is active.
• chargeAttributeName: string()
  Title: Charge Attribute Name

  Read Only: true

  Charge Attribute Name.
• chargeAttributeProductPriceEnabled: boolean()
  Title: Charge Attribute Product Price Enabled

  Read Only: true

  Charge Attribute Product Price Enabled.
• chargeAttributeVariableName: string()
  Title: Charge Attribute Variable Name

  Read Only: true

  Charge Attribute Variable Name.
• createdBy: Created By
  Title: Created By

  Read Only: true

  The details of the user who created the record.
• dataType(required): string()
  Title: Data Type

  Allowed Values: [ "Boolean", "Currency", "String", "Decimal", "Date", "Integer" ]

  Data Type of the Rate Card Template column.
• dateAdded: string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
  Title: Date Added

  Read Only: true

  Creation Date of the Rate Card Template column.
• dateModified: string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
  Title: Date Modified

  Read Only: true

  Last Modified date of the Rate Card Template column.
• defaultOverridable: boolean()
  Title: Default Overridable

  Indicates if the default value is overridable
• defaultValue: string()
  Title: Default Value

  Default Value of the Rate Card Template column.
• description: string()
  Title: Description

  Description of the Rate Card Template column.
• groupAccessEnabled: boolean()
  Title: Group Access Enabled

  Read Only: true

  Indicates whether the user has access to the groups segment
• id: integer()
  Title: Id

  Read Only: true

  The Unique Identifier of the Rate Card Template column.
• integrationId: string()
  Title: Integration ID

  Read Only: true

  Identifier for the corresponding entity in QP.
• ioType: string()
  Title: Input/Output Type

  Allowed Values: [ "input", "output" ]

  The Input/Output Type of the Pricing Matrix column.
• key: boolean()
  Title: Active

  Indicates if the rate card template column is a key.
• lastModifiedBy: Last Modified By
  Title: Last Modified By

  Read Only: true

  The details of the user who modified the record.
• links: array Links
  Title: Links

  Read Only: true

  The link relations associated with the resource instance.
• lookupType: string()
  Title: Lookup Type

  Lookup Type of the Rate Card Template column.
• lookupTypeLabel: string()
  Title: Lookup Type Display Label

  Read Only: true

  The lookup type display label of the Rate Card Template column.
• lookupUpdatable: boolean()
  Title: Lookup Updatable

  Whether the lookup type is updatable for the matrix template column.
• name: string()
  Title: Name

  Name of the Rate Card Template column.
• negotiable: boolean()
  Title: Negotiable

  Indicates if the value stored in this rate card template column is negotiable.
• operator: string()
  Title: Operator

  Allowed Values: [ "none", "<", "<=", "Not =", "=", ">", ">=", "Contains", "Not Contains", "Starts With", "Not Starts With", "Ends With", "Not Ends With" ]

  The operator to be applied on this Pricing Matrix column.
• orderNumber: integer()
  Title: Order Number

  The sequence number of the column in the template.
• pricingAttribute: string()
  Title: Pricing Attribute

  The pricing attribute refered to in this Pricing Matrix column.
• rateCardTemplateVarName: string
• required: boolean()
  Title: Required

  Indicates if the value of this rate card template column is required.
• segmentLevelAccessType: string()
  Title: Segment-level Access Type

  Read Only: true

  Segment-level Access Type
• templateType: string()
  Title: Template Type

  Read Only: true

  Allowed Values: [ "rateCard", "attributeBasedCharge", "scriptingPriceModel" ]

  The type of the parent Pricing Matrix Template.
• variableName: string()
  Title: Variable Name

  Variable Name of the Rate Card Template column.
• wildCardSupported: boolean()
  Title: Wild Card Supported

  Indicates if this column supports wild card values.

{
    "required":[
        "dataType"
    ],
    "properties":{
        "segmentLevelAccessType":{
            "type":"string",
            "format":"",
            "description":"Segment-level Access Type",
            "title":"Segment-level Access Type",
            "readOnly":true
        },
        "groupAccessEnabled":{
            "type":"boolean",
            "format":"",
            "description":"Indicates whether the user has access to the groups segment",
            "title":"Group Access Enabled",
            "readOnly":true
        },
        "createdBy":{
            "format":"",
            "description":"The details of the user who created the record.",
            "title":"Created By",
            "readOnly":true,
            "allOf":[
                {
                    "$ref":"#/definitions/UserDetails"
                }
            ]
        },
        "lastModifiedBy":{
            "format":"",
            "description":"The details of the user who modified the record.",
            "title":"Last Modified By",
            "readOnly":true,
            "allOf":[
                {
                    "$ref":"#/definitions/UserDetails"
                }
            ]
        },
        "id":{
            "type":"integer",
            "format":"",
            "description":"The Unique Identifier of the Rate Card Template column.",
            "title":"Id",
            "readOnly":true
        },
        "orderNumber":{
            "type":"integer",
            "format":"",
            "description":"The sequence number of the column in the template.",
            "title":"Order Number"
        },
        "name":{
            "type":"string",
            "format":"",
            "description":"Name of the Rate Card Template column.",
            "title":"Name"
        },
        "variableName":{
            "type":"string",
            "format":"",
            "description":"Variable Name of the Rate Card Template column.",
            "title":"Variable Name"
        },
        "key":{
            "type":"boolean",
            "format":"",
            "description":"Indicates if the rate card template column is a key.",
            "title":"Active"
        },
        "dataType":{
            "type":"string",
            "format":"",
            "description":"Data Type of the Rate Card Template column.",
            "title":"Data Type",
            "enum":[
                "Boolean",
                "Currency",
                "String",
                "Decimal",
                "Date",
                "Integer"
            ]
        },
        "lookupType":{
            "type":"string",
            "format":"",
            "description":"Lookup Type of the Rate Card Template column.",
            "title":"Lookup Type"
        },
        "lookupTypeLabel":{
            "type":"string",
            "format":"",
            "description":"The lookup type display label of the Rate Card Template column.",
            "title":"Lookup Type Display Label",
            "readOnly":true
        },
        "defaultValue":{
            "type":"string",
            "format":"",
            "description":"Default Value of the Rate Card Template column.",
            "title":"Default Value"
        },
        "defaultOverridable":{
            "type":"boolean",
            "format":"",
            "description":"Indicates if the default value is overridable",
            "title":"Default Overridable"
        },
        "description":{
            "type":"string",
            "format":"",
            "description":"Description of the Rate Card Template column.",
            "title":"Description"
        },
        "active":{
            "type":"boolean",
            "format":"",
            "description":"Indicates if the rate card template column is active.",
            "title":"Active"
        },
        "negotiable":{
            "type":"boolean",
            "format":"",
            "description":"Indicates if the value stored in this rate card template column is negotiable.",
            "title":"Negotiable"
        },
        "required":{
            "type":"boolean",
            "format":"",
            "description":"Indicates if the value of this rate card template column is required.",
            "title":"Required"
        },
        "integrationId":{
            "type":"string",
            "format":"",
            "description":"Identifier for the corresponding entity in QP.",
            "title":"Integration ID",
            "readOnly":true
        },
        "dateAdded":{
            "type":"string",
            "format":"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
            "description":"Creation Date of the Rate Card Template column.",
            "title":"Date Added",
            "readOnly":true
        },
        "dateModified":{
            "type":"string",
            "format":"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
            "description":"Last Modified date of the Rate Card Template column.",
            "title":"Date Modified",
            "readOnly":true
        },
        "lookupUpdatable":{
            "type":"boolean",
            "format":"",
            "description":"Whether the lookup type is updatable for the matrix template column.",
            "title":"Lookup Updatable"
        },
        "chargeAttributeName":{
            "type":"string",
            "format":"",
            "description":"Charge Attribute Name.",
            "title":"Charge Attribute Name",
            "readOnly":true
        },
        "chargeAttributeVariableName":{
            "type":"string",
            "format":"",
            "description":"Charge Attribute Variable Name.",
            "title":"Charge Attribute Variable Name",
            "readOnly":true
        },
        "chargeAttributeProductPriceEnabled":{
            "type":"boolean",
            "format":"",
            "description":"Charge Attribute Product Price Enabled.",
            "title":"Charge Attribute Product Price Enabled",
            "readOnly":true
        },
        "rateCardTemplateVarName":{
            "type":"string"
        },
        "links":{
            "type":"array",
            "format":"",
            "description":"The link relations associated with the resource instance.",
            "title":"Links",
            "readOnly":true,
            "items":{
                "$ref":"#/definitions/Link"
            }
        },
        "ioType":{
            "type":"string",
            "format":"",
            "description":"The Input/Output Type of the Pricing Matrix column.",
            "title":"Input/Output Type",
            "enum":[
                "input",
                "output"
            ]
        },
        "operator":{
            "type":"string",
            "format":"",
            "description":"The operator to be applied on this Pricing Matrix column.",
            "title":"Operator",
            "enum":[
                "none",
                "<",
                "<=",
                "Not =",
                "=",
                ">",
                ">=",
                "Contains",
                "Not Contains",
                "Starts With",
                "Not Starts With",
                "Ends With",
                "Not Ends With"
            ]
        },
        "pricingAttribute":{
            "type":"string",
            "format":"",
            "description":"The pricing attribute refered to in this Pricing Matrix column.",
            "title":"Pricing Attribute"
        },
        "wildCardSupported":{
            "type":"boolean",
            "format":"",
            "description":"Indicates if this column supports wild card values.",
            "title":"Wild Card Supported"
        },
        "templateType":{
            "type":"string",
            "format":"",
            "description":"The type of the parent Pricing Matrix Template.",
            "title":"Template Type",
            "readOnly":true,
            "enum":[
                "rateCard",
                "attributeBasedCharge",
                "scriptingPriceModel"
            ]
        }
    }
}

Nested Schema : Created By

Title: Created By

Read Only: true

The details of the user who created the record.

Match All

The details of the user who created the record.

Show Source

• object UserDetails

{
    "format":"",
    "description":"The details of the user who created the record.",
    "title":"Created By",
    "readOnly":true,
    "allOf":[
        {
            "$ref":"#/definitions/UserDetails"
        }
    ]
}

Nested Schema : Last Modified By

Title: Last Modified By

Read Only: true

The details of the user who modified the record.

Match All

The details of the user who modified the record.

Show Source

• object UserDetails

{
    "format":"",
    "description":"The details of the user who modified the record.",
    "title":"Last Modified By",
    "readOnly":true,
    "allOf":[
        {
            "$ref":"#/definitions/UserDetails"
        }
    ]
}

Nested Schema : Links

Type: array

Title: Links

Read Only: true

The link relations associated with the resource instance.

Show Source

• Array of: object Link

{
    "type":"array",
    "format":"",
    "description":"The link relations associated with the resource instance.",
    "title":"Links",
    "readOnly":true,
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : Link

Type: object

Show Source

• href: string
• name: string
• rel: string

{
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        },
        "name":{
            "type":"string"
        }
    }
}

Back to Top

Examples

The following example shows how to retrieve a list of columns for the specified pricing matrix template by submitting a GET request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X GET -H "Authorization: Bearer <token>" -H "Accept: application/json"
https://sitename.oracle.com/rest/v19/pricingSetup/matrixTemplates/testMatrixTemp1/columns

Response Body Sample

{
  "items": [{
      "id": 3023105055,
      "orderNumber": 1,
      "name": "Item Price",
      "variableName": "itemPrice",
      "key": false,
      "dataType": "Currency",
      "defaultOverridable": true,
      "description": "The item price.",
      "active": true,
      "negotiable": true,
      "required": false,
      "dateAdded": "2023-11-08T06:01:09Z",
      "dateModified": "2023-11-08T06:01:09Z",
      "ioType": "output",
      "operator": "none",
      "wildCardSupported": false
    }
  ],
  "offset": 0,
  "limit": 1000,
  "count": 1,
  "hasMore": false
}

Back to Top