xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Position — entity reference
REFERENCE · Last reviewed

Position — entity reference

A field-sales territory seat that exists independently of whoever currently holds it. Visit routes (beats) can be owned by a position instead of a person: plans generated from them go to the seat's holder at generation time, and the route's Resource is kept equal to that holder. Who holds the seat, and when, is recorded in Resource Position records; saving one moves the seat's routes and open future plans to the new holder, and a daily job (when the Position-based route assignment setting is on) applies future-dated handovers. The seat's Operating Location is the start and end point for territory planning, so a handover never moves the territory. Assignment rules can give records to a position's current holder. There is no numbering, status or approval.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → BranchThe branch the seat belongs to. An administrative grouping, and the fallback start point for territory planning when Operating Location is empty. It does not decide which routes or outlets the seat has.
CodeCodeMultiLineTextOptional short code for the seat (up to 50 characters). Assignment rules can find a position by its code.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTime
DescriptionDescriptionTextFree-text notes about the seat. Not used by any process.
GeoLocationOperating LocationGeoLocationThe seat's operating base on a map: territory planning starts and ends the seat's beats here. When it is empty, the seat's branch location is used instead.
IdIdGuidYes
IsActiveActiveBooleanWhether the seat is in use; on by default. Only assignment rules check it (an inactive position is never matched). Plan generation and territory planning ignore it, so an inactive seat still owns its routes and generates plans.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextThe seat's name, shown in pickers and territory-planning messages. Name the seat, not the person. Assignment rules can find a position by its name.
OwnerIdOwnerLookup → UserAccountYes
ParentPositionIdParent PositionLookup → PositionThe seat this one reports to, for reference. Nothing reads it: it gives no visibility, approval or reporting rights over the seats below.
RecordTypeIdRecord TypeGuid, hidden
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTime

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEditEditEdit
EditInLineEditEditInlineEdit in page.
EditInListEditEditInlineEdit In List Header
NewNewNewNew