Consulta de Adeudo — API Predial

ConsultaAdeudo

Devuelve los conceptos de adeudo del Impuesto Predial para el predio indicado, con base en los importes precalculados vigentes.

POST /api/predial/consulta-adeudo

Autenticación

requerido Authorization: Bearer <token> — obtenido en Login.

Cuerpo de la petición

{
  "id_mpio": 10,
  "id_tipo_predio": 1,
  "id_no_cuenta": "000123456"
}

Campo	Tipo	Descripción
`id_mpio`	int	requerido Clave del municipio
`id_tipo_predio`	int	requerido `1`=Urbano, `2`=Rústico, `3`=Suburbano
`id_no_cuenta`	string	requerido Número de cuenta catastral

Respuesta exitosa

{
  "estatus_ejecucion": 1,
  "mensaje_ciudadano": "",
  "mensaje_tecnico": "",
  "adeudos": [
    {
      "base_gravable": 450000.00,
      "clase_pago": 1,
      "bimestre": 0,
      "concepto": 1,
      "importe": 3600.00,
      "fecha_vigencia": "2024-12-31",
      "concepto_espejo": 0
    },
    {
      "base_gravable": 450000.00,
      "clase_pago": 1,
      "bimestre": 0,
      "concepto": 2,
      "importe": 180.00,
      "fecha_vigencia": "2024-12-31",
      "concepto_espejo": 0
    },
    {
      "base_gravable": 450000.00,
      "clase_pago": 1,
      "bimestre": 0,
      "concepto": 4,
      "importe": -1890.00,
      "fecha_vigencia": "2024-12-31",
      "concepto_espejo": 1
    }
  ]
}

Estructura de cada concepto

Campo	Tipo	Descripción
`base_gravable`	float	Base de cálculo del impuesto
`clase_pago`	int	`1`=Anual, `2`=Bimestral
`bimestre`	int	`0`=anual, `1`–`6`=bimestre correspondiente
`concepto`	int	Ver tabla de conceptos abajo
`importe`	float	Importe del concepto (negativo para descuentos)
`fecha_vigencia`	string	Fecha límite de vigencia (`YYYY-MM-DD`)
`concepto_espejo`	int	Concepto al que aplica la reducción (ej. `1` para Impuesto); `0` si no aplica

Tabla de conceptos

`concepto`	Descripción
`1`	Impuesto
`2`	Actualizaciones
`3`	Recargos
`4`	Reducción 50 %

Importes precalculados Los importes reflejan los valores vigentes capturados en el sistema catastral. El campo concepto: 4 (Reducción 50 %) se incluye cuando el predio tiene derecho a descuento; su importe es negativo e indica el concepto al que aplica mediante concepto_espejo.

Respuesta sin adeudos pendientes

Si el predio no tiene adeudos, el arreglo adeudos se devuelve vacío:

{
  "estatus_ejecucion": 1,
  "mensaje_ciudadano": "",
  "mensaje_tecnico": "",
  "adeudos": []
}