Locais de Trabalho¶

O que é¶

Local de trabalho é a unidade organizacional onde o colaborador está alocado dentro da Pontotel.

Importante

Na Pontotel, "local de trabalho" não precisa ser um espaço físico. Pode representar equipes, departamentos, setores ou filiais. Pense nele como uma unidade de gestão.

Por que isso importa numa integração¶

Organização operacional: filtros em folhas e relatórios por unidade/equipe
Parametrizações por unidade: fuso horário, feriados e regras aplicadas pelo local
Geolocalização (quando habilitado): endereço é base para validações de registro de ponto
Hierarquia com ERP: o codigo do local pode espelhar centros de custo ou unidades de negócio do ERP

Fuso horário e região são críticos

Em integrações multi-região (ex.: empresas com filiais em diferentes UFs ou países), o fuso horário por local define o offset dos timestamps de marcações e os feriados aplicados na folha.

Regras de Negócio¶

Um local pertence sempre a um empregador
O codigo deve ser único e estável (chave de integração)
A região (UF/Município) impacta quais feriados serão aplicados nos cálculos de folha
Locais inativos não aceitam novas marcações

Campos¶

Campo	Tipo	Obrigatório	Descrição
`id`	integer	—	ID interno
`empregador_id`	integer	✅	ID do empregador
`codigo`	string	Recomendado	Código de integração (centro de custo, filial etc.)
`nome`	string	✅	Nome do local
`fuso_horario`	string	Recomendado	Ex.: `America/Sao_Paulo`
`pais`	string	—	País (padrão: `BR`)
`uf`	string	—	UF (impacta feriados)
`municipio`	string	—	Município (impacta feriados)
`endereco`	object	—	Dados de endereço (para geolocalização)
`is_active`	boolean	—	Status (padrão: `true`)

Objeto `endereco`¶

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

Operações Disponíveis¶

Método	Endpoint	Descrição
GET	`/locais-trabalho/`	Listar locais
POST	`/locais-trabalho/`	Criar local
GET	`/locais-trabalho/{id}/`	Obter local
PATCH	`/locais-trabalho/{id}/`	Atualizar
DELETE	`/locais-trabalho/{id}/`	Remover (sem empregados vinculados)

Exemplo: Criar Local¶

Requisição¶

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"
  }
}

Erros Comuns¶

Erro	Causa	Solução
Feriados errados	Região (UF/Município) não preenchida	Sempre preencha UF e Município
Divergência de horários	Fuso horário incorreto	Configure `fuso_horario` para cada local com UF distinta
Código duplicado	`codigo` reutilizado	Garanta unicidade do código por empregador