Ecocont Estudio
Gestión y control tributario para tu estudio contable · Perú
production
Versión API
v1
Base: /api/v1
Puerto
3001
0.0.0.0 (todas las interfaces)
Módulos activos
10
grupos de endpoints
Auth
JWT 15 min
Refresh token 7 días
Accesos rápidos
Health check
Configuración de integración
Base URL/api/v1
Auth headerAuthorization: Bearer <token>
Tenant headerX-Tenant-Id: <tenantId>
Content-Typeapplication/json
Rate limit100 req / 60 s
Auth endpoints5 req / 60 s
CORSCORS_ORIGINS env var
WebSocketSocket.io en /
Endpoints disponibles
Autenticación & Usuarios
POST /api/v1/auth/login Login — obtener access + refresh token
POST /api/v1/auth/exchange SSO — sincronización desde ecocont_ui (X-Service-Key)
POST /api/v1/auth/refresh Renovar access token
POST /api/v1/auth/logout Invalidar sesión
GET /api/v1/users/me Perfil del usuario autenticado
Estudio & Membresías
GET /api/v1/tenants Listar estudios del usuario
POST /api/v1/tenants Crear nuevo estudio contable
GET /api/v1/tenants/:id/members Miembros del estudio
POST /api/v1/tenants/:id/members Invitar miembro al estudio
Cartera de clientes
GET /api/v1/companies Listar clientes del estudio
POST /api/v1/companies Agregar cliente (consulta SUNAT)
POST /api/v1/companies/sync-from-erp Sincronizar cartera desde ecocont_ui
GET /api/v1/companies/:id Detalle de cliente
DELETE /api/v1/companies/:id Eliminar cliente
POST /api/v1/companies/:id/credentials Guardar Clave SOL (cifrada)
GET /api/v1/companies/:id/credentials/status Estado de credenciales SOL
Datos tributarios ingestados
GET /api/v1/companies/:id/declarations Declaraciones (PDT 621, 601, etc.)
GET /api/v1/companies/:id/payments Pagos y constancias
GET /api/v1/companies/:id/detractions Detracciones SPOT
GET /api/v1/companies/:id/retentions Retenciones
GET /api/v1/companies/:id/buzon Buzón SOL (notificaciones SUNAT)
Motor tributario
GET /api/v1/companies/:id/debts/consolidated Deuda actualizada con TIM
GET /api/v1/companies/:id/fines Multas detectadas
POST /api/v1/companies/:id/fines/simulate Simular multa art. 173-178 CT
GET /api/v1/companies/:id/obligations Obligaciones y calendario vencimientos
GET /api/v1/companies/:id/compliance/score Score de cumplimiento tributario
GET /api/v1/companies/:id/multas/consolidated Vista consolidada multas + gradualidad
SIRE & Liquidación
GET /api/v1/companies/:id/sire Historial RVIE + RCE (SIRE)
GET /api/v1/companies/:id/declarations/liquidacion Liquidación mensual IGV/Renta
WhatsApp & Comunicaciones del estudio
GET /api/v1/comm-logs Historial de WhatsApp y emails enviados
GET /api/v1/comm-logs/stats Estadísticas de comunicaciones
GET /api/v1/whatsapp/templates Plantillas personalizables de mensajes
POST /api/v1/companies/:id/notify Enviar WhatsApp / email al cliente
GET /api/v1/companies/:id/notify/preview Preview de mensaje antes de enviar
Reportes PDF
POST /api/v1/companies/:id/reports Solicitar generación de reporte
GET /api/v1/companies/:id/reports/:id Estado y URL firmada del reporte
Webhook de scrapers externos
POST /api/v1/webhooks/ingest/:companyId Ingesta de datos desde scraper SOL (X-Webhook-Secret)
GET /api/v1/webhooks/events Historial de eventos de ingesta
Administración
GET /api/v1/health Health check (DB + Redis)
GET /api/v1/audit Logs de auditoría (OWNER)
GET /api/v1/admin/queues BullBoard — estado de colas (OWNER)
Ecocont Estudio — Plataforma de gestión para estudios contables — ECOCONT © 2026