Monitor

Endpoints de observabilidad y diagnóstico: estadísticas de uso, errores recientes y pruebas de conectividad contra AFIP sin necesidad de emitir un comprobante real.

Todos estos endpoints son anónimos

Ninguna ruta bajo /api/monitor requiere token. Están pensados para el panel web que la API sirve en su propio host, no para exponerse a internet. Entre ellos hay endpoints que listan usuarios y cuotas, crean empresas, suben certificados con su contraseña y reescriben las URLs de AFIP a las que apunta el sistema.

Si tu instalación es accesible públicamente, restringí /api/monitor/** por firewall, regla de reverse proxy o red interna.

Estadísticas

Contadores en memoria, acumulados desde el último reinicio del servicio.

GET /api/monitor/estadisticas Sin token

GET /api/monitor/dashboard Sin token

Vista consolidada: resumen, totales, detalle por empresa y ranking de tipos de comprobante.

json

{
  "resumen": { },
  "totales": { },
  "empresas": [ ],
  "topComprobantes": [ ]
}

GET /api/monitor/empresas Sin token

GET /api/monitor/empresas/{cuit} Sin token

Estadísticas de una empresa. Devuelve 404 si el CUIT no tiene actividad registrada.

DELETE /api/monitor/estadisticas Sin token

Reinicia los contadores.

Errores recientes

GET /api/monitor/errores Sin token

bash

curl "https://api.tudominio.com/api/monitor/errores?limite=20"

json

[
  {
    "cuit": "30712345678",
    "fecha": "2026-08-20T14:31:02",
    "operacion": "Emision",
    "mensaje": "[10016] El punto de venta 9 no esta dado de alta en AFIP",
    "ambiente": "produccion"
  }
]

Valor de `operacion`	Origen
`Login`	Autenticación WSAA.
`Emision`	Emisión de comprobante WSFE.
`ConsultaUltimo`	Consulta del último número autorizado.
`ConsultaComprobante`	Consulta de un comprobante.
`EmisionExportacion`	Autorización de comprobante WSFEX.

Se guardan en memoria

Solo se conservan los últimos 20 errores por empresa, y se pierden al reiniciar el servicio. Para auditoría real, usá los archivos de log del servidor.

Estado del servicio

GET /api/monitor/health Sin token

json

{
  "status": "healthy",
  "timestamp": "2026-08-20T14:00:00Z",
  "monitorActivo": true,
  "tiempoActivoMinutos": 4320,
  "empresasMonitoreadas": 3
}

Al no requerir token, es el endpoint indicado para el health check de un balanceador o de un uptime monitor.

Uso y actividad

GET /api/monitor/tokens Sin token

Consumo por token. No expone el valor del token, pero sí el email y la cuota de cada usuario.

json

[
  {
    "id": 1,
    "email": "sistema@miempresa.com",
    "companyName": "Mi Empresa SRL",
    "requestsUsed": 145,
    "requestsLimit": 1000,
    "createdAt": "2026-01-15T10:00:00Z",
    "expiresAt": null,
    "expirado": false,
    "porcentajeUso": 14.5
  }
]

GET /api/monitor/actividad Sin token

Últimas llamadas registradas, con endpoint y servicio. Acepta ?limite=, por defecto 50.

GET /api/monitor/usuarios Sin token

Vencimiento de certificados

GET /api/monitor/certificados Sin token

json

[
  {
    "cuit": "30712345678",
    "razonSocial": "Mi Empresa SRL",
    "ambiente": "produccion",
    "venceEn": "2027-04-15T00:00:00",
    "diasRestantes": 455,
    "estado": "VIGENTE"
  }
]

Estados posibles: VIGENTE, POR_VENCER, VENCIDO, SIN_FECHA. Un certificado vencido corta la facturación por completo, así que conviene alertar sobre este endpoint.

POST /api/monitor/certificados/recalcular-vencimientos Sin token

Relee los certificados almacenados y actualiza sus fechas de vencimiento.

Probar la conexión con AFIP

Estos endpoints hacen llamadas reales a AFIP usando el certificado del CUIT indicado. Son la forma más rápida de aislar un problema sin emitir nada.

GET /api/monitor/empresa/{cuit}/ping-wsaa Sin token

json

{
  "ok": true,
  "mensaje": "Autenticacion exitosa",
  "tokenPreview": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGlu..."
}

Si esto falla, el problema es el certificado o su autorización en AFIP; no tiene sentido seguir depurando el request.

Endpoint	Qué prueba
`/empresa/{cuit}/ping-wsaa`	Autenticación con el certificado.
`/empresa/{cuit}/ping-wsfe`	Disponibilidad de WSFE. Consulta siempre homologación.
`/empresa/{cuit}/ping-wsfex`	Disponibilidad de WSFEX.
`/empresa/{cuit}/ultimo-comprobante`	Último autorizado. Acepta `puntoVenta` y `tipoComprobante`.
`/empresa/{cuit}/puntos-venta`	Puntos de venta habilitados.
`/empresa/{cuit}/consultar-caea`	CAEA del período actual.
`/empresa/{cuit}/consultar-remito`	Remito cárnico por `?codigo=`.

También están disponibles como GET las mismas tablas de parámetros que en WSFE y WSFEX, bajo /api/monitor/empresa/{cuit}/…: tipos-comprobante, tipos-iva, tipos-documento, tipos-monedas, cotizacion, tipos-tributos, tipos-concepto, tipos-opcional, condicion-iva-receptor, fex-paises, fex-monedas, fex-unidades, fex-tipos-exportacion y fex-puntos-venta.

No los monitorees por código HTTP

Estos endpoints devuelven 200 incluso cuando la operación contra AFIP falló: el error viaja dentro del cuerpo, en ok: false o success: false. Una alerta basada solo en el status code no va a detectar nunca una caída de AFIP.

Configuración de AFIP

GET /api/monitor/config-afip Sin token

POST /api/monitor/config-afip Sin token

Lee y modifica las URLs de los servicios de AFIP por ambiente.

Cambia a dónde apunta el sistema

Este endpoint reescribe las direcciones a las que la API envía los comprobantes, y no requiere autenticación. Además, el cambio no afecta la autorización de facturas de exportación: WSFEX lee sus URLs directamente del archivo de configuración del servidor, salteándose esta tabla. Es una asimetría a tener presente si alguna vez necesitás repuntar los servicios.

Panel web

La API sirve un panel de monitoreo en su propio host, construido sobre estos endpoints:

Ruta	Contenido
`/monitor.html`	Panel de monitoreo.
`/monitor-mejorado.html`	Versión extendida del panel.
`/`	Interfaz de Swagger.
`/swagger/v1/swagger.json`	Documento OpenAPI.