Asignación a Cuadrilla

Proceso de Asignación de Usuarios a Cuadrilla

POST: Asignar usuarios a una cuadrilla

Descripción del API
Este endpoint permite asignar o desasignar usuarios a una cuadrilla mediante sus números de documento. El sistema procesa las solicitudes de contratación (hiring) y desvinculación (leaving) de forma masiva, creando la cuadrilla si no existe previamente.

Endpoint

POST /api/assignments/squad-user

Parámetros de entrada

Atributo	Requerido	Tipo	Descripción	Ejemplo
code	Sí	string	Código único de la cuadrilla	"SQ000001"
hiring	No	array	Array de números de documento de usuarios a asignar a la cuadrilla	["12345678", "87654321"]
leaving	No	array	Array de números de documento de usuarios a desasignar de la cuadrilla	["11223344"]

JSON de ejemplo (entrada)

{
    "code": "SQ000001",
    "hiring": [
        "12345678",
        "87654321",
        "11223344",
        "44332211",
        "55667788"
    ],
    "leaving": [
        "99887766"
    ]
}

Parámetros de salida

Atributo	Tipo	Descripción	Ejemplo
success	boolean	Indica si la operación fue exitosa.	true
code	string	Código de la cuadrilla procesada.	"SQ000001"
squadId	integer	ID de la cuadrilla en el sistema.	1
squadCreated	boolean	Indica si la cuadrilla fue creada en esta operación.	false
hiring.processed	integer	Cantidad de usuarios procesados exitosamente en hiring.	4
hiring.errors	array	Array de errores encontrados durante el proceso de hiring.	Ver ejemplo
hiring.errors[].dni	string	Número de documento del usuario que generó el error.	"55667788"
hiring.errors[].error	string	Mensaje descriptivo del error.	"Usuario no encontrado"
leaving.processed	integer	Cantidad de usuarios procesados exitosamente en leaving.	1
leaving.errors	array	Array de errores encontrados durante el proceso de leaving.	Ver ejemplo
leaving.errors[].dni	string	Número de documento del usuario que generó el error.	"99887766"
leaving.errors[].error	string	Mensaje descriptivo del error.	"Usuario no encontrado"

JSON de ejemplo (salida)

• Respuesta 200 OK:

{
    "success": true,
    "code": "SQ000001",
    "squadId": 1,
    "squadCreated": false,
    "hiring": {
        "processed": 4,
        "errors": [
            {
                "dni": "55667788",
                "error": "Usuario no encontrado"
            }
        ]
    },
    "leaving": {
        "processed": 1,
        "errors": []
    }
}

• Respuesta 200 OK (con cuadrilla creada):

{
    "success": true,
    "code": "SQ000002",
    "squadId": 2,
    "squadCreated": true,
    "hiring": {
        "processed": 3,
        "errors": []
    },
    "leaving": {
        "processed": 0,
        "errors": []
    }
}