# Consultar transferencia Santander preparada

> Devuelve el último estado conservado de una transferencia preparada por Emisso en esta conexión.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `santander_empresas.transferencia.consultar`                       |
| **Nombre MCP**      | `santander_empresas__transferencia__consultar`                     |
| **Conector**        | `santander_empresas`                                               |
| **Plano**           | `action`                                                           |
| **Scope (permiso)** | `santander_empresas:read`                                          |
| **Auth**            | `none`                                                             |
| **Versión**         | `1`                                                                |
| **Sensible**        | sí                                                                 |
| **Deprecado**       | no                                                                 |
| **Comportamiento**  | readOnly=true, destructive=false, idempotent=true, openWorld=false |

> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST y campo `connectionId` en el `execute` de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](/docs/referencia/conexiones/estado-consultar).

## Qué hace [#qué-hace]

No contacta al banco. Revisa observadoEn; la sincronización actualiza las operaciones conocidas. Una firma puede dejar pendientes otras firmas, visación o liberación.

## Entrada [#entrada]

| Campo             | Tipo   | Requerido | Descripción                                                                              |
| ----------------- | ------ | --------- | ---------------------------------------------------------------------------------------- |
| `transferenciaId` | string | sí        | transferenciaId devuelto al preparar; también se conserva ante un resultado desconocido. |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "transferenciaId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "description": "transferenciaId devuelto al preparar; también se conserva ante un resultado desconocido."
      }
    },
    "required": [
      "transferenciaId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/santander_empresas.transferencia.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"transferenciaId":"trf_5tYw2nRk88Ma"}}'
```

```json title="MCP · meta-tool execute"
{
  "tool": "santander_empresas.transferencia.consultar",
  "params": {
    "transferenciaId": "trf_5tYw2nRk88Ma"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "transferenciaId": "trf_5tYw2nRk88Ma",
    "referencia": "factura-1842",
    "codigoBanco": "00012345",
    "estado": "pendiente_firma",
    "accionesPendientes": [
      "firma"
    ],
    "observadoEn": "2026-11-20T19:00:00Z",
    "siguienteAccion": {
      "tipo": "autorizar_en_banco",
      "mensaje": "Un apoderado debe revisar y autorizar la transferencia en Office Banking."
    },
    "puedeReintentar": false
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "santander_empresas.transferencia.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

## Salida [#salida]

| Campo                     | Tipo                                                                                                                      | Requerido | Descripción                                                                                                                                                             |                                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `transferenciaId`         | string                                                                                                                    | sí        | Identificador durable de Emisso. Úsalo para consultar esta operación.                                                                                                   |                                                                                                             |
| `referencia`              | string                                                                                                                    | null      | sí                                                                                                                                                                      | Referencia de negocio; null únicamente si se recuperó un resultado incierto sin su registro de preparación. |
| `codigoBanco`             | string                                                                                                                    | null      | sí                                                                                                                                                                      | Identificador de transferencia confirmado por el banco, como texto; null cuando no se conoce.               |
| `estado`                  | `"creada"` · `"pendiente_firma"` · `"pendiente_visacion"` · `"pendiente_liberacion"` · `"en_proceso"` · `"realizada"` · … | sí        | Último resultado confirmado. creada no significa autorizada; realizada no acredita recepción por el destinatario. resultado\_desconocido nunca autoriza volver a crear. |                                                                                                             |
| `accionesPendientes`      | lista de `"firma"` · `"visacion"` · `"liberacion"`                                                                        | sí        | Controles que el banco todavía requiere. Pueden coexistir. Vacío no acredita pago si el estado es desconocido.                                                          |                                                                                                             |
| `observadoEn`             | string                                                                                                                    | null      | sí                                                                                                                                                                      | Instante ISO 8601 con zona de la última respuesta bancaria confirmada; null si no la hay.                   |
| `siguienteAccion`         | objeto                                                                                                                    | sí        | Qué debe hacer la persona o integración después de esta respuesta.                                                                                                      |                                                                                                             |
| `siguienteAccion.tipo`    | `"autorizar_en_banco"` · `"revisar_en_banco"` · `"consultar_estado"` · `"ninguna"`                                        | sí        | Próximo paso según la última observación de esta operación.                                                                                                             |                                                                                                             |
| `siguienteAccion.mensaje` | string                                                                                                                    | sí        | Instrucción para revisar, autorizar o seguir el resultado de la transferencia.                                                                                          |                                                                                                             |
| `puedeReintentar`         | booleano                                                                                                                  | sí        | Conserva la referencia y clave. Una repetición recupera esta operación; no solicita otro envío al banco.                                                                |                                                                                                             |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "transferenciaId": {
        "type": "string",
        "minLength": 1,
        "description": "Identificador durable de Emisso. Úsalo para consultar esta operación."
      },
      "referencia": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "Referencia de negocio; null únicamente si se recuperó un resultado incierto sin su registro de preparación."
      },
      "codigoBanco": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "Identificador de transferencia confirmado por el banco, como texto; null cuando no se conoce."
      },
      "estado": {
        "type": "string",
        "enum": [
          "creada",
          "pendiente_firma",
          "pendiente_visacion",
          "pendiente_liberacion",
          "en_proceso",
          "realizada",
          "rechazada",
          "resultado_desconocido"
        ],
        "description": "Último resultado confirmado. creada no significa autorizada; realizada no acredita recepción por el destinatario. resultado_desconocido nunca autoriza volver a crear."
      },
      "accionesPendientes": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "firma",
            "visacion",
            "liberacion"
          ]
        },
        "description": "Controles que el banco todavía requiere. Pueden coexistir. Vacío no acredita pago si el estado es desconocido."
      },
      "observadoEn": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "Instante ISO 8601 con zona de la última respuesta bancaria confirmada; null si no la hay."
      },
      "siguienteAccion": {
        "type": "object",
        "properties": {
          "tipo": {
            "type": "string",
            "enum": [
              "autorizar_en_banco",
              "revisar_en_banco",
              "consultar_estado",
              "ninguna"
            ],
            "description": "Próximo paso según la última observación de esta operación."
          },
          "mensaje": {
            "type": "string",
            "description": "Instrucción para revisar, autorizar o seguir el resultado de la transferencia."
          }
        },
        "required": [
          "tipo",
          "mensaje"
        ],
        "additionalProperties": false,
        "description": "Qué debe hacer la persona o integración después de esta respuesta."
      },
      "puedeReintentar": {
        "type": "boolean",
        "const": false,
        "description": "Conserva la referencia y clave. Una repetición recupera esta operación; no solicita otro envío al banco."
      }
    },
    "required": [
      "transferenciaId",
      "referencia",
      "codigoBanco",
      "estado",
      "accionesPendientes",
      "observadoEn",
      "siguienteAccion",
      "puedeReintentar"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

| Código                 | HTTP | Reintentable | Qué hacer                                                                                                           |
| ---------------------- | ---- | ------------ | ------------------------------------------------------------------------------------------------------------------- |
| `connection_disabled`  | 403  | no           | Reactívala en /connections o usa otra conexión del mismo sistema.                                                   |
| `connection_not_found` | 404  | no           | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |

Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](/docs/referencia/errores).


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/santander_empresas/transferencia-consultar.
