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

# Ventilations and invoices

> Download Ventilation files to pay out Cashbacks to your Consumers, retrieve Affiliation payout details, and access the invoices Paylead issues to your Program.

<Warning>
  **Work in progress, under review.** This page is not validated yet and may contain inaccuracies. Track and record its status in the [documentation review tracker](https://www.notion.so/22a535a8f8794ec8aa19f56cbb5f749a). This banner is removed once the page is validated.
</Warning>

Money flows through a Paylead [Program](/glossary#program) on two distinct tracks. **Ventilations** carry [Cashback](/glossary#cashback) amounts owed to your [Consumers](/glossary#consumer): Paylead computes who is owed what, you execute the bank transfer. **Invoices** carry the billing between Paylead and you, the [Program Manager](/glossary#program-manager): commission on Rewards, [Gifts](/glossary#gift) reimbursement, VAT.

Shift exposes both. This page covers where to find them and what each column means.

<Note>
  For the operating model behind Ventilation (Consumer-centric vs. Standard, invoicing cycle), see the [Ventilation concept](/program/user-journey/concepts/ventilation).
</Note>

## Ventilations

In **My Account** > **Ventilations**, each row is a Ventilation file covering one invoicing cycle. The file lists the [Cashback](/glossary#cashback) amount to transfer to each Consumer's bank account.

Use the search field to find a specific Ventilation, or the **Date from** / **Date to** filters to narrow the list.

### Columns

| Column                       | Description                                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------- |
| **Date**                     | Date Paylead paid the Program Manager. Blank means the payout has not been issued yet. |
| **Cycle (YYYY-MM)**          | The invoicing cycle during which the Rewards were validated.                           |
| **Invoice Reference**        | The invoice reference number tied to this Ventilation.                                 |
| **Payout Reference**         | The reference of the wire transfer issued by Paylead.                                  |
| **Total Amount to Allocate** | The total Cashback amount to be distributed across the Consumers in the file.          |
| **Status**                   | The status of the Paylead-to-Program-Manager payment.                                  |

<Tip>
  Rewards on a Ventilation line have transitioned through the technical statuses `Pending Validation` → `Validated` → `Paid In` → `Paid Out`. Only Rewards in `Paid Out` are settled for distribution to Consumers under the Standard approach. See the [Status reference](/program/shift/status-reference) for the full lifecycle.
</Tip>

### Downloading the file

Click the download icon on a row to retrieve the Ventilation as a CSV. Each line in the CSV corresponds to one Cashback owed to one Consumer.

| Field                   | Description                                                                                                                   |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Consumer ID**         | The pseudonymized Paylead identifier for the Consumer. Use it to look the Consumer up in Shift.                               |
| **External Account ID** | The Consumer account ID you provided. When a Consumer has several accounts, use this to route the payment to the correct one. |
| **Amount**              | The Cashback amount to pay to the Consumer.                                                                                   |
| **Bankwire Ref**        | Your reference for the transfer in the Paylead invoicing file.                                                                |
| **Execution Date**      | The date of the underlying transaction.                                                                                       |

<Tip>
  If your back-office automates payouts, prefer the M2M API over the manual download. See the [Ventilation concept](/program/user-journey/concepts/ventilation#retrieving-the-ventilation-file) for the endpoint.
</Tip>

## Affiliation Ventilation

[Affiliation](/glossary#affiliation) Rewards are paid out on a separate track: they are funded by the affiliation network (AWIN), not by the ALO commission flow. The **Affiliation Ventilation** section reflects that distinction.

| Column              | Description                                            |
| ------------------- | ------------------------------------------------------ |
| **Invoicing Cycle** | The period covered by the payment.                     |
| **Amount**          | The amount paid to the Program Manager for that cycle. |

Click the download icon to get the per-Consumer breakdown:

| Field                     | Description                                                                 |
| ------------------------- | --------------------------------------------------------------------------- |
| **consumer\_id**          | The Paylead identifier of the Consumer who earned the Affiliation Cashback. |
| **external\_account\_id** | The Consumer account ID you provided at onboarding.                         |
| **amount**                | The Affiliation Cashback amount generated by the Consumer.                  |
| **bankwire\_ref**         | The reference of the wire transfer from AWIN to the Program Manager.        |
| **execution\_date**       | The date AWIN paid the Program Manager.                                     |

<Note>
  Affiliation Ventilation and ALO Ventilation are reconciled separately. Two Consumers, one earning a Cashback from a card transaction and the other from a click-tracked online purchase, appear in different files even though they sit in the same Program.
</Note>

## Invoices

In **My Account** > **Invoices**, you can view and download every invoice Paylead issues to your Program. Two invoice types coexist: **Gifts** (reimbursement for Gift Rewards you distributed) and **Revenue** (commission Paylead owes you on ALO Cashbacks). Use the **All** filter to display both.

| Column         | Description                                    |
| -------------- | ---------------------------------------------- |
| **Date**       | The invoice creation date.                     |
| **Invoice**    | The invoice reference number.                  |
| **Type**       | `Gifts` or `Revenue`.                          |
| **Gifts VAT**  | The amount of Gifts transferred, VAT included. |
| **Fees VAT**   | The Program Manager commission, VAT included.  |
| **Amount VAT** | The VAT portion of the invoice.                |

Use **Date from** / **Date to** to scope the list. Without filters, every invoice since the Program launched is displayed.

Click the download icon on a row to retrieve the invoice as a PDF. Click the view icon to open it in a new tab without downloading.

## What's next

<CardGroup cols={2}>
  <Card title="Ventilation concept" icon="hand-coins" href="/program/user-journey/concepts/ventilation">
    Consumer-centric vs. Standard payout, invoicing cycle.
  </Card>

  <Card title="Status reference" icon="list-checks" href="/program/shift/status-reference">
    What `Pending Validation`, `Validated`, `Paid In`, `Paid Out` mean for a Reward.
  </Card>

  <Card title="Webhooks" icon="zap" href="/program/shift/webhooks">
    Subscribe to `Ventilation File Available` to automate file retrieval.
  </Card>

  <Card title="Reward lifecycle" icon="refresh-cw" href="/program/user-journey/guides/reward-lifecycle">
    Drive the Consumer-facing Rewards screen from the Connector API.
  </Card>
</CardGroup>