import_supplementation_data

Import supplementation data into FCCS for financial consolidation and close processes. Use this tool to add supplemental financial information to Oracle EPM Cloud FCCS.

Instructions

Import supplementation data / Importar dados de suplementacao

Input Schema

TableJSON Schema

Name	Required	Description	Default
`parameters`	No	Import parameters (period, year, scenario, etc.)

Implementation Reference

fccs_agent/tools/consolidation.py:81-93 (handler)

The main tool handler function that executes the import by calling the FCCS client.

async def import_supplementation_data(
    parameters: Optional[dict[str, Any]] = None
) -> dict[str, Any]:
    """Import supplementation data / Importar dados de suplementacao.

    Args:
        parameters: Import parameters (period, year, scenario, etc.).

    Returns:
        dict: Job submission result.
    """
    result = await _client.import_supplementation_data(_app_name, parameters)
    return {"status": "success", "data": result}

fccs_agent/tools/consolidation.py:201-213 (schema)

The JSON schema definition for the tool's input parameters in the TOOL_DEFINITIONS list.

{
    "name": "import_supplementation_data",
    "description": "Import supplementation data / Importar dados de suplementacao",
    "inputSchema": {
        "type": "object",
        "properties": {
            "parameters": {
                "type": "object",
                "description": "Import parameters (period, year, scenario, etc.)",
            },
        },
    },
},

fccs_agent/agent.py:170-176 (registration)

Registration of consolidation tools, including import_supplementation_data, in the TOOL_HANDLERS dictionary.

"export_consolidation_rulesets": consolidation.export_consolidation_rulesets,
"import_consolidation_rulesets": consolidation.import_consolidation_rulesets,
"validate_metadata": consolidation.validate_metadata,
"generate_intercompany_matching_report": consolidation.generate_intercompany_matching_report,
"import_supplementation_data": consolidation.import_supplementation_data,
"deploy_form_template": consolidation.deploy_form_template,
"generate_consolidation_process_report": consolidation.generate_consolidation_process_report,

fccs_agent/client/fccs_client.py:708-723 (helper)

The FCCSClient method that performs the actual API POST request to submit the import job.

async def import_supplementation_data(
    self,
    app_name: str,
    parameters: Optional[dict[str, Any]] = None
) -> dict[str, Any]:
    """Import supplementation data / Importar dados suplementares."""
    if self.config.fccs_mock_mode:
        return {"jobId": "701", "status": "Submitted", "jobType": "ImportSupplementationData"}

    payload = {"jobType": "IMPORTSUPPLEMENTATIONDATA", **(parameters or {})}
    response = await self._client.post(
        f"/{app_name}/jobs{self._get_query_params()}",
        json=payload
    )
    response.raise_for_status()
    return response.json()

FCCS MCP Agentic Server