Consultar certificado de retención de un contacto

Herramienta MCP: reports_get_client_withholding_certificate.

Devuelve el certificado de retención (carta o certificado de retención) de UN contacto específico para un periodo: datos del contacto, correos de entrega, dirección de entrega y totales netos de retención (IVA, FUENTE, ICA, OTRO).

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_client_withholding_certificate",
    "arguments": { "dateFrom": "2026-01-01", "dateTo": "2026-12-31", "customerId": "45" }
  }
}

Úsala cuando el usuario pida el certificado de retención de un cliente o proveedor. Es de solo lectura: no envía ni programa ningún correo. Resuelve primero el contacto; si hay más de un contacto que coincide con lo que dijo el usuario, pídele que elija antes de llamar a la herramienta.

Cómo interpretar el resultado:

• found=false (motivo NO_CERTIFICATE_FOR_PERIOD): no hay certificado para ese contacto en esas fechas (el contacto puede no existir o no tener retenciones). No ofrezcas ni confirmes ningún envío.

• found=true: confirma con el usuario contact.name, contact.identification.number y el periodo.

• canScheduleDelivery=false con motivo MISSING_EMAIL: el contacto no tiene correo (ni en el contacto ni en la configuración del certificado), así que el envío no se puede programar hasta registrar uno.

• canScheduleDelivery=true: emails son los destinatarios; si hay varios, confirma TODOS.

• availableRetentionTypes lista los tipos de retención con movimiento en el periodo; un tipo con total 0 no tiene movimiento. CREE nunca está disponible.

dateFrom, dateTo y customerId son obligatorios.

Solo lectura.