Manage Sales Stage Phase Codes Setup Task Guidance
FSM Task Identity Policy
Require exact task code/name, selected task SKILL.md, target environment, and
immutable archive SHA-256 throughout review, export, package preparation, and
validation.
- Review, export, and package preparation do not require Data Loader task context.
- Every Core Data Loader mutation handoff requires a persisted project
TaskContextPath, exactTaskName, and positiveTaskSequence. - The selected context entry must resolve to this task's exact skill path,
TaskCode,TaskName, offering, and functional area.
The persisted context may be generated from the project's resolved setup-task plan without creating an Oracle Run Book. Never hand-author, infer, or synthesize a context entry merely to satisfy Data Loader.
Purpose
Provides task-specific setup planning, routing, export, import, and validation guidance for Manage Sales Stage Phase Codes under Opportunities.
Setup Task Skill Contract
- task_code:
MOO_MANAGE_SALES_STAGE_PHASE_CODES - task_name:
Manage Sales Stage Phase Codes - parent_skill_id:
cx.sales.opportunities - pillar:
CX - offering:
Sales - functional_area:
Opportunities - functional_area_code:
ORA_MOO_OPPORTUNITIES - available_flag:
Y - export_import_supported_flag:
Y - csv_export_import_supported_flag:
Y - dataloader_import_mode:
FSM - businessObject: ``
- source_catalog:
knowledge/setup-task-catalog/effective/setupTasksAll.json
Usage
Use this skill when planning, sequencing, exporting, importing, or validating setup data for Manage Sales Stage Phase Codes under Opportunities.
Setup Task Metadata
- Task name:
Manage Sales Stage Phase Codes - Task code:
MOO_MANAGE_SALES_STAGE_PHASE_CODES - Available:
Y - Export/import supported:
Y - CSV export/import supported:
Y - CSV export/import routing:
supported - Data Loader import mode:
FSM - Business Object: ``
CSV Export, Import, and Validation Workflow
The fixed lookup is standard MOO_STAGE_PHASE_CD; it has no reference-data set
selector. Never substitute a set-enabled lookup, SetId or SetCode. Use
SingleLookup for one code, Read or Inventory, and Package for multiple reviewed
changes or full-task Export/Import. Delete remains unsupported.
- Load the local compiled plan and rules. Resolve the exact standard parent and fresh per-code state through Apps Common, its Lookups skill and Standard Lookups reference. Inventory paginates all codes; Create requires exact absence, Update/Disable an exact existing item. A failed read or incomplete page is not absence.
- Prefer a fresh completed full-data MOO_MANAGE_SALES_STAGE_PHASE_CODES export through shared.setup-export.task-level-export, then validate setup/reference data and the task-local package verifier. Preserve task identity, source ZIP, metadata, members, headers and unrelated content; use the recovery below when seeded parent/code rows are omitted.
- For a ready FSM mutation/Import, bind the reopened immutable PackagePath and PackageSha256 plus persisted TaskContextPath, exact TaskName and positive TaskSequence resolved to this skill/task/offering/functional area. Core Data Loader owns Task Hook validation, its immutable preview, later contextual approval, upload and one submission. Do not prescribe a literal approval keyword, create a child FSM preview, or revalidate outside its lifecycle.
- Accepted initiation ends its request. Status/errors/ProcessLog and exact read-back require a later explicit results request. Do not automatically poll or resubmit. Export/Import remain FSM-only.
- Only after applicable CSV recovery is exhausted may the verifier return RETURN_FALLBACK_REQUIRED. The router resumes the unchanged Create/Update/ Disable request once as REST_FALLBACK, restarts fresh parent/code reads and verifies the exhaustion receipt/reconciliation before a separate REST preview and immediate approval. Pending, uncertain or partial imports block route switching. The final fallback below is the only direct REST write route.
Execution Safety Contract
Before an external read, export, FSM package handoff, or direct REST preview or submission, run the preflight checks applicable to that operation:
- Bind the selected environment, release and project to the exact catalog task and standard lookup. Validate Operation, RequestMode and ExecutionRoute before resolution; apply code, delta and package requirements only where the requested operation needs them. Inventory and Read require no mutation ZIP or Data Loader context, and full-task Export requires no code or set.
- Confirm the privileges required for the selected read, export or mutation through the owning core/shared contract. A successful GET is not evidence of write permission. Resolve current parent/code state and reviewed impact before preparing a change; stop on stale, ambiguous or conflicting evidence.
- Validate supplied source paths and destination paths under the selected workspace. Before FSM handoff, verify safe ZIP shape, exact current-export task/member/header identity, reviewed parent-child changes, preserved unrelated content and the immutable final package evidence. For REST, check the exact method, same-target endpoint, writable body and verification GET.
- Preserve the selected executor's approval boundary. FSM handoff is validation only; Core Data Loader owns its retained-session preview, contextual approval and captured-source submission. Do not reread sources or revalidate outside its lifecycle after approval. REST requires its separately approved immutable preview immediately before submission. A changed preview or uncertain prior submission blocks further writes.
Load ora-resource/ora_error_handling.md before preview or execution. Classify failures, preserve sanitized diagnostics and external identifiers, and use only the owning core client's bounded read/auth recovery. Do not retry a mutation, upload or import automatically. Report actual status, elapsed polling and the safe next-check path on timeout; accepted Data Loader initiation ends the request until a later explicit status/results request. Redact credentials, tokens, authorization headers, cookies, private keys and protected payloads.
Header-Only Baselines and Standard Parent Linkage
A successful full-data export may have header-only CSVs because seeded data is omitted. Validate exact target/release/task, process result, ASM metadata, members and headers; zero rows alone are not a failed export or live absence. A template, unsafe/incomplete ZIP or unproven identity remains a blocker.
Retain the original export and prepare a separate final ZIP. In the current export's FND_APP_STANDARD_LOOKUP.csv, reuse the exact existing parent when it matches fresh live metadata; if omitted, add exactly one unchanged MOO_STAGE_PHASE_CD support row using live LookupType, Meaning, Description, ModuleId, CustomizationLevel and RestAccessSecured only where those fields are in the exported header. Leave added system-audit columns blank. Missing or conflicting required business fields block preparation; never invent parent metadata or create/change a lookup type.
Every reviewed child in ORA_FND_APP_STANDARD_LOOKUP_CODE.csv must join through FND_APP_STANDARD_LOOKUP.LookupType to that parent. Use fresh live absence or existing-state locks, the requested code/meaning and permitted mutable fields. Keep current CSV field/value conventions and exact spelling/order; display labels are not assumed to be CSV headers. Do not copy all seeded codes or add members absent from the current metadata contract. Validate the unchanged parent separately from the one or many business code changes, preserve all unrelated rows/members, and refresh exact state before FSM handoff. Child-only packages block even when the parent exists live.
Final Apps Common Fallback
Require a same-target/release/task/lookup/operation/row failure receipt with actual statuses, timestamps, classified failure, available artifact hashes and returned external IDs, plus applicable CSV recovery outcomes and why recovery cannot finish. Valid reasons are EXPORT_FAILED, EXPORT_TIMEOUT after the polling window, UNUSABLE_EXPORT after recovery, CSV_IMPORT_FAILED or CSV_IMPORT_NO_EFFECT. Header-only exports and repairable missing parent rows stay on CSV; do not submit invalid packages or repeat writes to prove failure.
After an accepted import, evaluation occurs only on a later explicit results request using Core Data Loader status/errors/ProcessLog. All related import jobs must be terminal and every requested code must remain at the reviewed pre-state or absent for Create. Pending jobs, unknown upload/initiation, incomplete diagnostics, partial changes or concurrent state drift block. All-applied returns verified state without writing; partial results require a new reviewed remaining-change request. Input/catalog/auth/approval/workflow/ context gaps and explicit FSM-only constraints cannot trigger fallback.
The dedicated verifier sets RestFallbackEligible=true only after exhaustion, reconciliation and fresh exact standard-parent/per-code reads. Reject duplicate case-sensitive LookupCode identities. REST supports Meaning, Description, EnabledFlag, StartDateActive, EndDateActive, DisplaySequence and Tag only; a Lookup_DFF change remains on FSM and blocks fallback rather than being dropped or guessed. Normalize reviewed Enabled Yes/No to REST EnabledFlag Y/N.
Prepare one immutable REST preview containing failure/recovery evidence, environment, ordered operations/codes, current/proposed state, impact, exact method/endpoint/body, verification GET and fingerprint. Create uses POST to standardLookups/MOO_STAGE_PHASE_CD/child/lookupCodes with LookupCode, Meaning and reviewed writable fields and Upsert-Mode=false. Update/Disable PATCH only the fresh same-target canonical child link; Disable sends only EnabledFlag=N. No SetId, SetCode, parent, audit or identity fields are written. Any changed or stale preview invalidates approval.
Obtain separate explicit approval immediately before Apps Common Lookups uses its core REST client. Submit each displayed request once in preview order and verify immediately. Stop on the first failure/uncertainty/unverified row; retain successes and unattempted rows without retry, rollback or another fallback. REST uses no Data Loader session/ZIP/context/approval; missing loader context is never an eligibility reason. No Delete route is introduced.
Oracle sources: 26D CSV export/import and 26D Standard Lookup Codes.
Oracle Resource Read Order
- ora_input_validation.md
- ora_dependency_readiness.md
- ora_reference_lookups.md
- ora_design_enforcement.md
- ora_error_handling.md
- ora_rule_registry.json for the compiled task-node graph
Use the rule planner before consuming the registry and load its execution guide. The local graph owns CSV recovery, final-fallback eligibility and approval gates.
Runtime Interface
Use manifest inputs/outputs; retain RequestMode, fixed standard lookup/task, reviewed ordered rows, live locks, immutable CSV evidence or failure/recovery/ reconciliation receipts, and route-owned preview/approval. No reference-set selection applies. Classify and redact errors through the local error rules.
Implementation Notes
Use the parent functional-area skill cx.sales.opportunities for functional-area sequencing and scope decisions. Track token usage for any generated project artifact or skill-run record using the manifest policy.
Offline Validation Evidence
Use golden-scenarios.md for synthetic requests and source-reviewed outcomes. The suite checks current source/registry equivalence, all-operation entry applicability, graph prerequisites and terminal boundaries:
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover \
-s pillars/cx/sales/opportunities/manage-sales-stage-phase-codes/tests -p 'test_*.py' -v
These checks do not execute Fusion or evaluate natural-language field rules.