Skip to main content
Three models describe where a job sits: the legal entity that employs someone, the organizational units they belong to, and the office they work from. All three are shared, so the ID lives on the employee rather than on these records.

​
The models

HRIS has no department endpoint and no cost-center endpoint. Every organizational dimension comes back from Get Groups, so filter by type or you get them mixed together.

​
How they connect

These are IDs on the employee, so expand returns them inline on an employee read instead of a second call. manager and pay_group behave the same way. Company and Group are independent of each other, and a group’s only parent is another group.

​
How many per employee

work_location, singular, is not a Location reference. It is an address object embedded on the employee, so reading it gets you the address without resolving an ID. A customer running several legal entities may hold them as several companies under one connector, or as separate connectors. Both happen, so don’t treat the first company as the customer.

​
What you can write

All three are read-only. Organizational structure changes in the source system and reaches you on the next sync.
  • Employee data - the person these models attach to
  • Expand - returning company and groups inline
  • Filters - filtering groups by type
  • Scoping - why a model can be missing entirely