ERPNext HRMSInstall

Summary

Retrieve multiple Employee documents from ERPNext HRMS with filtering, sorting, and field selection options.

Inputs

• API Version (required) — Select the Frappe REST API version to use (v1 or v2).
• Fields — Comma-separated list or JSON-style array of fields to include in the output (e.g., name,employee_name,status). Defaults to ["name"].
• Filters JSON — JSON-formatted filters to restrict returned Employee documents. Supports array format (e.g., [["status","=","Active"]]) or object format (e.g., {"employee":"HR-EMP-0001"}).
• Return All (required) — Choose whether to return all matching Employee documents without limit (true) or to apply a limit (false).
• Limit — Maximum number of Employee documents to return when 'Return All' is false. Defaults to 50, with a maximum of 1000.
• Order By — String specifying sorting order of returned documents, e.g., "modified desc". Defaults to "modified desc".

Output shape

a list of Employee document objects

The output is an array of objects representing Employee documents, each containing only the requested fields. When 'Return All' is true, the node automatically paginates through results up to 1000 records per request until no more documents remain.

Examples

Example 1: Fetch active Employees ordered by last modified date

API Version: v1; Fields: name,employee_name,status; Filters JSON: [["status","=","Active"]]; Return All: false; Limit: 50; Order By: modified desc

Links

• n8n community nodes installation guide