Confirmación de Pago — API Predial

ConfirmaPago

Recibe la confirmación de un pago de Impuesto Predial realizado en ventanilla o portal de cobro. Siempre paga todo el adeudo pendiente de la cuenta dentro de la misma ventana de 5 años que cubre ConsultaAdeudo (el año en curso y los 4 anteriores) — no recibe periodos en la petición, el servicio los resuelve internamente.

POST /api/predial/confirma-pago

Validación de importe con tolerancia ±10% Antes de registrar el pago, el servicio calcula el total esperado de cada periodo pendiente con la misma fórmula que ConsultaAdeudo y compara la suma contra importe_pagado. Si la desviación excede el 10% del total esperado, la petición se rechaza (400) y no se persiste ni sincroniza nada.

Autenticación

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

Cuerpo de la petición

{
  "id_mpio": 10,
  "id_tipo_predio": 1,
  "id_no_cuenta": 123456,
  "numero_control": 20240001,
  "referencia_pago": "REF12345678901234567",
  "fecha_pago": "2026-06-15",
  "importe_pagado": 8100.00,
  "lugar_pago": "VENTANILLA MUNICIPAL"
}

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
`numero_control`	int	requerido Número de control del recibo
`referencia_pago`	string	requerido Referencia de pago (máx. 20 caracteres)
`fecha_pago`	string	requerido Fecha del pago (`YYYY-MM-DD`)
`importe_pagado`	float	requerido Importe único que cobró el cajero por todo el adeudo pendiente
`lugar_pago`	string	opcional Descripción del punto de cobro

Respuesta exitosa

{
  "estatus_ejecucion": 1,
  "mensaje_ciudadano": "Pago recibido.",
  "mensaje_tecnico": "",
  "periodos": [
    { "periodo": 2024, "importe_cobrado": 3600.00 },
    { "periodo": 2025, "importe_cobrado": 900.00 },
    { "periodo": 2026, "importe_cobrado": 3600.00 }
  ]
}

Campo	Tipo	Descripción
`periodos`	array	Un elemento por cada periodo pendiente que se pagó
`periodos[].periodo`	int	Año del ejercicio
`periodos[].importe_cobrado`	float	Importe calculado (no una fracción arbitraria del `importe_pagado` recibido) atribuido a ese periodo

Respuesta — sin adeudos pendientes

{
  "estatus_ejecucion": 0,
  "mensaje_ciudadano": "Sin adeudos pendientes.",
  "mensaje_tecnico": "sin periodos pendientes para tipo=1 cuenta=12345"
}

Respuesta — importe fuera de tolerancia

{
  "estatus_ejecucion": 0,
  "mensaje_ciudadano": "El importe pagado no corresponde al adeudo pendiente.",
  "mensaje_tecnico": "importe_pagado=5000.00 fuera de tolerancia ±10% respecto al total esperado 8100.00 (periodos [2024 2025 2026])"
}