# XWUIInvoice

A complete invoice document: a header (issuer, customer, invoice number, issue/due dates, PO #), a line-items table (description, qty, unit price, discount, tax, line total), an auto-computed tax breakdown and grand total, an optional status ribbon (draft/sent/paid/partial/overdue/cancelled/refunded), and an optional QR code for ZATCA / EU e-invoice payloads. It composes `XWUIDisplayMonetary` for currency cells and `XWUIBarcodeQRCode` for the QR, and is built to render to screen, export to HTML/PDF, or print.

## Basic Usage

A standard invoice (INV-2026-001) from eXonware Inc. to Northwind Robotics with two line items - an annual Pro plan and onboarding hours - both at 15% VAT, with the status ribbon enabled.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A two-line USD invoice with 15% VAT, issuer/customer tax IDs, and the status ribbon shown.
```

## Statuses

Renders the same minimal invoice once per status value, walking through every ribbon variant from draft to refunded.

```example
file: examples/Statuses.ts
html: examples/Statuses.html
title: Statuses
description: One invoice per status - draft, sent, paid, partial, overdue, cancelled, refunded - each with its colored ribbon.
```

## With QR

A single invoice with `showQR: true` and a `qrPayload` string, rendering the e-invoice QR code in the header.

```example
file: examples/WithQR.ts
html: examples/WithQR.html
title: With QR
description: An invoice carrying a ZATCA-style qrPayload that renders as a header QR code.
```

```api
```