2.7. Create-time-entries

Creates a list of time entries and optionally sends them for approval.

Function name

create-time-entries

Parameters
  • data (Required). It is an array of time entry fields. For example, in case the data format is XML, you should post something like this:

    <data>
        <item>
            <creator_id>100</creator_id>
            <hours_worked>2.5</hours_worked>
            <user_comments>Fixed Bugs</user_comments>
            <for_date>2008-10-01</for_date>
            <task_id>12345</task_id>
            <time_code_id>12</time_code_id>
            <rate_type_id>1</rate_type_id>
            <is_billable>false</is_billable>
            <is_costable>true</is_costable>
        </item>
        <item>
            <creator_id>100</creator_id>
            <hours_worked>3</hours_worked>
            <user_comments>Done</user_comments>
            <for_date>2008-10-02</for_date>
            <task_id>89019</task_id>
            <time_code_id>13</time_code_id>
            <rate_type_id>1</rate_type_id>
            <is_billable>true</is_billable>
            <is_costable>true</is_costable>
        </item>
    </data>

    In case of JSON, you should submit an array of objects with the same properties.

    Here are the details of the fields:

    • creator_id (Required). Integer. The user on behalf of which the time entry is being submitted.

    • for_date (Required). Date. The date for this time entry.

    • hours_worked (Required). Float. The number of hours.

    • task_id (Required). Integer. The task for which this time entry is being filled.

    • time_code_id (Required). Integer. The time code ID for this time entry.

    • rate_type_id (Optional). Integer. 1 for standard, 2 for overtime (in case your organization uses overtime rates)

    • user_comments (Optional). The comments entered by user for this time entry.

    • is_billable (Optional). Boolean. Whether this time entry is billable to client.

    • is_costable (Optional). Boolean. Whether this time entry is costable to the company.

  • send-for-approval (Optional). Whether the entries submitted are to be sent for approval.

Return values

Nothing