ttd invoice¶

Create, render, and manage invoices. See the Invoicing guide for the full lifecycle.

ttd invoice COMMAND

Create and manage invoices.

Commands:

• create: Invoice a client's uninvoiced billable work (defaults to last month).
• list: List invoices, newest first.
• mark: Update invoice status; void releases its entries for re-invoicing.
• render: (Re)render an invoice's PDF/Markdown files.
• show: Show one invoice with line items.

invoice create¶

ttd invoice create [OPTIONS]

Invoice a client's uninvoiced billable work (defaults to last month).

Parameters:

• --client: Client slug
• --month: YYYY-MM
• --from:
• --to:
• --number: Override the number
• --pdf, --no-pdf: Render a PDF [default: False]
• --md, --no-md: Render Markdown [default: False]
• --out: Output directory
• --dry-run, --no-dry-run: Preview, change nothing [default: False]
• --interactive, --no-interactive, -i: Fill remaining fields via a form [default: False]

invoice list¶

ttd invoice list

List invoices, newest first.

invoice show¶

ttd invoice show NUMBER

Show one invoice with line items.

Parameters:

• NUMBER, --number: [required]

invoice render¶

ttd invoice render [OPTIONS] NUMBER

(Re)render an invoice's PDF/Markdown files.

Parameters:

• NUMBER, --number: [required]
• --pdf, --no-pdf: [default: False]
• --md, --no-md: [default: False]
• --out:

invoice mark¶

ttd invoice mark [OPTIONS] NUMBER STATUS

Update invoice status; void releases its entries for re-invoicing.

Marking paid records the paid date and freezes the tax set-aside at the current tax.set_aside_rate — re-mark with --paid-date to correct either.

Parameters:

• NUMBER, --number: [required]
• STATUS, --status: sent|paid|void [required]
• --paid-date: YYYY-MM-DD (default today); paid only