Customer Documentation Portal
  • Docs

›Data Model

Getting Started

  • Welcome
  • Environments
  • Onboarding

Documentation

  • Introduction
  • Data Organisation
  • Authentication
  • Query Language
  • Data Model

    • Data Model
    • Entities
    • Price
    • Price Request
    • Product
    • Product Group
    • Reference
    • Site
    • Survey History
    • Volume
  • Import Endpoints

Tutorials

  • Welcome
  • Excel
  • Authenticating

Global Product Group Entities

Overview

The Product Group collection consists of the Global Product Groups, OwnProductGroups and their association with a specific sites.


Product Data Model

The following data model shows the Product entity and it's relational links. For the full model, see Data Model.


Data Model


Global Product Group

NameDescription
Entity DescriptionDetails related to a customer's Global Product Groups
Source Schemadbo
Source TablePNGlobalProductGroup
Destination Collection(Endpoint)ProductGroup
Entity TypeProductGroup
Entity VariantGlobal

Global Product Group Attribute Details

This table identifies all of the attributes that are available on the Global Product Group record

FieldReference EntityField DescriptionFormatMax Bytes
GlobalProductGroupIDID of the global product group.int4
GlobalProductGroupUIDUnique ID representing the global product.uniqueidentifier16
ImportCodeIdentifier that is used to reference data relating to a specific product group.importcode100
NameName of the product group.nvarchar200
AliasThis is a simply a name a product group is known by. This way all the fuels product groups can be linked as can all the diesel product groups.nvarchar200
ActiveIndicates whether the global product is active or not.bit1
PrimaryProductUIDProductPriceNet ID for the global product that has been designated as the primary product of the product group.uniqueidentifier16
IncludeInOptimiseIndicates whether the product group (and it's products) would be included in site level optimisation or not.bit1
GeneratePricesIndicates whether price generation should occur for the product group.tinyint1
AutoImplementIndicates whether proposed prices will be exported automatically (if they pass validation) or will be sent to review.bit1
PolicyPolicy value defining how much the product group will try to achieve profit or volume in optimisation.int4
PMITemplateUIDPriceNet ID for the policy management (PMI) template that has been designated to the product group.uniqueidentifier16
PMILastRunDateLast date and time the PMI Process was run for this product group.datetime8
PMISuggestedPolicyThe policy suggested by the PMI Process.int4
PMIRunningRateThe running rate calculated by the PMI Process.int4
PMIAutoImplementDefines whether the PMISuggested policy will be automatically implemented (copied to the product group's policy property) or not.bit1
PMIFrequencyHow often (in days) the PMIProcess should run for the product group.tinyint1
PMIRunningLengthThe number of days over which the PMI process will calculate the running rate during the PMI process.int4
PMIMarginRunningLengthThe default number of days that the average margin for the PMI calculation will be calculated over, held at this level to allow it to be changed for future own product groups created from the global product group template.int4
DisplayOrderIndicates the position of the product group will be displayed in the application.tinyint1
RestPreRestPricingDictates the type of pricing that will be done, 0 indicates standard price generation, 1 = Use last price based on export type.tinyint1
RestSuspendAutoImplementDefines whether auto-implement of prices will be suspended for restoration based price requests.bit1
RestTurnOffAutoImplementAtEndDefines whether auto-implement will be turned off for the product group at the end of a restoration.bit1
RestMatchHighestCompetitorDefines whether to base the initial restoration price on the highest competitor price, if 0 the lowest competitor price will be used.bit1
RestAllowDecreaseDefines whether prices can be decreased during restoration.bit1
RestUseHigherRulesPriceDefines whether price generation should use the higher of the rules based price or restoration price.bit1
RestAllowFirstLowerDefines whether after restoration has finished the system is allowed to propose the first lower price in the market.bit1
RestSFROnDropDefines whether to send the product group to review when competitors drop price during a restoration.bit1
RestGPCToRestDefines whether a product group that has a GPC is moved into restoration after the first GPC price.bit1
RestMaxHoursThe maximum number of hours a product group can be in restoration.float8
RestGeneratePricesAtEndDefines whether a product group is forced to generate prices when a restoration ends.bit1
RestFirstGenToSFRDefines whether the first price generation (as a result of the RestGeneratePricesAtEnd being set) is sent to review.bit1
PMISalesImpactLimitPercentageAn integer value defining the percentage of event-coded data that is acceptable in the PMI Process.tinyint1
RestTriggerWaitPeriodMaximum to wait after one or more competitors have triggered to go into restoration.float8
RestLaggardModeIDDecides how to deal with competitors that trigger late on in restoration; 0 = Exclude Laggards From Calculation, 1 = Include Laggards In Calculation; 2 = Send the site to SFR with a note.tinyint1
RestUseGPCTriggerCountWhether GPC initiated restorations should use a different trigger count to normal restorations.bit1
RestGPCTriggerCountSpecific trigger count for GPC initiated restorations.int4
RestConsiderAllProductsA restoration setting.bit1
GenerateOnGPCEndDetermines whether when a GPC reaches its end time, a price generation should be performed.bit1
LFAutoImplementFlag to determine whether LF price requests automatically implement - it needs to support 3 options (Auto implement, Use same as main setting, Review prices)tinyint1
CreatedTime the record was created.datetime8
LastUpdatedTime the record was last updated.datetime8

Own Product Group

NameDescription
Entity DescriptionDetails related to a customer's Own Product Groups
Source Schemadbo
Source TablePNOwnProductGroup
Destination Collection(Endpoint)ProductGroup
Entity TypeProductGroup
Entity VariantOwn

Own Product Group Attribute Details

FieldReference EntityField DescriptionFormatMax Bytes
ActiveFlag to indicate whether the product group is active or not (0 = Inactive, 1 = Active)bit1
AlternativeMainMarkerUIDSite/ownSitecompetitorUnique ID representing the alternative main marker site.uniqueidentifier16
AutoChangeAcknowledgementPMI setting where False sends to Sites For Review for review and True applies and sends to Sites For Review for notification.bit1
AutoImplementIndicates whether proposed prices will be exported automatically (if they pass validation) or will be sent to review.bit1
GenerateOnGPCEndDetermines whether when a GPC reaches its end time, a price generation should be performed.bit1
GeneratePricesIndicates whether price generation should occur for the product group.tinyint1
GlobalProductGroupUIDParentProductGroupUID of the global product group.uniqueidentifier16
IncludeInOptimiseIndicates whether the product group (and it's products) would be included in site level optimisation or not.bit1
LFAutoImplementFlag to determine whether LF price requests automatically implement - it needs to support 3 options (Auto implement, Use same as main setting, Review prices)tinyint1
MaxVolumeTargetThe maximum forecasted volume target for the product group.float8
MinVolumeTargetThe minimum forecasted volume target for the product group.float8
OwnProductGroupIDID representing the own product group.int4
OwnProductGroupUIDUnique ID representing the own product group.uniqueidentifier16
OwnSiteCompetitorUIDSite/ownSitecompetitorPriceNet ID of an own site competitor which has been designated as the "Main Marker" for the product group.uniqueidentifier16
OwnSiteUIDSiteID of the own site.uniqueidentifier16
PMIAutoImplementDefines whether the PMISuggested policy will be automatically implemented (copied to the product group's policy property) or not.bit1
PMIFrequencyHow often (in days) the PMIProcess should run for the product group.tinyint1
PMIGroupingIDID of a PMI Group.tinyint1
PMILastRunDateLast date and time the PMI Process was run for this product group.datetime8
PMIMarginValue of Margin value used by PMI Templatemoney8
PMIMarginRunningLengthThe default number of days that the average margin for the PMI calculation will be calculated over for this product group.int4
PMIMarginRunningRateValue of the Margin running rate used by PMI Tableint4
PMIRunningLengthThe number of days over which the PMI process will calculate the running rate during the PMI process.int4
PMIRunningRateThe running rate calculated by the PMI Process.int4
PMISalesImpactLimitExceededIndicator to show when the Sales Impact Limit Percentage has been exceeded during the PMI Process.bit1
PMISalesImpactLimitPercentageAn integer value defining the percentage of event-coded data that is acceptable in the PMI Process.tinyint1
PMISuggestedPolicyThe policy suggested by the PMI Process.int4
PMITemplateUIDID for the policy management (PMI) template that has been designated to the product group.uniqueidentifier16
PolicyA value (0 - 100) that characterises your pricing tactic.int4
PreviousPolicyThe previous policy value for the product group.int4
ProfitTargetThe profit target of the product group.float8
RestActiveIndicator to show when the product group is in a restoration.bit1
RestAllowDecreaseDefines whether prices can be decreased during restoration.bit1
RestAllowFirstLowerDefines whether after restoration has finished the system is allowed to propose the first lower price in the market.bit1
RestConsiderAllProductsA restoration setting.bit1
RestFirstGenToSFRDefines whether the first price generation (as a result of the RestGeneratePricesAtEnd being set) is sent to review.bit1
RestGeneratePricesAtEndDefines whether a product group is forced to generate prices when a restoration ends.bit1
RestGPCToRestDefines whether a product group that has a GPC is moved into restoration after the first GPC price.bit1
RestGPCTriggerCountSpecific trigger count for GPC initiated restorations.int4
RestGroupOptional name of restoration group that this product group belongs to.nvarchar100
RestLaggardModeIDDecides how to deal with competitors that trigger late on in restoration; 0 = Exclude Laggards From Calculation, 1 = Include Laggards In Calculation; 2 = Send the site to SFR with a note.tinyint1
RestMatchHighestCompetitorDefines whether to base the initial restoration price on the highest competitor price, if 0 the lowest competitor price will be used.bit1
RestMaxHoursThe maximum number of hours a product group can be in restoration.float8
RestPreRestPricingDictates the type of pricing that will be done, 0 indicates standard price generation, 1 = Use last price based on export type.tinyint1
RestSFROnDropDefines whether to send the product group to review when competitors drop price during a restoration.bit1
RestSuspendAutoImplementDefines whether auto-implement of prices will be suspended for restoration based price requests.bit1
RestTriggerCountThe number of competitors who have triggered restoration.tinyint1
RestTriggerWaitPeriodMaximum number of hours to wait after one or more competitors have triggered to go into restoration.float8
RestTurnOffAutoImplementAtEndDefines whether auto-implement will be turned off for the product group at the end of a restoration.bit1
RestUseGPCTriggerCountWhether GPC initiated restorations should use a different trigger count to normal restorations.bit1
RestUseHigherRulesPriceDefines whether price generation should use the higher of the rules based price or restoration price.bit1
VolumeTargetThe volume target based on the minimum volume target, the maximum volume target and the policy.float8
← ProductReference →
  • Overview
    • Product Data Model
  • Global Product Group
    • Global Product Group Attribute Details
  • Own Product Group
    • Own Product Group Attribute Details
Copyright © 2025 Kalibrate Technologies Limited