Skip to main content
POST
Confirmación humana
Una llave de agente (emitida con aprobación obligatoria) no ejecuta nada irreversible sin que una persona de la empresa lo apruebe. Vale igual por REST y por MCP. Las llaves de ERP, POS e integradores no cambian: para ellas este flujo no existe. Operaciones que lo exigen: POST /invoices/{id}/cancel, cancel-administrative, cancel-note (deprecada), revert-cancel, credit-note, POST /events/end, /events/restamp-cufd, /massive/end, DELETE /webhooks/endpoints/{id} y /rotate-secret (tools: anularFactura, revertirAnulacion, crearNotaCreditoDebito, cerrarEvento, resellarFacturasEvento, cerrarLoteMasivo, eliminarWebhook, rotarSecretoWebhook). En MCP son exactamente las tools con annotations.destructiveHint: true (más confirmarAccion y las de administración que piden confirmación), así un cliente MCP sabe de antemano cuáles van a pedir aprobación.

Flujo

1

Pedís la operación

La operación no se ejecuta: queda congelada con sus argumentos y responde 428.
Leé confirmationId y expiresAt de error.details (formato estable clave=valor). En MCP llega como isError con [CONFIRMATION_REQUIRED] confirmationId=… expiresAt=… canales=… efecto="…".
2

El aprobador recibe un código

Un código de 6 dígitos, de un solo uso, por WhatsApp y/o correo: un canal que el agente no ve. El correo incluye el efecto (número de factura, monto, punto de venta; nunca datos del comprador). Vence a los 10 minutos.
3

Confirmás con el código

Se ejecuta exactamente lo congelado (no mandás argumentos de la operación) y responde lo mismo que habría respondido la operación original: mismo status y cuerpo. MCP: confirmarAccion(confirmationId, codigo), cuyo structuredContent es el de la tool confirmada (outputSchema objeto).

Errores

Cada código se gasta antes de ejecutar: a lo sumo una ejecución. Si el SIN falla después, pedí otra confirmación.

Configurar

El aprobador (WhatsApp en E.164 y/o correo) es dato de cada empresa y lo carga CUCU; la llave de la empresa no puede nombrarlo. Para darle un agente a una empresa: aprobador configurado + llave emitida con requiereAprobacion=true (generarApiKey). La llave del agente y la del ERP rotan por separado.