Consultar transferencia Santander preparada
Devuelve el último estado conservado de una transferencia preparada por Emisso en esta conexión.
| 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-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
transferenciaId | string | sí | transferenciaId devuelto al preparar; también se conserva ante un resultado desconocido. |
JSON Schema de entrada
{
"$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
}Ejemplo
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"}}'{
"tool": "santander_empresas.transferencia.consultar",
"params": {
"transferenciaId": "trf_5tYw2nRk88Ma"
},
"connectionId": "conn_9tKfR2mQx4Vb"
}Salida esperada (200):
{
"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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
transferenciaId | string | sí | Identificador durable de Emisso. Úsalo para consultar esta operación. |
referencia | string | null | sí |
codigoBanco | string | null | sí |
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í |
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. |
JSON Schema de salida
{
"$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
}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.