Empleadores¶

Qué es¶

Empleador representa a la empresa empleadora (persona jurídica o física) dentro de la plataforma Pontotel. Es identificado por CNPJ o CPF y funciona como la entidad raíz De la jerarquía, todos los lugares, grupos y empleados pertenecen a un empleador.

Por qué esto importa en una integración¶

En escenarios con múltiples CNPJs/unidades:

Separa datos por empleador, reflejando la estructura jurídica del grupo económico
Facilita consistencia con sistemas de hoja (códigos del empleador reflejando el ERP)
Base de informes, documentos y exportaciones (por ejemplo, espejo de punto por empresa)

Clave de integración

Defina el Código del empleador Como clave de integración y mantenerlo estable a lo largo del tiempo, especialmente en clientes multi-CNPJ.

Reglas de negocio¶

El CNPJ (o CPF) debe ser único en la plataforma
La razón social es obligatoria
Un empleador inactivo no puede recibir nuevos empleados
No troque el CNPJ/CPF de un empleador existente — cree un nuevo si la entidad jurídica cambia

Campos¶

Campo	Tipo	Obligatorio	Descripción
`id`	Integer	—	ID interno (auto)
`codigo`	string	Recomendado	Código de integración (usá el código ERP/folha)
`cnpj`	string	Gálatas (o CPF)	CNPJ
`cpf`	string	Gálatas (o CNPJ)	CPF (para MEI/empregador persona física)
`razao_social`	string	Gálatas	Razón social
`nome_fantasia`	string	—	Nombre de fantasía
`logo`	string	—	URL/base64 de la logo (para documentos)
`is_active`	boolean	—	Status (estándar: `true`)
`created_at`	datetime	—	Fecha de creación
`updated_at`	datetime	—	Última actualización

Operaciones disponibles¶

Método	Variable	Descripción
GET	`/empregadores/`	Listar empleadores
POST	`/empregadores/`	Crear empleador
GET	`/empregadores/{id}/`	Obtener empleador
PUT	`/empregadores/{id}/`	Actualizar (completo)
PATCH	`/empregadores/{id}/`	Actualizar (parcial)

Ejemplo: Crear empleado¶

Solicitud¶

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

{
  "codigo": "EMP-001",
  "cnpj": "12.345.678/0001-99",
  "razao_social": "Empresa Ejemplo LTDA",
  "nome_fantasia": "Empresa Ejemplo",
  "is_active": true
}

Respuesta (201 Created)¶

JSON
{
  "id": 42,
  "codigo": "EMP-001",
  "cnpj": "12.345.678/0001-99",
  "razao_social": "Empresa Ejemplo LTDA",
  "nome_fantasia": "Empresa Ejemplo",
  "is_active": true,
  "created_at": "2025-01-31T10:00:00-03:00",
  "updated_at": "2025-01-31T10:00:00-03:00"
}

Errores comunes¶

Error	Causa	Solución
CNPJ duplicado	Trata de crear dos empleadores con el mismo CNPJ	Busque el CNPJ antes de crear
Reutilizar código	Incluso código en empleadores distintos	Garanta unicidad del `codigo`
Intercambiar CNPJ	Cambiar CNPJ de empleador existente	Crea un nuevo empleador con el CNPJ correcto