alga-psa-time-and-billinglisted
Install: claude install-skill WYRE-AI/msp-claude-plugins
# Alga PSA Time and Billing
## Overview
Before a billing run, a service manager checks that time is submitted and approved, that
billable work is flagged billable, and that invoices are not sitting in draft or going
overdue. These are all reads; none is admin-gated in Conduit. Approving a time sheet,
requesting changes, finalising or sending an invoice is not possible through this
connector. List what needs doing and who should do it.
## Key Concepts
| Concept | Values |
|---|---|
| Time sheet `approval_status` | `DRAFT`, `SUBMITTED`, `APPROVED`, `CHANGES_REQUESTED` |
| Time entry `work_item_type` | ticket, project_task, non_billable_category, ad_hoc, interaction, co_managed |
| Invoice `status` | draft, sent, paid, overdue, cancelled, pending, prepayment, partially_applied |
## Common Workflows
### Time sheet approval backlog
1. `alga_time_sheets_list` with `approval_status` SUBMITTED, sorted by `submitted_at`
ascending: these wait on a manager.
`{"approval_status": "SUBMITTED", "sort": "submitted_at", "order": "asc", "limit": 100, "page": 1}`
2. Repeat with DRAFT for sheets not yet submitted and CHANGES_REQUESTED for sheets sent
back. Narrow to one period with `period_id`.
3. Map `user_id` to names with `alga_users_list`, and to managers with `alga_teams_list`
(each team has a manager) so each item has an owner.
4. Report per technician: period, state, age. Flag anything submitted more than a few
days ago.
### Hours by technician
1. `alga_time_entrie