Domain, Items, Locations, and Equipment

This is the first in a series of eight posts that walk through a complete OTM end-to-end transaction flow — from initial setup through planning, tendering, invoicing, and cost allocation. Each post builds on the previous one. Use this series as a starting point and refer to OTM Help documentation to explore each topic in depth.

Recommendation for new OTM consultants: If you are early in your OTM career, the single most effective way to build confidence is to complete this entire series hands-on in a non-production environment. Step through each post in order, create every object yourself, and verify the results — rather than just reading through them. You will make mistakes, and that is exactly the point: troubleshooting your own configuration teaches you far more than any documentation can.

You do not need to create a new Domain. Skip the Domain creation step and work inside your existing business domain instead. Everything else — Items, Locations, Equipment, Service Providers, Rates, Itineraries, Bulk Plan, Tender, Invoice, and Voucher Allocation — can be built and tested within your current domain without affecting production data.

Business Scenario:

Toys Corporation (TCRP) has one DC/Warehouse and three store locations in different cities. The DC distributes three items (Item A, Item B, Item C) to those stores. TCRP has contracts with two carriers (SGTM, PNDP) who use 20 ft, 40 ft, and 53 ft equipment. TCRP wants to use OTM Bulk Plan to optimise transport costs and settle carrier invoices.

Carriers
SGTMPNDP
Equipment Types
20-FT40-FT53-FT
50 milesEqp: 20/40-FT75 milesEqp: 53-FT100 milesEqp: 40-FT50 milesEqp: 20/40-FTDCLOC-ALOC-CLOC-B
ItineraryRouteCarriers
ITIN-ADC → LOC-BSGTM, PNDP
ITIN-BDC → LOC-CSGTM
ITIN-CDC → LOC-ASGTM, PNDP
ITIN-DDC → LOC-A → LOC-BSGTM, PNDP

The locations map to real addresses:

DC_TCRP — DC/Warehouse in Indianapolis, IN 46202
LOC_A — Store in Nashville, TN 37203
LOC_B — Store in Charlotte, NC 28078
LOC_C — Store in Atlanta, GA 30303

Map showing Indianapolis DC and the three store locations

Domain:

Create a new domain TCRP to hold all configurations and transaction data for this business scenario. Once your domain is up and running, it is worth reading OTM Domains — Standard Schema and Data Dictionary — it explains how OTM organises data across domains, the standard database schema, and how domain-level isolation works, which helps you understand why objects you create here stay within TCRP and do not affect other domains.

Configuration and Administration > Domain Management > Add Domain

Add Domain screen with TCRP domain details

Log in to the new domain with the default credentials:

User: ADMIN
Password: CHANGEME

Login screen for TCRP domain

OTM home screen after logging into TCRP domain

Items:

Define three items — ITEMA01, ITEMA02, ITEMA03.

Order Management > Material Management > Item

Item creation screen showing ITEMA01

Set item weight and dimensions:

Weight: 2 LB

Item dimensions tab showing weight of 2 LB

Item dimensions showing length, width, height values

Locations:

Create the four locations used in this scenario.

Shipment Management > Location Manager

Create the DC/Warehouse location first with role Ship From:

Location GID: TCRP.DC_TCRP

DC_TCRP location header details

DC_TCRP location address tab

Critical — Location Role Profile: Every location must have a Location Role Profile set to SHIPFROM/SHIPTO on the Roles tab. Bulk Plan uses this to identify valid shipment origins and destinations. If this is missing, Bulk Plan will fail to plan shipments through that location.

DC_TCRP location role configuration showing SHIPFROM/SHIPTO profile

Create the three store locations with role Ship To:

Store locations LOC_A, LOC_B, LOC_C list view

Equipment:

Define equipment groups for the three container sizes used by the carriers.

Shipment Management > Equipment Management > Equipment Groups

Create groups 20_FT, 40_FT, and 53_FT with their dimensions and capacity:

Equipment groups list showing 20_FT, 40_FT, 53_FT

Define an Equipment Group Profile that groups these equipment types for assignment to itinerary legs:

Shipment Management > Equipment Management > Equipment Group Profile

Equipment Group Profile header

Equipment Group Profile details showing 20_FT, 40_FT, 53_FT assigned

← Previous
Basic Logistics Terminology
Next →
Itinerary

Questions & Discussion

Have a question about this topic? Post it below — use your name or a pseudonym, no account required. Comments are reviewed before appearing, usually within 24 hours.