awkawbandClaude Sonnet 5 a0a629cbfe Add credits, projects, tasks, vendors, and purchase orders
Five more resources following clients.rs's template exactly, same as
the previous batch. credits.rs is otherwise identical to quotes.rs
since Credit is also a type alias for Invoice in the SDK (same table,
distinguished by entity_type upstream).

Verified against a live local server: full create/list/get/update/
delete round trip for all five.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-10-26 16:49:39 -04:00

invoiceninja-cli

A command-line client for the Invoice Ninja v5 API, built on invoiceninja-sdk.

Early scaffold. clients, invoices, quotes, credits, payments, products, expenses, projects, tasks, vendors, and purchase-orders are wired up so far, out of ~34 resources — see CLAUDE.md for the pattern the rest follow. GOALS.md covers what the crate is for and what it is not.

Development

Enter the dev shell (Rust toolchain via rust-overlay, matching the SDK's):

nix develop

Usage

Every subcommand needs an API token and, for a self-hosted install, a base URL. Both can be passed as flags or environment variables (the same names the SDK's own examples use):

export IN_API_TOKEN=...
# export IN_BASE_URL=https://your-domain.example/api/v1   # self-hosted only

invoiceninja-cli clients list
invoiceninja-cli clients list --all --status active,archived
invoiceninja-cli clients get <id>
invoiceninja-cli clients create --data '{"name": "Acme Inc"}'
invoiceninja-cli clients update <id> --data '{"city": "Springfield"}'
invoiceninja-cli clients delete <id>

create and update read the record body as JSON, from --data inline, --file <path> (- for stdin), or stdin if neither flag is given. update fetches the current record first and overlays the given fields on top of it, so you only need to mention what's changing — see the comment in src/body.rs for why that matters (Invoice Ninja's PUT is a full replace, not a patch).

Add --output json to any command for the full record instead of the table view's few key columns:

invoiceninja-cli --output json clients get <id>

Every other wired-up resource (invoices, quotes, credits, payments, products, expenses, projects, tasks, vendors, purchase-orders) follows the same list/get/create/update/delete shape, e.g. invoiceninja-cli invoices list --status active or invoiceninja-cli purchase-orders get <id>.

S
Description
No description provided
Readme MIT
239 KiB
Languages
Rust 90.5%
Nix 9.5%