Guía para robots y agentes autónomos sobre Certplag

Certplag es una plataforma SaaS chilena dedicada a digitalizar el control profesional de plagas. Unifica la generación de certificados sanitarios, el monitoreo de tratamientos, la planificación de visitas, la gestión documental y la comunicación con clientes finales en un solo flujo auditable.

Este recurso está pensado para rastreadores, LLMs y otros agentes automáticos que necesiten una descripción textual de la propuesta de valor, así como un mapa resumido de los puntos de acceso a la API.

Resumen funcional

  • Genera certificados sanitarios personalizables (T°V, roedores, aviares, extintores, etc.).
  • Orquesta agendas, registros fotográficos, planos con trampas y alertas en tiempo real para cada instalación.
  • Ofrece portal de clientes, reportes de consumo, dashboards de tendencias y trazabilidad de visitas del personal técnico.
  • Integra facturación, pagos, inventario, bodega y comunicaciones (mailbox, notificaciones push y códigos QR).

Rutas API destacadas

La API REST está versionada bajo /api/v1. En producción se publica en https://api.certplag.cl/api/v1 (usa http://localhost:3000/api/v1 en desarrollo). A continuación se listan agrupaciones de endpoints relevantes para exploración automática.

Autenticación y cuentas

Gestión de accesos tradicionales, Google OAuth, activaciones y recuperación de credenciales.

  • POST /auth/login — Generar JWT con credenciales locales.
  • POST /auth/register — Registrar cuentas productivas.
  • GET /auth/google — Inicio de sesión mediante Google OAuth.
  • GET /refresh-token — Rotar tokens cortos antes de expirar.

Personas, usuarios y clientes

Control de perfiles internos, invitados, clientes y asistencia digital de técnicos.

  • GET /user/profile — Perfil del usuario autenticado.
  • GET /users — Listado administrado con filtros RBAC.
  • GET /persons — Personas asociadas al supervisor actual.
  • POST /persons/create — Ingreso de clientes o responsables de sitio.
  • PUT /person/:id — Actualizar datos y bitácoras.

Operación técnica

Endpoints que alimentan las órdenes de servicio, planos, QR y reportes operacionales.

  • GET /qr/obtener — Catálogo de códigos QR disponibles.
  • POST /qr/generar — Generación masiva de códigos por sucursal.
  • POST /documentos — Emitir certificados y PDFs con firma digital.
  • GET /materialsAndSupplies/:placeId — Inventario de insumos y consumos por instalación.
  • GET /estadisticas/resultados-globales — Indicadores de desempeño acumulados.

Comercial y facturación

Soporta precios, pagos, integraciones de marketplaces y facturas electrónicas.

  • GET /prices — Catálogo de planes y tablas de precios vigentes.
  • POST /payments/create — Registrar pagos con adjuntos y comprobantes.
  • POST /mercadopago/create-preference — Crear preferencias y enlaces de cobro Mercado Pago.
  • POST /user/invoice/ensure — Asegurar generación de factura mensual por usuario.

Contenido y portal público

Información indexable para blogs, landing y paneles abiertos para clientes finales.

  • GET /blog/codigoBlog/:codigo — Colección de artículos.
  • GET /blog/:slug — Detalle de un artículo público.
  • GET /estadisticas/landing/resumen — Métricas sintetizadas para la landing.