Due-date schedule (`due_date_schedule`)

Schedule of milestones relative to a due date, used to emit time stages without embedding reminder logic.

Role

Schedule of milestones relative to a due date, used to emit time stages without embedding reminder logic.

This page describes the canonical functional concept. Detailed endpoints, HTTP parameters, and response formats belong in the API & events.

Ressource This resource has its own identifier and can be durably referenced by other objects and processes that need it.

The fields below capture the most important functional distinctions of the object.

Champ	Type	Role
`target_type`	`invoice \| receivable`	Business type to which this schedule applies.
`days_from_due_date`	`integer[]`	Signed thresholds relative to the due date: negative before, zero on the due date, positive after.
`active`	`boolean`	Whether the schedule is active for this merchant and `target_type`.
`source_reference`	`string \| null`	Optional external reference of the schedule.
`metadata`	`object`	Flat map of `string \| number \| boolean` scalars, following the API metadata convention.

Only one `due_date_schedule` may be active per merchant and `target_type`.
`days_from_due_date` is normalized, sorted, and deduplicated.
The schedule describes no action, channel, or template: processes react to stage events to decide what to do.
A value of -10 means ten days before the due date; 0 means the due date; 10 means ten days after.