Consulta de Predio — API Predial

ConsultaPredio

Devuelve los datos catastrales del predio identificado por municipio, tipo y número de cuenta.

POST /api/predial/consulta-predio

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": "",
  "id_mpio": 10,
  "id_tipo_predio": 1,
  "id_no_cuenta": 123456,
  "numero_control": 789,
  "calle": "HIDALGO",
  "no_ext": "12",
  "no_int": "",
  "colonia": "CENTRO",
  "localidad": "AJALPAN",
  "cp": 75910,
  "domicilio": "HIDALGO No. 12, Col. CENTRO, AJALPAN, C.P. 75910"
}

Campo	Tipo	Descripción
`id_no_cuenta`	int	Número de cuenta catastral
`numero_control`	int	Número de control interno (omitido si es 0)
`calle`	string	Nombre de la vialidad
`no_ext`	string	Número exterior
`no_int`	string	Número interior (puede estar vacío)
`colonia`	string	Colonia o fraccionamiento
`localidad`	string	Localidad o ciudad
`cp`	int	Código postal
`domicilio`	string	Dirección concatenada

Respuesta de error

Si la cuenta no existe en el catastro, mensaje_ciudadano lo indica explícitamente para que el ciudadano verifique el número capturado, en vez de confundirlo con “no tiene predio este año”:

{
  "estatus_ejecucion": 0,
  "mensaje_ciudadano": "La cuenta predial ingresada no fue encontrada. Favor de verificar la información e intentar nuevamente.",
  "mensaje_tecnico": "No se han encontrado registros para la cuenta 12345 y el tipo_predio 1, corrobore la información."
}

Si la cuenta sí existe pero no hay registro para el año en curso:

{
  "estatus_ejecucion": 0,
  "mensaje_ciudadano": "Predio no encontrado.",
  "mensaje_tecnico": ""
}

Número de cuenta El formato del número de cuenta varía por municipio. Usa exactamente el formato que aparece en el recibo de predial o en los registros catastrales del municipio.