FSM Journal Entry Record
In Field Service Management (FSM), a journal entry is a standard NetSuite accounting transaction that records debits and credits against general ledger accounts. FSM Project Labor Cost Posting uses it to record labor costs associated with a project.
The journal stores the resulting accounting amounts and line attribution. The source time bills retain their own time, hourly cost, and costing indicator. For information about calculation, time eligibility, and posting behavior, see FSM Project Labor Cost Posting.
Record Information
These identifiers distinguish the native record from its FSM model and from transaction search fields.
|
Property |
Value |
|---|---|
|
Record type |
Standard NetSuite |
|
Record name |
Journal Entry |
|
Record ID |
|
|
FSM model |
|
|
Record identity |
Internal ID ( |
|
Posting lines |
Native Lines sublist ( |
|
Transaction search type value |
|
Journal entry search data uses NetSuite Transaction search fields. For example, the FSM model reads debitamount and creditamount and writes the line fields debit and credit. Model attribute names and search column names are not interchangeable with saved field IDs. For information about journal entry fields, see Journal Entry - SuiteScript reference. For FSM model mappings, see FSM Record Model Configuration (models/journal).
Forms
Use the standard NetSuite Journal form or an account-created custom Journal form. FSM doesn't supply a dedicated journal entry form. A custom form can present the relevant accounting and Field Service columns without changing their underlying field identities.
NetSuite preferred-form settings affect initial form selection. Journal entry custom forms also support Store Form with Record. When the Store Form with Record box is checked, entries created with that form display the stored form when viewed or edited. See Custom Transaction Forms Properties and Storing Custom Forms with Transactions.
For journal entries created through models/journal, prototype.defaults.customform can supply an account-created custom form's internal ID. The standard journal model assigns no form ID. This creation default doesn't change the form of existing journals. See Custom Forms for Record Creation.
Record Relationships
The journal holds its accounting attribution on individual lines. The supplied FSM reference fields are separate from the native Name and Account fields. In the tables, a reference such as line.entity means field entity on sublist line, rather than a body-field ID.
|
Related Record |
Relationship and Field ID |
Purpose |
|---|---|---|
|
Project |
Journal line Name ( |
Associates the debit line with the project. More than one line or journal can identify the same project. |
|
Account |
Each journal line Account ( |
Identifies the account receiving that line's debit or credit. |
|
CRM task |
Journal line Field Service Task (trans) ( |
Retains the source time bill's FSM Task reference on the labor-cost debit line when a reference is available. |
|
Asset |
Journal line Field Service Asset (trans) ( |
Attributes the line to equipment or a service site. The labor-cost debit line receives the asset reference from the source time bill when available. |
|
Case |
Journal line Field Service Case (trans) ( |
Supplied optional column whose field definition sources the case from the selected CRM task. Labor posting doesn't explicitly copy a case value. |
|
Project task |
Journal line Field Service Project Task (trans) ( |
Supplied optional column, distinct from the CRM task column. Labor posting doesn't explicitly copy a project task value. |
|
Subsidiary |
Journal body Subsidiary ( |
Identifies the accounting subsidiary. FSM labor posting supplies this value from the project. |
|
Time bill |
The source time bill stores Customer/Project ( |
Supplies costing input and the separate costing result. The standard FSM action stores no source time bill ID on a journal line and no resulting journal ID on the time bill. |
The standard labor-cost credit line doesn't receive the project, task, or asset references. Interpret attribution at line level rather than treating those links as journal-wide relationships. For the complete allocation behavior, see Accounting Attribution.
An account-created link doesn't automatically add journal data to FSM Mobile, service history, reports, inheritance, or synchronization. Those uses require their own supported configuration and behavior.
FSM Fields
The tables identify the supplied English labels and useful field IDs. Account labels and form presentation can differ. Unless identified as FSM custom fields, the fields are native NetSuite data.
Accounting Data
These fields describe the journal and its posting lines. Line fields belong to the line sublist.
|
Field |
Field ID |
Purpose and Key Values |
|---|---|---|
|
Date |
|
Journal transaction date. The standard FSM labor action doesn't derive it from time bill dates. NetSuite creation defaults apply unless a configured creation default supplies a value. |
|
Currency |
|
Currency of journal amounts. When Multiple Currencies is enabled, FSM labor posting supplies the project's currency. |
|
Exchange Rate |
|
Native transaction exchange rate used by NetSuite accounting. It is separate from the time bill's saved hourly cost. |
|
Posting Period |
|
Native accounting period. NetSuite accounting preferences and approval rules determine its treatment. |
|
Account |
|
Ledger account for the line. For posting account configuration, see Configuring FSM Project Labor Cost Posting. |
|
Debit / Credit |
|
Monetary amounts in the journal currency, not hours or hourly rates. FSM creates a balanced debit/credit pair for each selected time bill. |
|
Memo |
|
Line description. Available time bill memo values are supplied to both lines of the labor-cost pair. |
|
Department / Class / Location |
|
Accounting classifications. FSM carries available time bill values to both lines when the corresponding NetSuite features are enabled. Location here is an accounting Location, not the asset's service-address text. |
Hours and hourly cost remain on the time bill. The journal amount calculation and its lack of hourly-cost currency conversion are explained in FSM Project Labor Cost Posting.
Field Service References and Compatibility Data
The following table lists five stored custom fields, all optional in the supplied field definitions. None has a fixed initial value. Sourcing and values supplied by a creation action are separate from a fixed field default.
|
Field |
Field ID |
Purpose and Key Values |
|---|---|---|
|
Field Service Task (trans) |
|
CRM task reference on a line. It is not the Project Task field. |
|
Field Service Asset (trans) |
|
Asset reference on a line. Its supplied sourcing uses the selected CRM task's Field Service Task Asset ( |
|
Field Service Case (trans) |
|
Case reference on a line, with supplied sourcing from the selected CRM task's native Case relationship. |
|
Field Service Project Task (trans) |
|
Project task reference on a line. Availability of this column doesn't mean the labor action populates it. |
|
Field Service Idempotency Key |
|
Identity field retained for compatibility and visibility. The standard labor-posting action doesn't assign a key to this field. |
This field doesn't indicate posting progress or prevent repeat posting by the standard labor-posting action.
Approval and Costing Indicators
Journal approval and time bill costing describe different records and different results.
|
Field or Indicator |
Stored On |
Meaning |
|---|---|---|
|
Approved ( |
Journal entry |
Native indicators that reflect journal approval according to the account's approval setup. These indicators don't show the status of FSM processing. |
|
Field Service Time Costed ( |
Time bill |
Hidden costing marker, cleared by default. FSM sets the marker after saving the labor-cost journal entry. |
The marker doesn't identify the journal entry or confirm its approval or posting to the general ledger.
The standard FSM journal definition has no dedicated labor-posting pending, running, completed, or error-reference field. A saved journal entry confirms that the transaction exists. Evaluate the source time bills' costing indicators and the journal entry's native approval state separately. For approval behavior, see Journal Entry Approval Overview. For partial failures and repeated posting, see Processing Model and Lifecycle.
Creation and Update Sources
The creation source determines which values are supplied. Native accounting validation and account customizations still apply.
|
Source |
Record Effect |
|---|---|
|
FSM Project Labour Cost Posting |
Creates a journal entry from eligible time for one project and supplies its posting lines and attribution. Time bill costing updates are separate operations. |
|
NetSuite journal entry, copy, import, or scripting |
Creates or updates the native transaction using the selected entry mechanism. A manually created journal doesn't itself set the FSM costing indicator on related time bills. |
|
NetSuite approval and accounting processing |
Maintains the journal's native approval and posting treatment. |
Editing, reversing, or deleting a journal doesn't automatically reset the source time bills' FSM Time Costed flag. The FSM labor action also doesn't amend an earlier journal when source time changes. See Limitations and Constraints for those boundaries.
Used by FSM Features
These capabilities create journal data or use its accounting attribution.
|
Feature |
Record Use |
|---|---|
|
Creates the labor-cost journal and updates the selected source time bills. |
|
|
Provides shortcuts to financial reports. The selected report's accounts, periods, approval and posting treatment, and criteria determine which journal data appears. Asset attribution uses the asset reference on the transaction line. |
Record Constraints and Data Requirements
A journal must satisfy NetSuite accounting validation, including valid line accounts and equal total debits and credits. Currency, subsidiary, classifications, and other requirements depend on the account's enabled features and accounting setup. See Journal Entries Overview.
The supplied FSM line relationships are not required on every journal entry. Requirements imposed by a custom form, account customization, or a specific posting capability are additional to the supplied field definitions. A valid saved journal is not proof that all time bill costing updates succeeded or that the journal has completed approval.