Find here the list of actions to apply on the objects, and the data reference for this object.

What is a timesheet ?

A timesheet contains indication of time spend on what.

Getting the timesheets list

GET /timesheets.xml

Returns all timesheets, page by page
Add a page parameter to navigate

Getting a single timesheet

GET /timesheets/#{id}.xml

Returns a single timesheet, identified by its id

Creating a new timesheet

POST /timesheets.xml

Creates a new timesheet, and returns the timesheet data

Updating an existing timesheet

PUT /timesheets/#{id}.xml

Updates some fields of an existing timesheet

Deleting an existing timesheet

DELETE /timesheets/#{id}.xml

Deletes the timesheet identified by its id

Object data

<timesheet>
 <id>id of this object</id>
 <period>month it's related to (date format)</period>
 <user_id>user it's related to</user_id>
 <status_id>timesheet status (see below)</status_id>
 <validated_at>date of validation</validated_at>
 <validator_id>user who validated the timesheet</validator_id>
 <unit>time unit (see below)</unit>
 <timesheet_lines>
  <timesheet_line>
   <user_id>user it's related to</user_id>
   <branch_id>service it's related to (see below)</branch_id>
   <day>day of month</day>
   <duration>duration in the time unit of the timesheet</duration>
   <description>description</description>
   <comment>additional comments</comment>
   <lead_id>id of related lead</lead_id>
   <project_id>id of related project</project_id>
  </timesheet_line>
 </timesheet_lines>
</timesheet>

Possible values of service

• 79 for sales

• 80 for documents

• 81 for direction

• 82 for human resources

• 83 for marketing

• 84 for purchases

• 85 for administrative

• 525 for research & development

• 575 for it

• 620 for not worked

Possible values of unit

• 530 for hours

• 531 if half-days

Possible values of status

• 76 if draft

• 77 if submitted

• 78 if archived