# MTPriceListMapping

This object maps between a priceable item, a parameter table, and a price list. Used by product offerings and subscriptions.

To view an object model diagram that includes MTPriceListMapping, click here.

## Program ID

Metratech.MTPriceListMapping.1

## Methods

Save | Saves modifications to the database.
CreateRateSchedule | Creates a new rate schedule for this price list mapping. This rate schedule will be linked to the appropriate parameter table, price list, and the template of the priceable item instance. A subsequent MTRateSchedule.Save() will insert it into the database.
FindRateScheduleAsRowset | Returns a rowset of rate schedules for this price list mapping. It cross references the needed rate schedule using: The associated parameter table, The associated price list, And the template of the associated priceable item instance.
GetPriceList | Returns the price list associated with this mapping.
GetParameterTable | Returns the parameter table definition associated with this mapping.
GetPriceableItem | Returns the priceable item instance associated with this mapping.

## Properties

Properties | Returns all (core and extended) properties of this object as a collection of MTProperty objects.
PriceableItemID | The unique (database) ID of the priceable item you want to map.
ParamTableDefinitionID | The parameter table definition to associate with the priceable item.
PriceListID | The price list to use for this priceable item.
CanICB | If true, an ICB rate can be applied to the priceable item.

# Method Detail

## CreateRateSchedule

This method creates a new rate schedule for this price list mapping. This rate schedule will be linked to the appropriate parameter table, price list, and the template of the priceable item instance.

A subsequent MTRateSchedule.Save() will insert it into the database.

### Visual Basic Syntax

CreateRateSchedule() As MTRateSchedule

### C++ Syntax

HRESULT CreateRateSchedule([out, retval] IMTRateSchedule * * apSchedule);

## FindRateScheduleAsRowset

This method returns a rowset of rate schedules for this price list mapping. It cross references the needed rate schedule using:

- The associated parameter table,

- The associated price list,

- And the template of the associated priceable item instance.

### Visual Basic Syntax

FindRateSchedulesAsRowset(Filter As Variant) As MTRowSet

### C++ Syntax

HRESULT FindRateSchedulesAsRowset([in, optional]VARIANT aFilter, [out, retval]IMTRowSet** apRowset);

## GetPriceList

This method returns the price list associated with this mapping.

### Visual Basic Syntax

GetPriceList() As MTPriceList

### C++ Syntax

HRESULT GetPriceList([out, retval] IMTPriceList * *pVal);

## GetParameterTable

This method returns the parameter table definition associated with this mapping.

### Visual Basic Syntax

GetParameterTable() As MTParamTableDefinition

### C++ Syntax

HRESULT GetParameterTable([out, retval] IMTParamTableDefinition * *pVal);

## GetPriceableItem

This method returns the priceable item instance associated with this mapping.

### Visual Basic Syntax

GetPriceableItem() As MTPriceableItem

### C++ Syntax

HRESULT GetPriceableItem([out, retval] IMTPriceableItem * *pVal);

## Save

This method saves modifications to the database.

### Visual Basic Syntax

Save()

### C++ Syntax

HRESULT Save()

# Property Detail

## Properties

This property Returns all (core and extended) properties of this object as a collection of MTProperty objects.

### Visual Basic Syntax

Property Properties As MTProperties

### C++ Syntax

HRESULT Properties([out, retval] IMTProperties **pVal);

## PriceableItemID

This property gets the ID of the priceable item you want to map.

### Visual Basic Syntax

Property PriceableItemID As Long

### C++ Syntax

HRESULT PriceableItemID([out, retval] long *pVal);

HRESULT PriceableItemID([in] long newVal);

## ParamTableDefinitionID

This property gets the parameter table definition to associate with the priceable item.

### Visual Basic Syntax

Property ParamTableDefinitionID As Long

### C++ Syntax

HRESULT ParamTableDefinitionID([out, retval] long *pVal);

HRESULT ParamTableDefinitionID([in] long newVal);

## PriceListID

This property establishes the price list to use for this priceable item.

### Visual Basic Syntax

Property PriceListID As Long

### C++ Syntax

HRESULT PriceListID([out, retval] long *pVal);

HRESULT PriceListID([in] long newVal);

## CanICB

If this boolean property is true, an ICB rate can be applied to the priceable item.

### Visual Basic Syntax

Property CanICB As Boolean

### C++ Syntax

HRESULT CanICB([out, retval] VARIANT_BOOL *pVal);

HRESULT CanICB([in] VARIANT_BOOL newVal);