Subscription Start-Date Override (Platform + API)

Problem Statement

Administrators need the ability to set or backdate the subscription end date directly from the platform. The current platform does not provide a controlled way to adjust end_date although this was possible in the past. This creates gaps when aligning entitlement periods or correcting subscription timelines.

User Story

As an admin or integrator, I want to explicitly set the subscription end date (including backdating) via the platform UI so that subscription timelines can be accurately ended without relying on workarounds.

Definition of Done (DoD)

1. Functional Requirements

• The platform allows administrators to set or backdate the subscription end_date.

• The Subscription End API accepts an optional end_date parameter.

• Changing the end date does not modify:

  • Invoice end date

  • Invoice line-item periods

  • Historical invoice data

2. Scope

• Applies to all plan types (shipment-based and time-based).

• Implemented in:

  • Platform UI (admin-level controls)

  • Subscription Create API

3. UI Note

• Where applicable, the UI must clearly state:
  “End date modifications do not affect invoice dates.”