Skip to main content
Glama

Identik Firma Electrónica

Crear documento desde plantilla

crear_documento_desde_plantilla

Genera un documento de firma electrónica a partir de una plantilla. Flujo: listar_plantillas → esta herramienta → enviar_documento. Devuelve el documentId y el signingUrl de cada firmante. IMPORTANTE: el documento queda en borrador (no consume crédito) hasta que lo envíes con enviar_documento.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "plantilla_id": "<plantilla_id>",
      "firmantes": "<firmantes>"
    },
    "name": "crear_documento_desde_plantilla"
  }
}

Input Schema

NameRequiredDescriptionDefault
asuntoNoAsunto del email de invitación.
tituloNoTítulo del documento (si no, hereda el de la plantilla).
mensajeNoMensaje del email de invitación.
firmantesYesLos firmantes de esta instancia.
plantilla_idYesEl `id` de la plantilla.
requiere_biometriaNotrue = cada firmante debe aprobar la verificación biométrica (DNI + prueba de vida) antes de firmar. Consume 1 crédito de verificación por aprobada.
avisar_por_whatsappNotrue = a cada firmante que tenga `telefono` cargado se le manda el link de firma por WhatsApp, ADEMÁS del email cuando se habilitan los avisos iniciales al enviar. En Electrónica y contratos prepago consume 1 crédito por mensaje; en Digital pago por documento se consumen los 5 créditos incluidos del paquete al enviar con este canal. Consultá estado_cuenta. Sin saldo o sin teléfono no se manda el WhatsApp.
codigo_por_whatsappNotrue = cada firmante debe ingresar un código de un solo uso recibido por WhatsApp antes de completar la firma (firma electrónica avanzada). OBLIGA a cargar `telefono` en TODOS los firmantes (sin teléfono, enviar_documento falla). Consume 1 crédito de WhatsApp por firmante, de la misma bolsa que los avisos (`whatsapp` en estado_cuenta); sin saldo el firmante firma normal.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / firmantes / items / properties / requiere_biometria
      Added value: +{
      +  "description": "Por firmante: false exime a ESTE firmante de la verificación de identidad aunque el documento tenga `requiere_biometria: true` (firma sin DNI + rostro y no consume crédito). Omitido o true: sigue al documento.",
      +  "type": "boolean"
      +}
  2. Changed2 schema fields changed
    • changedInput schema / properties / avisar_por_whatsapp / description
      Previous value: -"true = a cada firmante que tenga `telefono` cargado se le manda el link de firma por WhatsApp, ADEMÁS del email. Consume 1 crédito de WhatsApp por mensaje enviado (ver estado_cuenta). Sin saldo o sin teléfono no se manda nada y el email sale igual."New value: +"true = a cada firmante que tenga `telefono` cargado se le manda el link de firma por WhatsApp, ADEMÁS del email cuando se habilitan los avisos iniciales al enviar. En Electrónica y contratos prepago consume 1 crédito por mensaje; en Digital pago por documento se consumen los 5 créditos incluidos del paquete al enviar con este canal. Consultá estado_cuenta. Sin saldo o sin teléfono no se manda el WhatsApp."
    • changedInput schema / properties / firmantes / items / properties / telefono / description
      Previous value: -"Teléfono en formato internacional (por ej. \"+5491123456789\") para mandarle el link de firma por WhatsApp además del email. Requiere que la cuenta tenga saldo de WhatsApp (ver estado_cuenta) y que el documento lo tenga activado; si falta algo se ignora y el firmante recibe el email."New value: +"Teléfono en formato internacional (por ej. \"+5491123456789\") para mandarle el link de firma por WhatsApp además del email, cuando los avisos iniciales están habilitados. Requiere saldo de WhatsApp (ver estado_cuenta) y el canal activado en el documento. El consumo depende del plan; si falta teléfono o saldo no se manda el WhatsApp."
  3. First observed

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations supplied, the description carries the full behavioral burden and does disclose the most consequential traits: the operation creates a draft, does not consume credit until a separate send step, and returns per-signer documentId/signingUrl. It stops short of covering permission requirements, failure modes, or what happens to template-inherited fields, so it is strong but not exhaustive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four short sentences, zero filler, and the action is front-loaded ahead of the flow and the credit caveat. The 'IMPORTANTE' marker is used sparingly and correctly to flag the one detail that changes downstream behavior.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, but the description compensates by naming the returned documentId and signingUrl, and the flow plus draft-state note complete the picture for a fairly complex 8-parameter creation tool. Only edge-case behavior on failure or partial input is left to inference.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every one of the 8 parameters including the nested firmantes fields is already documented in the schema. The description adds no parameter-level meaning beyond what the schema provides, which is the correct baseline of 3 when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Genera un documento de firma electrónica a partir de una plantilla') and immediately distinguishes itself from the two siblings it sits between (listar_plantillas and enviar_documento). An agent knows exactly what this tool produces versus what the adjacent tools do.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides an explicit call chain 'listar_plantillas → esta herramienta → enviar_documento', which tells the agent both the prerequisite and the required follow-up. It also warns that the document stays in draft and consumes no credit until sent with enviar_documento, which is precisely the condition that determines whether to call it now or later.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.