---
title: "Invoice"
description: "one invoice: the lines by kind of usage from the metered rows, the fee, the amount recomputed from the record, the provider's id and the state"
section: concepts
address: /concepts/invoice
contract: 0476e35e6e275db5
---

# Invoice

one invoice: the lines by kind of usage from the metered rows, the fee, the amount recomputed from the record, the provider's id and the state

[figure: Invoice is a fact at tenant scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | fact |
| scope | tenant |
| key | the tenant and the period |
| store | postgres |
| family | operations |



## Fields


| field | type | required | note |
|---|---|---|---|
| `period` | [Window](/concepts/window) | yes |  |
| `lines` | `[json]` | yes | kind, quantity, price, amount |
| `fee` | `money` | yes |  |
| `amount` | `money` | yes | recomputed from the rows |
| `currency` | `text` | yes |  |
| `provider_invoice_id` | `text` | no |  |
| `state` | `one of draft \| issued \| paid \| failed \| void` | yes |  |



## Routes that use it
No route takes or returns Invoice directly. The record holds it, and the objects that point at it reach it.