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.
• refresh: Recompute invoice lines from locked entries and show a before/after diff.
• render: (Re)render an invoice's PDF/Markdown files.
• show: Show one invoice with line items, or rendered Markdown with --format md.

invoice create¶

ttd invoice create [OPTIONS]

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

Parameters:

• --client: Client slug
• --month: YYYY-MM
• --period: Period spec: 'last month', 'this week', 'last two weeks', 'june 16 to june 30', YYYY-MM, or YYYY-MM-DD to YYYY-MM-DD
• --from:
• --to:
• --number: Override the number
• --pdf, --no-pdf: Render a PDF [default: False]
• --md, --no-md: Render Markdown [default: False]
• --receipts, --no-receipts: Append expense receipts to the PDF [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 [OPTIONS] NUMBER

Show one invoice with line items, or rendered Markdown with --format md.

Parameters:

• NUMBER, --number: [required]
• --format: Output format: table (default) or md [default: table]

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]
• --receipts, --no-receipts: Append expense receipts to the PDF [default: False]
• --out:

invoice refresh¶

ttd invoice refresh [OPTIONS] NUMBER

Recompute invoice lines from locked entries and show a before/after diff.

Parameters:

• NUMBER, --number: [required]
• --apply, --no-apply: Apply changes when allowed [default: False]

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