MVV CONSULTORESConsultoría especializada
Desarrolladores

API de MVV Consultores

Use desde su propio sistema las calculadoras fiscales y notariales, los indicadores, las plantillas jurídicas y sus expedientes y agenda. Incluida en todos los planes, para las áreas que tenga contratadas.

Cómo empezar

  1. Contrate un plan en Planes.
  2. Cree una llave en Mi cuenta → API para desarrolladores. Se muestra una sola vez; guárdela como secreto.
  3. Envíela en cada consulta en el encabezado Authorization: Bearer mvv_live_….
curl https://portal-mvv.vercel.app/api/v1/indicadores/udi?fecha=2026-10-01 \
  -H "Authorization: Bearer $MVV_LLAVE"

Base: https://portal-mvv.vercel.app/api/v1 · JSON en UTF-8 · montos en pesos con IVA cuando aplica · fechas AAAA-MM-DD o ISO 8601.

Límites y errores

1,000 consultas por día por cuenta (se reinicia a medianoche, hora del centro de México) y 60 por minuto. Cada respuesta trae X-RateLimit-Limit y X-RateLimit-Remaining. Si necesita más, escríbanos.

Los errores responden con su código HTTP y { "error": { "codigo": "…", "mensaje": "…" } }:

  • 401 llave_invalida · 403 sin_plan, sin_area · 404 no_existe · 400 cuerpo_invalido, parametros · 429 limite_diario, limite_minuto

Cuenta

GET/api/v1· Cualquier plan

Datos de la cuenta de la llave: áreas habilitadas y despacho.

Calculadoras

Devuelven la misma hoja que se ve en el portal: totales, secciones con fundamento legal y avisos. Los valores que omita toman el predeterminado del campo.

GET/api/v1/calculadoras· Fiscal o notarios

Calculadoras disponibles para su plan.

GET/api/v1/calculadoras/{clave}· Según la calculadora

Campos que recibe: clave, tipo, opciones, valor predeterminado y cuándo aplica.

POST/api/v1/calculadoras/{clave}· Según la calculadora

Calcula con { valores }.

curl -X POST https://portal-mvv.vercel.app/api/v1/calculadoras/resico \
  -H "Authorization: Bearer $MVV_LLAVE" -H "Content-Type: application/json" \
  -d '{"valores": {"modo": "mensual", "mes": 10, "ingresos": 85000}}'
POST/api/v1/calculadoras/compraventa· Notarios

Liquidación de compraventa con { entrada }: ISR del enajenante y adquirente, ISAI, IVA, pro forma, prescripción y PLD. GET muestra todos los campos de la entrada.

curl -X POST https://portal-mvv.vercel.app/api/v1/calculadoras/compraventa \
  -H "Authorization: Bearer $MVV_LLAVE" -H "Content-Type: application/json" \
  -d '{"entrada": {"fEnaj": "2026-10-15", "precio": 4500000, "avaluo": 5200000, "catastral": 2900000,
                "fAdq": "2012-03-10", "cTerr": 600000, "cConst": 1400000, "isaiTasa": 2}}'

Indicadores

GET/api/v1/indicadores· Cualquier plan

Último INPC, UMA histórica, salario mínimo y tasas de recargos.

GET/api/v1/indicadores/inpc?desde=2025-01&hasta=2026-09· Cualquier plan

Serie mensual del INPC.

GET/api/v1/indicadores/udi?fecha=2026-10-01· Cualquier plan

Valor de la UDI de Banxico.

GET/api/v1/indicadores/factor?desde=2020-01-15&hasta=2026-10-31&monto=100000· Cualquier plan

Factor de actualización del art. 17-A CFF y monto actualizado.

Plantillas jurídicas

Llenado sin IA: los campos sin valor quedan como [Etiqueta] y se listan en faltantes.

GET/api/v1/plantillas?familia=contratos· Abogados

Plantillas disponibles (contratos, civil, mercantil, laboral, familiar, corporativo).

GET/api/v1/plantillas/{clave}· Abogados

Campos de la plantilla.

POST/api/v1/plantillas/{clave}· Abogados

Llena la plantilla con { valores, formato }. formato "texto" devuelve JSON; "docx" devuelve el archivo de Word.

curl -X POST https://portal-mvv.vercel.app/api/v1/plantillas/{clave} \
  -H "Authorization: Bearer $MVV_LLAVE" -H "Content-Type: application/json" \
  -d '{"valores": {...}, "formato": "docx"}' -o contrato.docx

Expedientes y agenda

Incluyen lo que la cuenta puede ver en el portal, también lo de su despacho según el modo que eligió el titular. capturo indica quién lo creó.

GET/api/v1/expedientes?area=abogados&q=ruiz&limite=50&desde=0· Áreas del plan

Lista paginada; q busca en número, título y partes.

POST/api/v1/expedientes· Áreas del plan

Crea un expediente: { area, herramienta, numero, titulo, partes, estatus, datos, resultado }.

GET/api/v1/expedientes/{id}· Áreas del plan

Expediente completo con datos y resultado.

PATCH/api/v1/expedientes/{id}· Áreas del plan

Cambia numero, titulo, partes, estatus, datos o resultado.

GET/api/v1/eventos?desde=2026-11-01&hasta=2026-11-30· Cualquier plan

Agenda: audiencias, citas, vencimientos y diligencias.

POST/api/v1/eventos· Cualquier plan

Crea un evento: { titulo, tipo, inicio, fin, lugar, notas, expediente_id }. tipo: audiencia, cita, vencimiento, diligencia u otro.

curl -X POST https://portal-mvv.vercel.app/api/v1/eventos \
  -H "Authorization: Bearer $MVV_LLAVE" -H "Content-Type: application/json" \
  -d '{"titulo": "Audiencia de pruebas", "tipo": "audiencia", "inicio": "2026-11-20T10:00:00-06:00", "lugar": "Juzgado 3o Civil"}'
PATCH/api/v1/eventos/{id}· Cualquier plan

Cambia titulo, tipo, inicio, fin, lugar o notas.

DELETE/api/v1/eventos/{id}· Cualquier plan

Borra el evento.

Los cálculos son herramientas de apoyo; el profesional usuario revisa cada resultado antes de presentarlo. Valores 2026 vigentes; los INPC nuevos se agregan al publicarse.

API para desarrolladores · MVV Consultores