# Invoices

Every paid event — order, subscription renewal, top-up — produces an invoice. Find them under **Billing → Invoices**.

## What an invoice contains

```
helodata Inc.
Bill to:  Acme Inc., 123 Main St, San Francisco, CA 94103, USA
Tax ID:   US-EIN-12-3456789

Invoice:  INV-2026-05-001234
Date:     2026-05-28
Due:      2026-05-28  (paid)

Line items:
─────────────────────────────────────────────────────
1. Residential Pro plan — May 2026          $1,500.00
2. Top-up — auto, threshold $50                $200.00
3. ISP batch bat_01HX — 20 IPs × 1 month      $120.00
─────────────────────────────────────────────────────
Subtotal:                                    $1,820.00
Tax (CA 8.5%):                                 $154.70
─────────────────────────────────────────────────────
Total:                                       $1,974.70  USD
```

## Download

* **PDF** — for filing, accounting integrations
* **CSV** — for line-item analysis
* **JSON** — for programmatic processing

All three from **Billing → Invoices → {invoice} → Download**, or via API:

```bash
curl -H "Authorization: Bearer API_KEY" \
     "https://api.helodata.com/v1/invoices/inv_01HX/pdf" \
     -o invoice.pdf
```

## Listing

```bash
curl -H "Authorization: Bearer API_KEY" \
     "https://api.helodata.com/v1/invoices?from=2026-01-01&to=2026-05-31"
```

Filter by period or status (`paid`, `due`, `failed`).

## Tax

We apply tax based on:

* **US** — by ship-to state, where helodata has nexus (currently CA, NY, WA)
* **EU** — VAT at the rate of your billing country; if you supply a valid VAT ID, we reverse-charge (no VAT on invoice)
* **UK** — VAT 20%; reverse-charge with a valid VAT number
* **Canada** — GST/HST per province
* **Everywhere else** — no tax at source; you may owe local taxes

Update your **Tax ID** under **Billing → Address & tax** so it appears on invoices.

## Currency conversion

If your default currency is EUR or GBP but your card was charged in USD, the conversion rate appears on the invoice with the date applied. Your bank may apply a separate FX fee — that's between you and the bank.

## Custom invoice formatting

Enterprise plans can request:

* Custom logo on invoices
* A different "Bill to" entity (e.g. parent company vs subsidiary)
* Net 30 / Net 60 payment terms (instead of pay-on-issue)
* PO numbers on every invoice
* Multi-entity rollups (one master invoice per quarter)

Email **<billing@helodata.com>**.

## Disputes

If an invoice looks wrong:

1. Open it from **Billing → Invoices**.
2. Click **Dispute**.
3. Pick a reason and describe what's wrong.
4. Our billing team responds within 2 business days. If your dispute is valid, we issue a credit note that offsets the next invoice.

## Common pitfalls

* **VAT charged when you have a VAT ID** — your VAT ID wasn't validated. Check **Billing → Address & tax** for the green checkmark; otherwise re-enter or contact <billing@helodata.com>.
* **Tax appears on a US invoice but you're not in those states** — check your shipping/billing state in **Address & tax**.
* **Old invoices missing** — invoices are retained for 7 years; export periodically for your own retention if you need longer.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/account-and-billing/invoices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.