OpenMeter Billing Settings

Send the invoice to the customer

Changed on

Approve a billing invoice.

This call instantly sends the invoice to the customer using the configured billing profile app.

This call is valid in two invoice statuses:

  • draft: the invoice will be sent to the customer, the invoice state becomes issued
  • manual_approval_needed: the invoice will be sent to the customer, the invoice state becomes issued
post/openmeter/billing/invoices/{invoiceId}/approve

Request

  • Base URL: http://localhost:8888/api/v3
  • URL: http://localhost:8888/api/v3/openmeter/billing/invoices/{invoiceId}/approve
  • Auth: none declared

Path parameters

invoiceIdstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

Example:01G65Z755AFWAKHE12NY0CQ9FH

Response

The updated invoice after sending to the customer.

idstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

descriptionstring

Optional description of the resource.

Maximum 1024 characters.

labelsLabels

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

created_atstring date-time required

RFC3339 formatted date-time string in UTC.

updated_atstring date-time required

RFC3339 formatted date-time string in UTC.

deleted_atstring date-time

RFC3339 formatted date-time string in UTC.

numberstring required

InvoiceNumber is a unique identifier for the invoice, generated by the invoicing app.

The uniqueness depends on a lot of factors:

  • app setting (unique per app or unique per customer)
  • multiple app scenarios (multiple apps generating invoices with the same prefix)
currencystring required

Three-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.

type'standard' required

Discriminator field identifying this as a standard invoice.

status'draft' | 'issuing' | 'issued' | 'payment_processing' | 'overdue' | 'paid' | 'uncollectible' | 'voided' required

Lifecycle status of a standard invoice.

issued_atstring date-time

RFC3339 formatted date-time string in UTC.

draft_untilstring date-time

RFC3339 formatted date-time string in UTC.

quantity_snapshotted_atstring date-time

RFC3339 formatted date-time string in UTC.

collection_atstring date-time

RFC3339 formatted date-time string in UTC.

due_atstring date-time

RFC3339 formatted date-time string in UTC.

sent_to_customer_atstring date-time

RFC3339 formatted date-time string in UTC.

Changes

  • v3159bfd1e78cfRevision changes
    • info

      added to the /////////////// response property allOf list for the response status

    • info

      removed from the /////////////// response property allOf list for the response status

  • v39082b60c6dd4Revision changes
    • info

      added the optional property ////// to the response with the status

    • info

      added to the ////// response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status