Skip to main content

Creación de Valores en FlexFields

Oracle Fusion Cloud Common Applications permite crear y dar de alta nuevos valores de un Value Set específico de forma automatizada mediante una petición POST. En este caso particular, se utiliza para registrar nuevas áreas de negocio dentro del conjunto de valores ALP_AREAS.

Esta opción puede utilizarse para:

  • Sincronizar FlexFields de Alpura de forma bidireccional desde sistemas periféricos.
  • Automatizar la creación de nuevos Valores en FlexFields existentes en Oracle Cloud sin intervención manual.
  • Mantener la integridad de catálogos maestros entre aplicaciones locales y la nube.
info

Este proceso se utiliza para la creación y alta (POST) de nuevos valores en el módulo de Flexfields/Value Sets de Oracle Cloud.

Documentación Oficial de Oracle

Para comprender la estructura 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/applications-common/25c/farca/op-servername-fscmrestapi-resources-11.13.18.05-valuesets-valuesets_id-child-values-post.html

Requisito de autorización y seguridad

Para realizar altas sobre los Value Sets de Oracle Applications, el usuario de la integración requiere permisos de escritura sobre configuraciones de Application Toolkit o Application Core (como el rol de Integration Specialist o roles de administración del catálogo FND).

De lo contrario, la API responderá con un error de autorización 401 Unauthorized o 403 Forbidden.


1. FlexFields en Proyectos​

FlexFieldsProyecto
ALP_AREASAlpura9

2. Flujo​


3. API​

Método: POST

URL: <url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/<ValueSetName>/child/values

Parámetro de Ruta (Path Parameter)

El segmento <ValueSetName> en la URL debe ser reemplazado por el código del juego de valores en el cual deseas dar de alta el nuevo registro.


4. 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 Fusion Cloud.Basic <usuario:contraseña>

5. Columnas de entrada (Request)​

Al tratarse de una petición de tipo POST, se requiere enviar en el cuerpo de la solicitud (body) los atributos del nuevo valor que se desea integrar al catálogo.


5.1 Parámetro de Ruta (Obligatorio)​

ParámetroTipoDescripciónEjemplo
ValueSetNameString (Path)Identificador único del juego de valores en Oracle Cloud.ALP_AREAS

5.2 Datos de la Solicitud de Creación (JSON Body)​

CampoDescripciónEjemplo
ValueCódigo alfanumérico o identificador del nuevo valor/área.NEW AREA
DescriptionGlosa o descripción detallada del área de negocio.NEW AREA
EnabledFlagBandera que indica si el registro se crea activo (Y) o inactivo (N).Y
StartDateActiveFecha de inicio de vigencia del registro (Formato YYYY-MM-DD).null
EndDateActiveFecha de fin de vigencia del registro (Formato YYYY-MM-DD).null

6. Ejemplo de Solicitud​

A continuación se muestra el ejemplo de consumo mediante cURL para realizar el alta del nuevo valor dentro de ALP_AREAS (omitiendo cabeceras dinámicas e inestables de Akamai para mayor claridad y permanencia de la documentación):

curl --location '<url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/ALP_AREAS/child/values' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic c29hOjFudDNyZmEy' \
--data '{
"Value": "NEW AREA",
"Description": "NEW AREA",
"EnabledFlag": "Y",
"StartDateActive": null,
"EndDateActive": null
}'

Nota:

Antes de ejecutar el comando curl, se debe reemplazar el valor <url_oracle> por el host de la instancia de Oracle Cloud deseada (DEV, UAT o PROD), según el ambiente en el que se requiera realizar la operación.

Verifique que la URL corresponda al ambiente correcto y que las credenciales utilizadas en el encabezado Authorization tengan los permisos necesarios para crear o actualizar valores en el juego de valores ALP_AREAS.


7. Ejemplo de Respuesta​

{
"ValueId": 688776,
"IndependentValue": null,
"IndependentValueNumber": null,
"IndependentValueDate": null,
"IndependentValueTimestamp": null,
"Value": "NEW AREA",
"ValueNumber": null,
"ValueDate": null,
"ValueTimestamp": null,
"TranslatedValue": null,
"Description": "NEW AREA",
"EnabledFlag": "Y",
"StartDateActive": null,
"EndDateActive": null,
"SortOrder": null,
"SummaryFlag": null,
"DetailPostingAllowed": null,
"DetailBudgetingAllowed": null,
"AccountType": null,
"ControlAccount": null,
"ReconciliationFlag": null,
"FinancialCategory": null,
"ExternalDataSource": null,
"CreationDate": "2026-10-27T17:47:34+00:00",
"CreatedBy": "1549612",
"LastUpdateDate": "2026-10-27T17:47:34.973+00:00",
"LastUpdatedBy": "1549612",
"links": [ ]
}