> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Overview of the invoice concept

## Invoices in Hyperline

Hyperline provides a simple and versatile invoicing solution to automate your invoicing, no matter the pricing model or the currency. Automate recurring billing or create one-off invoices on demand for your customers.

Hyperline automatically computes line items for invoices corresponding to products in the assigned plan.

Invoices are managed in the **Invoices** section of Hyperline. You can [configure your invoice](./configuration) in the Settings pages.

<Note>
  Invoices numbers always follow a sequential pattern (learn more in the
  [invoice configuration](./configuration#invoicing-numbers)).
</Note>

Invoices always feature:

* A creation date
* A due date
* The invoice status
* The invoice category
* The payment method
* The total amount for the transaction, including VAT if applicable
* Names and addresses of both parties
* Legal information (if any were added in the [Invoice settings](./configuration))

<Frame>
  <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/example.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=6e9764c307eefc7e7e7c23adb9d6e8e2" width="2544" height="3147" data-path="images/invoices/example.png" />
</Frame>

### Invoice language

Hyperline invoices are currently available in **English, French, German, Italian, Spanish, Polish, Portuguese and Dutch** languages.

The invoice is generated in the primary language of your country for legal and accounting purposes. However, depending on your customer's language preference, you or they can download the invoice in their preferred language.

### Invoice customer address

Invoices created before changing a customer's address will keep the previous address.

Any change made to an invoice through the "edit" action will automatically update the customer's address

<Frame>
  <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/customer-address.gif?s=f7e3648eda708532c0b5fec177eb375d" width="800" height="252" data-path="images/invoices/customer-address.gif" />
</Frame>

### Invoice payment method

The customer's default payment method is used when creating an invoice. While an invoice is not paid, you can update it.

<Frame>
  <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/payment-method.gif?s=d7a3ad33166ec09e6165a4265480ca1f" width="800" height="195" data-path="images/invoices/payment-method.gif" />
</Frame>

### Invoice status

`Draft`
Represents an editable invoice. We are only using this status before the invoice is finalized (ready to pay). A draft invoice is generated without a number.

`Open`
Displays when your customer is assigned a metered subscription, we create an open invoice (generated without a number) in the background that we update on a regular basis to represent the latest consumption.

`Grace period`
Displays when a metered subscription has closed. During the grace period, the invoice isn't charged, and you can make modifications manually until the end of the grace period. A grace period invoice is generated without a number.

`To pay`
The invoice is finalized (a number is assigned) and is pending payment. Invoices attached to an automated payment method will be automatically charged. Invoices paid by bank transfer will remain with this status until [you mark them as paid](./reconciliations).

`Late`
The invoice has passed its due date and has not been fully paid yet. This status helps you identify overdue invoices that require follow-up.

`Partially paid`
The invoice has been paid only partially (only for transfers). See the [Reconciliation page](./reconciliations) for more details.

`Paid`
The invoice is fully paid and now has a settled date, you can book keep it.

`Missing payment info`
We haven't tried to process the invoice because the related customer doesn't have a payment method.

`Late`
The invoice has passed its due date and has not been fully paid yet. This status helps you identify overdue invoices that require follow-up.

`Error`
We have tried to charge the invoice 4 times (3 retries) and it failed. Learn more on how to handle payment errors [on this page](../payments/payment-errors).

`Uncollectible`
Represents an invoice that cannot be collected due to reasons like bankruptcy, disputes, or prolonged nonpayment, and which is typically written off as a bad debt. Can still be marked as paid  in case funds are finally collected.

`Voided`
The invoice has been voided and is no longer valid. Voided invoices are kept for record-keeping purposes but have no financial impact.

`Closed`
The invoice has been closed without payment, typically because there was nothing to bill after the grace period ended (for example, when all metered items resulted in zero usage).

<Frame>
  <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/list2.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=be6288e456978507de5b02bd5d618153" width="2480" height="1426" data-path="images/invoices/list2.png" />
</Frame>

### Invoice categories

**Refund** - The related payment has been refunded. A credit note has been issued.
**One-off** - Describes a one-off invoice.
**Subscription** - Describes an invoice that is part of a subscription.

You can filter invoices by category in the **Invoices** page using the **Category** filter dropdown.

### Invoice filters

**Outstanding** - Invoices that have been only partially paid and still awaiting for payments.
**Late** - Invoices with passed due date and not fully paid yet.
**Paid** - Fully paid invoices.
**Refunded** - Refunded invoices.

<Frame>
  <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/list4.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=1af25024a7d8c3b026926a979053f15d" width="2480" height="1426" data-path="images/invoices/list4.png" />
</Frame>

### View invoices by customer

You can view all the invoices for a specific customer by going to **Customers**, selecting one customer and clicking on the **Invoices** tab.

<Frame>
  <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/customer.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=811680d808f8ebed9a3b54689798f0c4" width="2482" height="1426" data-path="images/invoices/customer.png" />
</Frame>

## Send recurring invoices

Recurring invoices are automatically generated with subscriptions. For this, you need to [assign a subscription](../subscriptions/create) and start a subscription to a customer to trigger recurrent invoicing.

Recurring invoices can have different amounts or the same amounts each time, depending on the pricing model (pay-per-use is more likely to vary over time than monthly fixed-price subscriptions).

<Frame>
  <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/details-focus.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=89da87270d6d60320347a93396eb9246" width="1448" height="922" data-path="images/invoices/details-focus.png" />
</Frame>

## One-time payments

One-off invoices will be generated for one-time payments, such as onboarding fees, unique license fees or any other kind of product with a **fee** model you create from the **Product catalog** section.

To charge a one-time payment:

<Steps>
  <Step title="Go to the `Customers` page">
    Select the customer you want to charge.
  </Step>

  <Step title="Click on `Action` and `Charge one-time payment`">
    <Frame>
      <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/otp1.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=e4ede192a55998d13ae82c0f50866554" width="3248" height="1388" data-path="images/invoices/otp1.png" />
    </Frame>
  </Step>

  <Step title="Choose the issue date for your invoice">
    <Frame>
      <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/otp4.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=18ed2fbf2f4e03147edf69b983daa637" width="1214" height="786" data-path="images/invoices/otp4.png" />
    </Frame>

    <Note>
      <ul>
        <li>Immediately: The date will be set to today, and result in a direct charge on your customer's payment method</li>
        <li>Checkout completion: It will create a checkout link for your customer pay with. The issue date will match the payment date</li>
      </ul>
    </Note>
  </Step>

  <Step title="Choose the product, the name and the price for the one time payment you want to apply for this customer">
    If none are set by default, you can still visit the **Product catalog** page to create new fee products.

    <Frame caption="You can also add coupons to apply a specific discount to your invoice">
      <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/otp2.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=90cfbee87440792a098c60f33b9816ea" width="3204" height="2010" data-path="images/invoices/otp2.png" />
    </Frame>

    1. If you select **Immediately**, the invoice is created instantly and will appear with a **Paid** status.

    <Frame>
      <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/otp3.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=97aa2ccd02653f0910843c69dfcb32e9" width="1448" height="922" data-path="images/invoices/otp3.png" />
    </Frame>

    2. If you enabled the checkout session, an invoice will be created with a **Draft** status until the customer pays through their checkout page.
  </Step>
</Steps>

<Note>
  It is possible to generate one-time payment invoices for a customer who
  already has an ongoing subscription with recurring invoices. Alternatively, it
  is possible to generate one-time payment for a customer without an active
  subscription.
</Note>
