🔍 ¿Qué hace este endpoint?

Lista las empresas Partners o Distribuidores asociados al usuario autenticado. Permite obtener un listado simplificado con solo el identificador y nombre de cada elemento.

El endpoint funciona de dos formas según el parámetro option:

Partners (por defecto): Retorna empresas que tienen configuración de partner, ordenadas alfabéticamente por nombre
Distribuidores (option=distributors): Retorna distribuidores únicos asociados a las empresas del usuario, con nombres capitalizados y sin duplicados.

🎯 ¿Cuándo usar este endpoint?

Para obtener un listado simplificado de partners a los que el usuario tiene acceso
Para obtener un listado de distribuidores únicos asociados a las empresas del usuario
Cuando necesitas identificar rápidamente las empresas partner o distribuidores disponibles para el usuario autenticado

📌 Consideraciones importantes

Permisos y roles:

Solo usuarios con acceso a empresas con rol administrador (admin) o contador (accountant) pueden acceder a este endpoint.
Solo puedes consultar tu propia información de usuario. Debes ser el usuario autenticado y tener un acceso de usuario activo para poder consultar tu información.
Si intentas consultar un usuario al que no tienes permiso, recibirás un error indicando que el acceso está prohibido 403 No autorizado.

Ordenamiento:

Partners: Ordenados alfabéticamente por nombre (ascendente).
Distribuidores: Sin orden específico (orden de aparición).

Variaciones en la respuesta

La información que recibes puede cambiar según si envías el parámetro option o no.

Ejemplo con option=partners (o sin option):

{
  "data": [
    {
      "id": "5d54ac11-5fd2-4137-a784-e6f1434e92de",
      "name": "company test S.A.S."
    },
    {
      "id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
      "name": "company test Ltda."
    }
  ]
}

Ejemplo con option=distributors:

{
  "data": [
    {
      "id": "d1e2f3a4-b5c6-7890-1234-567890abcdef",
      "name": "distributor"
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "distributor  S.A.S."
    }
  ]
}