Consulta de LPN's
Oracle Warehouse Management Cloud (Oracle WMS Cloud) permite consultar la información operativa de los contenedores y tarimas de entrada (IBLPN - Inbound License Plate Number) a través de su interfaz REST lgfapi mediante una petición GET.
Esta opción puede utilizarse para:
- Consultar el estado operativo actual (
status_id) de una tarima o bulto recibido en almacén. - Obtener el identificador interno numérico (
id) de WMS necesario para transacciones posteriores de inventario o reubicación. - Validar la existencia física y digital de un contenedor de entrada antes de ejecutar transferencias hacia producción o despacho.
- Sincronizar el estatus de tarimas entre sistemas Manufacturing Execution System/ERP y el piso operativo del Centro de Distribución.
Un IBLPN (Inbound LPN) representa la unidad básica de empaque o carga (tarima, caja, contenedor) que ingresa y se almacena en el almacén de Oracle WMS.
Para revisar la referencia de entidades y parámetros disponibles en la API de Oracle WMS Cloud (LogFire API), consulta la documentación oficial:
https://docs.oracle.com/en/cloud/saas/warehouse-management/
El consumo de la API lgfapi requiere un usuario de sistema configurado con acceso a la compañía y facilidad correspondiente (Instancia de WMS) y permisos de lectura sobre el módulo de inventario y contenedores. Sin estas credenciales, el servicio devolverá error de autenticación 401 Unauthorized.
Para Sistemas existe el Grupo ALP_WMS_TI con los privilegios asignados por Negocio
1. Flujo
2. API
Método: GET
URL: <url_base_wms>/wms/lgfapi/v10/entity/iblpn
3. Headers
| Header | Descripción | Valor |
|---|---|---|
Content-Type | Formato de datos esperado para la integración. | application/json |
Authorization | Credenciales de autenticación HTTP Basic configuradas para el entorno WMS. | Basic <usuario:contraseña> |
4. Parámetros de Entrada (Request)
Al ser una petición de consulta, los parámetros se transmiten como Query Parameters en la URL para filtrar y delimitar los campos devueltos en la respuesta.
4.1 Parámetros de Consulta (Query Params)
| Parámetro | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
orig_container_nbr | String | Sí | Número o código original del contenedor/tarima a buscar. | 70499900000004 |
fields | String | No | Lista delimitada por comas de atributos específicos a devolver en la respuesta para optimizar la transferencia de datos. | id,container_nbr,status_id |
5. Ejemplo de Solicitud
A continuación se muestra el ejemplo estándar de consumo mediante cURL estructurado para una consulta limpia:
curl --location --request GET '<url_base_wms>/wms/lgfapi/v10/entity/iblpn?orig_container_nbr=70499900000004&fields=id%2Ccontainer_nbr%2Cstatus_id' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <credenciales_en_base64>'
Antes de ejecutar el comando curl, se debe reemplazar el valor <url_base_wms> por el host de la instancia de Oracle Cloud WMS deseada (TEST, TEST2), según el ambiente en el que se requiera realizar la operación.
6. Ejemplo de Respuesta
{
"result_count": 2,
"page_count": 1,
"page_nbr": 1,
"next_page": null,
"previous_page": null,
"results": [
{
"id": 137,
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/iblpn/137",
"create_user": "OCS_EANGELES",
"create_ts": "2025-07-01T02:04:08.835135-06:00",
"mod_user": "OCS_EANGELES",
"mod_ts": "2026-03-01T05:16:50.623293-06:00",
"facility_id": {
"id": 3,
"key": "GPR",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/facility/3"
},
"company_id": {
"id": 1,
"key": "ALPURA",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/company/1"
},
"container_nbr": "12400000170011-137",
"type": "I",
"status_id": 90,
"vas_status_id": 0,
"curr_location_id": null,
"prev_location_id": {
"id": 16764,
"key": "ANDEN-FRIOS-0-0",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/location/16764"
},
"priority_date": null,
"pallet_id": null,
"rcvd_shipment_id": {
"id": 187,
"key": "INICIAL_GPR1_30062025",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/ib_shipment/187"
},
"rcvd_ts": "2025-07-01T02:04:08.830317-06:00",
"rcvd_user": "OCS_EANGELES",
"weight": "209.92",
"volume": "0.256",
"pick_user": "",
"pack_user": "",
"putawaytype_id": null,
"ref_iblpn_nbr": "",
"ref_shipment_nbr": "",
"ref_po_nbr": "",
"ref_oblpn_nbr": "",
"first_putaway_ts": "2025-07-03T06:06:31.639964-06:00",
"parcel_batch_flg": false,
"lpn_type_id": null,
"cart_posn_nbr": "0",
"audit_status_id": 10,
"qc_status_id": 0,
"asset_id": null,
"asset_seal_nbr": "",
"price_labels_printed": false,
"comments": "",
"actual_weight_flg": false,
"length": "0",
"width": "0",
"height": "0",
"rcvd_trailer_nbr": "",
"orig_container_nbr": "12400000170011",
"pallet_position": "",
"inventory_lock_set": {
"result_count": 1,
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/inventory_lock/?containerlockxref__container_id=137"
},
"nbr_files": 0,
"cust_field_1": "",
"cust_field_2": "",
"cust_field_3": "",
"cust_field_4": "",
"cust_field_5": "",
"cart_nbr": ""
},
{
"id": 18711,
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/iblpn/18711",
"create_user": "OCS_EANGELES",
"create_ts": "2026-03-01T05:16:50.643032-06:00",
"mod_user": "OCS_EANGELES",
"mod_ts": "2026-03-30T09:55:40.727154-06:00",
"facility_id": {
"id": 3,
"key": "GPR",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/facility/3"
},
"company_id": {
"id": 1,
"key": "ALPURA",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/company/1"
},
"container_nbr": "12400000170011",
"type": "I",
"status_id": 30,
"vas_status_id": 0,
"curr_location_id": {
"id": 16747,
"key": "TRANSITO-00-00-F",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/location/16747"
},
"prev_location_id": null,
"priority_date": null,
"pallet_id": null,
"rcvd_shipment_id": {
"id": 1125,
"key": "INICIAL_GPR01032026",
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/ib_shipment/1125"
},
"rcvd_ts": "2026-03-01T05:16:50.641678-06:00",
"rcvd_user": "OCS_EANGELES",
"weight": "1286.592",
"volume": "1.536",
"pick_user": "",
"pack_user": "",
"putawaytype_id": null,
"ref_iblpn_nbr": "",
"ref_shipment_nbr": "",
"ref_po_nbr": "",
"ref_oblpn_nbr": "",
"first_putaway_ts": "2026-03-30T09:55:40.716824-06:00",
"parcel_batch_flg": false,
"lpn_type_id": null,
"cart_posn_nbr": "",
"audit_status_id": 10,
"qc_status_id": 0,
"asset_id": null,
"asset_seal_nbr": "",
"price_labels_printed": false,
"comments": "",
"actual_weight_flg": false,
"length": "0",
"width": "0",
"height": "0",
"rcvd_trailer_nbr": "",
"orig_container_nbr": "12400000170011",
"pallet_position": "",
"inventory_lock_set": {
"result_count": 1,
"url": "https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/inventory_lock/?containerlockxref__container_id=18711"
},
"nbr_files": 0,
"cust_field_1": "",
"cust_field_2": "",
"cust_field_3": "",
"cust_field_4": "",
"cust_field_5": "",
"cart_nbr": ""
}
]
}