Invoices

List, create, upload, decline, batch, and pay HEVN invoices.

List invoices and bills

List all invoices:

hevn invoice list
hevn invoice list --yaml

List incoming bills for the current account:

hevn bills
hevn bills --yaml

Get an invoice

hevn invoice get <invoice-id>
hevn invoice get --invoice-id <invoice-id> --yaml

Use the public invoice endpoint:

hevn invoice get <invoice-id> --public

Create an invoice

Interactive flow:

hevn invoice new

Non-interactive flow:

hevn invoice new \
  --contractor-email [e-mail] \
  --contractor-name Vendor \
  --client-email [e-mail] \
  --client-name "Your Company" \
  --item "Consulting:1:100" \
  --due-date 2026-06-01

Items can be provided as repeatable --item flags:

hevn invoice new \
  --contractor-email [e-mail] \
  --item "Design:2:150" \
  --item '{"name":"Review","quantity":1,"price":75}'

Or as a JSON array:

hevn invoice new \
  --contractor-email [e-mail] \
  --items '[{"name":"Consulting","quantity":1,"price":"100"}]'

Upload an incoming invoice

Upload an invoice PDF or document and create an incoming invoice record:

hevn invoice upload-incoming \
  --path ./invoice.pdf \
  --contractor-email [e-mail] \
  --items '[{"name":"Consulting","quantity":1,"price":"100"}]'

Uploaded documents are cached in the local config so a path can later resolve to its document id.

Create from contract

hevn invoice new \
  --contract-id <contract-id> \
  --period-start 2026-06-01 \
  --add-item "Extra support:1:250"

The current user’s address is required for contract invoice creation.

Batch invoicing

hevn invoice batch \
  --contract '{"contractId":"<contract-id>","period":0,"memo":"May payroll","items":[{"name":"Monthly services","quantity":1,"price":"5000"}]}' \
  --yaml

Or pass an array:

hevn invoice batch \
  --contracts-json '[{"contractId":"<contract-id>","period":0,"items":[{"name":"Services","quantity":1,"price":"5000"}]}]'

Decline an invoice

hevn invoice decline --invoice-id <invoice-id> --yes --yaml

Pay an invoice

Actually moving the money is handled by the transfer command:

hevn transfer --invoice-id <invoice-id> --memo "Invoice payment"

Separately, hevn invoice pay marks an invoice as paid (optionally with a custom transaction reference) without moving funds — use it when the invoice was settled outside HEVN:

hevn invoice pay <invoice-id> --reference <tx-reference>