Asignaciones de personal

Devuelve el personal con asignación vigente y aprobada en contratos de los comitentes solicitados.

GET /ruc/api/asignaciones_personal?id_comitente=9999

Header	Requerido	Descripción
Authorization	Sí	Bearer <token> (ver)

Parámetros

Parámetro	Tipo	Requerido	Descripción
id_comitente	string	Sí	Uno o varios IDs separados por coma (9999 o 9999,9998). Sólo enteros positivos.
limit	int	No	Máximo de registros. Predeterminado y máximo: 5000.
offset	int	No	Registros a saltear. Predeterminado: 0.

Se pueden pedir varios comitentes en una sola llamada. Si alguno está fuera de tu alcance, la respuesta completa es 403: no se devuelve parcialmente el resto.

Qué incluye

Una persona entra en el resultado cuando:

• es un recurso de tipo persona;
• tiene una asignación vigente a la fecha y aprobada;
• esa asignación pertenece a un contrato de alguno de los comitentes pedidos;
• tiene número de documento cargado.

Una misma persona suele estar cargada por más de un contratista, y los datos no siempre coinciden. Se devuelve una fila por (CUIL, comitente), la de la asignación más reciente. Ante dos peticiones idénticas se obtiene la misma respuesta y el mismo ETag.

No se envían emails, teléfonos ni direcciones.

Respuesta

{
  "data": [
    {
      "cuil": "20-99999999-9",
      "dni": "99999999",
      "apellido": "PEREZ",
      "nombre": "JUAN CARLOS",
      "id_comitente": 9999
    }
  ],
  "paginado": {
    "limit": 5000,
    "offset": 0,
    "count": 1,
    "total": 1
  },
  "_links": [
    { "href": "https://auditium.com.ar/ruc/api/logout", "rel": "logout", "method": "POST" }
  ]
}

Campo	Tipo	Descripción
data[].cuil	string	CUIL
data[].dni	string	Número de documento
data[].apellido	string	Apellido
data[].nombre	string	Nombre
data[].id_comitente	int	Comitente de la asignación
paginado.limit	int	Límite aplicado
paginado.offset	int	Desplazamiento aplicado
paginado.count	int	Registros en esta página
paginado.total	int	Registros disponibles en total

Paginado

Seguir pidiendo mientras offset + count < total, incrementando offset en limit:

offset=0     → count=5000, total=12000
offset=5000  → count=5000
offset=10000 → count=2000  → fin

Mientras queden páginas, _links incluye next con la URL ya armada (y prev cuando no estás en la primera). Seguir next hasta que desaparezca evita la aritmética.

ETag

La respuesta incluye un header ETag calculado sobre data. Comparándolo con el de la corrida anterior se detecta si el padrón cambió, sin recorrer registro por registro.

Errores

Código	type	Caso
400	parametro-requerido	Falta id_comitente
400	parametro-invalido	id_comitente, limit u offset con valor no válido
401	credenciales-ausentes / credenciales-invalidas	Token ausente, inválido o vencido
403	ambito-insuficiente	Algún id_comitente está fuera de tu alcance

Ejemplo completo

# 1) Login
TOKEN=$(curl -s -X POST -u "$AUDITIUM_USER:$AUDITIUM_PASS" \
     https://auditium.com.ar/ruc/api/login | jq -r .access_token)

# 2) Personal del comitente 36
curl -s 'https://auditium.com.ar/ruc/api/asignaciones_personal?id_comitente=9999' \
     -H "Authorization: Bearer $TOKEN"

# 3) Tercera página de 1000, dos comitentes
curl -s 'https://auditium.com.ar/ruc/api/asignaciones_personal?id_comitente=9999,9998&limit=1000&offset=2000' \
     -H "Authorization: Bearer $TOKEN"

# 4) Cerrar sesión
curl -s -X POST https://auditium.com.ar/ruc/api/logout \
     -H "Authorization: Bearer $TOKEN"