Consultas DGI permiten omitir idEmpresa para usuarios con una unica empresa

Los endpoints de consultas DGI ahora pueden resolver automaticamente la empresa cuando el usuario autenticado no es admin_sistema y solo tiene una empresa asociada.

Nueva funcionalidad 27/03/2026 REST Version: v1

Endpoints afectados

  • GET /api/v1/dgi/consultaRut/{rut}
  • GET /api/v1/dgi/consultaNombreEntidad
  • GET /api/v1/dgi/consultaCva/{rut}
  • GET /api/v1/dgi/consultaDatosEntidad/{rut}

Migracion recomendada

Si el integrador autentica usuarios no admin_sistema con una sola empresa asociada, ahora puede omitir idEmpresa en estas llamadas. Si el usuario tiene varias empresas o es admin_sistema, debe seguir enviandolo.

Que cambia

Los endpoints siguientes ahora admiten omitir idEmpresa cuando el usuario autenticado:

  • GET /api/v1/dgi/consultaRut/{rut}
  • GET /api/v1/dgi/consultaNombreEntidad
  • GET /api/v1/dgi/consultaCva/{rut}
  • GET /api/v1/dgi/consultaDatosEntidad/{rut}

Y ademas:

  • no es admin_sistema
  • no tiene empresa en sesion
  • tiene exactamente una empresa asociada

En ese escenario la API selecciona automaticamente esa empresa y ejecuta la consulta con los mismos controles de permisos ya existentes.

Impacto para integradores

Las integraciones que usan JWT con usuarios atados a una sola empresa ya no necesitan enviar idEmpresa obligatoriamente en estas operaciones.

No cambia el contrato para usuarios con multiples empresas ni para admin_sistema. En esos casos se debe seguir enviando idEmpresa.

Migracion recomendada

  1. Mantener idEmpresa si el cliente trabaja con multiples empresas o con usuarios administradores globales.
  2. Si el cliente opera siempre con usuarios de una unica empresa, idEmpresa pasa a ser opcional para estos endpoints.
  3. Ante respuesta Debe indicar la empresa., enviar idEmpresa explicitamente.