Precision Pricing
With Miva’s Precision Pricing capability, merchants can now price products at less than a penny, which is helpful for stores that sell small products, like industrial fasteners, in mass quantities. Specifically, prices can be set to eight decimal places, allowing for prices as low as $0.00000001.
On This Page
Important
Adding precision pricing or weight may have unexpected consequences when using third party integrations that use these data fields. If, for example, you create a $0.005 product, it is not appropriate for us to decide that this should be exposed differently in the API. That could also create unexpected consequences, so we leave it to our customers to make these decisions and deal with these consequences downstream.
Installation and Setup
Precision Pricing requires no configuration after upgrading to Miva version 10.11.00. In fact, most customers will still use the standard two decimal places and see no change.
In Use
Behind the scenes, different calculation and data storage rules are applied when Miva finds a product where more than two decimal places have been assigned, for example as a product weight, product price, or in volume discounting table.
- Situations where knowing the high precision price is important (e.g. when multiplying by chosen quantity).
- Situations where converting to two digit pricing totals of item x quantity makes more sense, for customer facing totals and typical checkout integrations.
Here’s an example of a volume discount table showing discounts. The actual product is priced is $0.5596 (not shown) and weight is stored to precision, 0.01344358 lbs.
Customer Experience
What the customer would see is, and appropriately, they are seeing high precision pricing because this is a per unit price.
If a customer adds 1001 of this item to the basket, they see this, a much more appropriate, two-digit total cost.:
Miva Behind the Scenes
At an order level, for a product with Precision Pricing, none of the precision-rich data is lost and is reflected in the order information.
While in the database, even though the basket is presented with two decimal places, the precision price information is retained.
Integrations and Compatibility
Any integration that uses the Miva API to pull orders, also receives rich, precision pricing and weight data.
{
"success": 1,
"data": [
{
"order_id": 8837362,
"line_id": 428,
"group_id": 428,
"parent_id": 0,
"status": 0,
"subscrp_id": 0,
"subterm_id": 0,
"shpmnt_id": 0,
"rma_id": 0,
"product_id": 1208,
"dt_instock": 0,
"code": "RFS01174",
"name": "\u002312 PROZ\u2122 SD T3 HI-LO THREADED HEX CAP ROOFING SCREW",
"sku": "",
"type": "product",
"retail": 0.5596,
"base_price": 0.5596,
"price": 0.07884,
"total": 78.92,
"formatted_total": "$78.92",
"weight": 0.01344358,
"formatted_weight": "0.01344358 lb",
"taxable": true,
"tax": 6.12,
"formatted_tax": "$6.12",
"upsold": false,
"quantity": 1001,
"discounts": [
{
"order_id": 8837362,
"line_id": 428,
"pgrp_id": 497,
"display": true,
"descrip": "Volume Discount",
"discount": 0.48076
}
]
}
]
}
{
"from_country": "US",
"from_zip": "92127",
"from_state": "CA",
"from_city": "San Diego",
"from_street": "5060 Shoreham Place",
"to_country": "US",
"to_zip": "92127",
"to_state": "CA",
"to_city": "San Diego",
"to_street": "5060 Shoreham Place",
"amount": 78.92,
"shipping": 17.42,
"plugin": "miva",
"line_items": [
{
"id": "428",
"quantity": 1001,
"product_tax_code": "",
"description": "RFS01174",
"unit_price": 0.5596,
"discount": 481.24076
}
]
}
{
"tax": {
"order_total_amount": 96.34,
"shipping": 17.42,
"taxable_amount": 78.92,
"amount_to_collect": 6.12,
"rate": 0.0775,
"has_nexus": true,
"freight_taxable": false,
"tax_source": "destination",
"jurisdictions": {
"country": "US",
"state": "CA",
"county": "SAN DIEGO",
"city": "SAN DIEGO"
},
"breakdown": {
"taxable_amount": 78.92,
"tax_collectable": 6.12,
"combined_tax_rate": 0.0775,
"state_taxable_amount": 78.92,
"state_tax_rate": 0.0625,
"state_tax_collectable": 4.93,
"county_taxable_amount": 78.92,
"county_tax_rate": 0.01,
"county_tax_collectable": 0.79,
"city_taxable_amount": 0,
"city_tax_rate": 0,
"city_tax_collectable": 0,
"special_district_taxable_amount": 78.92,
"special_tax_rate": 0.005,
"special_district_tax_collectable": 0.39,
"line_items": [
{
"id": "428",
"taxable_amount": 78.92,
"tax_collectable": 6.12,
"combined_tax_rate": 0.0775,
"state_taxable_amount": 78.92,
"state_sales_tax_rate": 0.0625,
"state_amount": 4.93,
"county_taxable_amount": 78.92,
"county_tax_rate": 0.01,
"county_amount": 0.79,
"city_taxable_amount": 0,
"city_tax_rate": 0,
"city_amount": 0,
"special_district_taxable_amount": 78.92,
"special_tax_rate": 0.005,
"special_district_amount": 0.39
}
]
}
}
}
"Package": [
{
"PackagingType": {
"Code": "02"
},
"Dimensions": {
"UnitOfMeasurement": {
"Code": "IN"
},
"Length": "0.00",
"Width": "0.00",
"Height": "0.00"
},
"PackageWeight": {
"Weight": "13.4570",
"UnitOfMeasurement": {
"Code": "LBS"
}
},
"PackageServiceOptions": {}
}
],To ensure downstream compatibility, Miva adapts native integrations that do not support precision pricing where they require us to send a quantity.
For example, In places where it would break to send this information:
Item: #12 WIDGET
Quantity: 1001
Price: $0.07884
Total: $78.92
We instead send:
Item: (Qty: 1001) #12 WIDGET
Quantity: 1
Price: $78.92
Total: $78.92
In this case, for PayPal:
Notably, TaxJar DOES support precision pricing and we send it rich precision pricing data when available.
Notes
- Unless a product is $0, a basket line will never be less than $0.01 to protect against giving basket totals of zero If a product is stored as $0.00005 and a customer adds only one of the item to the basket, the basket total will be $0.01.
- The same API calls you may be using today to add or update products now fully support precision pricing and weight without any modification.
- Miva Provision File and Flat File Import methods for managing volume discount pricing now support precision pricing.