ambito-insuficiente

urn:auditium:api:error:ambito-insuficiente

HTTP	403
title	Comitente fuera de alcance

El endpoint está habilitado, pero alguno de los comitentes solicitados no está dentro del alcance de tus credenciales.

Con otro valor de id_comitente la misma credencial funciona.

Causa típica

• Se pidió un id_comitente que no corresponde a la relación comercial del emisor.
• Se pidieron varios comitentes en una sola llamada y uno está fuera de alcance. La respuesta completa es 403: no se devuelve parcialmente el resto.
• El id_comitente vino de una configuración copiada de otro entorno.

Cómo resolverlo

El detail nombra exactamente los comitentes rechazados de los que se enviaron. Quitarlos de la petición:

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

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

Si el comitente debería estar habilitado, pedir la ampliación del alcance al contacto técnico.

Ejemplo

{
    "type": "urn:auditium:api:error:ambito-insuficiente",
    "title": "Comitente fuera de alcance",
    "status": 403,
    "detail": "No se encuentra habilitado para consultar el/los comitente/s: 9998.",
    "instance": "/ruc/api/asignaciones_personal?id_comitente=9999,9998",
    "_links": [
        { "href": "https://developers.auditium.com.ar/errores/ambito-insuficiente", "rel": "help", "method": "GET" }
    ]
}

Relacionados

• capacidad-insuficiente — el endpoint no está habilitado, con ningún parámetro.
• Asignaciones de personal