Obtener PDF del certificado de retención

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": incluye fileName, mimeType (application/pdf) y contentBase64, los bytes originales del PDF (puede ser pesado). Entrega ese archivo al usuario sin redibujarlo. Si viene message, 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; message es el texto del servidor (contacto desconocido, cuerpo inválido u operación no permitida).

Solo lectura.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
^\d+$

ID local (público) de UN contacto (idClient), el mismo que se usa como customerId en reports_get_client_withholding_certificate. No es el ID global ni una lista.

string
required
^\d{4}-\d{2}-\d{2}$

Inicio del periodo del certificado, en formato YYYY-MM-DD.

string
required
^\d{4}-\d{2}-\d{2}$

Fin del periodo del certificado, en formato YYYY-MM-DD.

string
length ≥ 1

Texto opcional que se imprime como "consignado en". Omítelo para que el PDF use la ciudad de la compañía. No envíes una cadena vacía: el PDF imprimiría la ciudad en blanco.

string
^\S+(,\S+)*$

Filtro opcional de claves de retención (keyRetentionReference), separadas por coma y sin espacios, por ejemplo IVA,FUENTE. Omítelo para incluir todas las claves con movimiento en el periodo, incluidas CREE y claves de otros países. El IVA se agrupa por periodo bimestral; las demás claves se agrupan por concepto y porcentaje.

Responses
200

PDF del certificado en Base64 (status: file) o un mensaje del servidor (status: message)

401

No autorizado (token de Alegra inválido o expirado).

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here!