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.
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.
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
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
| FlexFields | Proyecto |
|---|---|
ALP_AREAS | Alpura9 |
2. Flujo
3. API
Método: POST
URL: <url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/<ValueSetName>/child/values
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
| 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 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ámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
ValueSetName | String (Path) | Identificador único del juego de valores en Oracle Cloud. | ALP_AREAS |
5.2 Datos de la Solicitud de Creación (JSON Body)
| Campo | Descripción | Ejemplo |
|---|---|---|
Value | Código alfanumérico o identificador del nuevo valor/área. | NEW AREA |
Description | Glosa o descripción detallada del área de negocio. | NEW AREA |
EnabledFlag | Bandera que indica si el registro se crea activo (Y) o inactivo (N). | Y |
StartDateActive | Fecha de inicio de vigencia del registro (Formato YYYY-MM-DD). | null |
EndDateActive | Fecha 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
}'
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": [ ]
}