Skip to main content

Position / job title

Represents an organizational role or job title (e.g. Warehouse Manager): internal code, canonical title and optional localized titles, department, job family, grade/level, responsibility description, management flag, and full-time equivalent (fteEquivalent). This is not the person record: people are Employees and reference this entity via positionId.

Full JSON example​

{
  "id": "pos_wh_manager",
  "channel": "demoipaas",
  "createdAt": "2025-06-01T00:00:00+00:00",
  "updatedAt": "2026-01-15T09:00:00+00:00",
  "code": "WH-MGR",
  "title": "Warehouse Manager",
  "titleLocalized": {
    "it": "Responsabile magazzino",
    "en": "Warehouse Manager"
  },
  "department": "Logistics",
  "jobFamily": "Operations",
  "grade": "M2",
  "description": "Pianifica inventari, team picking e sicurezza sul lavoro.",
  "isManagement": true,
  "fteEquivalent": 1.0
}

Remarkable notes​

  • code and grade should align with the job catalog of the destination HR/ERP system.
  • titleLocalized helps multilingual portals; if omitted, many connectors rely on title only.
  • One Position can be assigned to multiple employees; headcount or budget rules are usually enforced downstream.