Skip to main content

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.
info

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.

Documentación Oficial de Oracle

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

Requisito de autorización y seguridad

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

Parámetros de Endpoint y Operación
  • <url_wms>: Debe reemplazarse por el host y ambiente de Oracle WMS Cloud (ej. https://te6.wms.ocs.oraclecloud.com/alpura_test para 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​

HeaderDescripciónValor
Content-TypeIndica que la información enviada en el cuerpo está en formato JSON.application/json
AuthorizationCredenciales 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)​

CampoTipoRequeridoDescripciónEjemplo
facility_idNumberCondicionalIdentificador numérico interno de la instalación/almacén en WMS.3
facility_id__codeStringCondicionalAlternativa para enviar la instalación mediante su código de texto (ej. GPR).GPR
company_id__codeStringSíCódigo alfanumérico de la compañía a la que pertenece la secuencia.ALPURA
counter_codeStringSíNombre o clave del contador configurado en WMS (ej. LPNs ciegos o de recepción).BLIND_LPN_NBR
sub_codeStringOpcionalSubclasificación o prefijo adicional si el contador así lo requiere.null

4.2 Opciones de Generación (options)​

CampoTipoRequeridoDescripciónEjemplo
countIntegerOpcionalCantidad 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
}
}'
Nota:

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."
}
]
}
}