# Introducción

A diferencia de otros sistemas, en esta API **no se solicita un token diferente** para cada cuenta hija. Se utiliza un único token maestro y se cambia el contexto dinámicamente en cada petición.

#### Paso 1: Autenticación Inicial <a href="#user-content-paso-1-autenticacion-inicial" id="user-content-paso-1-autenticacion-inicial"></a>

Obtén tu token de acceso (`x-auth-token`) autenticándote con tus credenciales de **Cuenta Administradora**. Este token será el que utilices para todas tus operaciones, tanto propias como de tus hijos.

* **Endpoint:** `POST /api/v1/auth/login`
* **Resultado:** Recibes un token que identifica tu identidad como Administrador.

#### Paso 2: Identificar el ID del Negocio Hijo <a href="#user-content-paso-2-identificar-el-id-del-negocio-hijo" id="user-content-paso-2-identificar-el-id-del-negocio-hijo"></a>

Debes conocer el identificador único (`business_id`) del negocio sobre el cual deseas operar. Puedes obtener una lista de tus cuentas vinculadas consultando tu panel de administración o el endpoint de negocios.

#### Paso 3: Configurar los Headers de la Petición <a href="#user-content-paso-3-configurar-los-headers-de-la-peticion" id="user-content-paso-3-configurar-los-headers-de-la-peticion"></a>

Para realizar una petición sobre un hijo, debes incluir **dos headers obligatorios**:

1. `x-auth-token`: Tu token de administrador (Paso 1).
2. `child-id`: El ID del negocio hijo (Paso 2).

**Ejemplo de llamada (cURL):**

```hurl
curl -X GET "https://api.trazo.com/api/v1/transactions" \
     -H "x-auth-token: TU_TOKEN_DE_ADMINISTRADOR" \
     -H "child-id: ID_DEL_NEGOCIO_HIJO"
```

#### Paso 4: Procesamiento de la API <a href="#user-content-paso-4-procesamiento-de-la-api" id="user-content-paso-4-procesamiento-de-la-api"></a>

Cuando la API recibe estos headers, realiza lo siguiente:

* Valida que el token sea vigente.
* Verifica que tú (dueño del token) seas realmente el administrador de ese `child-id`.
* **Aísla la consulta:** El sistema responderá como si la petición hubiera sido hecha por el hijo, devolviendo solo los saldos, transacciones o configuraciones de ese negocio específico.

{% hint style="warning" %}
El `child-id` no se "guarda" en la sesión. Debes enviarlo en **cada una** de las peticiones que quieras realizar sobre el hijo.
{% endhint %}

#### Paso 5: Volver al Contexto de Administrador <a href="#user-content-paso-5-volver-al-contexto-de-administrador" id="user-content-paso-5-volver-al-contexto-de-administrador"></a>

Si deseas realizar una operación sobre tu propia cuenta principal, simplemente realiza la petición **omitiendo** el header `child-id`.

```hurl
curl -X GET "https://api.trazo.com/api/v1/transactions" \
     -H "x-auth-token: TU_TOKEN_DE_ADMINISTRADOR"
```

{% hint style="info" %}
Nunca pidas un token usando las llaves del hijo si eres el administrador, usa siempre tu propio token para mantener la trazabilidad de quién realizó la acción.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qentaz.com/documentation/cuentas-administradas/introduccion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.