Documentation for Developer and End User audiences will be completed on
the MadCap Flare software for publishing the documentation source to PDF
and online user documentation with minimal time and effort after
authorship. Flare allows for multiple output types, and tracks of
publishing using conditionals to steer the audience type and targets to
steer the publication to the web or print documentation environment for
the end user. For Clarity's purpose, the tracks will be per Version
number and the conditionals will be used for delivering content to the
audience types.
More information can be found in the software documentation here:
http://webhelp.madcapsoftware.com/flare10/ . The authoring file(Flare
Project) can be found on Dev B here:
C:\Data\Projects\ClarityInternal\Libraries\Documentation\V21\Clarity
eCommerce Framework.flprj The folder located at:
C:\Data\Projects\ClarityInternal\Libraries\Documentation\V21\ is
backed up into Stash so make sure to pull down, before you publish out
your new files with Flare, then push back into Stash. The menu structure
for the documentation will be broken down between the Framework, API,
Connect and Web UI. Development comments should be marked with
conditionals towards development and end user comments should be marked
with conditionals towards UI. Comments for both can be marked with both.
Most Clients don't utilize an ERP system or other system to pull
products in. They just want a simple "this is my price, I might have a
temporary Sale on specific products every now and then". To meet those
requirements we have the following three fields:
PriceMsrp: Some websites also display a 'Manufacturer's Suggested Retail
Price'. This price is almost never used in calculations but instead
gives the illusion of a discount to the customer.
PriceBase: The base price of the product, almost always used in normal
(not-in-a-current-sale) products and viewed on the product details,
catalog, carts and checkouts.
PriceSale: The sale price of the product, when set with a value and with
the IsSale flag for the product turned on, this price will be displayed
instead of the PriceBase value.
Example of how these three relate For example, you go to Kohl's and on a
pair of pants you see a tag that says the MSRP $49.99 (PriceMsrp), but
Kohl's never charges you $49.99, they start their own pricing at $29.99
(PriceBase). Kohl's is also having a sale that says 50% off so the sale
price is $14.99 (PriceSale). What gets used in the 'Shopping Cart' is
$14.99.
We also had one client which also wanted what they called a Reduction
Price, this will not be part of the normal platform but the Reduction
price had the same relationship with Base that MSRP did with base, it
was a flat starting point for price calculations (causing Price Base to
be ignored).
Other, especially larger, Clients will use an ERP system that allows
them to coordinate pricing levels across departments, knowledge of the
product transferring throughout the entire sales process. Some of these
clients still use the Simple Method as seen above and their data will be
transported as such. However, the rest will use some form of Tiered
Pricing System. The Tiered Method covers this more advanced scenario
along with several others by proxy.
There are four main components to this method: the Price Tiers, the
Account Price Points, the Product Price Points and the Product Price
Roundings.
Note: In a future version, this will be expanded to cover additional
scenarios for tighter control of the resulting prices.
The Price Tier, also known as the Price Level or the Price Key or Price
Rule, is a simple table that states the names of the different tiers. It
does not contain any actual price or cost modification rules and serves
as a relationship point.
Accounts are assigned a specific price tier which they have access to,
so there would be an Account Price Point record that contains both the
Price Tier's identifier and the Account's identifier.
Note: In a future version, Account Price Point will also include a
global % off value to used in all price calculations for the account.
The meat of the Tiered Method is handled in the Product Price Points
table. Each Product will be assigned one or more Price Tiers with the
following information:
Tells the price calculator how to round the price when there are too
many decimal digits.
Scenario 1, the Client offers special reduced pricing to customers that
they have built a relationship with. Anyone that they have not only sees
the full pricing on the website, same for anonymous (not logged in)
users.
That price was calculated by:
That price was calculated by:
On the product details page he puts in 500 and sees a Volume price come
out of $14.59 per bottle. That price was calculated by: