feat(invoices): Ability to skip 0 invoices

[brunomiguelpinto]

Context

We currently finalize all invoices, including those with a total amount of $0, leading to unnecessary clutter and potential confusion. To improve flexibility and reduce unnecessary finalizations, organizations will now have the option to decide whether $0 invoices should be finalized or not. This setting can be configured at the organization level, with the option to override it for individual customers.

Description

This PR introduces a new service, TransitionToFinalStatusService, which checks the finalize_zero_amount_invoice setting to decide whether to finalize an invoice or move it to the closed state after checking the customer and organization setting ( if the invoice fees_amount_cents is 0 )

Changes

Organization Setting

Added a new parameter finalize_zero_amount_invoice to the organization settings:

{
  "organization": {
    "finalize_zero_amount_invoice": "false" // default is true
  }
}

Customer Setting

Added a new parameter finalize_zero_amount_invoice to the customer settings to allow overriding the organization-level setting:

{
  "customer": {
    "finalize_zero_amount_invoice": "finalize" // default value is "inherit"
  }
}

Possible Values:

• inherit: (Default) The setting follows the organization-level configuration.
• finalize: Invoices are issued and finalized, even if the total amount is $0.
• skip: Invoices with a total amount of $0 are not finalized.

TransitionToFinalStatusService

The service checks the finalize_zero_amount_invoice setting to determine whether to finalize an invoice or move it to the closed state after evaluating the customer, organization, and invoice amount.

Invoice State: closed

• Introduces a closed state for invoices with a total amount of $0.
• Invoices in this state:
  • Will not be assigned a number.
  • Will not appear in the application.
  • Will only exist in the database.

Service Integration

The new TransitionToFinalStatusService was integrated into various points where invoices are finalized:

• Invoices::AdvanceChargesService
• Invoices::CreateOneOffService
• Invoices::CreatePayInAdvanceChargeService
• Invoices::RefreshDraftAndFinalizeService
• Invoices::SubscriptionService