> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Materialized Invoice V1

# Type: Materialized Invoice Object

# Link: https://dev.wix.com/docs/api-reference/account-level/studio-workspace/earnings/materialized-invoice-v1/materialized-invoice-object.md

## Description: A materialized invoice surfaces the invoices and payments a partner received from the payment handler (Tipalti), aggregated for the partner to read. The underlying invoices are grouped into one materialized invoice per earnings month per payment status, and each total is broken down by revenue stream (premium, GPV, marketplace, and app market). Records are created automatically by Wix as the partner is paid, so partners can't create or update them. All amounts are in USD.

## Schema:

```json
 Type: Materialized Invoice Object | type: MaterializedInvoice
 Description: A materialized invoice surfaces the invoices and payments a partner received from the payment handler (Tipalti), aggregated for the partner to read. The underlying invoices are grouped into one materialized invoice per earnings month per payment status, and each total is broken down by revenue stream (premium, GPV, marketplace, and app market). Records are created automatically by Wix as the partner is paid, so partners can't create or update them. All amounts are in USD.
       - name: id  | type: string | description: Materialized invoice ID.
           - name: value  | type: string | description: 
       - name: earningsMonth  | type: string | description: Earnings month the invoice covers.  This is a month bucket, not an exact instant. It's normalized to the start of the day on the first day of the month. The underlying invoices are grouped into one materialized invoice per earnings month per payment status.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: invoicesRefCodes  | type: Array<string> | description: Reference codes of the underlying invoices included in this aggregation.  A reference code is the identifier assigned by the payment handler (Tipalti) to each invoice. It's the same value that a premium, GPV, or marketplace payout carries in its `invoiceId`, so you can filter on this field to find the invoice a payout was included in.
       - name: amount  | type: number | description: Total amount across the grouped invoices, in USD. Equals the sum of the `revenueStreamsAggregation` sub-totals.
       - name: status  | type: string | description: Payment status of the grouped invoices for the earnings month.
           enum: UNPAID, PAID, BELOW_THRESHOLD
       - name: revenueStreamsAggregation  | type: RevenueStreamsAggregation | description: Invoice total broken down into its premium, GPV, marketplace, and app market revenue-stream sub-totals.
           - name: premium  | type: number | description: Total premium earnings from premium subscriptions the partner sold, in USD.
               - name: value  | type: number | description: 
           - name: gpv  | type: number | description: Total GPV earnings, in USD. GPV (gross payment volume) is the payment volume processed across the sites the partner manages.
           - name: marketplace  | type: number | description: Total marketplace earnings from marketplace transactions, such as template sales, in USD.
           - name: appMarket  | type: number | description: Total app market earnings, in USD. This is a fourth revenue stream alongside premium, GPV, and marketplace, so include it when you add the sub-totals up to the invoice's `amount`.

```