Crear departamento
Descripción
Section titled “Descripción”Da de alta un departamento en la empresa.
Parámetros de consulta
Section titled “Parámetros de consulta”| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
codigoEmpresa | int | ✅ (si es multiempresa) | Código de la empresa |
Campos obligatorios *
Section titled “Campos obligatorios *”| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
codigoDepartamento | string | ✅ | Código (máx. 10 caracteres) |
departamento | string | ✅ | Descripción (máx. 30 caracteres) |
Ejemplo
Section titled “Ejemplo”curl -X POST "https://api.tandem.com/api/common/auxiliares/departamentos" \ -H "Authorization: Bearer tu_access_token" \ -H "Content-Type: application/json" \ -d '{ "codigoDepartamento": "ADM", "departamento": "Administración" }'Cuerpo de la petición
Section titled “Cuerpo de la petición”{ "codigoDepartamento": "ADM", "departamento": "Administración"}Respuesta (200)
Section titled “Respuesta (200)”{ "success": true, "message": "Departamento creado correctamente", "resultado": { "codigoEmpresa": 1, "codigoDepartamento": "ADM", "departamento": "Administración", "idDepartamento": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }}Respuesta con error
Section titled “Respuesta con error”Si ya existe (409 Conflict):
{ "success": false, "message": "Ya existe un departamento con código 'ADM'"}Si falta un campo o supera la longitud máxima (400):
{ "success": false, "message": "El campo 'departamento' no puede superar los 30 caracteres."}