Entity System Overview

Introduction

The Entity System is the foundation of CargoXplorer TMS, providing a comprehensive data model for all business objects in the transportation and logistics domain. With over 100 pre-defined entities, the system covers every aspect of freight forwarding operations, from customer management to financial transactions, shipping documentation, and warehouse operations.

Entities in CargoXplorer TMS are more than just database tables - they are intelligent business objects with built-in behaviors, relationships, validations, and workflow integration capabilities. This low-code approach allows rapid development of complex logistics applications while maintaining data integrity and business rule enforcement.

Core Concepts

What is an Entity?

An entity represents a business object or concept in the TMS system. Each entity:

• Has a unique identifier and standardized naming convention
• Contains fields (attributes) that store data
• Defines relationships with other entities
• Includes business rules and validations
• Integrates with workflows, permissions, and UI components
• Supports custom extensions and configurations

Entity Categories

Entities are organized into logical categories based on their business function:

1. Core Business Entities

   • Job (Aggregate Entity)
   • Order (Shipment, Warehouse Booking, Quote)
   • Contact (Customer, Vendor, Agent, Carrier, Broker)

2. Financial Entities

   • Accounting Transaction (Invoice, Bill, Credit Memo)
   • Payment
   • Charge
   • Accounting Item

3. Operational Entities

   • Commodity

4. Document Entities

   • Document
   • Attachment