Settings

Invoice Settings

What appears on your printed invoices, receipts and statements — set once and applied to every document.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/settings/invoice-settings

Overview

These settings control the printed output for the whole business. They apply to sale invoices, receipts and statements, so branding stays consistent. The printed purchase order has its own layout — see PO Print Settings — and uses these values for anything left blank there. The panel is under My Account → Settings, with a live preview beside it.

Settings — Invoice settings
Invoice settings
Invoice settings — The settings panel with business details, column toggles and a live preview of the printed invoice.

Business details

These print in the header and footer. Anything left blank is simply omitted rather than printed empty.

Header and footer
ParameterTypeRequiredDescription
biz_name_overridestringOptionalBusiness name to print, when it differs from the registered tenant name.
sloganstringOptionalTagline printed under the business name.
addressstringOptionalBusiness address.
phone1stringOptionalFirst contact number.
phone2stringOptionalSecond contact number.
phone3stringOptionalThird contact number.
emailstringOptionalContact email.
footer_textstringOptionalFooter line — typically thanks or return policy.
footer_notestringOptionalSecond footer line for smaller print.

Column toggles

These decide which columns appear in the items table. Turning columns off matters most on thermal paper, where width is tight.

ParameterTypeRequiredDescription
col_row_noboolean= trueOptionalLine number.
col_imageboolean= falseOptionalProduct thumbnail. Off by default — it uses a lot of width and ink.
col_item_nameboolean= trueOptionalItem name.
col_qtyboolean= trueOptionalQuantity.
col_unit_priceboolean= trueOptionalPrice per unit.
col_discount_itemboolean= falseOptionalPer-line discount.
col_line_totalboolean= trueOptionalLine total.
col_items_per_unitboolean= falseOptionalItems per Unit — the pieces in one line unit (24 on a carton of water, 1 on a single piece).
TipOn an 80mm roll, keep item name, quantity and line total and turn the rest off. Too many columns wrap and make the receipt harder to read, not more informative.

Summary blocks

ParameterTypeRequiredDescription
show_subtotalboolean= trueOptionalSubtotal before the invoice discount.
show_discount_totalboolean= trueOptionalThe invoice-level discount line.
show_customer_nameboolean= trueOptionalThe customer's name.
show_customer_debtboolean= falseOptionalThe customer's total outstanding balance.
show_last_paymentboolean= falseOptionalTheir most recent payment.
Warningshow_customer_debtprints the customer's full outstanding balance on every invoice they are given. It is genuinely useful for credit customers, and awkward if a receipt is handed to whoever collects the goods. Consider who receives the paper before switching it on.

Logo

ParameterTypeRequiredDescription
logo_data_urlstringOptionalThe stored logo image. Set by uploading, cleared by deleting. Read-only in the save request.
  • Uploaded through POST /api/v1/invoice-settings/logo.
  • Removed through DELETE /api/v1/invoice-settings/logo.
  • Prints at the top of every document, scaled to the paper size.
NoteA wide, short logo reproduces best. Tall logos are scaled down to fit the header and can end up too small to read on a thermal receipt.

Thermal default

ParameterTypeRequiredDescription
default_thermalboolean= falseOptionalPre-select the thermal size in the print dialog.
TipCounter-heavy businesses should turn this on. It saves choosing the size on every sale, and A4 is still available whenever it is needed.

The DigitalKey watermark

Requires subscriptioninvoice.remove_watermark5,000 IQD / month
ParameterTypeRequiredDescription
show_dk_watermarkboolean= trueOptionalYour preference for showing the mark.
has_remove_watermark_featurebooleanOptionalWhether the removal feature is subscribed. Read-only.
effective_watermarkbooleanOptionalWhat actually prints. Read-only.
Importanteffective_watermark is what governs the printed output, not show_dk_watermark. Without the subscription the mark prints whatever your preference says. Turning the toggle off and finding the watermark still there is expected behaviour, not a fault.

Related