API Docs / Schemas / StatutoryDateConfigDto

StatutoryDateConfigDto

Configuration for the projected StatutoryDueDate on tasks created from a recurring task.
Different properties are required based on the Type value:

  • None: no statutory date is set.
  • SpecificDate: FixedMonth + FixedDay (DD/MM annual; invalid days clamped to end-of-month).
  • ClientKeyDate: ClientDateSourceType + Timing + OffsetDays (OffsetMonths optional), plus
    ClientDateType (KeyDate source) or CustomFieldDefinitionCode (CustomField source).
  • DayOfMonth: DayOfMonth (1-31; clamped to last day for shorter months).

Properties

Name Type Description
typeenum

None SpecificDate ClientKeyDate DayOfMonth

None SpecificDate ClientKeyDate DayOfMonth

fixedMonthinteger

Month (1-12). Required when Type is SpecificDate.

Month (1-12). Required when Type is SpecificDate.

fixedDayinteger

Day of month (1-31). Required when Type is SpecificDate. Clamped to last day of month at projection time.

Day of month (1-31). Required when Type is SpecificDate. Clamped to last day of month at projection time.

dayOfMonthinteger

Nth day of month (1-31). Required when Type is DayOfMonth. Clamped to last day for shorter months.

Nth day of month (1-31). Required when Type is DayOfMonth. Clamped to last day for shorter months.

clientDateSourceTypeenum

KeyDate CustomField

KeyDate CustomField

clientDateTypeenum

IncorporationDate YearEnd AccountsNextDue AccountsNextPeriodStart AccountsNextPeriodEnd AccountsLastPeriodFiled AccountsLastPeriodStart AccountsLastPeriodEnd AccountsLastMadeUpTo ConfirmationStatementDue ConfirmationStatementNextMadeUpTo LastConfirmationStatementFiled LastConfirmationStatementMadeUpTo NextVatReturnDue NextVatPeriodEndQuarterly NextVatReturnDueQuarterly NextVatPeriodEndMonthly NextVatReturnDueMonthly NextTaxQuarterPeriodEnd NextTaxQuarterSubmissionDeadline NextPayeCisFilingDue PensionReEnrolmentDate

IncorporationDate YearEnd AccountsNextDue AccountsNextPeriodStart AccountsNextPeriodEnd AccountsLastPeriodFiled AccountsLastPeriodStart AccountsLastPeriodEnd AccountsLastMadeUpTo ConfirmationStatementDue ConfirmationStatementNextMadeUpTo LastConfirmationStatementFiled LastConfirmationStatementMadeUpTo NextVatReturnDue NextVatPeriodEndQuarterly NextVatReturnDueQuarterly NextVatPeriodEndMonthly NextVatReturnDueMonthly NextTaxQuarterPeriodEnd NextTaxQuarterSubmissionDeadline NextPayeCisFilingDue PensionReEnrolmentDate

customFieldDefinitionCodestring

Custom field code. Required when Type is ClientKeyDate and ClientDateSourceType is CustomField.

Custom field code. Required when Type is ClientKeyDate and ClientDateSourceType is CustomField.

customFieldDefinitionLabelstring

Custom field label. Populated in responses only.

Custom field label. Populated in responses only.

timingenum

OnActualDate DaysBefore DaysAfter

OnActualDate DaysBefore DaysAfter

offsetDaysinteger

Days portion of the offset relative to the client date. Required when Type is ClientKeyDate.

Days portion of the offset relative to the client date. Required when Type is ClientKeyDate.

offsetMonthsinteger

Months portion of the offset relative to the client date. Optional alongside OffsetDays - e.g.
"Year End + 9 months + 1 day" for CT payment. Must be >= 0 when set; direction comes from Timing.

Months portion of the offset relative to the client date. Optional alongside OffsetDays - e.g.
"Year End + 9 months + 1 day" for CT payment. Must be >= 0 when set; direction comes from Timing.

JSON Example

{
  "type": "None",
  "fixedMonth": 0,
  "fixedDay": 0,
  "dayOfMonth": 0,
  "clientDateSourceType": "KeyDate"
}

Contained in Schemas