Mastering Smart Pricing in techSHIP [Guide]

Last updated: October 30, 2026

Use Custom Pricing Tables in techSHIP to define Carrier costs, client prices, and surcharges within Smart Pricing.

This guide covers their configuration, the shared Pricing Dimensions and Zones & Areas resources, and how you apply your pricing strategy to Carriers and Client Accounts.

For a full overview of all new features, see 📄 What's New in techSHIP: A Guide to the Latest Features [Information].

Prefer listening? This podcast-style audio walks you through the article's key points:

Mastering Smart Pricing in techSHIP.m4a

AI-Assisted & Human-Reviewed: For general information only. Please double-check important details.

Understanding Smart Pricing

You can use Simple Rates for basic custom-rate configuration. For more detailed control, use Custom Pricing Tables within Smart Pricing to define Carrier costs, client prices, and surcharges.

To ensure your profit margins are managed correctly, the system separates your financial data into two fundamental dimensions:

  • Cost: The actual baseline amount the Carrier charges you.

  • Price: The final billed amount you charge your customer.

Within a Custom Pricing Table, you define both Cost and Price values. You use Cost to evaluate Carrier expenses and Price to calculate client charges. With Split Mode, you configure Rates and Accessorials as separate calculation paths.

Core Architecture Components

When you configure a Custom Pricing Table, you combine the following components:

Entity

Function Within Smart Pricing

Pricing Dimensions

Defines the measurement brackets, such as weight tiers, used to segment shipping costs.

Zones & Areas

Maps the geographic transit routes from an origin to a destination.

Accessorial Collections

Groups variable or flat surcharges, such as fuel fees or custom conditions, into reusable profiles.

Custom Pricing Tables

Acts as the central hub that consolidates your building blocks into a final routing framework.

Service Levels

Defines specific Services mapped within a pricing table, combining selected zones and dimensions.

Rate Items

Provides the numerical matrix within each Service Level, where exact Cost and Price values intersect across your dimensions and zones.

The following infographic visualizes the data flow and relationship between these foundational entities.

All Smart Pricing resources belong to your central Organization and are shared seamlessly across all your specific Locations.

You can also use the same Pricing Dimensions and Zones & Areas resources when configuring Markup Profiles. For detailed conceptual information and advanced configuration, refer to 📄 Understanding Markup Profiles in techSHIP [Guide].

Building the Pricing Components

Prepare the components you need for your Custom Pricing Table using the dedicated configuration guides below. Continue with Accessorial Collections in this article when your pricing strategy requires additional surcharges.

Pricing Dimensions

You use Pricing Dimensions to define measurement brackets, such as weight tiers, for your pricing configuration.

To create a dimension, maintain its ranges, or update its items through a file, follow 📄 How to Configure Pricing Dimensions in techSHIP [Step-by-Step Guide].

Once your Pricing Dimensions are ready, continue with Zones & Areas.

Zones & Areas

You use Zones & Areas to define geographic areas, shipping zones, and the mappings between origins and destinations.

To create and maintain these resources or review the use of supported [SYSTEM] mappings, follow 📄 How to Configure Zones & Areas in techSHIP [Step-by-Step Guide].

Once your geographic configuration is ready, continue with Accessorial Collections or Configuring Custom Pricing Tables, as required.

Accessorial Collections

An Accessorial Collection groups additional shipping surcharges into a single, reusable profile.

  1. Click Accessorial Collections from the left menu under the Smart Pricing category.

  2. Press Create, provide a Code and Name, and save the record.

The Code value is permanent and cannot be changed after creation.

  1. Click the Edit icon on your newly created record to configure the specific surcharges.

Regardless of the accessorial type being created, you must define at least one calculation dimension: Price or Cost.

  1. Under the Location Based tab, press Create to define geographic Area surcharges using flat Price and Cost values.

Selecting a master Zone & Area locks this mapping for the entire collection once the first location-based record is created.

Predefined [SYSTEM] zones are not available for Location Based accessorials. You must map these surcharges to manually created Zones & Areas to ensure proper routing.

  1. Under the Shipment Attribute Based tab, press Create to define surcharges triggered by a custom Condition using flat Price and Cost amounts.

  1. Under the Fuel Surcharge tab, press Create to define variable percentage fees evaluated over the Base Rate. Here, you can also define floor and ceiling constraints (Min Price, Max Price, Min Cost, and Max Cost).

  1. Under the Advanced tab, press Create to define highly custom logic. In this section, your Condition, Price, and Cost fields can all be dynamically evaluated using mathematical expressions.

The Advanced tab uses complex custom expressions. To minimize errors, prefer the predefined tabs.

When configuring dynamic calculations, fields such as Condition, Price, and Cost use NCalc to evaluate expressions. Click the Edit icon to access the Expression Builder.

The Expression Builder provides a searchable dictionary of available properties and real-time syntax validation.

Follow these syntax rules:

  • Implicit: Omit brackets for variables without dots, for example Weight > 10. The system searches Shipment, then Order.

  • Explicit: Use brackets for variables with dots, for example [Order.City] == 'Toronto' or [Shipment.TotalWeight] * 0.35.

  • Floors and Ceiling: To enforce minimum or maximum limits in the Advanced tab, use the min() or max() functions, for example max(15, [Shipment.CollectOnDeliveryAmount] * 0.05).

  • Case sensitivity: All parameters are case-sensitive.

  • Reference: For syntax and operators, consult the NCalc Documentation.

Newly created Fuel Surcharges and Advanced accessorials are saved as Inactive by default. To apply these calculations, you must manually toggle the status to Active and properly configure the Start Date and End Date.

The surcharge profile is now ready to be used. You can map these collections globally or at the Service Level from within your Custom Pricing Tables.

Configuring Custom Pricing Tables

A Custom Pricing Table acts as the central hub where your building blocks are combined to create the final rate matrix.

Creating Service Levels

  1. Click Custom Pricing Tables from the left menu under the Smart Pricing category.

  2. Press Create, complete the required fields (Name and Currency), and save the record.

The Currency value is permanent and cannot be changed after creation.

  1. Click the Edit icon on your newly created record to configure the table properties.

  1. Under the Service Levels tab, press Create and configure the service properties, ensuring you select your previously built Zone & Area and Pricing Dimension profiles to establish the core routing dimensions.

The defined Service Code must exactly match the native Service Code of the intended Carrier. Unmatched codes will trigger order processing errors.

For the Service Level to be actively evaluated, ensure the Status toggle is set to Published and properly configure the Start Date and End Date. These parameters strictly control whether the rates are applied during calculations.

When you import Service Levels into a Custom Pricing Table, unchanged Service Levels keep their existing publication state. Newly added or actually changed Service Levels become Unpublished so you can review them before publishing.

The Service Level is now configured. Continue with Populating Rate Items when you are ready to define its Cost, Price, and Transit Days values.

AI Assistant

The techSHIP interface features a dedicated AI Assistant integrated directly into the Custom Pricing Tables page to help you troubleshoot your rating logic.

To open the chat interface, click the AI Assistant button located in the top-right corner when editing any Custom Pricing Table.

For more information about using the AI Assistant, see 📄 techSHIP AI Assistant: Overview & Availability [Information].

Restore a Custom Pricing Table from Backup

You can use Restore from backup to start a dated recovery workflow for an existing Custom Pricing Table.

Go to Smart Pricing > Custom Pricing Tables and open the Custom Pricing Table you want to restore. On the main table page, select Actions > Restore from backup.

Preview

Start the restore from the main Custom Pricing Table page. Restore from backup is not available from a Service Level's Rate Items page.

The Restore from backup dialog opens. Continue with 📄 Configuration Backups and Restore in techSHIP [Guide] to select a snapshot, review the changes, and complete the restore.

Populating Rate Items

  1. In the Service Levels tab, click the Rate Items icon on a specific service row.

  1. Under the Rates tab, select your target Mode from the top dropdown.

The Mode selector provides the following matrix views:

Mode

Behavior

All (readonly)

Opens by default and displays Cost, Price, and Transit Days together. You cannot edit values in this mode.

Cost

Lets you edit Cost values.

Price

Lets you edit Price values.

Transit Days

Lets you edit Transit Days values.

You must switch from All (readonly) to Cost, Price, or Transit Days before editing the corresponding values.

  1. Click directly into the intersecting matrix cells to edit their numerical values.

Use the following Rate Item value rules when editing the matrix:

Field

Accepted Values

Cost

Blank, 0, or a positive numeric value

Price

Blank, 0, or a positive numeric value

Transit Days

Blank, 0, or a positive whole number

A blank value clears that dimension when you save.

  1. Click Save to commit all pending Rate Item changes together.

Leaving an edited cell does not save its value.

When unsaved Rate Item changes exist, techSHIP requests confirmation before you change the displayed Mode, switch tabs, open another Service Level, leave the Rate Service Level page, or start a Rate Items import. Canceling keeps your pending edits; confirming the action discards them.

Tax amounts evaluated by the engine, including Canadian GST/HST/QST, are standard routing estimates. You must systematically verify all calculations to ensure financial compliance.

To bypass manual UI entry, you can manage Rate Items using the Export and Import functions under the Actions menu. This lets you bulk update your pricing matrix through a spreadsheet.

A Rate Items workbook represents the complete matrix, not a partial update. A blank or missing cell, a missing zone column, or a missing bracket row is interpreted as blank and therefore clears any existing value in that location.

The numerical rate matrix is now saved and ready for rating calculations. Continue with Mapping Accessorials if you need to apply global or Service-specific surcharges.

Mapping Accessorials (Header vs. Detail)

Surcharges can be mapped at two different architectural levels, dictating how they apply.

  • Header Level (Global): To apply surcharges across every Service within the table, go to the main Custom Pricing Table page, click the Accessorials tab, and assign your Accessorial Collections.

  • Detail Level (Service-Specific): To apply surcharges to one specific Service, open the Rate Items page for that Service, click the Accessorials tab, and assign your Accessorial Collections.

Accessorial Collections mapped at the Detail Level completely override any global collections applied at the Header Level. For example, if a global profile has five rules and a Service-specific profile has one, that specific Service will only evaluate the single rule. When viewing the Service Levels grid, a lightning bolt (âš¡) icon appears next to any Service with detail-level accessorials configured, allowing you to quickly identify these local surcharge exceptions.

When mapping accessorials at the Detail Level, collections containing Location Based surcharges will only appear as options if their assigned Zone & Area exactly matches the Rate Item. However, if the Rate Item utilizes [SYSTEM] zones, this restriction is bypassed, allowing you to map any Location Based accessorial collection to the Service.

Ensure you press Save after mapping your accessorials to apply the configuration.

Your accessorial mappings are now saved. Continue with Applying Your Pricing Strategy to assign the Custom Pricing Table to the appropriate Carrier or Client Account.

Applying Your Pricing Strategy

After configuring your Custom Pricing Tables, assign them to your Carriers to define costs and to your Client Accounts to define client prices, as needed.

Defining Carrier Costs and Surcharges

This configuration overrides standard Carrier API rates, extracting only the Cost dimensions from your matrix.

  1. Click My Carriers from the left menu under the Carriers category.

  2. Click the Edit icon on a specific Carrier.

  1. Click the Rates tab.

  2. Set the Mode to Smart Pricing Rates (Cost).

  3. Select your Custom Pricing Table from the dropdown menu.

  4. Press Save to apply your changes.

The Carrier will now use your custom table to evaluate operational costs.

Continue with Defining Client Prices and Surcharges when you also need to apply the pricing table's Price values to a Client Account.

Defining Client Prices and Surcharges

This configuration extracts the Price dimensions and utilizes the split-mode logic to independently manage surcharges.

  1. Click Clients from the left menu under the Clients category.

  2. Click the Edit icon on a specific Client.

  1. Click the Edit icon on a Client Account.

  1. Click the Rates & Markups tab.

  2. Under the Markup group, set the Rate Mode to Smart Pricing Rates (Price).

  3. Select your Custom Pricing Table.

  4. Set the Accessorial Mode to either Smart Pricing (to use the custom surcharges configured in your table) or Markup Profile (to calculate fees mathematically over the baseline using a profile).

  5. Click Save to apply your changes.

When you enable Rate Shopping and Include Markup for a Client Account using Smart Pricing Rates, techSHIP includes the applicable Smart Pricing markup when comparing that account's rates. This means the Cost column in the order's Rates tab can show the markup-inclusive comparison amount instead of only the original Carrier cost.

Include Markup applies only to the Client Account where you enable it. As a result, using Smart Pricing markup in the comparison can change which Carrier or Account is selected and the resulting estimated charge.

After saving, you have configured your Client Account to use the selected Custom Pricing Table for prices and the selected Accessorial Mode for surcharges. Before using this configuration for routine processing, verify the calculated charges with a controlled test order, including the values returned to your Host System.