Manage Legal Entity Setup Task Guidance
Purpose
Provides task-specific setup planning, routing, export, import, and validation guidance for Manage Legal Entity under Legal Structures.
Setup Task Skill Contract
- task_code:
XLE_MANAGE_LEGAL_ENTITY
- task_name:
Manage Legal Entity
- parent_skill_id:
erp.financials.legal-structures
- pillar:
ERP
- offering:
Financials
- functional_area:
Legal Structures
- functional_area_code:
ORA_ASK_LEGAL_STRUCTURES
- available_flag:
Y
- export_import_supported_flag:
Y
- csv_export_import_supported_flag:
Y
- source_catalog:
knowledge/setup-task-catalog/effective/setupTasksAll.json
Usage
Use this skill when planning, sequencing, exporting, importing, or validating setup data for Manage Legal Entity under Legal Structures.
Country and Identifying Jurisdiction
Load the reference lookup rules and
the country/default mappings before
resolving a CREATE candidate. Use territoriesLOV followed by the minimal-field
addressGeographies country lookup. The selected primary country's
GeographyValue supplies GeographyName; retain TerritoryShortName separately.
The address lookup does not expose GeographyId, and obtaining a country ID is
not a prerequisite for this flow.
Reuse the user's identifying-jurisdiction name/search text or ask for it when
missing. Resolve it with legalJurisdictionsLOV, obtain an explicit choice if
multiple eligible records match, and verify the selected exact import name is
unambiguous. Name, identifying flag, and effective-date checks do not independently
prove jurisdiction-to-country association. Preserve that disclosure and the
documented GeographyElement1 derivation limit in the package preview.
These lookups run only at the existing LE.RESOLVE_REFERENCES step through the
declared REST client and selected environment. The changes apply to the main LRU
and registration rows authored within this LE aggregate; they do not alter the
separate Manage Legal Reporting Unit or Manage Legal Jurisdictions skills.
Setup Task Metadata
- Task name:
Manage Legal Entity
- Task code:
XLE_MANAGE_LEGAL_ENTITY
- Available:
Y
- Export/import supported:
Y
- CSV export/import supported:
Y
- CSV export/import routing:
supported
CSV Export, Import, and Validation Workflow
CSVExportImportSupportedFlag is Y for this task, so route task setup data work through the relevant skills:
- Export setup task data with
shared.setup-export.task-level-export.
- Validate setup task data with
shared.validation.setup-data-validator.
- Validate reference data with
shared.validation.reference-data-validator.
- Load the task-local
ora-resource/ora_rule_registry.json and run its referenced input, lookup, dependency, defaulting, design, error-handling, and final-package-readiness checks. The ora-resource graph validates the candidate; it does not create a Fusion mutation.
- Prepare the FSM archive locally using the contract below.
- Hand the exact final archive to
core.data-loader only after the local workflow returns READY_FOR_DATA_LOADER_PREVIEW.
Use this task metadata when invoking those skills:
- Offering:
Financials
- Functional area / Setup Object:
Legal Structures
- Setup task name:
Manage Legal Entity
- Setup task code:
XLE_MANAGE_LEGAL_ENTITY
Local-Only FSM Package Preparation
This assisted workflow prepares a package locally and stops before upload or any Fusion mutation.
- Require a fresh, same-target, same-release, successful same-task FSM export as the immutable baseline. Bind the exact environment and task identity, current
ASM_SETUP_CSV_METADATA.xml, the exact current entity-tree hierarchy and all six CSV members, exact header spelling and order, and the exported encoding.
- Re-run the complete task ora-resource graph against the reviewed inputs and baseline. Fail closed with a task-specific package-contract gap if any source, mapping, value, member hierarchy, header, encoding, carrier, or aggregate rule is missing or ambiguous; do not invent a package contract.
- Build the smallest supported UI-equivalent semantic delta from the task resources: the legal-entity root, its same-name main legal reporting unit, its identifying legal-entity registration, and the identifying main-LRU registration. Preserve all six current CSV members, all required unchanged parent rows, every unrelated row, and every untouched archive member. Preserve existing registration-function rows unchanged and add zero candidate function rows. Keep a registration-function member header-only only when it is already header-only in the baseline.
- Do not copy physical IDs, audit fields, object-version fields, ESS fields, or service-owned values from the baseline or another row. Copy a value only when the task resources explicitly authorize it as a carrier.
- Produce a ZIP-valid immutable FSM archive, its SHA-256 digest, a member inventory, a row/member semantic diff against the baseline, and a sanitized package-preparation receipt containing no secrets or sensitive payload values.
- Any source, mapping, value, package byte, member inventory, or hash change invalidates this preview state and requires the full validation and package-preparation workflow to run again.
- On success, return
READY_FOR_DATA_LOADER_PREVIEW. Do not claim READY_FOR_IMPORT or approval. Stop before upload or mutation and hand the exact immutable archive to core.data-loader, which owns Task Hook validation, preview, explicit approval, archive-hash verification, upload, and initiation.
Inputs
implementation_objective
project_context
setup_task_scope
setup_data_artifacts
Outputs
setup_task_plan
setup_data_routing
validation_checkpoints
skill_run_record
token_usage_record
Implementation Notes
Use the parent functional-area skill erp.financials.legal-structures for functional-area sequencing and scope decisions. Track token usage for any generated project artifact or skill-run record using the manifest policy.
1---2skill_id: "erp.financials.legal-structures.manage-legal-entity"3name: manage-legal-entity-setup-task-guidance4description: "Provides task-specific setup guidance for Manage Legal Entity under the Legal Structures functional area."5layer: "pillar"6pillar: "ERP"7offering: "Financials"8functional_area: "Legal Structures"9functional_area_code: "ORA_ASK_LEGAL_STRUCTURES"10task_code: "XLE_MANAGE_LEGAL_ENTITY"11task_name: "Manage Legal Entity"12parent_skill_id: "erp.financials.legal-structures"13available_flag: "Y"14export_import_supported_flag: "Y"15csv_export_import_supported_flag: "Y"16dataloader_import_mode: "FSM"17businessObject: ""18source_catalog: "knowledge/setup-task-catalog/effective/setupTasksAll.json"19type: "planning"20execution_mode: "assisted"21owner_team: "ERP financials pillar team"22version: "0.1.0"23inputs:24 - "implementation_objective"25 - "project_context"26 - "setup_task_scope"27 - "setup_data_artifacts"28outputs:29 - "setup_task_plan"30 - "setup_data_routing"31 - "validation_checkpoints"32 - "skill_run_record"33 - "token_usage_record"34depends_on:35 - "shared.setup-export.task-level-export"36 - "shared.validation.setup-data-validator"37 - "shared.validation.reference-data-validator"38 - "core.data-loader"39uses_core:40 - "core.fusion-api.rest-api-client"41 - "core.project-mgmt.artifact-version-manager"42 - "core.project-mgmt.artifact-registry-manager"43 - "core.project-mgmt.project-state-manager"44persists_project_state: true45token_usage_tracking:46 enabled: true47 granularity: "per_skill_run"48 artifact_type: "token_usage_record"49 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"50 estimation_method: "chars/4 estimate unless exact tokenizer or API accounting is available"51 required_fields:52 - "activity_start_time"53 - "skill_id"54 - "task"55 - "trigger"56 - "artifacts_written"57 - "files_read"58 - "estimated_input_tokens"59 - "estimated_output_tokens"60 - "estimated_total_tokens"61 - "estimation_method"62 - "notes"63state_updates:64 - "setup_task_sequence"65 - "configuration_blueprints"66 - "validation_results"67 - "token_usage_records"68workspace_outputs:69 - artifact_type: "configuration_blueprint"70 default_location: "project/{project_id}/artifacts/pillars/erp/financials/legal-structures/manage-legal-entity/current/"71 versioning_policy: "major-new-version-minor-confirm-update"72 - artifact_type: "validation_result"73 default_location: "project/{project_id}/artifacts/pillars/erp/financials/legal-structures/manage-legal-entity/current/"74 versioning_policy: "major-new-version-minor-confirm-update"75 - artifact_type: "skill_run"76 default_location: "project/{project_id}/state/runs/"77 versioning_policy: "append-only"78 - artifact_type: "token_usage_record"79 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"80 versioning_policy: "append-only"81applicability:82 industries:83 - "All"84 countries:85 - "All"86 fusion_releases:87 - "Current Oracle Fusion Cloud release"88side_effects:89 - "Performs routed read-only Fusion reference lookups and prepares local FSM archives; core.data-loader owns approved upload and import."90required_privileges:91 - "Read access to the territory, address-geography, jurisdiction, legal-entity, and optional parent PSU references used by the applicable branch."92metadata:93 source: https://skillmd.com/skills/oracle/manage-legal-entity-setup-task-guidance94---9596# Manage Legal Entity Setup Task Guidance9798## Purpose99100Provides task-specific setup planning, routing, export, import, and validation guidance for `Manage Legal Entity` under `Legal Structures`.101102## Setup Task Skill Contract103104- task_code: `XLE_MANAGE_LEGAL_ENTITY`105- task_name: `Manage Legal Entity`106- parent_skill_id: `erp.financials.legal-structures`107- pillar: `ERP`108- offering: `Financials`109- functional_area: `Legal Structures`110- functional_area_code: `ORA_ASK_LEGAL_STRUCTURES`111- available_flag: `Y`112- export_import_supported_flag: `Y`113- csv_export_import_supported_flag: `Y`114- source_catalog: `knowledge/setup-task-catalog/effective/setupTasksAll.json`115116## Usage117118Use this skill when planning, sequencing, exporting, importing, or validating setup data for `Manage Legal Entity` under `Legal Structures`.119120### Country and Identifying Jurisdiction121122Load [the reference lookup rules](ora-resource/ora_reference_lookups.md) and123[the country/default mappings](ora-resource/ora_defaulting_rules.md) before124resolving a CREATE candidate. Use `territoriesLOV` followed by the minimal-field125`addressGeographies` country lookup. The selected primary country's126`GeographyValue` supplies `GeographyName`; retain `TerritoryShortName` separately.127The address lookup does not expose `GeographyId`, and obtaining a country ID is128not a prerequisite for this flow.129130Reuse the user's identifying-jurisdiction name/search text or ask for it when131missing. Resolve it with `legalJurisdictionsLOV`, obtain an explicit choice if132multiple eligible records match, and verify the selected exact import name is133unambiguous. Name, identifying flag, and effective-date checks do not independently134prove jurisdiction-to-country association. Preserve that disclosure and the135documented `GeographyElement1` derivation limit in the package preview.136137These lookups run only at the existing `LE.RESOLVE_REFERENCES` step through the138declared REST client and selected environment. The changes apply to the main LRU139and registration rows authored within this LE aggregate; they do not alter the140separate Manage Legal Reporting Unit or Manage Legal Jurisdictions skills.141142## Setup Task Metadata143144- Task name: `Manage Legal Entity`145- Task code: `XLE_MANAGE_LEGAL_ENTITY`146- Available: `Y`147- Export/import supported: `Y`148- CSV export/import supported: `Y`149- CSV export/import routing: `supported`150151## CSV Export, Import, and Validation Workflow152153`CSVExportImportSupportedFlag` is `Y` for this task, so route task setup data work through the relevant skills:1541551. Export setup task data with `shared.setup-export.task-level-export`.1562. Validate setup task data with `shared.validation.setup-data-validator`.1573. Validate reference data with `shared.validation.reference-data-validator`.1584. Load the task-local `ora-resource/ora_rule_registry.json` and run its referenced input, lookup, dependency, defaulting, design, error-handling, and final-package-readiness checks. The ora-resource graph validates the candidate; it does not create a Fusion mutation.1595. Prepare the FSM archive locally using the contract below.1606. Hand the exact final archive to `core.data-loader` only after the local workflow returns `READY_FOR_DATA_LOADER_PREVIEW`.161162Use this task metadata when invoking those skills:163164- Offering: `Financials`165- Functional area / Setup Object: `Legal Structures`166- Setup task name: `Manage Legal Entity`167- Setup task code: `XLE_MANAGE_LEGAL_ENTITY`168169### Local-Only FSM Package Preparation170171This assisted workflow prepares a package locally and stops before upload or any Fusion mutation.1721731. Require a fresh, same-target, same-release, successful same-task FSM export as the immutable baseline. Bind the exact environment and task identity, current `ASM_SETUP_CSV_METADATA.xml`, the exact current entity-tree hierarchy and all six CSV members, exact header spelling and order, and the exported encoding.1742. Re-run the complete task ora-resource graph against the reviewed inputs and baseline. Fail closed with a task-specific package-contract gap if any source, mapping, value, member hierarchy, header, encoding, carrier, or aggregate rule is missing or ambiguous; do not invent a package contract.1753. Build the smallest supported UI-equivalent semantic delta from the task resources: the legal-entity root, its same-name main legal reporting unit, its identifying legal-entity registration, and the identifying main-LRU registration. Preserve all six current CSV members, all required unchanged parent rows, every unrelated row, and every untouched archive member. Preserve existing registration-function rows unchanged and add zero candidate function rows. Keep a registration-function member header-only only when it is already header-only in the baseline.1764. Do not copy physical IDs, audit fields, object-version fields, ESS fields, or service-owned values from the baseline or another row. Copy a value only when the task resources explicitly authorize it as a carrier.1775. Produce a ZIP-valid immutable FSM archive, its SHA-256 digest, a member inventory, a row/member semantic diff against the baseline, and a sanitized package-preparation receipt containing no secrets or sensitive payload values.1786. Any source, mapping, value, package byte, member inventory, or hash change invalidates this preview state and requires the full validation and package-preparation workflow to run again.1797. On success, return `READY_FOR_DATA_LOADER_PREVIEW`. Do not claim `READY_FOR_IMPORT` or approval. Stop before upload or mutation and hand the exact immutable archive to `core.data-loader`, which owns Task Hook validation, preview, explicit approval, archive-hash verification, upload, and initiation.180181182## Inputs183184- `implementation_objective`185- `project_context`186- `setup_task_scope`187- `setup_data_artifacts`188189## Outputs190191- `setup_task_plan`192- `setup_data_routing`193- `validation_checkpoints`194- `skill_run_record`195- `token_usage_record`196197## Implementation Notes198199Use the parent functional-area skill `erp.financials.legal-structures` for functional-area sequencing and scope decisions. Track token usage for any generated project artifact or skill-run record using the manifest policy.