> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Socios en TED Lerian

> Restringe la credencial de TED Lerian de un socio a la organización y al ledger de Midaz de tu instalación, indícalos en cada solicitud y entiende los rechazos que recibe.

Un [socio](https://docs.lerian.studio/es/platform/access-manager/features/partners/overview) puede llamar a TED Lerian con su propia credencial. Restringes esa credencial a la organización de Midaz y, si quieres, al ledger en el que trabaja TED Lerian. Esta página trata de TED Lerian. Para TED JD, consulta [Socios en TED](https://docs.lerian.studio/es/platform/access-manager/features/partners/ted.md).

Todo socio de TED Lerian necesita un alcance.

> [!NOTE]
>
> Necesitas Access Manager v3.20.0 o posterior. Las versiones anteriores no aceptan los permisos de TED Lerian.

## Paso a paso

***

**1. Elige dónde actúa el socio**

TED Lerian tiene dos restricciones. Las dos se aplican a los recursos `transfers` y `incoming-transfers`:

| Restricción | Campo de la API | Lo que alcanza el socio | Lo que se rechaza |
| - | - | - | - |
| **Organización de Midaz** | `organizationId` | Enviar una TED y obtener una cotización de tarifa, leer y listar transferencias y sus líneas de tiempo, cancelar una transferencia, y leer y listar TED recibidas y sus líneas de tiempo. | Todas las demás organizaciones, y las rutas que actúan sobre todo el tenant (consulta [Rutas que ningún socio alcanza](#routes-that-no-partner-reaches)). |
| **Ledger de Midaz** | `ledgerId` | Enviar una TED y obtener una cotización de tarifa. El ledger está bajo la organización. | Todos los demás ledgers. También las lecturas, la cancelación y las TED recibidas (consulta [La restricción de ledger cubre solo el envío](#the-ledger-restriction-covers-only-sending)). |

TED Lerian trabaja en una organización y en un ledger: los que están configurados para tu institución. Consulta la configuración en [Descripción general de la API de TED Lerian](https://docs.lerian.studio/es/reference/interfaces/ted-lerian/ted-lerian-api-overview.md). Pon esa organización, y ese ledger si restringes por ledger, en el alcance del socio.

**2. Da al socio sus permisos y su alcance**

Crea el socio, o modifícalo, en la [Consola](https://docs.lerian.studio/es/platform/access-manager/features/partners/console.md) o con la [API de Identity](https://docs.lerian.studio/es/platform/access-manager/features/partners/api.md). El slug del producto es `plugin-br-ted-lerian`.

* Agrega la entrada de alcance de la organización. Sin una entrada de alcance, Access Manager rechaza el socio con `400` e `IDE-1060`.
* Para restringir el socio a un ledger, agrega también la entrada de alcance del ledger.
* Revisa los recursos y las acciones. Lo máximo que puedes dar es lo que tiene el rol de editor de TED Lerian en tu tenant. Por encima de eso, Access Manager rechaza con `IDE-1043`.

Un socio puede tener solo estos permisos:

| Permiso | Rutas | Socio restringido a la organización | Socio restringido a un ledger |
| - | - | - | - |
| `transfers:create` | `POST /v1/transfers`, `POST /v1/transfers/fee-quotes` | Sí | Sí |
| `transfers:read` | `GET /v1/transfers`, `GET /v1/transfers/{transferId}`, `GET /v1/transfers/{transferId}/timeline` | Sí | No |
| `transfers:cancel` | `POST /v1/transfers/{transferId}/cancel` | Sí | No |
| `incoming-transfers:read` | `GET /v1/incoming-transfers`, `GET /v1/incoming-transfers/{incomingTransferId}`, `GET /v1/incoming-transfers/{incomingTransferId}/timeline` | Sí | No |

Access Manager rechaza todos los demás permisos con `400` e `IDE-1056`. Estos permisos actúan sobre todo el tenant: el desbloqueo y la decisión del análisis de fraude de una transferencia, la devolución y las decisiones sobre una TED recibida, la conciliación, los dashboards, la política y los vínculos de ISPB, la lista de participantes, el catálogo de eventos y la configuración de runtime. Access Manager también rechaza con `IDE-1056` los permisos marcados con **No** para un socio restringido a un ledger. La Consola marca estas líneas como **Outside the scope**.

**3. Crea su aplicación de TED Lerian**

Crea la aplicación del socio con el producto `plugin-br-ted-lerian`. Consulta [Crea las aplicaciones del socio](https://docs.lerian.studio/es/platform/access-manager/features/partners/api.md#create-the-partners-applications) en la guía de la API, o [en la Consola](https://docs.lerian.studio/es/platform/access-manager/features/partners/console.md#create-the-partners-applications). Envía el client ID y el client secret al socio por un canal seguro.

**4. Indica la organización y el ledger en cada solicitud**

El socio indica la organización en el encabezado `X-Organization-Id`, y el ledger en el encabezado `X-Ledger-Id`. Los dos encabezados son opcionales para los demás llamadores. Un socio debe enviarlos como muestra esta tabla. Una solicitud sin ellos se rechaza.

| Rutas | `X-Organization-Id` | `X-Ledger-Id` |
| - | - | - |
| Envío y cotización de tarifa: `POST /v1/transfers`, `POST /v1/transfers/fee-quotes` | Siempre | Cuando el socio está restringido a un ledger |
| Transferencias: `GET /v1/transfers`, `GET /v1/transfers/{transferId}`, `GET /v1/transfers/{transferId}/timeline`, `POST /v1/transfers/{transferId}/cancel` | Siempre | No se lee |
| TED recibidas: `GET /v1/incoming-transfers`, `GET /v1/incoming-transfers/{incomingTransferId}`, `GET /v1/incoming-transfers/{incomingTransferId}/timeline` | Siempre | No se lee |

Los encabezados no eligen la organización ni el ledger. TED Lerian siempre los toma de su configuración, y los encabezados solo los confirman. TED Lerian revisa cada encabezado que lee:

| Encabezado | Respuesta |
| - | - |
| Ausente | La solicitud se ejecuta como se ejecuta sin socios. |
| Igual a la configuración | La solicitud se ejecuta. |
| Otro valor, o no es un UUID | `400` con `TED-0001`. El mensaje nombra el encabezado. |
| Presente, y la configuración no tiene el valor | `503` con `TED-0080`. |

Esta revisión se aplica a todos los llamadores, también a las aplicaciones de tu propia institución.

Cuando un envío o una cotización de tarifa tiene `X-Ledger-Id`, la cuenta en `X-Account-Id` debe ser una cuenta de ese ledger. Si no, la respuesta es `400` con `TED-0001`. TED Lerian también hace esta revisión en un reintento con una clave `X-Idempotency` que ya usó. No repite una respuesta guardada para una cuenta de otro ledger.

**5. Confirma que funciona**

Usa la credencial de un socio con `transfers:read`, restringido solo a la organización. Lista las transferencias de la organización del alcance del socio. La respuesta es `200`:

```bash theme={null}
TED_LERIAN_BASE_URL="https://ted-lerian.<your-domain>"     # your TED Lerian base URL
TED_LERIAN_BEARER_TOKEN="paste-the-partner-access-token-here"
MIDAZ_ORGANIZATION_ID="paste-the-organization-in-the-scope"

curl -s -o /dev/null -w '%{http_code}\n' \
  -H "Authorization: Bearer ${TED_LERIAN_BEARER_TOKEN}" \
  -H "X-Organization-Id: ${MIDAZ_ORGANIZATION_ID}" \
  "${TED_LERIAN_BASE_URL}/v1/transfers"
```

Envía la misma solicitud sin el encabezado `X-Organization-Id`. La respuesta es `403` con `TED-0071`.

## La restricción de ledger cubre solo el envío

***

TED Lerian lee el ledger solo cuando un socio envía una TED u obtiene una cotización de tarifa. Las lecturas, la cancelación y las TED recibidas no llevan ledger. Una transferencia puede estar en un ledger anterior de tu institución, y una TED recibida puede estar en cualquier ledger de los vínculos de ISPB. TED Lerian no las filtra por ledger.

Por eso, un socio restringido a un ledger solo puede enviar y obtener cotizaciones de tarifa. Access Manager se niega a darle `transfers:read`, `transfers:cancel` o `incoming-transfers:read`, con `400` e `IDE-1056`. Para que un socio pueda leer o cancelar transferencias, restríngelo solo a la organización.

Un socio restringido a la organización lee todas las transferencias y TED recibidas de la organización, en todos los ledgers. Dale `transfers:read` e `incoming-transfers:read` solo cuando pueda ver todas ellas.

## TED recibidas sin organización

***

TED Lerian atribuye cada TED recibida a una organización. Una TED recibida que todavía no puede atribuir no tiene organización y espera en `MANUAL_REVIEW`. Un socio no ve estas TED recibidas:

* `GET /v1/incoming-transfers` no las lista.
* `GET /v1/incoming-transfers/{incomingTransferId}` y `GET /v1/incoming-transfers/{incomingTransferId}/timeline` responden `404`, como si la TED no existiera.

Las aplicaciones de tu institución siguen viendo estas TED recibidas cuando no actúan por un socio. Usa una de ellas para revisar las TED recibidas que no tienen organización.

## Las reglas del socio en Midaz no valen para sus transferencias

***

TED Lerian llama a Midaz y al CRM con su propia credencial, también cuando atiende a un socio. Los permisos y el alcance del socio en Midaz no se aplican a estas llamadas.

TED Lerian no tiene restricción de cuenta. La cuenta en `X-Account-Id` debe pertenecer a la organización de TED Lerian, o la respuesta es `403` con `TED-0009`. Cuando la solicitud tiene `X-Ledger-Id`, la cuenta también debe ser una cuenta de ese ledger, o la respuesta es `400` con `TED-0001`.

> [!WARNING]
>
> Da `transfers:create` solo a un socio que pueda enviar desde todas las cuentas de la organización. Un socio con este permiso puede enviar desde cualquier cuenta de la organización que indique en `X-Account-Id`.

## Rutas que ningún socio alcanza

***

Todas las rutas fuera de la tabla del paso 2 actúan sobre todo el tenant. Un socio no puede tener los permisos de estas rutas, así que TED Lerian lo rechaza con `403` y `TED-0071`:

* El desbloqueo y la decisión del análisis de fraude de una transferencia.
* La devolución, la decisión de revisión y la decisión de la verificación de fraude de una TED recibida.
* Las rutas de conciliación, `/v1/reconciliation/*`.
* Los dashboards de operaciones, `/v1/operations/*`.
* La política y los vínculos de ISPB, `/v1/policy/*`.
* La lista de participantes, `GET /v1/participants`.
* La configuración de runtime, `/v1/system/*`.

Usa una aplicación de tu propia institución para estas rutas.

## Si algo falla

***

| Código | Estado | Qué significa | Qué hacer |
| - | - | - | - |
| `TED-0071` | 403 | La solicitud indica una organización o un ledger fuera del alcance del socio, o no envía un encabezado que el socio debe enviar. También está fuera de los permisos o de la lista de IP del socio. | Envía `X-Organization-Id`, y `X-Ledger-Id` cuando el socio esté restringido a un ledger, con valores del alcance del socio. Revisa también los permisos y la lista de IP del socio. |
| `TED-0070` | 401 | El socio está suspendido, o la solicitud está fuera de su período de validez. | Reactiva el socio, o cambia su período de validez. |
| `TED-0001` | 400 | `X-Organization-Id` o `X-Ledger-Id` no es un UUID, o indica otra organización u otro ledger que los de la configuración de TED Lerian. En un envío o una cotización de tarifa, la cuenta en `X-Account-Id` no es una cuenta del ledger en `X-Ledger-Id`. | Envía la organización y el ledger para los que TED Lerian está configurado. Un llamador que no es socio también puede no enviar el encabezado. Debita una cuenta de ese ledger. |
| `TED-0080` | 503 | La solicitud envía un encabezado, y TED Lerian no tiene organización o ledger configurado para compararlo. | El administrador configura la organización y el ledger de TED Lerian. |

`TED-0071` no dice si fueron los permisos o el alcance los que rechazaron la solicitud. Es intencional: un socio no puede usar un rechazo para saber qué organizaciones o ledgers existen fuera de su alcance.

Un cambio en un socio, como una suspensión o un nuevo alcance, se aplica en su próxima solicitud, también con un token que ya tiene. Cuando TED Lerian guarda las decisiones de Access Manager por un tiempo, definido en `AUTH_CACHE_TTL`, el cambio se aplica después de ese tiempo.

Para todos los demás códigos, consulta la [lista de errores de TED Lerian](https://docs.lerian.studio/es/reference/interfaces/ted-lerian/ted-lerian-error-list.md). Para los rechazos al crear o cambiar un socio, consulta [Códigos de error](https://docs.lerian.studio/es/platform/access-manager/features/partners/api.md#error-codes) en la guía de la API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.