API de lectura · Mejorasoft

Volver al inicio de sesión

Guía rápida de consumo

Todas las operaciones son GET de sólo lectura. La URL base es /api/lectura, las respuestas usan JSON y siempre incluyen data y pagination.

1. Autenticación Envía la credencial de servicio en el encabezado X-API-Key. En Swagger también puedes usar el botón Authorize.
2. Consultar Selecciona el endpoint y agrega filtros en la URL. Los filtros enviados juntos se combinan con condición AND.
3. Paginar Usa offset y limit. El límite predeterminado es 50 y el máximo es 100 registros.

Ejemplos

curl -H "X-API-Key: SU_CREDENCIAL" \
  "https://mspnt.mejorasofterp.com/api/lectura/viajes?fecha_inicio=2026-07-20&fecha_fin=2026-07-26&limit=100"

curl -H "X-API-Key: SU_CREDENCIAL" \
  "https://mspnt.mejorasofterp.com/api/lectura/viajes?id=157"

curl -H "X-API-Key: SU_CREDENCIAL" \
  "https://mspnt.mejorasofterp.com/api/lectura/liquidaciones/cartas_porte?folio=46"

Filtros comunes

FiltroFunciónEjemplo
idBusca el ID único exacto del recurso.?id=157
fecha_inicio / fecha_finRango inclusivo de movimientos, formato YYYY-MM-DD.?fecha_inicio=2026-07-20&fecha_fin=2026-07-26
fecha_modificacion_desdeSincronización incremental por última modificación.?fecha_modificacion_desde=2026-07-26T18:00:00-06:00
offset / limitDesplazamiento y tamaño de página.?offset=100&limit=100
convenio_idObtiene todos los servicios o planes de un convenio.?convenio_id=31
folioObtiene todos los trayectos o vínculos carta porte de una liquidación.?folio=46

Qué significa id

En catálogos, convenios, servicios, viajes, trayectos y tickets identifica la fila principal devuelta. En convenios/diesel y convenios/trayectos identifica el convenio. En liquidaciones y liquidaciones/rentabilidad identifica el folio de liquidación. En liquidaciones/cartas_porte identifica la relación única entre liquidación, carta porte, viaje y operador.

Relaciones de liquidación: liquidaciones_cartas_porte_operadores es la fuente autoritativa. Una liquidación sin relación activa en esa tabla no se devuelve. El filtro folio obtiene todas las relaciones de la liquidación; el filtro id obtiene una sola relación exacta.