Herramienta MCP: reports_get_withholding_certificate_pdf.
Devuelve el PDF original de Alegra del certificado de retención de UN contacto para un periodo, con su diseño. Es de solo lectura: no envía correos.
Ejemplo de llamada JSON-RPC:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "reports_get_withholding_certificate_pdf",
"arguments": { "idClient": "45", "fromDate": "2026-01-01", "toDate": "2026-12-31" }
}
}No la llames sin el ID local del contacto (idClient), fromDate y toDate (YYYY-MM-DD). Un contacto por llamada. Resuelve primero el contacto; si coincide más de uno, pide al usuario que elija. idClient es el mismo ID que se usa como customerId en reports_get_client_withholding_certificate.
La respuesta es JSON con un status:
-
status: "file": incluyefileName,mimeType(application/pdf) ycontentBase64, los bytes originales del PDF (puede ser pesado). Entrega ese archivo al usuario sin redibujarlo. Si vienemessage, el PDF no tiene páginas porque el periodo no tuvo retenciones para imprimir: aun así entrega el archivo e indícalo. -
status: "message": no hay archivo;messagees el texto del servidor (contacto desconocido, cuerpo inválido u operación no permitida).
Solo lectura.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
200PDF del certificado en Base64 (status: file) o un mensaje del servidor (status: message)
401No autorizado (token de Alegra inválido o expirado).