documents: org name in the invoice and payslip headers, document_header_colorv0.1.63

1 files changed, 10 insertions, 4 deletions

diff --git a/docs/PROTOCOL.md b/docs/PROTOCOL.md
index 75f1990..081eb6a 100644
--- a/docs/PROTOCOL.md
+++ b/docs/PROTOCOL.md
@@ -374,7 +374,7 @@ resolved rows in a dry run.
 | Command | Args | Notes |
 |---|---|---|
 | `settings.get` | — | effective org settings (defaults included); secret values replaced by `_set` flags |
-| `settings.set` | `key`, `value?` | known keys: `default_series`, `series_voucher`, `series_invoice`, `series_payroll`, `series_bokslut`, `series_ib`, `attachment_dir`, `bank_account`, `invoice_receivable_account`, `invoice_revenue_account`, `invoice_bankgiro`, `invoice_our_ref`, `smtp_host`, `smtp_port`, `smtp_user`, `smtp_from`, `smtp_reply_to`, `smtp_security`, `smtp_password` |
+| `settings.set` | `key`, `value?` | known keys: `default_series`, `series_voucher`, `series_invoice`, `series_payroll`, `series_bokslut`, `series_ib`, `attachment_dir`, `bank_account`, `invoice_receivable_account`, `invoice_revenue_account`, `invoice_bankgiro`, `invoice_our_ref`, `document_header_color`, `smtp_host`, `smtp_port`, `smtp_user`, `smtp_from`, `smtp_reply_to`, `smtp_security`, `smtp_password` |
 
 `series_voucher`, `series_invoice`, `series_payroll`, `series_bokslut` and
 `series_ib` (1–8 characters, e.g. `A`, `V-`, `Å`) are the number series each
@@ -391,7 +391,10 @@ only, up to 10 characters, default `1930`) is the account `bank.import` uses
 when the request carries no `account`. `invoice_receivable_account` (default
 `1510`) and `invoice_revenue_account` (default `3001`) are the receivable and
 default revenue account of invoice postings, digits only, up to 10
-characters. Verification ids are the concatenation of series and number
+characters. `document_header_color` (`#rrggbb`, default `#314c59`) is the
+background colour of the generated documents' header bars (invoice and
+lönebesked); the invoice prints the org name on it. Verification ids are the
+concatenation of series and number
 (`V-8`), and series are free-form: only an unbroken numbering per series is
 required.
 
@@ -644,7 +647,9 @@ is the idempotency key).
 `invoice.sequence_set` and `invoice.issue` are audited; `invoice.issue`
 supports `dry_run`, which validates and renders but takes no number and
 writes nothing. `invoice.pdf` returns the stored document as base64
-(`JVBERi0` after decoding is the PDF magic). When the setting
+(`JVBERi0` after decoding is the PDF magic). The document's header bar
+prints the organization `name` and is coloured by `document_header_color`
+(default `#314c59`; invalid stored values fall back to it). When the setting
 `invoice_bankgiro` is present it is printed in the document's Bankgiro field;
 `invoice_our_ref` (up to 64 characters) prefills the invoice form's "Vår
 referens".
@@ -756,7 +761,8 @@ given date (default: today) and sets the run's `status` to `paid` with
 `payment_voucher_id`; paying twice is a `CONFLICT`.
 
 `payroll.payslip` renders one A4 lönebesked for an employee line of a posted
-run: the employer header and footer, the employee name, the masked
+run: the employer name in the header bar (coloured by
+`document_header_color`), the employer footer, the employee name, the masked
 personnummer (`********-1234`, or `********` when the key is unavailable),
 period, pay date, tax table and column, then Bruttolön, the negative
 Preliminärskatt, a rule and Nettolön, and the note `Arbetsgivaravgifter