How to Manage Order and Shipment References in techOMS [Step-by-Step Guide]

Last updated: November 10, 2026

You can use the References tab within a Sales Order, Purchase Order, or Shipment to manage key-value pairs associated with the record or its specific lines.

This guide explains how to view, filter, add, edit, and delete references within these records in techOMS.

Screenshots in this article are provided for illustrative purposes. The shared procedures remain the same, but options, available fields, and certain UI elements may differ depending on the selected entity.

Understanding References

techOMS centralizes reference data within the References tab of each supported record, allowing you to track Codes and Values associated with Orders and Shipments.

A reference can apply to an entire record or to a specific line within that record. The available Type options depend on the entity you are managing.

The References table displays the following information columns:

  • Type: Indicates whether the reference applies to the entire record or an individual line. The displayed Type labels depend on the entity.

  • Line #: Displays the specific line number (only populated for line-level references).

  • Code and Value: The reference key-pair data (e.g., Code: InternalID, Value: 12345).

  • Context: Provides additional identifying information to help distinguish references:

    • For record-level references, it shows the associated Order # or Shipment #.

    • For line-level references, it shows the associated SKU.

  • Actions: Provides Edit and Delete controls when reference management is available.

Accessing References

You can manage references through the References tab of the corresponding Sales Order, Purchase Order, or Shipment.

Supported Entities

Supported Entity

Navigation Path

Sales Orders

Sales > Sales Orders > Open Sales Order > References

Purchase Orders

Purchases > Purchase Orders > Open Purchase Order > References

Shipments

Sales > Shipments > Open Shipment > References

You need appropriate permissions to access and manage references. For more information, see 📄 techOMS User permissions structure [Information].

For more information on finding the desired record, see:

Access Procedure

  1. Open the desired record.

  2. Click the References tab.

Adding References

You can manually add references to an Order, Shipment, or specific record line directly from the References tab.

To add a reference:

  1. Inside the References tab, click Add.

  1. Enter the reference Code and Value.

  2. Select the reference Type:

    • Order or Shipment: Associates the reference with the entire record.

    • Order Line or Shipment Line: Associates the reference with a specific line. Select the corresponding Line item.

  1. Click Save.

The saved reference appears in the References table.

Editing References

You can modify an existing reference when the record and your permissions allow editing. The fields available for modification depend on the selected entity.

To edit a reference:

  1. Click Edit next to the desired reference.

  1. Update the Code or Value as needed.

  2. Click Save.

The updated reference information appears in the References table.

Deleting References

You can remove a reference from the References table when deletion is permitted.

Make sure you select the correct reference before confirming deletion. The reference-management interface does not provide an Undo action for deleted references.

To delete a reference:

  1. Click Delete next to the desired reference.

  1. Click OK to confirm.

The reference is removed when the deletion completes successfully.

Filtering and Searching References

When an Order or Shipment contains a large number of references, you can use the search and filter tools to locate specific data:

  • Search bar: Locate matching references.

  • Quick Filter (Show only...): Toggle the view between available reference Types.

  • Advanced Filter: Narrow results more precisely as described in the procedure below.

To filter references:

  1. Click the Filter icon next to the search bar.

  1. Select the Type you wish to view.

If you select a line-level reference Type, you can further filter by Line # or Line SKU to display references associated with a specific line.

  1. Click Apply.

The table displays the references matching the selected filters.

The available Type options depend on whether you are viewing an Order or a Shipment.

Entity-Specific Considerations

Sales and Purchase Orders

Sales Orders and Purchase Orders support two reference Types:

  • Order: Applies to the order as a whole.

  • Order Line: Applies to a specific line within the order.

You can manually add, edit, or delete Order references only when the Order is in Draft status.

References defined on a Customer or Supplier profile can be automatically copied to the corresponding Order:

  • Customer References: Copied to a Sales Order when you assign a Customer in the Ship To section and save the order.

  • Supplier References: Copied to a Purchase Order when you assign a Supplier and save the order.

These copied references appear with the Order Type, alongside other order-level references.

The copying process occurs when the order is saved. Changes made later to the original Customer or Supplier references in the Address Book do not automatically update references already copied to an existing order.

If you edit or delete a reference that was originally copied from a Customer, it will not be restored automatically unless you re-select the Customer in the Ship To field, which may duplicate other references.

Similarly, changing the Customer or Supplier assigned to an existing order can append new references without automatically removing those copied from the previous entity. Review the References tab and remove obsolete entries when necessary.

For more information on reference inheritance and copying behavior, see 📄 Understanding Customers and Suppliers (Address Books) [Guide].

Shipments

Shipments support two reference Types:

  • Shipment: Applies to the shipment as a whole.

  • Shipment Line: Applies to a specific line within the shipment.

You can add, edit, and delete both types directly from the shipment's References tab when the actions are available.

Once a shipment reference is created, you can modify its Code and Value, but you cannot change its Type or associated Line. Reference-management actions are unavailable when the shipment is closed or on hold.