Manage Billing Details with Reis (YAML Mode)

Your organisation's billing details can be declared as a kind: billing_details document and applied with reis apply, so the identity printed on your invoices lives in version control with the rest of your infrastructure.

Updated 11 Aug 20262 min read

Your organisation's billing details can be declared as a kind: billing_details document and applied with reis apply, so the identity printed on your invoices lives in version control with the rest of your infrastructure.

There is exactly one set of billing details per organisation — the document describes it; applying it updates it in place.

YAML structure

kind: billing_details
entity_type: company
legal_name: Acme Trading LLC
email: accounts@acme.example
address_line1: Office 402, Al Majaz Tower
address_line2: Corniche Street
city: Sharjah
state: Sharjah
country: AE
tax_id: "100123456789003"
tax_id_type: trn
registration_number: "1234567"
billing_reference: PO-4471

Apply it:

reis apply -f billing-details.yaml

Fields you leave out of the document keep their current values, so a minimal document updating one thing is fine:

kind: billing_details
billing_reference: PO-2027-118

Fields

All fields are optional.

Field	Description
`legal_name`	Registered legal entity name, printed on invoices. Falls back to your organisation display name when unset.
`email`	The billing email all organisation email goes to.
`entity_type`	`individual` or `company`.
`address_line1` / `address_line2`	Postal address lines.
`city`	City.
`state`	State, province or emirate.
`postcode`	Postal code — not required everywhere.
`country`	ISO 3166-1 alpha-2 country code, e.g. `AE` or `DE`.
`tax_id`	Tax registration number. Requires `tax_id_type`.
`tax_id_type`	`vat`, `trn`, `gst`, `abn`, `ein` or `other` — drives the label the invoice prints.
`registration_number`	Company registration or trade licence number.
`billing_reference`	A PO number or cost centre printed on invoices.

Invoices are snapshots

Each invoice records your billing details as they were on the day it was issued — applying a change affects future invoices only.