For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Visit appVisit websiteBook a demo
  • Get Started
    • Welcome
  • Authentication
    • Hirer Service Accounts
  • Concepts
    • Introduction
    • Directory & Contractors
    • Contracts
    • Approvals
    • Timesheeting
    • Checklists
  • Webhooks
    • Portal Access
    • Endpoint Setup
    • Securing Your Endpoints
    • Monitoring, Debugging & Recovery
  • Client API
    • Webhook Events
LogoLogo
Visit appVisit websiteBook a demo
On this page
  • What is a Timesheet?
  • Actors
  • Timesheet States
  • Lifecycle Overview
  • How the Approval Flow Works
  • Skip and Recall
  • Skipping a Timesheet
  • Recalling a Timesheet
  • Timesheet Entries
  • What Happens on Approval
Concepts

Timesheeting

Was this page helpful?
Previous

Checklists

Next
Built with

What is a Timesheet?

A timesheet represents a single billing period on a contract — one calendar week, running Monday to Sunday. Timesheets are generated automatically by the platform for every week within a contract’s active period; neither you nor the contractor needs to create them manually.

The contractor fills in what they worked during that week and submits it. You then review and approve or reject it. Once approved, the timesheet triggers invoicing and payroll.

Actors

ActorRole
ContractorFills in time entries and expenses, submits the timesheet, and can recall or skip it if needed.
HirerReviews submitted timesheets and approves or rejects them.
Platform (automated)Generates timesheets at the start of each week, and auto-approves timesheets where your configuration allows it.
Third party integrationThird party integrations can generate and submit approved timesheets directly into the YunoJuno platform.

Timesheet States

StateWhat it means
DRAFTThe timesheet has been generated but the contractor has not yet submitted it. Entries can be added and edited freely.
SUBMITTEDThe contractor has submitted the timesheet. It is awaiting approval or rejection.
RESUBMITTEDThe hirer rejected the timesheet and the contractor has submitted a corrected version. Treated identically to SUBMITTED for approval purposes.
APPROVEDThe timesheet has been fully approved. Invoicing and payroll are triggered.
ZERO_TIMEThe contractor indicated they did no billable work this period (a “skip”).
REJECTEDThe hirer rejected the timesheet. The contractor must edit and resubmit.
VOIDThe timesheet has been administratively cancelled. No billing occurs.

Lifecycle Overview

How the Approval Flow Works

Timesheets which are managed by the YunoJuno platform follow this workflow.

  1. Timesheet generated — at the start of each contract week, the platform automatically creates a timesheet in the DRAFT state.

  2. Contractor fills in entries — the contractor logs their time (and any expenses) and submits the timesheet. It moves to SUBMITTED.

  3. Hirer review and decision:

    • Approve — the timesheet moves to APPROVED and invoicing and payroll are triggered. A PDF record is generated.
    • Reject — the timesheet moves to REJECTED. The contractor is notified and must correct and resubmit.

  4. Resubmission — when the contractor resubmits after rejection, the timesheet moves to RESUBMITTED and follows exactly the same approval path as a fresh submission.

Third party integrations submit timesheets in the APPROVED state.

Skip and Recall

Skipping a Timesheet

If a contractor did no billable work during a period, they can skip the timesheet rather than submitting zero hours. This moves the timesheet to ZERO_TIME.

Recalling a Timesheet

If a contractor needs to correct a submission before you have approved it, they can recall it. This returns the timesheet to DRAFT so they can edit and resubmit.

Timesheet Entries

Each timesheet contains one or more entries representing individual units of work or cost within the billing period.

Entry typeWhat it represents
STANDARDRegular billable time for the period.
OVERTIMEOvertime hours beyond the standard working day, billed at a the overtime rate.
ADJUSTMENTA positive lump sum, often used for corrections.
EXPENSEA claimed expense submitted by the contractor, with a proof document.

What Happens on Approval

When you approve a timesheet:

  • The timesheet moves to APPROVED.
  • Invoicing is triggered, starting our billing process.