Description

n8n-nodes-tia

This is an n8n community node. It lets you use the TIA (Time & Invoice Administration) API in your n8n workflows.

TIA is a time registration and invoice management platform by Cronos. This node allows you to retrieve timesheet data, manage invoice lines, and access user information from the TIA API.

n8n is a fair-code licensed workflow automation platform.

Installation |
Operations |
Credentials |
Compatibility |
Usage |
Resources |
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Local Development

Install dependencies
npm install
Build before you run
npm run build
Start n8n with the custom node loaded (recommended)
npm run dev
Alternative: use globally installed n8n
npm run dev:local

Operations

Timesheet

| Operation | Description |
| ————————- | ————————————————————– |
| Get Many | Retrieve all timesheets for a specific month and year |
| Get By Period | Retrieve timesheets between a start and end date |
| Get By User | Retrieve timesheets for a specific user by month and year |
| Get Completion Status | Get timesheet completion status for all employees in a company |

All timesheet operations support:

• Return All: Fetch all results with automatic pagination
• Limit: Restrict the number of returned results (default: 10)

User

| Operation | Description |
| ———— | ————————————– |
| Get Many | Retrieve all users from the TIA system |

Invoice Line

| Operation | Description |
| ———- | ——————————————————————— |
| Search | Search and filter invoice lines with optional date and status filters |

Available Filters:

• Created After: Return invoice lines created on or after a specific date
• Status ID: Filter by invoice line status

– Any: No status filter (returns all)
– Invoiced (6): Only invoiced lines
– Proforma / Draft (1): Only draft/proforma lines

Pagination Options:

• Return All: Fetch all matching results with automatic pagination
• Limit: Restrict the number of returned results (default: 50, applied client-side)

> Note: The TIA API returns invoice lines in different formats depending on query parameters. The node automatically detects and handles these formats.

Credentials

To use this node you need the following credentials from your TIA administrator:

| Field | Description |
| ———— | ———————————————— |
| Base URL | The TIA API endpoint |
| API Key | Your TIA API key (used in the X-apikey header) |
| Username | Your TIA username |
| Password | Your TIA password |

The node uses token-based authentication:

1. Credentials are exchanged for a temporary access token via /v1/Token
2. The token is cached and reused until it expires (with a 5-minute safety buffer)
3. Expired tokens are automatically refreshed

> Tip: If your API key or password contains special characters (like quotes), use “Expression” mode in n8n instead of “Fixed” mode.

Compatibility

• Tested with n8n version 2.6.4 and 2.8.3
• Requires Node.js v18 or higher

Usage

1. Add the TIA node to your workflow
2. Configure your TIA API credentials
3. Select a resource (Timesheet, User, or Invoice Line)
4. Choose an operation
5. Fill in the required parameters (dates, filters, etc.)
6. Execute the workflow

> Tip: For the “Get By User” operation, use the User > Get Many operation first to find available usernames.

Date Format (Get By Period)

The TIA API expects dates in the format yyyy-MM-dd HH:mm:ss:ffZ. The node handles this conversion automatically – just select your dates using the n8n date picker.

Resources

• n8n community nodes documentation
• TIA API documentation (Swagger)
• GitHub repository

Version history

0.4.4 (Apr 30, 2026)

• Removed dead requestDefaults block from node description (n8n verification requirement)
• Removed unused loadOptions.getUsers method (dead code since user dropdown removal)
• Moved getCredentials() call to execute() and pass credentials as parameter to API helpers (n8n linter compliance)

0.4.0

• Timesheet Completion Status operation for checking which employees have completed their timesheets
• Changed username field from dynamic dropdown to plain text input for AI Agent compatibility
• Updated README and DEVELOPER.md to reflect dropdown removal

0.3.0

• Invoice Line resource with Search operation

– Filter by creation date (Created After)
– Filter by status (Invoiced, Proforma/Draft, or Any)
– Client-side limit support
– Automatic detection and handling of different API response formats

• Changed default limit from 50 to 10 across all resources
• Added 404 and 429 error handling
• Added DEVELOPER.md with comprehensive developer guide

0.2.0

• User resource with Get Many operation
• Dynamic username dropdown for Get By User (loads usernames from API)
• Added Dots & Arrows logo

0.1.0

• Initial release
• Timesheet resource with Get Many, Get By Period, and Get By User operations
• Token-based authentication with automatic caching and refresh
• Pagination support for large datasets
• Date format conversion for Get By Period