Modulos API

La API de Zentto expone mas de 40 modulos de negocio bajo el prefijo /v1/. Cada modulo tiene su propio router, servicio y stored procedures asociados.

Resumen de modulos

#	Modulo	Base path	Endpoints	SP principal
1	Documentos de Venta	/v1/documentos-venta	~15	usp_AR_SalesDocument_*, usp_Doc_Sales_*
2	Documentos de Compra	/v1/documentos-compra	~12	usp_AP_PurchaseDocument_*, usp_Doc_Purchase_*
3	Clientes	/v1/clientes	~8	usp_Master_Customer_*
4	Proveedores	/v1/proveedores	~8	usp_Master_Supplier_*
5	Inventario	/v1/inventario	~10	usp_Inv_*
6	Inventario Avanzado	/v1/inventario-avanzado	~20	usp_Inv_*, usp_Inv_Integracion_*
7	Bancos	/v1/bancos	~15	usp_Fin_*
8	Contabilidad	/v1/contabilidad	~20	usp_Acct_*, usp_Acct_Advanced_*
9	Cuentas por Cobrar (CxC)	/v1/cxc	4	usp_AR_*
10	Cuentas por Pagar (CxP)	/v1/cxp	4	usp_AP_*
11	Abonos	/v1/abonos	~6	usp_AR_Payment_*
12	Pagos	/v1/pagos	~6	usp_AP_Payment_*
13	Nomina	/v1/nomina	~15	sp_Nomina_*
14	RRHH	/v1/rrhh	44	sp_RRHH_*
15	Empleados	/v1/empleados	~8	usp_Master_Employee_*
16	POS	/v1/pos	~12	usp_Ops_*, sp_POS_*
17	Restaurante	/v1/restaurante	~15	sp_Restaurante_*, usp_Rest_*
18	Ecommerce	/v1/addons	~10	usp_Ecommerce_*
19	Fiscal	/v1/fiscal	~8	usp_Fiscal_*
20	Retenciones	/v1/retenciones	~6	usp_Fiscal_Retenciones_*
21	CRM	/v1/crm	~15	usp_CRM_*
22	Call Center	/v1/crm/call-center	~18	usp_CRM_CallCenter_*
23	Manufactura	/v1/manufactura	~18	usp_Mfg_*, usp_Mfg_Integracion_*
24	Flota	/v1/flota	~20	usp_Fleet_*
25	Logistica	/v1/logistica	~18	usp_Logistics_*
26	Permisos (RBAC)	/v1/permisos	~16	usp_RBAC_*
27	Auditoria	/v1/auditoria	~6	usp_Audit_*
28	Usuarios	/v1/usuarios	~8	usp_Sec_*
29	Empresa	/v1/empresa	~5	usp_Cfg_*
30	Reportes	/v1/reportes	~8	Varios
31	Configuracion	/v1/config	~5	usp_Cfg_*
32	Media	/v1/media	~4	— (filesystem)
33	Supervision	/v1/supervision	~6	sp_Supervisor_*
34	Sistema	/v1/sistema	~8	usp_Sys_*
35	Payments (Paddle)	/v1/payments	~5	usp_Pay_*
36	Billing	/v1/billing	~4	usp_Sys_Billing_*
37	Centro de Costo	/v1/centro-costo	~4	usp_Acct_CostCenter_*
38	Maestros (CRUD generico)	/v1/maestros	~6	usp_Master_*
39	Categorias	/v1/categorias	~4	usp_Master_Category_*
40	Marcas	/v1/marcas	~4	usp_Master_Brand_*
41	Unidades	/v1/unidades	~4	usp_Master_Unit_*
42	Vendedores	/v1/vendedores	~4	usp_Master_Seller_*
43	Movimientos Inventario	/v1/movinvent	~4	sp_MovUnidades*
44	CRUD dinamico	/v1/crud	~3	usp_Util_*
45	Meta	/v1/meta	~3	usp_Misc_*

Detalle de modulos principales

Documentos de Venta (/v1/documentos-venta)

Gestion unificada de documentos comerciales de venta.

Tipos de documento: Factura, Nota de Credito, Nota de Debito, Pedido, Cotizacion, Presupuesto, Orden.

Endpoint	Metodo	Descripcion
/	GET	Listar documentos con filtros y paginacion
/:id	GET	Obtener documento con detalle
/	POST	Crear documento
/:id	PUT	Actualizar documento
/:id/anular	POST	Anular documento
/:id/convertir	POST	Convertir tipo (cotizacion → factura)
/reporte	GET	Reporte de ventas

SPs: usp_Doc_Sales_List, usp_Doc_Sales_Get, usp_Doc_Sales_CreateTx, usp_Doc_Sales_VoidTx

Integraciones best-effort: Genera asiento contable, actualiza CxC, descuenta stock, envia notificacion.

Documentos de Compra (/v1/documentos-compra)

Misma estructura que ventas pero para el ciclo de compras.

Endpoint	Metodo	Descripcion
/	GET	Listar documentos de compra
/:id	GET	Obtener documento con detalle
/	POST	Crear documento de compra
/:id/anular	POST	Anular documento

SPs: usp_Doc_Purchase_List, usp_Doc_Purchase_Get, usp_Doc_Purchase_CreateTx, usp_Doc_Purchase_VoidTx

Inventario Avanzado (/v1/inventario-avanzado)

Extension del inventario basico con almacenes, zonas, lotes y seriales.

Endpoint	Metodo	Descripcion
/almacenes	GET/POST	CRUD de almacenes
/almacenes/:id	GET	Detalle de almacen
/almacenes/:id/zonas	GET/POST	Zonas dentro del almacen
/zonas/:id/ubicaciones	GET/POST	Ubicaciones dentro de zona
/lotes	GET/POST	Gestion de lotes
/lotes/:id	GET	Detalle de lote
/seriales	GET/POST	Gestion de seriales
/seriales/:id	GET	Detalle de serial
/seriales/:id/estado	PATCH	Cambiar estado del serial
/stock-ubicacion	GET	Stock por ubicacion
/valoracion/:productId	GET	Valoracion de producto
/valoracion	POST	Ejecutar valoracion
/movimientos	GET/POST	Movimientos de stock

SPs: usp_Inv_Warehouse_*, usp_Inv_Lot_*, usp_Inv_Serial_*, usp_Inv_StockMovement_*

Contabilidad (/v1/contabilidad)

Modulo contable completo con plan de cuentas, asientos, y reportes financieros.

Endpoint	Metodo	Descripcion
/cuentas	GET/POST	Plan de cuentas
/asientos	GET/POST	Asientos contables
/asientos/:id	GET	Detalle de asiento
/asientos/:id/aprobar	POST	Aprobar asiento
/asientos/:id/anular	POST	Anular asiento
/balance-general	GET	Balance general
/estado-resultados	GET	Estado de resultados
/balance-comprobacion	GET	Balance de comprobacion
/mayor-analitico	GET	Mayor analitico
/activos-fijos	GET/POST	Activos fijos
/depreciacion	POST	Ejecutar depreciacion
/cierre-periodo	POST	Cierre de periodo contable

SPs: usp_Acct_Account_*, usp_Acct_JournalEntry_*, usp_Acct_Advanced_*, usp_Acct_FixedAssets_*

Bancos (/v1/bancos)

Gestion bancaria, conciliacion y caja chica.

Endpoint	Metodo	Descripcion
/cuentas-bancarias	GET/POST	Cuentas bancarias
/movimientos	GET/POST	Movimientos bancarios
/conciliacion	GET/POST	Conciliacion bancaria
/conciliacion/:id/aplicar	POST	Aplicar conciliacion
/caja-chica	GET/POST	Cajas chicas
/caja-chica/:id/movimientos	GET/POST	Movimientos de caja chica

Integraciones: Cada movimiento bancario genera asiento contable (best-effort).

CRM (/v1/crm)

Gestion de relaciones con clientes, pipeline de ventas y call center.

Endpoint	Metodo	Descripcion
/pipelines	GET/POST	Pipelines de ventas
/pipelines/:id/stages	GET/POST	Etapas del pipeline
/leads	GET/POST	Leads/oportunidades
/leads/:id	GET/PUT	Detalle y edicion de lead
/leads/:id/cambiar-etapa	POST	Mover lead de etapa
/leads/:id/cerrar	POST	Cerrar lead (ganado/perdido)
/actividades	GET/POST	Actividades
/actividades/:id/completar	POST	Marcar actividad completada
/dashboard	GET	KPIs del CRM
/call-center/*	*	Sub-modulo Call Center (18 endpoints)

SPs: usp_CRM_Pipeline_*, usp_CRM_Lead_*, usp_CRM_Activity_*, usp_CRM_CallCenter_*

Manufactura (/v1/manufactura)

Gestion de produccion con BOM, centros de trabajo y ordenes.

Endpoint	Metodo	Descripcion
/bom	GET/POST	Listas de materiales
/bom/:id	GET	Detalle de BOM
/bom/:id/activar	POST	Activar BOM
/bom/:id/obsoleto	POST	Marcar como obsoleto
/bom/:id/rutas	GET/POST	Rutas de produccion
/centros-trabajo	GET/POST	Centros de trabajo
/ordenes	GET/POST	Ordenes de trabajo
/ordenes/:id	GET	Detalle de orden
/ordenes/:id/iniciar	POST	Iniciar produccion
/ordenes/:id/consumir	POST	Reportar consumo de materiales
/ordenes/:id/reportar-salida	POST	Reportar producto terminado
/ordenes/:id/completar	POST	Completar orden
/ordenes/:id/cancelar	POST	Cancelar orden

SPs: usp_Mfg_BOM_*, usp_Mfg_WorkCenter_*, usp_Mfg_WorkOrder_*, usp_Mfg_Integracion_*

Integraciones best-effort: Al completar, consume materiales del inventario, produce producto terminado, y genera asiento contable.

Flota (/v1/flota)

Gestion de vehiculos, combustible, mantenimiento y viajes.

Endpoint	Metodo	Descripcion
/vehiculos	GET/POST	Vehiculos
/vehiculos/:id	GET	Detalle con historial
/vehiculos/:id/documentos	GET/POST	Documentos del vehiculo
/combustible	GET/POST	Registros de combustible
/tipos-mantenimiento	GET/POST	Tipos de mantenimiento
/mantenimientos	GET/POST	Mantenimientos
/mantenimientos/:id	GET	Detalle de mantenimiento
/mantenimientos/:id/completar	POST	Completar mantenimiento
/mantenimientos/:id/cancelar	POST	Cancelar mantenimiento
/viajes	GET/POST	Viajes
/viajes/:id/completar	POST	Completar viaje
/dashboard	GET	Dashboard de flota

SPs: usp_Fleet_Vehicle_*, usp_Fleet_Fuel_*, usp_Fleet_Maintenance_*, usp_Fleet_Trip_*

Logistica (/v1/logistica)

Gestion de transporte, recepciones y despachos.

Endpoint	Metodo	Descripcion
/transportistas	GET/POST	Transportistas
/conductores	GET/POST	Conductores
/recepciones	GET/POST	Recepciones de mercancia
/recepciones/:id	GET	Detalle de recepcion
/recepciones/:id/aprobar	POST	Aprobar recepcion (ingresa stock)
/devoluciones	GET/POST	Devoluciones
/devoluciones/:id/aprobar	POST	Aprobar devolucion
/notas-entrega	GET/POST	Notas de entrega
/notas-entrega/:id	GET	Detalle de nota
/notas-entrega/:id/despachar	POST	Despachar (descuenta stock)
/notas-entrega/:id/entregar	POST	Confirmar entrega

SPs: usp_Logistics_Carrier_*, usp_Logistics_GoodsReceipt_*, usp_Logistics_DeliveryNote_*

Permisos RBAC (/v1/permisos)

Sistema de permisos granulares, restricciones de precio y aprobaciones.

Endpoint	Metodo	Descripcion
/permisos	GET	Catalogo de permisos
/permisos/seed	POST	Sembrar permisos iniciales
/roles/:roleId/permisos	GET/POST	Permisos por rol
/roles/:roleId/permisos/bulk	POST	Asignacion masiva
/usuarios/:userId/permisos	GET	Permisos del usuario
/usuarios/:userId/permisos/override	POST	Override de permisos
/usuarios/:userId/verificar/:code	GET	Verificar permiso
/precios	GET/POST	Restricciones de precio
/precios/verificar/:userId	GET	Verificar restriccion
/reglas-aprobacion	GET/POST	Reglas de aprobacion
/aprobaciones	GET/POST	Solicitudes de aprobacion
/aprobaciones/:id	GET	Detalle de solicitud
/aprobaciones/:id/accion	POST	Aprobar/rechazar

SPs: usp_RBAC_Permission_*, usp_RBAC_RolePermission_*, usp_RBAC_PriceRestriction_*, usp_RBAC_ApprovalRule_*

RRHH (/v1/rrhh)

Modulo mas extenso con 44 endpoints cubriendo beneficios, salud ocupacional, obligaciones legales y vacaciones.

Grupo	Endpoints	Descripcion
Departamentos	~4	CRUD de departamentos
Cargos	~4	CRUD de posiciones
Beneficios	~6	Gestion de beneficios laborales
Vacaciones	~6	Solicitudes y aprobacion de vacaciones
Salud Ocupacional	~6	Examenes y registros medicos
Obligaciones Legales	~6	Cumplimiento legal
Documentos	~6	Documentos del empleado
Evaluaciones	~6	Evaluaciones de desempeno

SPs: sp_RRHH_Beneficios_*, sp_RRHH_SaludOcupacional_*, sp_RRHH_ObligacionesLegales_*, sp_Vacation_*

Archivos de stored procedures

Cada modulo tiene sus SPs organizados en archivos dedicados:

Archivo	Contenido
usp_ar.sql	Cuentas por cobrar
usp_ap.sql	Cuentas por pagar
usp_doc_sales.sql	Documentos de venta
usp_doc_purchase.sql	Documentos de compra
usp_acct.sql	Contabilidad basica
usp_acct_advanced.sql	Contabilidad avanzada (reportes)
usp_acct_fixedassets.sql	Activos fijos
usp_acct_templates.sql	Plantillas contables
usp_acct_equity.sql	Patrimonio
usp_acct_inflation.sql	Ajuste por inflacion
usp_inv.sql	Inventario
usp_inv_integracion.sql	Integracion inventario con otros modulos
usp_crm.sql	CRM
usp_crm_callcenter.sql	Call Center
usp_mfg.sql	Manufactura
usp_mfg_integracion.sql	Integracion manufactura
usp_fleet.sql	Flota
usp_logistics.sql	Logistica
usp_rbac.sql	Permisos RBAC
usp_audit.sql	Auditoria
usp_sec.sql	Seguridad
usp_cfg.sql	Configuracion
usp_ecommerce.sql	Ecommerce
usp_pay.sql	Pagos
usp_fiscal_tributaria.sql	Fiscal tributaria
usp_fiscal_retenciones.sql	Retenciones
sp_nomina_*.sql	Nomina (multiples archivos)
sp_rrhh_*.sql	RRHH (multiples archivos)
sp_pos_*.sql	POS
sp_restaurante_*.sql	Restaurante
sys_alertas.sql	Alertas del sistema
sys_notificaciones.sql	Notificaciones