Initial proposal for Issue #534: Add Commitment Discount Unit Price a…

…nd Cost

specification/columns/columns.mdpp

@@ -18,12 +18,14 @@ The FOCUS specification defines a group of columns that provide qualitative valu
 !INCLUDE "chargeperiodend.md",1
 !INCLUDE "chargeperiodstart.md",1
 !INCLUDE "commitmentdiscountcategory.md",1
+!INCLUDE "commitmentdiscountcost.md",1
 !INCLUDE "commitmentdiscountid.md",1
 !INCLUDE "commitmentdiscountname.md",1
 !INCLUDE "commitmentdiscountquantity.md",1
 !INCLUDE "commitmentdiscountstatus.md",1
 !INCLUDE "commitmentdiscounttype.md",1
 !INCLUDE "commitmentdiscountunit.md",1
+!INCLUDE "commitmentdiscountunitprice.md",1
 !INCLUDE "consumedquantity.md",1
 !INCLUDE "consumedunit.md",1
 !INCLUDE "contractedcost.md",1

specification/columns/commitmentdiscountcost.md

@@ -0,0 +1,57 @@
+# Commitment Discount Cost
+
+Commitment Discount Cost represents the cost calculated by multiplying the [Commitment Discount Unit Price](#glossary:commitmentdiscountunitprice) and the corresponding [Pricing Quantity](#pricingquantity). Commitment Discount Cost is denominated in the [Billing Currency](#billingcurrency) and is commonly used to calculate savings based on [*commitment discounts*](#commitment-discount).
+
+The CommitmentDiscountCost column adheres to the following requirements:
+
+* CommitmentDiscountCost MUST be present in a [*FOCUS dataset*](#glossary:FOCUS-dataset) when the provider supports *commitment discounts*.
+* CommitmentDiscountCost MUST be of type Decimal.
+* CommitmentDiscountCost MUST conform to [Numeric Format](#numericformat) requirements.
+* CommitmentDiscountCost MUST be denominated in the *BillingCurrency*.
+* CommitmentDiscountCost MUST be present when [*CommitmentDiscountId*](#glossary:commitmentdiscountid) is present.
+* CommitmentDiscountCost MUST equal [*PricingQuantity*](#pricingquantity) * ([*CommitmentDiscountUnitPrice*](#commitmentdiscountunitprice) - ([*ListUnitPrice*](#listunitprice) - [*ContractedUnitPrice*](#contractedunitprice))), and an effective difference exists between *ListUnitPrice and *ContractedUnitPrice* when [*negotiated discounts*] apply.
+* [*BilledCost*](#billedcost) MUST match CommitmentDiscountCost when [*ChargeCategory*](#chargecategory) is "Purchase" and *ChargeClass* is not "Correction".
+* [*EffectiveCost*](#billedcost) MUST match CommitmentDiscountCost when *ChargeCategory* is "Usage" and *ChargeClass* is not "Correction".
+* CommitmentDiscountCost MAY be null or any valid decimal value if *ChargeClass* is "Correction".
+
+When [*CommitmentDiscountCategory*](#commitmentdiscountcategory) is "Spend", *CommitmentDiscountUnitPrice* is not null, and *ChargeClass* is not "Correction", the following applies:
+
+* CommitmentDiscountCost MUST be the predefined amount of spend committed for each [*charge period*](glossary:chargeperiod) of the *commitment discount's* [*term*](glossary:term) when [*ChargeCategory*](#chargecategory) is "Purchase".
+* CommitmentDiscountUnitPrice MUST be the *effective unit price* of the covering resource's SKU when *ChargeCategory* is "Usage".
+
+When *CommitmentDiscountCategory* is "Usage", *CommitmentDiscountUnitPrice* is not null, and *ChargeClass* is not "Correction", the following applies:
+
+* CommitmentDiscountUnitPrice MUST be the *effective unit price* for the preselected SKU when *ChargeCategory* is "Purchase" or "Usage".
+* When [*commitment discount flexibility*](glossary:commitment-discount-flexibility) does not apply, the covering resource's SKU MUST match the purchasing SKU.
+* When *commitment discount flexibility* applies, the covering resource's SKU MAY be different than the purchasing SKU.
+
+## Column ID
+
+CommitmentDiscountCost
+
+## Display Name
+
+Commitment Discount Cost
+
+## Description
+
+Cost calculated by multiplying Commitment Discount Unit Price and the corresponding Pricing Quantity.
+
+## Usability Constraints
+
+**Aggregation:** When aggregating Commitment Discount Cost for savings calculations, it's important to exclude *commitment discount* purchases (i.e. when *ChargeCategory* is "Purchase") that are paid to cover future eligible charges (e.g., *commitment discount*). Otherwise, when accounting for all upfront or accrued purchases, it's important to exclude *commitment discount* usage (i.e. when *ChargeCategory* is "Usage"). This exclusion helps prevent double counting of these quantities in the aggregation.
+
+## Content Constraints
+
+| Constraint      | Value            |
+|:----------------|:-----------------|
+| Column type     | Metric           |
+| Feature level   | Conditional      |
+| Allows nulls    | True             |
+| Data type       | Decimal          |
+| Value format    | [Numeric Format](#numericformat) |
+| Number range    | Any valid decimal value |
+
+## Introduced (version)
+
+1.2

specification/columns/commitmentdiscountunitprice.md

@@ -0,0 +1,56 @@
+# Commitment Discount Unit Price
+
+Commitment Discount Unit Price represents the [*effective unit price*](#glossary:effectiveunitprice) for a single [Pricing Unit](#pricingunit) of the associated [*commitment discount's*](#glossary:commitmentdiscount) purchase or utilizing resource's SKU, exclusive of any [*negotiated discounts*](#negotiated-discount]). This price is denominated in the [Billing Currency](#billingcurrency) and is commonly used to calculate the discounted cost of a purchase or resource utilizing the *commitment discount*.
+
+The CommitmentDiscountUnitPrice column adheres to the following requirements:
+
+* CommitmentDiscountUnitPrice MUST be present in a [*FOCUS dataset*](#glossary:FOCUS-dataset) when the provider supports *commitment discounts*.
+* CommitmentDiscountUnitPrice MUST be a Decimal within the range of non-negative decimal values.
+* CommitmentDiscountUnitPrice MUST conform to [Numeric Format](#numericformat) requirements.
+* CommitmentDiscountUnitPrice MUST be denominated in the [*BillingCurrency*](#billingcurrency).
+* CommitmentDiscountUnitPrice MUST be present when [*CommitmentDiscountId*](#commitmentdiscountid) is present.
+* CommitmentDiscountUnitPrice MUST NOT include [*negotiated discounts*](#glossary:negotiated-discount)
+* CommitmentDiscountUnitPrice MUST equal [*CommitmentDiscountCost*](#commitmentdiscountcost) / [*PricingQuantity*](#pricingquantity) + ([*ListUnitPrice*](#listunitprice) + [*ContractedUnitPrice*](#contractedunitprice))
+* CommitmentDiscountUnitPrice MAY be null or any valid decimal value if [*ChargeClass*](#chargeclass) is "Correction".
+
+When [*CommitmentDiscountCategory*](#commitmentdiscountcategory) is "Spend" and *ChargeClass* is not "Correction", the following applies:
+
+* CommitmentDiscountUnitPrice MUST be the predefined amount of spend committed for each [*charge period*](glossary:chargeperiod) of the *commitment discount's* [*term*](glossary:term) when [*ChargeCategory*](#chargecategory) is "Purchase".
+* CommitmentDiscountUnitPrice MUST be the *effective unit price* of the covering resource's SKU when *ChargeCategory* is "Usage".
+
+When *CommitmentDiscountCategory* is "Usage" and *ChargeClass* is not "Correction", the following applies:
+
+* CommitmentDiscountUnitPrice MUST be the *effective unit price* for the preselected SKU when *ChargeCategory* is "Purchase" or "Usage".
+* When [*commitment discount flexibility*](glossary:commitment-discount-flexibility) does not apply, the covering resource's SKU MUST match the purchasing SKU.
+* When *commitment discount flexibility* applies, the covering resource's SKU MAY be different than the purchasing SKU.
+
+## Column ID
+
+CommitmentDiscountUnitPrice
+
+## Display Name
+
+Commitment Discount Unit Price
+
+## Description
+
+The *effective unit price* for a single Pricing Unit of the associated *commitment discount's* purchase or covering resource's SKU, exclusive of any *negotiated discounts*.
+
+## Usability Constraints
+
+**Aggregation:** Column values should only be viewed in the context of their row and not aggregated to produce a total.
+
+## Content Constraints
+
+| Constraint      | Value                                |
+|:----------------|:-------------------------------------|
+| Column type     | Metric                               |
+| Feature level   | Conditional                          |
+| Allows nulls    | True                                 |
+| Data type       | Decimal                              |
+| Value format    | [Numeric Format](#numericformat)     |
+| Number range    | Any valid non-negative decimal value |
+
+## Introduced (version)
+
+1.2

specification/glossary.md

@@ -68,6 +68,10 @@ The agreed-upon unit price for a single [Pricing Unit](#pricingunit) of the asso
 
 A specification-defined categorical attribute that provides context or categorization to billing data.
 
+<a name="glossary:effective-unit-price">Effective Unit Price</a>
+
+The discounted rate associated with a [*commitment discount*](#glossary:commitment-discount) and derived as the committed purchase amount divided by the number of [*charge periods*](glossary:chargeperiod) within its [*term*](glossary:term).
+
 <a name="glossary:effective-cost"><b>Effective Cost</b></a>
 
 The amortized cost of the charge after applying all reduced rates, discounts, and the applicable portion of relevant, prepaid purchases (one-time or recurring) that covered this charge.