Workplaces¶

What is it?¶

Workplace is the organizational unit where the collaborator is allocated within Pontotel.

Important

At Pontotel, "workplace" it doesn't have to be a physical space. Can represent teams, departments, sectors or subsidiaries. Think of it as a management unit.

Why It Matters In Integration¶

Operational organisation: filters in sheets and reports per unit/team
Parameters per unit: time zone, holidays and rules applied by the site
Geolocation (when enabled): Address is the basis for point registration validations
Hierarchy with ERP: o codigo the site can mirror cost centers or ERP business units

Time zone and region are critical

In multi-region integrations (e.g. companies with subsidiaries in different UFs or countries), the local time zone defines the timestamp offset of markings and holidays applied on the sheet.

Business Rules¶

A place always belongs to an employer
O codigo must be unique and stable (integration key)
The region (UF/Municiple) impacts which holidays will be applied in leaf calculations
Inactive places do not accept new markings

Fields¶

Field	Type	Required	Description
`id`	integer	—	Internal ID
`empregador_id`	integer		Employer ID
`codigo`	string	Recommended	Integration code (cost centre, subsidiary etc.)
`nome`	string		Location name
`fuso_horario`	string	Recommended	Ex.: `America/Sao_Paulo`
`pais`	string	—	Country (standard: `BR`)
`uf`	string	—	UF (impact holidays)
`municipio`	string	—	Municipality (impact holidays)
`endereco`	object	—	Address data (for geolocation)
`is_active`	boolean	—	Status (default: `true`)

Subject matter `endereco`¶

JSON
{
  "logradouro": "Av. Paulista",
  "numero": "1000",
  "complemento": "Andar 10",
  "bairro": "Bela Vista",
  "cidade": "São Paulo",
  "estado": "SP",
  "cep": "01310-100"
}

Available Operations¶

Method	Endpoint	Description
GET	`/locais-trabalho/`	List Locations
POST	`/locais-trabalho/`	Create Local
GET	`/locais-trabalho/{id}/`	Get Local
PATCH	`/locais-trabalho/{id}/`	Update
DELETE	`/locais-trabalho/{id}/`	Remove (without tied employees)

Example: Create Local¶

Request¶

HTTP
POST /pontotel/api/v4/locais-trabalho/
Authorization: Bearer {token}
Content-Type: application/json

{
  "empregador_id": 42,
  "codigo": "SP-SEDE",
  "nome": "Sede São Paulo",
  "fuso_horario": "America/Sao_Paulo",
  "uf": "SP",
  "municipio": "São Paulo",
  "is_active": true,
  "endereco": {
    "logradouro": "Av. Paulista",
    "numero": "1000",
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "estado": "SP",
    "cep": "01310-100"
  }
}

Common Errors¶

Error	Cause	Solution
Wrong Holidays	Region (UF/Municip) not completed	Always fill in UF and Municipality
Time difference	Incorrect time zone	Configure `fuso_horario` for each site with distinct UF
Duplicate code	`codigo` reused	Ensure single code per employer