Acumatica API - Endpoint Default 23 200 001 icon

Acumatica API - Endpoint Default 23 200 001

Interact with Acumatica Endpoint Default/23.200.001

Actions478

Financial Year → Insert/Update

AI-generated

Summary

Upsert financial year records in Acumatica

Inputs

  • details — Fixed collection of financial year detail records; multiple entries allowed. Each entry includes Description, EndDate, PeriodNbr, and StartDate fields. Used to specify the core financial year data being inserted or updated.
  • LengthOfFinancialPeriodInDays — Single-value fixed collection specifying the length of a financial period in days. Accepts a number (default 0).
  • NbrOfFinancialPeriods — Single-value fixed collection specifying the number of financial periods. Accepts a number (default 0).
  • additionalFields — Optional collection of additional financial year properties. Authors can add fields such as AdjustToPeriodStart, BelongsToNextYear, CreatedDateTime, DayOfWeek, FinancialYearStartsOn, FirstFinancialYear, FirstPeriodStartDate, HasAdjustmentPeriod, LastModifiedDateTime, PeriodsStartDayOfWeek, PeriodType, UserDefinedPeriods, and YearEndCalculationMethod.

Output shape

The Acumatica API response for the upsert operation, typically returning the created or updated financial year record. Default/empty values are stripped before request to prevent 400-level errors.

All fields are scoped to the Financial Year resource and Insert/Update operation per the node's displayOptions. The source implementation (buildBody) unwraps fixedCollection option keys, recursively strips default/empty values, and constructs the request body for the Acumatica upsert endpoint.

Links

Discussion