Cotiza en 1 hora · Instalación profesional · Garantía de 1 año
Menú
Integraciones

API del ERP

Conecta tu sistema con la operación de PCM Los Cabos. Consulta facturas, registra cobros, sincroniza catálogos y concilia movimientos a través de una API REST documentada en OpenAPI.

Capacidades

¿Qué puedes hacer con la API?

La API expone los módulos operativos del ERP. Estos son los casos de uso principales que soporta el schema publicado:

Consultar facturas y CFDI

Obtiene el estado de facturas timbradas, descarga XML/PDF y filtra por cliente, rango de fecha o estatus de pago.

Registrar cobros

Aplica pagos contra facturas, captura comprobantes y consulta el historial de cobranza asociado a cada cliente.

Sincronizar catálogos

Mantén productos, precios, existencias y listas actualizadas entre el ERP y tu tienda o punto de venta externo.

Leer contactos

Consulta clientes, proveedores y usuarios del sistema para validar datos antes de crear documentos.

Conciliar movimientos

Lee extractos bancarios, estados de cuenta y movimientos para emparejar ingresos con facturas abiertas.

Orquestar órdenes y proyectos

Crea y consulta órdenes de servicio, proyectos de instalación y cotizaciones desde tus propios flujos.

Seguridad

Autenticación

La API usa tokens JWT. Obtén un token con tus credenciales, envíalo en cada solicitud y refréscalo antes de que expire.

  1. Inicia sesión
    POST https://erp.pcmloscabos.com/api/v1/auth/login/

    Envía {"email","password"}. La respuesta devuelve el token de acceso.

  2. Envía el token
    Authorization: Bearer <token>

    Inclúyelo como header en todas las peticiones protegidas.

  3. Refresca el token
    POST https://erp.pcmloscabos.com/api/v1/auth/refresh/

    Solicita un nuevo token antes de que el actual expire.

Ejemplo con curl
curl -X POST https://erp.pcmloscabos.com/api/v1/auth/login/ \
  -H "Content-Type: application/json" \
  -d '{"email":"tu@empresa.com","password":"TuClaveSegura"}'
Formatos

Respuestas de la API

Todas las respuestas usan JSON. Familiarízate con estas estructuras antes de consumir los endpoints.

Éxito

{"data": ...}

Error

{"error": "...", "code": "..."}

Paginación

{"data": ..., "total": ..., "page": ..., "limit": ..., "total_pages": ...}

Usa page y limit como query params.

Documentación viva

Explorador interactivo

La referencia completa de endpoints, esquemas y ejemplos se mantiene en la documentación OpenAPI del ERP. Usa Swagger o ReDoc para probar directamente contra el schema real.

Fuente de verdad

Referencia completa

Esta página es una introducción. La especificación viva es la fuente de verdad: incluye todos los endpoints disponibles, sus parámetros, códigos de respuesta y ejemplos actualizados. Si hay diferencia entre esta página y la documentación OpenAPI, prevalece la documentación OpenAPI.

Ver documentación OpenAPI
Cotizar