Shipping Calculation
CyberStore shipping methods determine how freight is calculated and presented during checkout. Each method maps to a SYSPRO shipping instruction and uses one of three calculation types: Provider, TotalSimple, or Percentage.
The active Customer Class controls whether CyberStore calculates freight, which shipping methods are available, and the order in which those methods appear. A method can be added to or removed from a Customer Class without being disabled globally.
Calculation types
Choose a calculation type according to the source and structure of the shipping price.
| Calculation type | Source and behavior |
|---|---|
| Provider | Requests a real-time rate from a configured carrier integration such as UPS, FedEx, US Postal Service, or C. H. Robinson. The returned rate can be adjusted before display. |
| TotalSimple | Selects a flat shipping amount from a configured matrix based on item subtotal, total item mass, or total item volume. It does not call an external provider. |
| Percentage | Calculates shipping from a percentage of the item subtotal and an optional flat fee. It does not use a provider or calculation matrix. |
Changing a method’s calculation type resets configuration that belongs to the previous type. Review the method before saving after a calculation-type change.
Provider calculation flow
A Provider method follows this sequence:
- The configured provider returns a base rate.
- CyberStore evaluates the method’s required-weight threshold.
- When the threshold is not met, CyberStore calculates the price with the applicable alternate method.
- CyberStore applies the primary rate adjustment when enabled.
- CyberStore applies the secondary matrix adjustment when enabled.
- CyberStore prevents the final shipping amount from falling below zero.
The provider supplies the rate; the CyberStore shipping method controls alternates and adjustments applied to that rate.
UPS OAuth package splitting
The UPS OAUTH provider limits each rated package to 150 pounds. Before requesting a rate for a heavier shipment, CyberStore divides the total weight into packages of no more than 150 pounds. The request uses package code 02 (Package) and weight unit LBS.
For example, a 370-pound shipment is rated as two 150-pound packages and one 70-pound package. This automatic splitting applies only to the UPS OAUTH provider.
Provider rate adjustments
A Provider method can increase or decrease the returned rate by a flat amount or percentage. A secondary calculation matrix can apply an additional tiered adjustment based on item subtotal, total item mass, or total item volume.
The UPS OAUTH provider returns public UPS rates, which can differ from the shipper’s negotiated cost. The same primary and secondary Shipping Method adjustments apply to those returned rates.
For a secondary matrix, rows are evaluated from top to bottom using an up-to-and-including threshold. The last applicable row determines the adjustment. Gaps between thresholds resolve to the lower row, and duplicate calculation values are not allowed.
TotalSimple calculation
A TotalSimple method uses its calculation matrix as the primary source of the shipping price. The matrix can evaluate:
- Item subtotal.
- Total item mass.
- Total item volume.
Rows are evaluated from top to bottom using an up-to-and-including threshold. The last applicable row supplies the flat shipping amount and acts as the maximum configured threshold. If no row matches, the shipping amount is 0.00. Provider adjustments do not apply to a TotalSimple method.
Percentage calculation
A Percentage method uses the following calculation:
Shipping cost = (item subtotal x percentage) + flat fee
The percentage must be positive, and the flat fee must be zero or greater. Percentage methods do not use minimums, maximums, tiered matrices, or provider adjustments. The final amount cannot be negative.
Alternate methods
A Provider method can use an alternate method when the order does not meet its required-weight threshold. The alternate can use any calculation type.
- The alternate method calculates the shipping price behind the scenes.
- Checkout continues to display the original method name.
- A branch-specific alternate takes precedence over the method’s default alternate.
Global overrides
Some conditions bypass the normal method calculation.
Customer free freight
A Customer configured for free freight receives a shipping amount of 0.00. This override applies regardless of the selected method or calculation type.
Oversized or insured items
When any order item is flagged as Insurance Required or Oversized, CyberStore bypasses checkout shipping calculation and tells the shopper that shipping will be calculated later. The order can proceed without a finalized shipping amount so the back office can calculate freight and confirm it with the Customer.
Provider failures
A provider failure does not prevent checkout from completing. CyberStore displays the shipping amount as TBD, includes a warning on the order confirmation, and leaves the back office to resolve the final shipping amount. Provider API calls and failures can be logged for troubleshooting.
Configuration references
Use the following references to configure the behavior described here:
- Shipping Methods defines calculation types, provider mapping, alternates, adjustments, and matrices.
- Customer Class Shipping controls method availability, display order, and class-specific shipping messages.
- Shipping Providers covers licensed carrier integrations, credentials, endpoints, and production validation.