API Zeus ERP & POS — Documentación Funcional

API Zeus ERP & POS — Documentación Funcional

Base URL: https://api.infosis.tech/zeus  |  Formato: REST / JSON

Autenticación

Todas las solicitudes requieren el header Authorization con el token del usuario. El header X-Tenant es opcional y se usa para operaciones multi-empresa.

Authorization: Bearer <token>
X-Tenant: <identificador-de-empresa>   (opcional)

Los errores de autenticación devuelven HTTP 401. Accesos no permitidos devuelven HTTP 403.

Paginación

Los endpoints que devuelven listas aceptan los parámetros page (número de página, desde 0) y size (resultados por página). La respuesta incluye metadatos con el total de elementos y páginas disponibles.

Módulos principales

Artículos — /articulo

Gestión completa del catálogo de productos.

• GET /articulo — Lista todos los artículos.
• GET /articulo/{id} — Obtiene un artículo por ID.
• GET /articulo/page — Lista paginada. Acepta page, size y franchised.
• GET /articulo/search — Búsqueda con filtros personalizados por columnas.
• POST /articulo — Crea un artículo nuevo.
• PUT /articulo — Actualiza un artículo existente.
• PATCH /articulo — Actualización parcial de campos.
• DELETE /articulo/{id} — Elimina un artículo por ID.
• GET /articulo/{id}/stock — Stock de un artículo por depósito.
• GET /articulo/stocks — Stock de todos los artículos, filtrable por warehouseIds.
• GET /articulo/batch?ids= — Obtiene múltiples artículos por IDs.
• POST /articulo/batch — Crea múltiples artículos a la vez.
• PATCH /articulo/prices — Actualiza precios y porcentajes masivamente.
• PATCH /articulo/costs — Recalcula precios desde costos.

Categorías de artículo: /articulo/categoria — CRUD completo + paginación + batch.
Tipos de artículo: /articulo/tipo — CRUD completo + paginación + batch.
Artículos secundarios: /articulo/sec — CRUD completo.
Códigos de barra: /codigo-de-barra — CRUD + búsqueda por código o por artículo.

Catálogo — /catalogo

Vista optimizada del catálogo para e-commerce y punto de venta.

• GET /catalogo — Listado paginado con filtros: query, categorias, marcas, group, depositos, minPrice, maxPrice, inStock, active, priceList, sortBy, sortDir.
• GET /catalogo/producto/{id} — Detalle de un producto con precio de lista.
• POST /catalogo/producto/batch — Obtiene múltiples productos en una llamada.
• POST /catalogo/imagenes/batch — Obtiene imágenes de múltiples productos a la vez.

Clientes — /cliente

• GET /cliente — Lista todos los clientes.
• GET /cliente/{id} — Obtiene un cliente por ID.
• GET /cliente/search — Búsqueda filtrada y paginada.
• POST /cliente — Crea un cliente.
• PUT /cliente — Actualiza un cliente.
• PATCH /cliente — Actualización parcial.
• DELETE /cliente/{id} — Elimina un cliente.
• GET /cliente/{id}/saldo — Saldo pendiente del cliente en una sucursal (requiere sucursal).
• GET /cliente/account/{id} — Balance de cuenta del cliente.
• GET /cliente/address/{id} — Direcciones registradas del cliente.

Categorías de cliente: /cliente/categoria — CRUD completo + paginación + batch.

Stock e Inventario

• GET /articulo/stocks — Stock de todos los artículos por depósito.
• GET /articulo/{id}/stock?warehouseIds=1&warehouseIds=2 — Stock de un artículo en depósitos específicos.
• /inventario — Gestión de inventario.
• /mov-stock — Movimientos de stock.
• /tran-stock — Transacciones de stock.

Cajas — /cajas

• GET /cajas — Lista todas las cajas.
• GET /cajas/{id} — Obtiene una caja por ID.
• GET /cajas/page — Lista paginada.
• CRUD completo disponible.
• /cajas/concepto — Conceptos de caja: CRUD + paginación.

Bancos — /banco

• GET /banco — Lista de bancos.
• POST /banco/movimiento — Consulta movimientos bancarios por filtros.
• POST /banco/movimiento/saldos — Consulta saldos bancarios.
• POST /banco/movimiento/save — Registra una conciliación bancaria.
• GET /banco/movimiento/{id} — Movimientos de una cuenta específica.

Otros módulos disponibles

/proveedor, /vendedor, /sucursal, /empresa, /usuario, /lista, /deposito, /factura, /recibo, /remito-vta, /transaccion, /promo, /asientos, /ecommerce, /webhook-bridge, /retenciones, /tarjetas, /moneda.

Códigos de respuesta HTTP

Código	Significado
200	Operación exitosa
201	Recurso creado correctamente
204	Sin contenido (eliminación exitosa)
401	No autenticado — token ausente o inválido
403	Sin permisos para el recurso solicitado
404	Recurso no encontrado

Ejemplos de uso frecuente

Consultar stock de un artículo en depósitos específicos:

GET /articulo/{id}/stock?warehouseIds=1&warehouseIds=2

Buscar artículos por nombre o código:

GET /articulo/search?filter=zapatilla&filters=

Catálogo paginado con lista de precios y filtro de stock:

GET /catalogo?page=0&size=20&priceList=1&query=camisa&inStock=true

Consultar saldo pendiente de un cliente:

GET /cliente/{id}/saldo?sucursal=1