Jump to

• Request
• Response

Update one product rule

patch

/fscmRestApi/resources/11.13.18.05/channelPrograms/{ProgramId}/child/productRules/{ProgramLineId}

Request

Path Parameters

• ProgramId(required): integer(int64)
  Value that uniquely identifies the channel program. It is a primary key that the application generates when it creates the program.
• ProgramLineId(required): integer
  Value that uniquely identifies the product rule. It is a primary key that the application generates when it creates the product rule.

Header Parameters

• Metadata-Context: string
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version: string
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• DFF: array Descriptive Flexfields for Product Rules
  Title: Descriptive Flexfields for Product Rules

  The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.
• DiscountType: string
  Type of discount. A list of accepted values is defined in the lookup type ORA_CJM_LINE_DISCOUNT_TYPE.
• DiscountTypeCode: string
  Maximum Length: 30

  Abbreviation that identifies the type of discount.
• DiscountValue: number
  Value of the discount.
• FromDate: string (date)
  Date when the product rule becomes applicable.
• Item: string
  Name of the item in the inventory.
• ItemDescription: string
  Description of the item in the inventory.
• ItemId: string
  Maximum Length: 240

  Value that uniquely identifies the item in the inventory.
• ItemLevel: string
  Level at which discounts are defined. Valid values include Item and All Items. A list of accepted values is defined in the lookup type ORA_CJM_ITEM_LEVEL.
• ItemLevelCode: string
  Maximum Length: 30

  Abbreviation that identifies the level at which discounts are defined.
• MaximumQuantity: number
  Maximum quantity allowed for each product rule.
• SupplierItem: string
  Maximum Length: 255

  Name of the supplier item.
• SupplierItemDescription: string
  Maximum Length: 255

  Description of the supplier item.
• SupplierItemId: integer (int64)
  Value that uniquely identifies the supplier item.
• ToDate: string (date)
  Date when the product rule is no longer applicable.
• UnitOfMeasure: string
  Unit of measure of the item for pricing.
• UOMCode: string
  Maximum Length: 30

  Abbreviation that identifies the unit of measure for pricing.

{
    "type":"object",
    "properties":{
        "DFF":{
            "title":"Descriptive Flexfields for Product Rules",
            "type":"array",
            "description":"The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.",
            "items":{
                "$ref":"#/components/schemas/channelPrograms-productRules-DFF-item-patch-request"
            },
            "x-cardinality":"1"
        },
        "DiscountType":{
            "type":"string",
            "description":"Type of discount. A list of accepted values is defined in the lookup type ORA_CJM_LINE_DISCOUNT_TYPE.",
            "nullable":true,
            "x-queryable":false
        },
        "DiscountTypeCode":{
            "maxLength":30,
            "type":"string",
            "description":"Abbreviation that identifies the type of discount.",
            "nullable":false,
            "x-queryable":false
        },
        "DiscountValue":{
            "type":"number",
            "description":"Value of the discount.",
            "nullable":false,
            "x-queryable":false
        },
        "FromDate":{
            "type":"string",
            "description":"Date when the product rule becomes applicable.",
            "format":"date",
            "nullable":true,
            "x-queryable":false
        },
        "Item":{
            "type":"string",
            "description":"Name of the item in the inventory.",
            "nullable":true
        },
        "ItemDescription":{
            "type":"string",
            "description":"Description of the item in the inventory.",
            "nullable":true,
            "x-queryable":false
        },
        "ItemId":{
            "maxLength":240,
            "type":"string",
            "description":"Value that uniquely identifies the item in the inventory.",
            "nullable":true
        },
        "ItemLevel":{
            "type":"string",
            "description":"Level at which discounts are defined. Valid values include Item and All Items. A list of accepted values is defined in the lookup type ORA_CJM_ITEM_LEVEL.",
            "nullable":true
        },
        "ItemLevelCode":{
            "maxLength":30,
            "type":"string",
            "description":"Abbreviation that identifies the level at which discounts are defined.",
            "nullable":false
        },
        "MaximumQuantity":{
            "type":"number",
            "description":"Maximum quantity allowed for each product rule.",
            "nullable":true,
            "x-queryable":false
        },
        "SupplierItem":{
            "maxLength":255,
            "type":"string",
            "description":"Name of the supplier item.",
            "nullable":true
        },
        "SupplierItemDescription":{
            "maxLength":255,
            "type":"string",
            "description":"Description of the supplier item.",
            "nullable":true,
            "x-queryable":false
        },
        "SupplierItemId":{
            "type":"integer",
            "description":"Value that uniquely identifies the supplier item.",
            "format":"int64",
            "nullable":true,
            "x-hints":{
                "precision":18
            }
        },
        "ToDate":{
            "type":"string",
            "description":"Date when the product rule is no longer applicable.",
            "format":"date",
            "nullable":true,
            "x-queryable":false
        },
        "UOMCode":{
            "maxLength":30,
            "type":"string",
            "description":"Abbreviation that identifies the unit of measure for pricing.",
            "nullable":true,
            "x-queryable":false
        },
        "UnitOfMeasure":{
            "type":"string",
            "description":"Unit of measure of the item for pricing.",
            "nullable":true,
            "x-queryable":false
        }
    }
}

Nested Schema : Descriptive Flexfields for Product Rules

Type: array

Title: Descriptive Flexfields for Product Rules

The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.

Show Source

• Array of: object channelPrograms-productRules-DFF-item-patch-request

{
    "title":"Descriptive Flexfields for Product Rules",
    "type":"array",
    "description":"The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.",
    "items":{
        "$ref":"#/components/schemas/channelPrograms-productRules-DFF-item-patch-request"
    },
    "x-cardinality":"1"
}

Nested Schema : channelPrograms-productRules-DFF-item-patch-request

Type: object

Show Source

• __FLEX_Context: string
  Title: Context Segment

  Maximum Length: 30

  Descriptive flexfield context name for product rule.
• __FLEX_Context_DisplayValue: string
  Title: Context Segment

  Descriptive flexfield context display value for product rule.
• ProgramLineId: integer
  Value that uniquely identifies the product rule.

{
    "type":"object",
    "properties":{
        "ProgramLineId":{
            "type":"integer",
            "description":"Value that uniquely identifies the product rule.",
            "nullable":false,
            "x-hints":{
                "DISPLAYHINT":"Hide",
                "includeInCompactView":true
            }
        },
        "__FLEX_Context":{
            "title":"Context Segment",
            "maxLength":30,
            "type":"string",
            "description":"Descriptive flexfield context name for product rule.",
            "nullable":true,
            "x-hints":{
                "help":{
                    "instruction":"Context Segment"
                },
                "FND_ACFF_ValueSetInfo":"_FLEX_ContextValueSet_Internal#INDEPENDENT",
                "controlType":"choice",
                "FND_ACFF_AkaAttrName":"__FLEX_Context_DisplayValue",
                "includeInCompactView":true,
                "FND_ACFF_IsDiscriminator":"true",
                "FND_ACFF_JavaType":"java.lang.String",
                "FND_ACFF_MaximumLength":"1024",
                "FND_ACFF_PreferredDisplayType":"LOV"
            },
            "x-oj":{
                "transform":{
                    "path":"oj-sp/common-util/flex-util",
                    "name":"transformFlexUIHints"
                }
            }
        },
        "__FLEX_Context_DisplayValue":{
            "title":"Context Segment",
            "type":"string",
            "description":"Descriptive flexfield context display value for product rule.",
            "nullable":true,
            "x-hints":{
                "updateable":"false",
                "help":{
                    "instruction":"Context Segment"
                },
                "DISPLAYHINT":"Hide",
                "FND_ACFF_IsReadOnly":"true",
                "FND_ACFF_AkaRealSegmentAttrName":"__FLEX_Context",
                "FND_ACFF_JavaType":"java.lang.String",
                "FND_ACFF_ListDisplayAttrName":"Name",
                "FND_ACFF_MaximumLength":"1024",
                "FND_ACFF_PreferredDisplayType":"LOV"
            },
            "x-oj":{
                "transform":{
                    "path":"oj-sp/common-util/flex-util",
                    "name":"transformFlexUIHints"
                }
            }
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The following table describes the default response for this task.

Headers

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Body ()

Root Schema : channelPrograms-productRules-item-response

Type: object

Show Source

• CreatedBy: string
  Read Only: true

  Maximum Length: 64

  User who created the record.
• CreationDate: string (date-time)
  Read Only: true

  Date and time when the user created the record.
• DFF: array Descriptive Flexfields for Product Rules
  Title: Descriptive Flexfields for Product Rules

  The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.
• DiscountType: string
  Type of discount. A list of accepted values is defined in the lookup type ORA_CJM_LINE_DISCOUNT_TYPE.
• DiscountTypeCode: string
  Maximum Length: 30

  Abbreviation that identifies the type of discount.
• DiscountValue: number
  Value of the discount.
• FromDate: string (date)
  Date when the product rule becomes applicable.
• Item: string
  Name of the item in the inventory.
• ItemDescription: string
  Description of the item in the inventory.
• ItemId: string
  Maximum Length: 240

  Value that uniquely identifies the item in the inventory.
• ItemLevel: string
  Level at which discounts are defined. Valid values include Item and All Items. A list of accepted values is defined in the lookup type ORA_CJM_ITEM_LEVEL.
• ItemLevelCode: string
  Maximum Length: 30

  Abbreviation that identifies the level at which discounts are defined.
• LastUpdateDate: string (date-time)
  Read Only: true

  Date and time when the user most recently updated the record.
• LastUpdatedBy: string
  Read Only: true

  Maximum Length: 64

  User who most recently updated the record.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• MaximumQuantity: number
  Maximum quantity allowed for each product rule.
• ProgramId: integer (int64)
  Name that identifies the qualifier used in channel program qualification.
• ProgramLineId: integer
  Value that uniquely identifies the product rule. It is a primary key that the application generates when it creates the product rule.
• SupplierItem: string
  Maximum Length: 255

  Name of the supplier item.
• SupplierItemDescription: string
  Maximum Length: 255

  Description of the supplier item.
• SupplierItemId: integer (int64)
  Value that uniquely identifies the supplier item.
• ToDate: string (date)
  Date when the product rule is no longer applicable.
• UnitOfMeasure: string
  Unit of measure of the item for pricing.
• UOMCode: string
  Maximum Length: 30

  Abbreviation that identifies the unit of measure for pricing.

{
    "type":"object",
    "properties":{
        "CreatedBy":{
            "maxLength":64,
            "type":"string",
            "description":"User who created the record.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "CreationDate":{
            "type":"string",
            "description":"Date and time when the user created the record.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "DFF":{
            "title":"Descriptive Flexfields for Product Rules",
            "type":"array",
            "description":"The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.",
            "items":{
                "$ref":"#/components/schemas/channelPrograms-productRules-DFF-item-response"
            },
            "x-cardinality":"1"
        },
        "DiscountType":{
            "type":"string",
            "description":"Type of discount. A list of accepted values is defined in the lookup type ORA_CJM_LINE_DISCOUNT_TYPE.",
            "nullable":true,
            "x-queryable":false
        },
        "DiscountTypeCode":{
            "maxLength":30,
            "type":"string",
            "description":"Abbreviation that identifies the type of discount.",
            "nullable":false,
            "x-queryable":false
        },
        "DiscountValue":{
            "type":"number",
            "description":"Value of the discount.",
            "nullable":false,
            "x-queryable":false
        },
        "FromDate":{
            "type":"string",
            "description":"Date when the product rule becomes applicable.",
            "format":"date",
            "nullable":true,
            "x-queryable":false
        },
        "Item":{
            "type":"string",
            "description":"Name of the item in the inventory.",
            "nullable":true,
            "x-queryable":true
        },
        "ItemDescription":{
            "type":"string",
            "description":"Description of the item in the inventory.",
            "nullable":true,
            "x-queryable":false
        },
        "ItemId":{
            "maxLength":240,
            "type":"string",
            "description":"Value that uniquely identifies the item in the inventory.",
            "nullable":true,
            "x-queryable":true
        },
        "ItemLevel":{
            "type":"string",
            "description":"Level at which discounts are defined. Valid values include Item and All Items. A list of accepted values is defined in the lookup type ORA_CJM_ITEM_LEVEL.",
            "nullable":true,
            "x-queryable":true
        },
        "ItemLevelCode":{
            "maxLength":30,
            "type":"string",
            "description":"Abbreviation that identifies the level at which discounts are defined.",
            "nullable":false,
            "x-queryable":true
        },
        "LastUpdateDate":{
            "type":"string",
            "description":"Date and time when the user most recently updated the record.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "LastUpdatedBy":{
            "maxLength":64,
            "type":"string",
            "description":"User who most recently updated the record.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "MaximumQuantity":{
            "type":"number",
            "description":"Maximum quantity allowed for each product rule.",
            "nullable":true,
            "x-queryable":false
        },
        "ProgramId":{
            "type":"integer",
            "description":"Name that identifies the qualifier used in channel program qualification.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "ProgramLineId":{
            "type":"integer",
            "description":"Value that uniquely identifies the product rule. It is a primary key that the application generates when it creates the product rule.",
            "nullable":false,
            "x-queryable":true
        },
        "SupplierItem":{
            "maxLength":255,
            "type":"string",
            "description":"Name of the supplier item.",
            "nullable":true,
            "x-queryable":true
        },
        "SupplierItemDescription":{
            "maxLength":255,
            "type":"string",
            "description":"Description of the supplier item.",
            "nullable":true,
            "x-queryable":false
        },
        "SupplierItemId":{
            "type":"integer",
            "description":"Value that uniquely identifies the supplier item.",
            "format":"int64",
            "nullable":true,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "ToDate":{
            "type":"string",
            "description":"Date when the product rule is no longer applicable.",
            "format":"date",
            "nullable":true,
            "x-queryable":false
        },
        "UOMCode":{
            "maxLength":30,
            "type":"string",
            "description":"Abbreviation that identifies the unit of measure for pricing.",
            "nullable":true,
            "x-queryable":false
        },
        "UnitOfMeasure":{
            "type":"string",
            "description":"Unit of measure of the item for pricing.",
            "nullable":true,
            "x-queryable":false
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        }
    }
}

Nested Schema : Descriptive Flexfields for Product Rules

Type: array

Title: Descriptive Flexfields for Product Rules

The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.

Show Source

• Array of: object channelPrograms-productRules-DFF-item-response

{
    "title":"Descriptive Flexfields for Product Rules",
    "type":"array",
    "description":"The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.",
    "items":{
        "$ref":"#/components/schemas/channelPrograms-productRules-DFF-item-response"
    },
    "x-cardinality":"1"
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : channelPrograms-productRules-DFF-item-response

Type: object

Show Source

• __FLEX_Context: string
  Title: Context Segment

  Maximum Length: 30

  Descriptive flexfield context name for product rule.
• __FLEX_Context_DisplayValue: string
  Title: Context Segment

  Descriptive flexfield context display value for product rule.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• ProgramLineId: integer
  Value that uniquely identifies the product rule.

{
    "type":"object",
    "properties":{
        "ProgramLineId":{
            "type":"integer",
            "description":"Value that uniquely identifies the product rule.",
            "nullable":false,
            "x-hints":{
                "DISPLAYHINT":"Hide",
                "includeInCompactView":true
            },
            "x-queryable":true
        },
        "__FLEX_Context":{
            "title":"Context Segment",
            "maxLength":30,
            "type":"string",
            "description":"Descriptive flexfield context name for product rule.",
            "nullable":true,
            "x-hints":{
                "help":{
                    "instruction":"Context Segment"
                },
                "FND_ACFF_ValueSetInfo":"_FLEX_ContextValueSet_Internal#INDEPENDENT",
                "controlType":"choice",
                "FND_ACFF_AkaAttrName":"__FLEX_Context_DisplayValue",
                "includeInCompactView":true,
                "FND_ACFF_IsDiscriminator":"true",
                "FND_ACFF_JavaType":"java.lang.String",
                "FND_ACFF_MaximumLength":"1024",
                "FND_ACFF_PreferredDisplayType":"LOV"
            },
            "x-oj":{
                "transform":{
                    "path":"oj-sp/common-util/flex-util",
                    "name":"transformFlexUIHints"
                }
            },
            "x-queryable":true
        },
        "__FLEX_Context_DisplayValue":{
            "title":"Context Segment",
            "type":"string",
            "description":"Descriptive flexfield context display value for product rule.",
            "nullable":true,
            "x-hints":{
                "updateable":"false",
                "help":{
                    "instruction":"Context Segment"
                },
                "DISPLAYHINT":"Hide",
                "FND_ACFF_IsReadOnly":"true",
                "FND_ACFF_AkaRealSegmentAttrName":"__FLEX_Context",
                "FND_ACFF_JavaType":"java.lang.String",
                "FND_ACFF_ListDisplayAttrName":"Name",
                "FND_ACFF_MaximumLength":"1024",
                "FND_ACFF_PreferredDisplayType":"LOV"
            },
            "x-oj":{
                "transform":{
                    "path":"oj-sp/common-util/flex-util",
                    "name":"transformFlexUIHints"
                }
            },
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string
  Title: hyperlink reference

  The URI to the related resource.
• kind: string
  Title: kind

  Allowed Values: [ "collection", "item", "describe", "other" ]

  The kind of the related resource.
• name: string
  Title: name

  The name of the link to the related resource.
• properties: object properties
• rel: string
  Title: relation

  Allowed Values: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

  The name of the relation to the resource instance. Example: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Links

DFF

Operation: /fscmRestApi/resources/11.13.18.05/channelPrograms/{ProgramId}/child/productRules/{ProgramLineId}/child/DFF

Parameters:

• ProgramId: $request.path.ProgramId
• ProgramLineId: $request.path.ProgramLineId

The Descriptive Flexfields for Product Rules resource manages additional details about a product rule of a program.

Back to Top