Ubicación Masiva de LPN's
Oracle Warehouse Management Cloud (LogFire) permite ubicar o realizar el acomodo masivo de múltiples contenedores de entrada (Inbound LPNs) de manera simultánea hacia una ubicación física específica de la instalación mediante una petición POST al endpoint de acción /entity/iblpn/bulk_locate.
Esta opción puede utilizarse para:
- Agilizar el proceso de acomodo (Putaway) de múltiples tarimas o contenedores en una sola transacción.
- Definir reglas operativas de despaletización automática (
depalletize_on_putaway_flg) durante el ingreso a la ubicación. - Reubicar inventario de manera masiva desde áreas de tránsito o andenes de recepción hacia ubicaciones de almacenamiento o producción.
Este proceso se utiliza para el acomodo, reubicación y despaletización masiva (POST) de registros de contenedores existentes dentro de la estructura de Oracle WMS Cloud.
Para comprender las reglas de acomodo y las directrices de los recursos de inventario de entrada en Oracle WMS REST API, puedes consultar la guía de Oracle Cloud: https://docs.oracle.com/en/cloud/saas/warehouse-management/26b/owmre/locate-inbound-lpn.html
Para ejecutar acciones de ubicación masiva sobre LPNs, el usuario de la integración requiere permisos de modificación de inventario y ejecución de tareas de Putaway en LogFire (como el rol de integración de servicios web ocswebservice o perfiles con privilegios de supervisor de almacén).
De lo contrario, la API responderá con un error de autorización 401 Unauthorized o 403 Forbidden.
1. Flujo
2. API
Método: POST
URL: <url_base_wms>/wms/lgfapi/v10/entity/iblpn/bulk_locate
<url_base_wms>: Debe reemplazarse por el host y ambiente de Oracle WMS Cloud.- Este endpoint permite acomodar o reubicar de manera masiva un listado de LPNs de entrada (
iblpn) hacia una ubicación física específica dentro del almacén.
3. Headers
| Header | Descripción | Valor |
|---|---|---|
Content-Type | Indica que la información enviada en el cuerpo está en formato JSON. | application/json |
Authorization | Credenciales de autenticación HTTP Basic para Oracle WMS Cloud. | Basic <usuario:contraseña> |
4. Columnas de entrada (Request)
La solicitud se envía con el método POST y un cuerpo JSON compuesto por dos secciones:
parameters: Contiene los criterios para filtrar e identificar los LPNs que van a ser ubicados.options: Define la ubicación de destino y las reglas operativas aplicables al proceso de acomodo.
4.1 Criterios de Selección de LPNs (parameters)
| Campo | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
id__in | Array (Numbers) | Sí | Listado de IDs internos del sistema correspondientes a los LPNs (iblpn) que se desea ubicar. | [85549] |
4.2 Opciones de Ubicación y Operación (options)
| Campo | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
location_barcode | String | Sí | Código de barras de la ubicación física de destino (ej. pasillo, andén, rack o área de producción). | AO |
depalletize_on_putaway_flg | Boolean | Sí | Bandera que define si el LPN debe despaletizarse o desagruparse automáticamente al momento de realizar el acomodo. | true |
5. Ejemplo de Solicitud
A continuación se muestra el ejemplo de consumo mediante cURL para realizar el acomodo masivo del LPN con ID interno 85549 en la ubicación AO:
curl --location 'https://te6.wms.ocs.oraclecloud.com/alpura_test/wms/lgfapi/v10/entity/iblpn/bulk_locate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic YWxwd2Vic2VydmljZTpBbHB1cmEwMQ==' \
--data '{
"parameters": {
"id__in": [85549]
},
"options": {
"location_barcode": "AO",
"depalletize_on_putaway_flg": true
}
}'
Antes de ejecutar el comando curl, verifique que: Los identificadores numéricos de los LPNs enviados en id__in existan en la base de datos de alpura_test y se encuentren en un estado válido para su acomodo (ej. en andén de recepción o tránsito interno).
La ubicación de destino (location_barcode) exista en el maestro de ubicaciones de WMS y tenga capacidad disponible para recibir inventario.
El comportamiento del flag depalletize_on_putaway_flg esté alineado con el proceso físico de tu operación en Alpura (despaletizar o mantener la tarima unificada).
6. Ejemplo de Respuesta
6.1 Respuesta Exitosa (200 OK)
{
"success": true,
"response": {
"message": "Ubicación masiva de contenedores realizada con éxito.",
"processed_count": 1,
"location_barcode": "AO"
}
}
6.2 Respuesta con Error (400 Bad Request / 404 Not Found)
Si la ubicación de destino no existe o el LPN no está en un estado elegible:
{
"success": false,
"response": {
"message": "Falló el proceso de ubicación masiva.",
"errors": [
{
"key": "location_barcode",
"msg": "La ubicación física 'AO' no existe o está inactiva."
}
]
}
}