Accounting Integration Settings - Accounting Configuration
 

Job Number Format (STO Accounting)

 

The Job Number Format mask identifies the job numbering structure in the Sage Timberline® Office Job Cost Accounting database. WMS will not be able to correctly receive job information from Job Cost if the mask does not match the job numbering structure exactly. These settings should be configured for each accounting company. See the following section "Job Section Mapping Scenarios" for information to determine what mapping is required.

 

To establish the job number format:

  1. Access the Integration menu > Accounting > Accounting Integration Settings.

  2. Verify the accounting company currently selected in the Accounting Companies grid is the correct accounting company for which this setting will be defined. If necessary, click on a different accounting company.

  3. Click the Accounting Configuration tab.


     

  4. Enter the mask in the Job Number Format field by clicking the icon next to the Job Number Format field. This will display the Accounting JC Job Sections dialog.


     

  5. For each Section, beginning with Section 1:

  1. Enter the appropriate number of characters for section by clicking the up/down buttons next to each section.

  2. Separate the sections of the job number by entering a separator symbol such as '-' in the separator field between the current section and the next section.

  3. Repeat steps a & b for Section 2 and 3 if required. If a section is not required, just leave it and the separator field blank.

  4. For example, if the job numbers have 8 characters with 3 in the first section, 2 in the second section, and 3 in the last section, the Sample mask will display as 111-22-333 in the top left of the dialog and as###-##-### in the Job Number Format field on the Accounting Configuration Tab.
     

  1. Verify the job number mask by clicking Verify in the lower right side of the dialog.

  2. Adjust the mask as necessary.

  3. If using job section mapping, continue to the following section.

  1. Otherwise, Click OK to accept the updated Job Number Format and return to the Accounting Configuration Tab,

  2. Click the Save button at the top of the screen to save any changes.

Note

If the auto-numbering option will be used for numbering purchase orders, the job number, excluding the separating characters such as- is limited to 9 characters.

 

Job Section Mapping Scenarios (STO Accounting)

EachMap To field for each Section on the Accounting JC Job Sections dialog can be assigned a code from the available list. This code is used to interpret the value in the assigned section of the job number. For example, if section one of the job number is mapped to the division code, the value in section one of the job number must contain a valid division code. Once a code is assigned to a Map To field, that code is no longer available in the remaining Map To lists.

 

Note

Job section mapping only applies when importing new jobs into WMS from Sage Timberline Office Accounting. It can be used as a filtering tool for keeping out unwanted jobs. Job section mapping will not affect any current jobs that already exist within WMS.

Once mapping is established, the job number within a job record must match ALL assigned criteria in order to be imported. It is not necessary to use job section mapping, and it is not required that all three Map To fields contain a value.

 

 

 

 

 

 

 

 

 

 

Several common mapping scenarios are outlined below.  

Map to Division Code

In this scenario, map any Map To field (corresponding to section 1, 2, or 3) to the division code (it does not have to be mapped to the first section). If any section is assigned to the division code, the import process looks for the value in that specific position within the job number. The process must find a match on the division code within the job to import to the division code of the division currently selected in WMS. If no match is found, the job does not import into WMS.

 

Map to Division Code and Area Number

In this scenario, map any two of the Map To fields to the division code and the area number. The import process searches for the division code match, then the area number. The division code must match the division currently selected in WMS, and the area number must match an area within that division. If a match is not found for both the division code and area number, the job will not import into WMS. If a match is found for both, the area ID on the job record is updated, assigning the job to the area matching the area number in the job number section.  

 

Map to Division Code and Sales Code

In this scenario, map any two of the Map To fields to the division code and the sales code. The import process searches for the division code match, then the sales code. The division code must match the division currently selected in WMS, and the sales code must match an area within that division. If a match is not found for both the division code and sales code, the job will not import into WMS. If a match is found for both, the area ID on the job record is updated, assigning the job to the area matching the sales code in the job number section.  

Map to Area Number

In this scenario, map any one of the Map To sections (corresponding to section 1, 2, or 3) to the area number (it does not have to be mapped to the first section). The import process searches for an area with a matching area number within the current division. If a match is found, the job is imported and the area ID on the job record is updated, assigning the job to the area matching the area number in the job number section.  

 

Note

If this mapping scenario is employed, unique area numbers must exist across all divisions.

 

 

 

 

Map to Sales Code

In this scenario, map any one of the Map To sections (corresponding to section 1, 2, or 3) to the sales code (it does not have to be mapped to the first section). The import process searches for an area with a matching sales code within the current division. If a match is found, the job is imported and the area ID on the job record is updated, assigning the job to the area matching the sales code in the job number section.   

 

Note

If this mapping scenario is employed, unique sales codes must exist across all areas in the division.

 

 

 

 

To map codes to section(s) of the job number:

  1. From the Accounting Configuration tab, click on the  icon next to the Job Number Format field if the Accounting JC Job Sections dialog is not already open.

  2. Establish the Map To field values as desired. The options are Division Code, Area Number, Sales Code, Phase and Lot Number. Populate only those fields needed, in any order.


     

  3. Click OK when complete.

  4. Click the Save button in the toolbar.

 

Job Number Format (Explorer Contract Manager V7)

 

The Job Number Format mask identifies the sections of the job number in the Explorer Contract Manager V7 accounting company which are to be mapped to WMS Area, Phase Release and Lot Number codes. WMS will not be able to automatically assign jobs received from Explorer Contract Manager to the correct Area, Phase Release and/or Lot Number if the mapping of the sections does not match the Explorer Contract Manager job numbering structure exactly. These settings should be configured for each accounting company. See the following section "Job Section Mapping Scenarios" for information to determine what mapping is required.

 

To establish the job number format:

  1. Access the Integration menu > Accounting > Accounting Integration Settings.

  2. Verify the accounting company currently selected in the Accounting Companies grid is the correct accounting company for which this setting will be defined. If necessary, click on a different accounting company.

  3. Click the Accounting Configuration tab.


     

  4. Enter the mask in the Job Number Format field by clicking the icon next to the Job Number Format field. This will display the Accounting JC Job Sections dialog.


     

  5. For each Section, beginning with Section 1:

  1. Enter the appropriate number of characters for section by clicking the up/down buttons next to each section.

  2. Separate the sections of the job number by entering a separator symbol such as '-' in the separator field between the current section and the next section.

  3. Repeat steps a & b for Section 2 and 3 if required. If a section is not required, just leave it and the separator field blank.

  4. For example, if the job numbers have 8 characters with 3 in the first section, 2 in the second section, and 3 in the last section, the Sample mask will display as 111-22-333 in the top left of the dialog and as###-##-### in the Job Number Format field on the Accounting Configuration Tab.
     

  1. If using job section mapping, continue to the following section.

  1. Otherwise, Click OK to accept the updated Job Number Format and return to the Accounting Configuration Tab,

  2. Click the Save button at the top of the screen to save any changes

 

IMPORTANT

It is up to the user to ensure the Explorer job sections and mappings are correct as there is no direct communication between Explorer Contract Manager and WMS to validate this information.  Incorrect settings may result in failures in one or more points of the integration.

 

Note

If the auto-numbering option will be used for numbering purchase orders, the job number, excluding the separating characters such as- is limited to 9 characters.

 

 

Job Section Mapping Scenarios (Explorer Contract Manager V7)

EachMap To field can be assigned a code from the available list. This code is used to interpret the value in the assigned section of the job number. For example, if section one of the job number is mapped to the sales code, the value in section one of the job number must contain a valid sales code. Once a code is assigned to a Map To field, that code is no longer available in the remaining Map To lists.

 

Note

Job section mapping only applies when receiving new jobs into WMS from Explorer Contract Manager via the BMT.net API. Job section mapping will not affect any current jobs that already exist within WMS.

Jobs received via the BMT.net API are required to be assigned to a WMS Division as part of the job data submitted to the API. Jobs submitted to the BMT.net API will be rejected if they do not contain a valid Division Code or DIV_ID. For this reason there is no mapping of Division Code in the Job number for Explorer Contract Manager.

Once mapping is established, the each section of job number within a job record must contain valid values for the mapped field. If a section contains an invalid code, the job record will still be added to WMS, but the value of the mapped field will be unassigned. It is not necessary to use job section mapping, and it is not required that all three Map To fields contain a value.

 

 

 

 

 

 

 

 

 

 

 

 
 
 
 

Several common mapping scenarios are outlined below.  

 

Map to Sales Code

In this scenario, map any one of the Map To sections (corresponding to section 1, 2, or 3) to the sales code (it does not have to be mapped to the first section). The import process searches for an area with a matching sales code within the division assigned to the job. If a match is found, the job is imported and the area ID on the job record is updated, assigning the job to the area matching the sales code in the job number section.   

 

Note

If this mapping scenario is employed, unique sales codes must exist across all areas in the division.

 

 

Map to Sales Code and Phase Code

In this scenario, map any two of the Map To fields to the sales code and the Phase code. The import process searches for the sales code match, then the phase code. The sales code must be valid for the division assigned to the job, and the phase code must match a phase release within the sales code's area. If a match is not found for both the sales code and phase code, the job will not import into WMS. If the sales code section contains an invalid code, the job record will still be added to WMS, but the value of the AREA_ID field will be unassigned and the value in the phase code section will be ignored. If the phase code section contains an invalid code, the job record will still be added to WMS, but the value of the Phase_Release_ID field will be unassigned and the value in the phase code section will be ignored.   
 

To map codes to section(s) of the job number:

  1. From the Accounting Configuration tab, click on the  icon next to the Job Number Format field if the Accounting JC Job Sections dialog is not already open.

  2. Establish the Map To field values as desired. The options are Sales Code, Phase Code and Lot Number. Populate only those fields needed, in any order.


     

  3. Click OK when complete.

  4. Click the Save button in the toolbar.

 

Related Topics

Accounting Configuration

Job Number Format Mapping: Phase Release

JC Cost Code Format

JC Job Field Mapping

Track Extras (Options)

Track Variance Categories on Reissued Items

Track Variance Categories on difference between Budget and Commitment