Sign in

v1

latestOpenAPI 3.0.02026-07-24161168406.5 KB
Position

Create a new position replication

Creates a series of new replicas of a new position using the provided data.

post/os/v1/positions/replication

Query parameters

quantitynumber
Example:5

Number of positions to be created as replica

Request body

namestring required

Position name

externalCodeRolestring required

Role external code

externalCodeAreastring required

Area external code

descriptionstring

Position description

externalCodeCostCenterstring

Cost center external code

externalCodeOperationUnitstring

Operation unit external code

externalCodeParentstring required

Parent position external code

Example request

{
  "name": "Software Engineer",
  "externalCodeRole": "ROLE-001",
  "externalCodeArea": "AREA-001",
  "description": "Responsible for software development",
  "externalCodeCostCenter": "CC-001",
  "externalCodeOperationUnit": "OU-001",
  "externalCodeParent": "POS-001"
}

Response

uuidstring uuid required

Position UUID

namestring required

Position name

externalCodestring required

Position external code

descriptionstring nullable

Position description

status'OPEN' | 'FILLED' | 'CLOSED' | 'FROZEN' required

Position status indicating current state (OPEN: available for assignment, FILLED: has assigned employee, CLOSED: no longer active, FROZEN: temporarily inactive)

Example response

[
  {
    "uuid": "cc2339c3-bf5a-406b-bafa-3bf8c0acbf23",
    "name": "Software Engineer",
    "externalCode": "SE123",
    "description": "Posição de desenvolvedor time ABC",
    "role": {
      "name": "Desenvolvedor",
      "similarity": "CONSULTANT",
      "externalCode": "RR-001"
    },
    "employee": {
      "uuid": "d20dc017-80c6-4706-bbfe-549c1cc4d2c1",
      "internalCompanyNumber": "132AT41"
    },
    "area": {
      "uuid": "cab41475-caa7-47a7-9b28-eecae80c1ae3",
      "name": "Produto",
      "similarity": "ACCOUNTING",
      "externalCode": "AA-001"
    },
    "costCenter": {
      "name": "CC-001",
      "externalCode": "CC-001"
    },
    "operationUnit": {
      "name": "Operation Unit 1",
      "externalCode": "OU-001"
    },
    "parent": {
      "uuid": "0372fc1b-35e0-42c5-bbe7-98dc7c218da1",
      "name": "Software Engineer",
      "externalCode": "SE123",
      "employee": {
        "uuid": "d20dc017-80c6-4706-bbfe-549c1cc4d2c1",
        "internalCompanyNumber": "132AT41"
      }
    },
    "additionalParents": [
      {
        "uuid": "0372fc1b-35e0-42c5-bbe7-98dc7c218da1",
        "name": "Software Engineer",
        "externalCode": "SE123",
        "employee": {
          "uuid": "d20dc017-80c6-4706-bbfe-549c1cc4d2c1",
          "internalCompanyNumber": "132AT41"
        }
      }
    ],
    "status": "OPEN"
  }
]