Consultar transferencia Santander preparada

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

Tool IDsantander_empresas.transferencia.consultar
Nombre MCPsantander_empresas__transferencia__consultar
Conectorsantander_empresas
Planoaction
Scope (permiso)santander_empresas:read
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=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.

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

CampoTipoRequeridoDescripción
transferenciaIdstringsí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
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"}}'
MCP · meta-tool execute
{
  "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

CampoTipoRequeridoDescripción
transferenciaIdstringsíIdentificador durable de Emisso. Úsalo para consultar esta operación.
referenciastringnullsí
codigoBancostringnullsí
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.
accionesPendienteslista de "firma" · "visacion" · "liberacion"síControles que el banco todavía requiere. Pueden coexistir. Vacío no acredita pago si el estado es desconocido.
observadoEnstringnullsí
siguienteAccionobjetosí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.mensajestringsíInstrucción para revisar, autorizar o seguir el resultado de la transferencia.
puedeReintentarbooleanosí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ódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa 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.

En esta página