Inventory API

API operativa

Inventario y recepción, por API

Catálogo, existencias, lotes y recepción por ASN de un WMS, expuestos como REST sobre el ERP. Sin panel: la app móvil y los integradores hablan directo con estos endpoints.

Capacidades

Lo que resuelve

Tres cosas, y las tres contra el inventario real del ERP: consultar lo que hay, recibir lo que llega y dejar registro de cada movimiento.

Catálogo y existencias

Productos, almacenes, lotes y ubicaciones, siempre acotados a la empresa del usuario. Incluye escaneo por código exacto: si el producto está en otra bodega la respuesta lo dice, con cuánto hay y dónde.

Recepción por ASN

El operador escanea el folio del packing slip y recibe la precarga completa. Al cerrar, la API valida lo escaneado contra lo esperado y genera la entrada de inventario con un lote por tarima.

Importar entradas

El Excel o CSV del cliente se sube, se revisa y se confirma. Las columnas se deducen del encabezado, así que el archivo puede cambiar de forma sin romper la carga, y un folio no entra dos veces.

Superficie

Endpoints por grupo

Todos bajo /api, todos con la misma envoltura de respuesta. El detalle de cada uno, con su forma y un ejemplo real, está en la documentación.

Autenticación

/auth/login · /auth/user · /auth/logout · /auth/forgot-password

Escaneo

/escaneo · /escaneo/validar/serie · /escaneo/validar/lote · /escaneo/validar/pedimento

Recepción por ASN

/asn · /asn/escaneo/{id} · /asn/{id}/etiquetas · /etiquetas/medidas

Importación de entradas

/entradas/importar · /entradas/importar/{uuid}/confirmar

Catálogo

/productos · /almacenes · /lotes/{id} · /catalogos · /ubicaciones · /alertas-stock

Documentos y conteos

/entradas · /salidas · /traspasos · /conteos

Acceso

Token y listo

# 1. Obtener el token
curl -X POST https://api.wdi.com.mx/api/auth/login \
  -H 'Accept: application/json' \
  -d 'username=tu_usuario' \
  -d 'password=tu_contrasena'

# 2. Usarlo en todo lo demas
curl https://api.wdi.com.mx/api/productos \
  -H 'Authorization: Bearer <token>' \
  -H 'Accept: application/json'
  • Token Bearer de Sanctum, válido un día. No hay registro público: las cuentas salen del ERP.
  • Toda respuesta correcta viene como { status, message, data }; los errores, como { errors: [...] }.
  • El alcance va por empresa y por almacén asignado. Un almacén que no te toca responde 404, no 403.
  • Cada endpoint está documentado con su forma de respuesta y un ejemplo tomado de datos reales.