Input File Layout

The input file is named by the user.

The error file has the same name with an ".ERR" extension.

The input file can be either a fixed-format file or a comma-separated file. If the file is a fixed-format file, you must fill every position with either an appropriate character or a space. It is not necessary to zero-fill numbers; you can use spaces to maintain the proper format. If the file is comma-separated, it is not necessary to fill every position, but the file must have the correct number of commas. Each record must be on a separate line and end with a carriage return and line feed.

In fixed-format files, you must populate the required input file fields with valid data. If you do not populate an optional column in a fixed-length input file, you must enter the maximum number of spaces for that column before entering data for the next column. After you have entered the last character of meaningful data for the input file, you do not need to fill the remaining column lines with spaces. For example, if the Sequence Number field in position 217 is the last required value (out of a total of 487 possible field position spaces), you do not need to add the remaining 269 spaces. However, if you enter the Sequence Number in position 217 and wish to enter data in the Project-Account Abbrev field (starting at position 228) but not the Effective Billing Date field (starting at position 218), you must enter 10 spaces in place of the Effective Billing Date field before entering Project-Account Abbrev data in position 228. This also applies when you enter data in a required field, skip the following optional field, and then enter data in another required field.

Most users of earlier versions of Costpoint can continue to use the previous format, which did not include the Organization Abbreviation and the Project Abbreviation. If you are using the Comma-Separated Values format and 21 commas are present in the input file, the earlier format is presumed. There is one condition in which you cannot use the previous format. You must include the new field positions if:

  • You are using the Fixed-Length format,
  • You entered Notes, and
  • You did not pad the record to the previous full record length.

The current full record length for fixed-length records is 487. 

Note: You cannot use commas in the Notes field. Neither format requires that the Notes field be filled with spaces, but both require that every record end with a carriage return and line feed.
Note: The input file layout may contain fields that are available only in Costpoint Advanced. If you are using Costpoint Essentials, these fields are excluded from the import process and may be left blank or null when you create the input file.

Input File Excel Template

Go to the Developer Resources page of the Costpoint Information Center to download the Excel template file specifically designed for this preprocessor. Templates for other Costpoint preprocessors are also available at the same location.

Input File Layout

# Field Name Costpoint Table/Column Data Type and Size Column Required/Optional Defaulting Information Format/Contents
1 Timesheet Date TS_HDR and TS_LN.TS_DT Char 10 1–10 Required If a value is not supplied in the input file, the To date specified on the screen defaults. YYYY-MM-DD
2 Employee ID TS_HDR and TS_LN.EMPL_ ID Char 12 11-22 Required
3 Timesheet Type Code TS_HDR and TS_LN.S_TS_ TYPE_CD Char 2 23-24 Required If a value is not supplied in the input file, type R defaults. R, B, L, D, N, or C
4 Working State TS_HDR. WORK_STATE_CD Char 2 25-26 Required If a value is not supplied in the input file, the Default Overtime State from the Manage Employee Salary Information screen defaults.
5 Fiscal Year TS_HDR.FY_ CD Char 6 27-32 Required If not supplied in the input file, the Fiscal Year specified on the Import Timesheets screen defaults.
6 Period TS_HDR.PD_ NO Numeric 2 33-34 Required If not supplied in the input file, the Period specified on the Import Timesheets screen defaults. (99)
7 Subperiod TS_HDR.SUB_PD_NO Numeric 2 35-36 Required If not supplied in the input file, the Subperiod specified on the Import Timesheets screen defaults. (99)
Note: Not available with a Costpoint Starter license.
8 Correcting Ref Date TS_HDR.CORRECTING_REF_DT Char 10 37-46 Optional YYYY-MM-DD
9 Pay Type TS_LN.PAY_TYPE Char 3 47-49 Required For default information, please see "Pay Type" in the Tables section of Processing Details.
10 General Labor Category TS_LN.GENL_LAB_CAT_CD Char 6 50-55 Required For default information, please see "General Labor Category" in the Tables section of Processing Details.
11 Timesheet Line Type Code TS_LN.S_TS_ LN_TYPE_CD Char 1 56-56 Required If a value is not supplied in the input file, type A defaults. A, B, L, M, S
12 Labor Cost Amount TS_LN.LAB_CST_AMT Numeric 15 57-71 Required For default information, please the "Labor Cost Amount" in the Tables section of Processing Details. (-99999999999.99)
13 Hours TS_LN.ENTERED_HRS and CHG_HRS Numeric 10 72-81 Required (-999999.99)
14 Workers' Comp Code TS_LN.WORK_COMP_CD Char 6 82-87 Required For default information, please see "Workers' Comp Code" in the Tables section of Processing Details.
15 Labor Location Code TS_LN.LAB_LOC_CD Char 6 88-93 Required if Require Labor Location is selected on the Configure Labor Settings screen. For default information, please see "Labor Location Code" in the Tables section of Processing Details.
16 Organization ID TS_LN.ORG_ID Char 20 94-113 Required For default information, please see "Organization" in the Tables section of Processing Details.
17 Account ID TS_LN.ACCT_ ID Char 15 114-128 Required For default information, please see "Account" in the Tables section of Processing Details.
18 Project ID TS_LN.PROJ_ ID Char 30 129-158 Required if Project Required is selected on the Manage Accounts screen for the specified account. For default information, please see "Project" in the Tables section of Processing Details.
19 Project Labor Category TS_LN.BILL_LAB_CAT_CD Char 6 159-164 Required/ Optional status dependent upon project setup. For default information, please see "Project Labor Category" in the Tables section of Processing Details.
20 Reference Number 1 TS_LN.REF_STRUC_1_ID Char 20 165-184 Optional For default information, please see "Reference Number 1" in the Tables section of Processing Details.
Note: This should be blank if you have a Costpoint Starter Edition license. Any value will cause an error.
21 Reference Number 2 TS_LN.REF_STRUC_2_ID Char 20 185-204 Optional For default information, please see "Reference Number 2" in the Tables section of Processing Details.
Note: This should be blank if you have a Costpoint Starter Edition license. Any value will cause an error.
22 Organization Abbreviation TS_LN.ORG_ABBRV_CD Char 6 205-210 Optional If not supplied in input file, the organization abbreviation defaults from the Manage Organization Elements screen.
23 Project Abbreviation TS_LN.PROJ_ABBRV_CD Char 6 211-216 Optional If not supplied in input file, the project abbreviation defaults from the Basic Info tab of the Manage Project User Flow.
24 Sequence Number TS_HDR and TS_LN.TS_HDR_SEQ_NO Numeric 1 217-217 Required If a value is not supplied in the input file, 1 defaults. 1 - 9
25 Effective Billing Date TS_LN.EFFECT_BILL_D Char 10 218-227 Optional If a value is not supplied in the input file, the Default Method selected in the Effective Bill Date Options group box on the Configure Labor Settings screen is used to determine the default value. YYYY-MM-DD
26 Project-Account Abbrev. TS_LN.PROJ_ACCT_ABBRV_CD Char 6 228-233 Optional If a value is not specified in the input file, the Proj-Acct Abbrev defaults from the Manage Project Account Groups screen.
27 Multi-State Code TS_LN.WH_ST_CD Char 2 234-235 Optional Required if the Multi State Withholding Taxes check box is selected on the Manage Pay Periods screen.
28 Reference Sequence Num TS_HDR.REFERENCE_

SEQ_NO

Char 1 236-236 Optional If not supplied and timesheet type is Labor Only, default 1.
29 Timesheet Line Date TS_LN.TS_LN_DT Char 10 237-246 Optional Required only when prorating with a Calculation Method of Days per Cycle. YYYY-MM-DD
30 Notes TS_LN.NOTES Char 254 247-500 Optional

Manufacturing Order Timesheets

Note: This input file layout section is used only by companies with a Costpoint Manufacturing license.

If the timesheet line type is M (Manufacturing Order), replace fields 22 through 30 with the following fields:

# Field Name Costpoint Table/Column Data Type and Size Column Required/ Optional Defaulting Information Format/Contents
22 Manufacturing Order ID TS_LN_MO.MO_ID Char 10 205-214 Required if the Timesheet Line Type Code is M.
23 Operation Sequence No TS_LN_MO.MO_ OPER_SEQ_NO Numeric 4 215-218 Required if the Operation Step No is specified.
24 Operation Step No TS_LN_MO.MO_OPER_STEP_NO Numeric 3 219-221 Required if the Operation Sequence No is specified.
25 Activity Type TS_LN_MO.S_ ACTIVITY_ TYPE Char 1 222 Required if the Timesheet Line Type Code is M. R or S
26 Work Center ID TS_LN_MO.WC_ID Char 12 223-234 Optional
27 Organization Abbreviation TS_LN.ORG_ ABBRV_CD Char 6 235-240 Optional If not supplied in input file, the organization abbreviation defaults from the Manage Organization Elements screen.
28 Project Abbreviation TS_LN.PROJ_ ABBRV_CD Char 6 241-246 Optional If not supplied in the input file, the project abbreviation defaults from the Basic Info tab of the Manage Project User Flow.
29 Sequence Number TS_HDR and TS_LN.TS_HDR_SEQ_NO Numeric 1 247 Required If a value is not supplied in the input file, 1 defaults. 1 - 9
30 Effective Billing Date TS_LN.EFFECT_BILL_DT Char 10 248-257 Optional If a value is not supplied in the input file, the Default Method selected in the Effective Bill Date Options group box on the Configure Labor Settings screen is used to determine the default value. YYYY-MM-DD
31 Project-Account Abbrev TS_LN.PROJ_ACCT_ABBRV_CD Char 6 258-263 Optional If not specified in the input file, the project account abbreviation defaults from the Manage Project Account Groups screen.
32 Multi-State Code TS_LN.WH_ST_CD Char 2 264-265 Optional Required if the Multi State Withholding Taxes check box is selected on the Manage Pay Periods screen.
33 Reference Seq Num TS_HDR.REFERENCE_SEQ_NO Char 1 266 Optional If not supplied and timesheet type is Labor Only, default 1.
34 Timesheet Line Date TS_LN.TS_LN_DT Char 10 267-276 Optional Required only when prorating with a Calculation Method of Days per Cycle. YYYY-MM-DD
35 Notes TS_LN.NOTES Char 254 277-530 Optional
36 Transaction ID TS_LN.TRANS_ID Numeric 8 N/A Optional

Sales Order Timesheets

If the Timesheet Line Type is S (Sales Order), replace fields 22 through 30 with the following fields:

# Field Name Costpoint Table/Column Data Type and Size Column Required/ Optional Defaulting Information Format/Contents
22 Sales Order ID TS_LN_SO.SO_ ID Char 10 205-214 Required if the Timesheet Line Type Code is S.
23 SO Release No TS_LN_SO.SO_RLSE_NO Numeric 2 215-216 Required if the Timesheet Line Type Code is S.
24 SO Line No TS_LN_SO.SO_LN_KEY Numeric 2 217-218 Optional
25 Organization Abbreviation TS_LN.ORG_ABBRV_CD Char 6 219-224 Optional If not supplied in input file, the organization abbreviation defaults from the Manage Organization Elements screen.
26 Project Abbreviation TS_LN.PROJ_ ABBRV_CD Char 6 225-230 Optional If not supplied in input file, the project abbreviation defaults from the Basic Info tab of the Manage Project User Flow.
27 Sequence Number TS_HDR and TS_LN.TS_HDR_SEQ_NO Numeric 1 231 Required If not supplied in the input file, 1 defaults. 1 - 9
28 Effective Billing Date TS_LN.EFFECT_BILL_DT Char 10 232-241 Optional If a value is not supplied in the input file, the Default Method selected in the Effective Bill Date Options group box on the Configure Labor Settings screen is used to determine the default value. YYYY-MM-DD
29 Project-Account Abbrev. TS_LN.PROJ_ ACCT_ABBRV_CD Char 6 242-247 Optional If not specified in the input file, the project account abbreviation defaults from Manage Project Account Groups screen.
30 Multi-State Code TS_LN.WH_ST_CD Char 2 248-249 Optional Required if the Multi State Withholding Taxes check box is selected on the Manage Pay Periods screen.
31 Reference Sequence Num TS_HDR.REFERENCE_SEQ_NO Char 1 250-250 Optional If not supplied and timesheet type is Labor Only, default 1.
32 Timesheet Line Date TS_LN.TS_LN_DT Char 10 251-260 Optional Required only when prorating with a Calculation Method of Days per Cycle. YYYY-MM-DD
33 Notes TS_LN.NOTES Char 254 261-514 Optional