parametro-invalido

urn:auditium:api:error:parametro-invalido

HTTP	400
title	Parámetro inválido

El parámetro llegó, pero con un valor que no puede interpretarse. El detail nombra el parámetro y qué admite.

Causa típica

Parámetro	Valor rechazado	Qué admite
id_comitente	9999,x, -1, 0, 99.9	Enteros positivos separados por coma
limit	abc, 0, -10	Entero mayor a cero
offset	abc, -1	Entero mayor o igual a cero
incluir	estado_requisito, estado, todo	estado_requisitos (único valor admitido)
requiere_presentar	true, si, 2	0 o 1

incluir con un valor desconocido no se ignora: si se aceptara en silencio, la respuesta llegaría sin el bloque pedido y sería indistinguible de una en la que no hay nada que informar.

requiere_presentar también responde 400 cuando se envía sinincluir=estado_requisitos: filtra por un dato que esa respuesta no incluye.

Origen frecuente: una lista de IDs armada con un separador de más (?id_comitente=9999,), o un valor numérico que llegó como cadena vacía o null desde la configuración del cliente.

Cómo resolverlo

Validar los valores antes de armar la URL:

# Falla: coma final
curl -s 'https://auditium.com.ar/ruc/api/asignaciones_personal?id_comitente=9999,' \
     -H "Authorization: Bearer $TOKEN"

# Correcto
curl -s 'https://auditium.com.ar/ruc/api/asignaciones_personal?id_comitente=9999,9998' \
     -H "Authorization: Bearer $TOKEN"

Un limit mayor al máximo del endpoint no produce este error: se acota en silencio y paginado.limit informa el valor aplicado.

Ejemplo

{
    "type": "urn:auditium:api:error:parametro-invalido",
    "title": "Parámetro inválido",
    "status": 400,
    "detail": "El parámetro `id_comitente` sólo admite enteros positivos separados por coma.",
    "instance": "/ruc/api/asignaciones_personal?id_comitente=9999,x",
    "_links": [
        { "href": "https://developers.auditium.com.ar/errores/parametro-invalido", "rel": "help", "method": "GET" }
    ]
}

Relacionados

• parametro-requerido — el parámetro no llegó.
• validacion — el valor se entiende, pero viola una regla de negocio.