Lugares de trabajo¶

Qué es¶

Lugar de trabajo Es la unidad organizacional donde el colaborador está asignado dentro de la Pontotel.

Importante

En Pontotel, "local de trabajo" no necesita ser un espacio físico. Puede representar equipos, departamentos, sectores o filiales. Piense en él como una unidad de gestión.

Por qué esto importa en una integración¶

Organización operativa: filtros en hojas e informes por unidad/equipe
Parametrizaciones por unidad: Zona horaria, feriados y reglas aplicadas por el local
Geolocalización (cuando esté habilitado): dirección se basa en validaciones de registro de punto
Jerarquía con ERP: codigo del local puede reflejar centros de costo o unidades de negocio del ERP

Fuso horario y región son críticos

En integraciones multiregión (por ejemplo: empresas con filiales en diferentes UFs o países), la zona horaria por local define el offset de timestamps marcaciones y marcas Vacaciones en la hoja.

Reglas de negocio¶

Un lugar siempre pertenece a un empleador
El codigo Debe ser único y estable (clave de integración)
La región (UF/Municipio) impacta en qué vacaciones se aplicarán en los cálculos de hoja
Lugares inactivos no aceptan nuevas marcas

Campos¶

Campo	Tipo	Obligatorio	Descripción
`id`	Integer	—	ID interno
`empregador_id`	Integer	Gálatas	ID del empleador
`codigo`	string	Recomendado	Código de integración (centro de costo, filial etc.)
`nome`	string	Gálatas	Nombre del lugar
`fuso_horario`	string	Recomendado	Ex.: `America/Sao_Paulo`
`pais`	string	—	País (estándar: `BR`)
`uf`	string	—	UF (impacta feriados)
`municipio`	string	—	Municipio (impacta feriados)
`endereco`	object	—	Datos de dirección (para geolocalización)
`is_active`	boolean	—	Status (estándar: `true`)

Objeto `endereco`¶

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

Operaciones disponibles¶

Método	Variable	Descripción
GET	`/locais-trabalho/`	Listar lugares
POST	`/locais-trabalho/`	Crear local
GET	`/locais-trabalho/{id}/`	Obtener local
PATCH	`/locais-trabalho/{id}/`	Actualizar
DELETE	`/locais-trabalho/{id}/`	Eliminar (sin empleados vinculados)

Ejemplo: Crear local¶

Solicitud¶

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

Errores comunes¶

Error	Causa	Solución
Vacaciones equivocadas	Región (UF/Municipio) no rellenada	Siempre rellene UF y Municipio
Divergencia de horarios	Fuso horario incorrecto	Configure `fuso_horario` para cada local con UF distinta
Código duplicado	`codigo` reutilizado	Garanta unicidad del código por empleador