Creación de Etiquetas Ciegas
Oracle Fusion Cloud Common Applications permite modificar y actualizar parcialmente los atributos de un valor existente dentro de un Value Set específico mediante una petición PATCH.
Esta opción puede utilizarse para:
- Actualizar descripciones de FlexFields forma dinámica ante cambios.
- Habilitar o deshabilitar temporalmente áreas operativas cambiando la bandera de estado.
- Configurar o ajustar rangos de fechas de vigencia para el uso de los valores del catálogo.
Este proceso se utiliza para la modificación y actualización parcial (PATCH) de registros existentes dentro de la estructura de Value Sets de Oracle Cloud.
Para comprender la jerarquía de Value Sets y recursos REST de Oracle Application Common Feature, puedes consultar la guía de Oracle REST APIs:
https://docs.oracle.com/en/cloud/saas/supply-chain-and-manufacturing/25c/fasrp/op-processworkorders-processworkordersuniqid-child-processworkorderdff-workorderid-patch.html
Para realizar modificaciones sobre los Value Sets de Oracle Applications, el usuario de la integración requiere permisos de edición/escritura sobre configuraciones de Application Toolkit o Application Core (como el rol de Integration Specialist o roles de administración de catálogos FND).
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_wms>/wms/lgfapi/v10/entity/seq_counter/get_next_number
<url_wms>: Debe reemplazarse por el host y ambiente de Oracle WMS Cloud (ej.https://te6.wms.ocs.oraclecloud.com/alpura_testpara pruebas o el dominio correspondiente a producción).- Este endpoint permite consultar y reservar el siguiente consecutivo filtrando por criterios de negocio dentro del objeto
parameters. Si ya se conoce el identificador numérico interno del contador, también puede invocarse como<url_wms>/wms/lgfapi/v10/entity/seq_counter/<id>/get_next_number.
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 que se divide en dos secciones principales:
parameters: Criterios de filtro para identificar de forma unívoca el contador en la instalación y compañía deseada.options: Parámetros de control sobre la cantidad de folios que se desean reservar.
4.1 Criterios de Selección del Contador (parameters)
| Campo | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
facility_id | Number | Condicional | Identificador numérico interno de la instalación/almacén en WMS. | 3 |
facility_id__code | String | Condicional | Alternativa para enviar la instalación mediante su código de texto (ej. GPR). | GPR |
company_id__code | String | Sí | Código alfanumérico de la compañía a la que pertenece la secuencia. | ALPURA |
counter_code | String | Sí | Nombre o clave del contador configurado en WMS (ej. LPNs ciegos o de recepción). | BLIND_LPN_NBR |
sub_code | String | Opcional | Subclasificación o prefijo adicional si el contador así lo requiere. | null |
4.2 Opciones de Generación (options)
| Campo | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
count | Integer | Opcional | Cantidad de folios consecutivos que se reservarán y retornarán (por defecto 1, máximo 1000). | 1 |
5. Ejemplo de Solicitud
A continuación se muestra el ejemplo de consumo mediante cURL para generar el siguiente número de LPN ciego (BLIND_LPN_NBR) para el almacén con ID 3 y compañía ALPURA:
curl --location 'https://te6.wms.ocs.oraclecloud.com/alpura_test/wms/lgfapi/v10/entity/seq_counter/get_next_number' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic YWxwd2Vic2VydmljZTpBbHB1cmEwMQ==' \
--data '{
"parameters": {
"facility_id": 3,
"company_id__code": "ALPURA",
"counter_code": "BLIND_LPN_NBR"
},
"options": {
"count": 1
}
}'
Antes de ejecutar el comando curl, verifique que: El contador (counter_code) se encuentre previamente creado y activo en la pantalla Sequence Counter (Contadores de Secuencia) de Oracle WMS para la compañía y almacén solicitados.
El usuario de integración cuente con permisos vigentes sobre la compañía ALPURA y la instalación seleccionada.
Cada llamada exitosa consume y reserva los números solicitados en la base de datos de WMS de manera irreversible para garantizar que no existan folios duplicados.
6. Ejemplo de Respuesta
6.1 Respuesta Exitosa (200 OK)
Al reservar un único folio ("count": 1):
{
"next_number_list": [
"70499900000022"
]
}
6.2 Respuesta con Error (400 Bad Request / 404 Not Found)
Si los parámetros no localizan un contador activo en WMS:
{
"success": false,
"response": {
"message": "Falló la obtención del siguiente consecutivo.",
"errors": [
{
"key": "counter_code",
"msg": "No se encontró ningún contador de secuencia para los filtros especificados."
}
]
}
}