Consultar el detalle de los convenios de la Tesorería

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.

Tool IDtgr.convenios_detalle.consultar
Nombre MCPtgr__convenios_detalle__consultar
Conectortgr
Planoaction
Lee el alcanceconvenios (debe estar habilitado en la conexión)
Scope (permiso)tgr:read
Authnone
Versión2
Sensiblesí
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Lee el detalle YA sincronizado de cada convenio de pago con la Tesorería General de la República: las cuotas con su vencimiento, monto y si están pagadas, la próxima cuota por pagar, cuántas van pagadas, el total y las deudas acogidas con su condonación. Sirve para responder cuánto se debe y cuándo vence lo siguiente. Cada convenio trae la fecha en que se leyó su página de cuotas ('cuotasLeidasEn') y la de su comprobante ('comprobanteLeidoEn'): informa cada dato con su fecha. Lectura pura: NO contacta a la Tesorería ni dispara una sincronización. Si la empresa no tiene convenios la lista viene vacía con 'pantallaLeidaEn' fechado; si nunca se sincronizó, viene vacía con 'pantallaLeidaEn' en null. Para traer datos nuevos usa 'tgr.conexion.sincronizar'. Pagina con 'cursor'.

Entrada

CampoTipoRequeridoDescripción
numeroResolucionstringnoFiltra por un número de resolución, escrito tal cual lo muestra la Tesorería. Omítelo para ver todas las filas.
cursorstringnoPuntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.
limitentero 1-500no · default 100Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "numeroResolucion": {
      "description": "Filtra por un número de resolución, escrito tal cual lo muestra la Tesorería. Omítelo para ver todas las filas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "cursor": {
      "description": "Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/tgr.convenios_detalle.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"numeroResolucion":"4455667"}}'
MCP · meta-tool execute
{
  "tool": "tgr.convenios_detalle.consultar",
  "params": {
    "numeroResolucion": "4455667"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "convenios": [
      {
        "numeroResolucion": "4455667",
        "fechaResolucion": "2026-03-05",
        "tipoConvenio": "Ley 20.780 Fiscal",
        "tipoPago": "CONVENIO CON CONDONACION",
        "fechaInicio": "2026-03-05",
        "numeroCuotas": 3,
        "cuotasPagadas": 1,
        "montoCuotaContado": 250000,
        "totalAPagar": 600000,
        "proximaCuota": {
          "numero": 2,
          "fechaVencimiento": "2026-04-30",
          "monto": 175000
        },
        "cuotas": [
          {
            "numero": 1,
            "fechaVencimiento": "2026-03-31",
            "monto": 250000,
            "tipo": "Cuota contado",
            "pagada": true
          },
          {
            "numero": 2,
            "fechaVencimiento": "2026-04-30",
            "monto": 175000,
            "tipo": "Cuota normal",
            "pagada": false
          },
          {
            "numero": 3,
            "fechaVencimiento": "2026-05-31",
            "monto": null,
            "tipo": "Cuota de ajuste",
            "pagada": false
          }
        ],
        "deudas": [
          {
            "tipo": "FISCAL",
            "rutRol": "76111222",
            "formulario": "22",
            "folio": "998877665",
            "fechaVencimiento": "2025-04-30",
            "condonacionIntereses": 40,
            "condonacionMultas": 40,
            "totalAPagar": 600000
          }
        ],
        "observadoEn": "2026-10-04T14:02:11.000Z",
        "cuotasLeidasEn": "2026-10-04T14:02:11.000Z",
        "comprobanteLeidoEn": "2026-10-04T14:01:40.000Z"
      }
    ],
    "pantallaLeidaEn": "2026-10-04T14:02:11.000Z",
    "cursor": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "tgr.convenios_detalle.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

CampoTipoRequeridoDescripción
convenioslista de objetosíUn detalle por convenio, armado desde su comprobante de resolución y su página de cuotas.
convenios[].numeroResolucionstringsíEl número de la resolución con que la Tesorería otorgó el convenio. Identifica al convenio en las tres pantallas: úsalo para cruzarlas. Es texto: no lo conviertas a número.
convenios[].fechaResolucionstringnullsí
convenios[].tipoConveniostringnullsí
convenios[].tipoPagostringnullsí
convenios[].fechaIniciostringnullsí
convenios[].numeroCuotasenteronullsí
convenios[].cuotasPagadasenteronullsí
convenios[].montoCuotaContadoenteronullsí
convenios[].totalAPagarenteronullsí
convenios[].proximaCuotaobjetonullsí
convenios[].proximaCuota.numeroenterosíEl número de la cuota.
convenios[].proximaCuota.fechaVencimientostringnullsí
convenios[].proximaCuota.montoenteronullsí
convenios[].cuotaslista de objetosíTodas las cuotas del convenio, en orden.
convenios[].cuotas[].numeroenterosíEl número de la cuota dentro del convenio, desde 1.
convenios[].cuotas[].fechaVencimientostringnullsí
convenios[].cuotas[].montoenteronullsí
convenios[].cuotas[].tipostringnullsí
convenios[].cuotas[].pagadabooleanonullsí
convenios[].deudaslista de objetosíLas deudas que el convenio acoge, del comprobante de resolución de 'comprobanteLeidoEn'. Vacía también cuando el comprobante no se alcanzó a leer: en ese caso 'totalAPagar' viene en null y no significa que no haya deudas.
convenios[].deudas[].tipostringnullsí
convenios[].deudas[].rutRolstringsíEl RUT o rol de la deuda, como texto.
convenios[].deudas[].formulariostringnullsí
convenios[].deudas[].foliostringsíEl folio de la deuda, como texto: no lo conviertas a número.
convenios[].deudas[].fechaVencimientostringnullsí
convenios[].deudas[].condonacionInteresesnúmeronullsí
convenios[].deudas[].condonacionMultasnúmeronullsí
convenios[].deudas[].totalAPagarenteronullsí
convenios[].observadoEnstringsíCuándo se guardó por última vez el detalle de este convenio (ISO 8601): la más reciente de las dos lecturas. No dice qué tan al día está cada dato: para eso mira 'cuotasLeidasEn' y 'comprobanteLeidoEn'.
convenios[].cuotasLeidasEnstringnullsí
convenios[].comprobanteLeidoEnstringnullsí
pantallaLeidaEnstringnullsí
cursorstringnullsí
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "convenios": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "numeroResolucion": {
            "type": "string",
            "description": "El número de la resolución con que la Tesorería otorgó el convenio. Identifica al convenio en las tres pantallas: úsalo para cruzarlas. Es texto: no lo conviertas a número."
          },
          "fechaResolucion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "x-emisso-formato": "AAAA-MM-DD",
            "description": "La fecha de la resolución en formato AAAA-MM-DD, o null si no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
          },
          "tipoConvenio": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El tipo de convenio con el texto de la Tesorería. null cuando la celda vino vacía."
          },
          "tipoPago": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El tipo de pago del comprobante (por ejemplo «CONVENIO CON CONDONACION»)."
          },
          "fechaInicio": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "x-emisso-formato": "AAAA-MM-DD",
            "description": "La fecha de inicio del convenio en formato AAAA-MM-DD, o null si no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
          },
          "numeroCuotas": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "En cuántas cuotas se pactó el convenio. null cuando la celda no traía un entero; el texto queda en 'celdas'."
          },
          "cuotasPagadas": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuántas cuotas registra pagadas la Tesorería en su página de cuotas, a la fecha de 'cuotasLeidasEn'. null si no se leyó esa página."
          },
          "montoCuotaContado": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "El monto de la cuota contado (el pie), según el comprobante de 'comprobanteLeidoEn', en pesos chilenos. null cuando la Tesorería no lo muestra o no se pudo leer."
          },
          "totalAPagar": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "El total del convenio, con la condonación ya aplicada, según el comprobante de 'comprobanteLeidoEn', en pesos chilenos. null cuando la Tesorería no lo muestra o no se pudo leer."
          },
          "proximaCuota": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "numero": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "El número de la cuota."
                  },
                  "fechaVencimiento": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "x-emisso-formato": "AAAA-MM-DD",
                    "description": "Su vencimiento en formato AAAA-MM-DD, o null si no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
                  },
                  "monto": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Su monto en pesos chilenos; null si todavía no se liquida."
                  }
                },
                "required": [
                  "numero",
                  "fechaVencimiento",
                  "monto"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "La primera cuota que la Tesorería no registra pagada, a la fecha de 'cuotasLeidasEn'. null si están todas pagadas o no se leyó la pantalla de cuotas."
          },
          "cuotas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "numero": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "El número de la cuota dentro del convenio, desde 1."
                },
                "fechaVencimiento": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "x-emisso-formato": "AAAA-MM-DD",
                  "description": "El vencimiento de la cuota en formato AAAA-MM-DD, o null si no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
                },
                "monto": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "El monto de la cuota en pesos chilenos. null en la cuota de ajuste mientras la Tesorería no la liquida (se calcula después de pagar la penúltima), o si no se pudo leer. Un null NO es cero."
                },
                "tipo": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "«Cuota contado», «Cuota normal», «Cuota de ajuste»… con el texto de la Tesorería. null si el comprobante no se leyó."
                },
                "pagada": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Si la Tesorería la registra pagada, a la fecha de 'cuotasLeidasEn' del convenio. null cuando no se leyó la pantalla de cuotas."
                }
              },
              "required": [
                "numero",
                "fechaVencimiento",
                "monto",
                "tipo",
                "pagada"
              ],
              "additionalProperties": false
            },
            "description": "Todas las cuotas del convenio, en orden."
          },
          "deudas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tipo": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "El tipo de deuda con el texto de la Tesorería (por ejemplo «FISCAL»)."
                },
                "rutRol": {
                  "type": "string",
                  "description": "El RUT o rol de la deuda, como texto."
                },
                "formulario": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "El formulario de la deuda (por ejemplo 21 o 22), como texto."
                },
                "folio": {
                  "type": "string",
                  "description": "El folio de la deuda, como texto: no lo conviertas a número."
                },
                "fechaVencimiento": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "x-emisso-formato": "AAAA-MM-DD",
                  "description": "El vencimiento original de la deuda en formato AAAA-MM-DD, o null si no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
                },
                "condonacionIntereses": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "El porcentaje de condonación de intereses otorgado (0 a 100). null si no se leyó el comprobante."
                },
                "condonacionMultas": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "El porcentaje de condonación de multas otorgado (0 a 100). null si no se leyó el comprobante."
                },
                "totalAPagar": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Lo que se paga por esta deuda en el convenio, en pesos chilenos. null cuando la Tesorería no lo muestra o no se pudo leer."
                }
              },
              "required": [
                "tipo",
                "rutRol",
                "formulario",
                "folio",
                "fechaVencimiento",
                "condonacionIntereses",
                "condonacionMultas",
                "totalAPagar"
              ],
              "additionalProperties": false
            },
            "description": "Las deudas que el convenio acoge, del comprobante de resolución de 'comprobanteLeidoEn'. Vacía también cuando el comprobante no se alcanzó a leer: en ese caso 'totalAPagar' viene en null y no significa que no haya deudas."
          },
          "observadoEn": {
            "type": "string",
            "description": "Cuándo se guardó por última vez el detalle de este convenio (ISO 8601): la más reciente de las dos lecturas. No dice qué tan al día está cada dato: para eso mira 'cuotasLeidasEn' y 'comprobanteLeidoEn'."
          },
          "cuotasLeidasEn": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuándo se leyó la página de cuotas de este convenio (ISO 8601). Es la fecha de 'cuotas', 'pagada', 'cuotasPagadas' y 'proximaCuota': si es de hace días, una cuota pudo pagarse desde entonces; dilo así. null cuando no se conoce la fecha de esa lectura: la página aún no se ha leído o la fila se guardó antes de que se anotara su fecha. Si 'cuotas' trae datos, son reales pero de fecha desconocida: dilo así. No inventes valores que vengan en null."
          },
          "comprobanteLeidoEn": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuándo se leyó el comprobante de resolución de este convenio (ISO 8601). Es la fecha de 'deudas', 'totalAPagar', 'montoCuotaContado' y 'tipo' de cada cuota. Cambia poco, así que puede ser bastante más antigua que 'cuotasLeidasEn'; al informar un total, di de qué fecha es. null cuando no se conoce la fecha de esa lectura: el comprobante aún no se ha leído o la fila se guardó antes de que se anotara su fecha. Si 'totalAPagar' trae un valor, es real pero de fecha desconocida: dilo así; si viene en null, no inventes un total."
          }
        },
        "required": [
          "numeroResolucion",
          "fechaResolucion",
          "tipoConvenio",
          "tipoPago",
          "fechaInicio",
          "numeroCuotas",
          "cuotasPagadas",
          "montoCuotaContado",
          "totalAPagar",
          "proximaCuota",
          "cuotas",
          "deudas",
          "observadoEn",
          "cuotasLeidasEn",
          "comprobanteLeidoEn"
        ],
        "additionalProperties": false
      },
      "description": "Un detalle por convenio, armado desde su comprobante de resolución y su página de cuotas."
    },
    "pantallaLeidaEn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Cuándo una sincronización leyó páginas del detalle por última vez (ISO 8601); puede haber sido solo de algunos convenios, y una sincronización que no leyó ninguna página no mueve esta fecha. Con fecha y sin filas, la empresa no tiene convenios con detalle; en null, el detalle todavía no se ha leído (sincroniza con 'tgr.conexion.sincronizar' antes de concluir que no hay nada). El detalle se lee después de las pantallas y por tandas, así que una sincronización puede dejar convenios sin leer, y los demás conservan su lectura anterior. Para saber qué tan al día está un convenio, no uses esta fecha: mira su 'cuotasLeidasEn' (cuotas y pagos) y su 'comprobanteLeidoEn' (total y deudas) y di de qué fecha es cada dato. Si esta fecha es null y 'tgr.convenios.consultar' ya trae convenios, el detalle aún no se ha podido leer: no significa que no haya deuda. Las sincronizaciones siguientes lo completan solas."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Puntero a la página siguiente. Si viene distinto de null hay más filas: vuelve a llamar reenviándolo tal cual en 'cursor'. Un null significa que no queda nada por traer."
    }
  },
  "required": [
    "convenios",
    "pantallaLeidaEn",
    "cursor"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
alcance_not_enabled403noHabilita el alcance en /connections o quítalo del input de la sincronización.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

Próximos pasos

En esta página