OptimoSuite WMS API

Plataforma REST de Gestión de Almacenes — NewSoft Ideas

Build v1.0.0 · 31 Mar 2026
Estado
Operacional
Entorno
Production
Controllers
32
Endpoints
202
Endpoints Móvil
108
BD Servidor
.

Módulos

Inventario & Existencias

Stock en tiempo real, existencias por ubicación, palet y lote

WMS Core

Ingresos / Recibo

Órdenes de compra, recibo parcial/total, control de calidad

WMS Core

Salidas / Ventas

Despacho, consolidados, devoluciones, ajustes y tracking

WMS Core

Picking & Voice Picking

Órdenes de surtido, bloqueo exclusivo, daños, reserva y despacho

WMS Core

Transferencias

Movimientos entre bodegas y ubicaciones internas

WMS Core

Cuentas & Autenticación

Registro, login, JWT, roles admin, apps M2M, recuperación de contraseña

Seguridad

Seguridad & RBAC

Contratos, menú dinámico, permisos y bootstrap por usuario

Seguridad

Workflow

Máquina de estados: aprobaciones, transiciones, visibilidad

Seguridad

Móvil RF — Auth

Login JWT, registro de equipos, sesión, menú dinámico por perfil

Móvil

Móvil RF — Recibo

Recibo de mercancía desde PDA: OC, items, lotes, series, ubicación

Móvil

Móvil RF — Picking

Surtido dirigido/manual, consolidado, lotes, series, despacho

Móvil

Móvil RF — Movimientos

Artículos, palets, calidad, ajustes, reservas, reabasto

Móvil

Móvil RF — Inventario

Conteo físico, cíclico, ajuste automático, escaneo de códigos

Móvil

Móvil RF — Consultas

Stock por ubicación, palet y artículo; búsqueda por código/UPC

Móvil

Móvil RF — Bitácora

Registro batch de interacciones, sesiones, auditoría de procesos

Móvil

Reportes & Alertas

Generación dinámica (Word, Excel, DevExpress), alertas programadas

Reportes

Tarificador

Cálculo automático de tarifas, matriz de precios, importar/exportar

Sistema

Email & Dispositivos

Envío de correos SMTP, logging de eventos de dispositivos móviles

Sistema

Integraciones

SAP Business One, TMS, CRM (cotizaciones), WhatsApp (Twilio)

Sistema

Referencia Rápida — Endpoints Principales

MétodoEndpointDescripción
POST/api/cuentas/loginLogin de usuario → JWT
POST/api/cuentas/token-appToken M2M (client credentials)
POST/api/movil/auth/loginLogin móvil → JWT con claims
GET/api/movil/catalogos/estadosEstados de inventario
GET/api/movil/consultas/ubicacion/{id}Existencias en ubicación
POST/api/movil/ingresos/registrar-itemRegistrar ingreso de artículo
POST/api/movil/picking/confirmar-lineaConfirmar línea de surtido
POST/api/movil/movimientos/itemsMovimiento de artículo
POST/api/movil/inventario/conteoConteo físico
POST/api/movil/interaction-log/batchBatch de bitácora de sesión
GET/api/picking/ordersÓrdenes de picking pendientes
POST/api/picking/orders/{id}/completeCompletar orden de picking
POST/api/reports/{id}/renderGenerar reporte dinámico
POST/api/workflow/transicionEjecutar transición de estado

Consulta los 202 endpoints completos en Swagger.

Autenticación

JWT Bearer

Login de usuario con email/password. Token en header Authorization: Bearer <token>

Basic Auth (M2M)

Integraciones con client_id:client_secret. Soporta scopes.

Móvil RF

JWT con claims bod_id, equ_id, cia_id. Política EsMovil.

Explorar API — Swagger UI Panel de Trabajos — Hangfire