Address Setup

Prev Next

Feature Overview

Address Setup controls how recipient addresses are assembled and positioned on printed documents. Document Customizer supports two complementary mechanisms for this, which can be used independently or in combination.

The first and simpler mechanism is the classic Address Setup table, which defines on a per-table and per-address-type basis which fields to concatenate to form an address block. You specify the document table, the address type (Customer, Bill-to, or Ship-to), and a sequence of field rows — each with an optional related-table lookup, a caption prefix, and a new-line flag. When the document is printed, the system walks through these rows and builds the address string. The blanking of the local country/region code (so domestic addresses do not show the country name) is handled automatically via the Blank Local Country/Region flag in Document Customizer Content.

The second, more powerful mechanism is Address Templates, introduced to give fine-grained control over each line's font, size, bold, italic, and underline styling, as well as precise pixel-level positioning of each address block independently. An Address Template is a named set of line definitions for a specific BC table; a Report Address Template then groups up to four Address Templates (Bill-to, Ship-to, Ship-from, Customer) and links them together. When a Report Address Template is assigned in Document Customizer Content, it overrides the classic Address Setup and the position values in the Layout for that document.

Together, these two mechanisms cover everything from the simplest "show the standard customer address" use case to complex multi-address layouts with per-line styling and precise windowed-envelope positioning.

Key Facts

Classic address pages Address Fields page (Address Setup table)
Template-based address pages Address Templates page; Address Template Lines page; Report Address Templates page
Where to assign Classic: automatic (per table/type). Template: Document Customizer Content → Address Template Code field
Address types supported Customer, Bill-to, Ship-to, Ship-from
Document tables with Bill-to Sales Header, Sales Invoice Header, Sales Cr. Memo Header, Sales Shipment Header, Transfer Header
Document tables with Ship-to Sales Header, Sales Invoice Header, Sales Cr. Memo Header, Sales Shipment Header, Customer
Document tables with Ship-from Transfer Header
Blank local country Blank Local Country/Region in Document Customizer Content suppresses the country on domestic addresses
Both addresses Show Both Addresses in Document Customizer Content shows both bill-to and ship-to simultaneously
Position override Address Template position settings override the Layout-level address position fields

Getting Started

Using the classic Address Setup:

  1. Open Address Fields (from Document Customizer Content → Address action, or by searching).
  2. The system comes pre-configured with address field definitions for all supported document tables. Review the existing rows to understand the current setup.
  3. To modify the address composition for a specific document table and address type, find the relevant rows (filtered by Table No and Type) and adjust the Field No., New line, and Using Table/Using Field settings.
  4. Enable Blank Local Country/Region in Document Customizer Content to suppress the country name for domestic addresses.

Using Address Templates (recommended for precise control):

  1. Open Address Templates and create a new template with a Code and Description. Set Table No. to the relevant BC document table.
  2. Open the template and add Lines — one row per address element. Set the Order, Field No., and optionally Using Table/Using Field for related-table lookups. Enable New Line where a line break should occur in the address block.
  3. For each line, optionally set Font, Font Size, Bold, Italic, or Underline for per-line typography.
  4. Set the template's address position (Address Vertical Position, Address Horizontal Position, alignment) to place the block precisely on the page.
  5. Create a Report Address Template that groups the individual Address Templates (Bill-to, Ship-to, Ship-from, Customer) for a specific BC table.
  6. In Document Customizer Content, set the Address Template Code field to the Report Address Template code.

Related Features

Address Setup integrates with several other Document Customizer features. Layout & Visual Design provides the global address position defaults (vertical and horizontal position, font size, alignment) that apply when no Address Template is assigned; Address Templates override these when present. Captions & Translations provides caption codes that can prefix individual address lines (e.g. "Ship to: " before the recipient name). Bank Accounts per Currency is separate from address setup but similarly uses the document's currency context — both are resolved at runtime using document data. The Header Setup feature can also display address-derived data (e.g. ship-to name, customer VAT number) in the header fields, complementing the dedicated address block rendered by Address Setup.


User Stories

US-01: Configure the bill-to address to show name, address lines, and country

As a Business Manager
I want to ensure that the bill-to address on invoices shows the customer's full name, two address lines, postal code and city, and country (for international customers only)
So that the address block is complete and correct for all documents, domestic and international

Setup:

  1. Open Address Fields and locate the rows for the Sales Invoice Header table with Type = Billto.
  2. Verify that Name, Address, Address 2, Post Code + City are all present as rows, with New line enabled on each row that should start a new line.
  3. Ensure the Country field row uses Using Table = Country/Region and Using Field = Name (to show the country name rather than the code).
  4. In Document Customizer Content, enable Blank Local Country/Region for the Sales Invoice. This will suppress the country name when the customer's country matches the company's country code.
US-02: Show a ship-to address alongside the bill-to address on an invoice

As a Business Manager
I want to print both the bill-to address and the ship-to address on invoices when the delivery address differs from the billing address
So that the customer can confirm both addresses from a single document

Setup:

  1. In Document Customizer Content, enable Show Both Addresses for the Sales Invoice.
  2. Ensure the Address Fields table has rows defined for both Type = Billto and Type = Shipto for the Sales Invoice Header table.
  3. The two address blocks will be rendered side by side (bill-to on the left, ship-to on the right by default based on the Layout position settings).
US-03: Position the address block precisely for windowed envelopes

As a Business Manager
I want to place the bill-to address at exactly 50 mm from the top and 25 mm from the left edge of the page, aligned to the window of our standard DL envelopes
So that invoices can be mailed without needing to insert a separate address label

Setup:

  1. Create a new Address Template for the Sales Invoice Header table. Set:
    • Address Vertical Position = 50, Address Vertical Pos. Unit = mm (use cm if mm is not available; 5 cm = 50 mm)
    • Address Horizontal Position = 25, unit = cm (2.5 cm)
    • Address Position Text Align = Left
  2. Add the address line rows in the template.
  3. Create a Report Address Template for the Sales Invoice Header table. Set the Bill-to Address Template Code to your new template.
  4. In Document Customizer Content, set Address Template Code to the Report Address Template code.
US-04: Apply bold font to the recipient's name line in the address block

As a Business Manager
I want to print the customer's name in bold in the address block, while the address lines below are in regular weight
So that the name stands out and makes envelopes easy to sort

Setup:

  1. Open the Address Template for the relevant document table.
  2. In the template Lines, find the row for the Name field.
  3. Enable Bold on that row.
  4. Leave all other rows with Bold unchecked.
  5. Save and run a test report.
US-05: Show a "Deliver to:" prefix before the ship-to address

As a Business Manager
I want to print the label "Deliver to:" in the ship-to address block so that the two address blocks are clearly distinguishable on the page
So that recipients can immediately identify the billing address vs. the delivery address

Setup:

  1. In the Address Template (or classic Address Setup) for the Ship-to address type, add a row at the top of the sequence.
  2. Set Field No. to blank (or a constant-return field) and set Caption to a caption code that translates to "Deliver to:" in the relevant languages.
  3. Enable New Line on this row so the caption appears on its own line above the name.
  4. Save and test.
US-06: Use a related-table lookup to show the translated country name

As a Business Manager
I want to show the full country name (e.g. "Germany") rather than the country code (e.g. "DE") in the address block, and have it automatically translate to the document language
So that addresses on international documents are human-readable for the recipient

Setup:

  1. In Address Fields (or Address Template Lines), find the row for the country field.
  2. Set Field No. to the Country/Region Code field on the document table.
  3. Set Using Table to the Country/Region table.
  4. Set Using Field to the Name field on Country/Region.
  5. Enable Country Field (this is set automatically when Using Table is Country/Region). The system will suppress the country when it matches the company's country code if Blank Local Country/Region is enabled.
  6. The Country/Region table in BC stores localised country names; the system uses the document language to retrieve the translated name via BC's FormatAddress mechanism.
US-07: Configure bank accounts per currency for payment details on invoices

As a Accountant
I want to ensure that invoices in EUR show our EUR bank account details and invoices in DKK show our DKK bank account
So that customers always receive the correct payment routing information without any manual adjustment

Setup:

  1. Open Bank Accounts per Currency from Document Customizer Content (or from the navigation).
  2. Add a row for each currency: set Currency Code to EUR (or DKK) and Bank Account to the relevant bank account code.
  3. Optionally set Payment Method if the bank account selection should also depend on the payment method (e.g. different IBAN for direct debit vs. wire transfer).
  4. In Header Setup or Footer HTML Parameters, reference the Bank Field mechanism to display the bank account fields (IBAN, SWIFT, Bank Name) from the resolved bank account.

Note: The Bank Accounts per Currency lookup priority is: (1) match on both Payment Method and Currency Code, (2) Currency Code only, (3) Payment Method only, (4) no filter (default account). Set up at minimum a row with blank Currency Code as the fallback for currencies not explicitly listed.

US-08: Create a Report Address Template that groups bill-to and ship-to templates

As a IT Manager
I want to create a Report Address Template that bundles a precisely positioned bill-to template and a ship-to template for the Sales Invoice Header, so both addresses are fully controlled and consistently formatted
So that the Sales Invoice always renders both addresses exactly as specified, regardless of the Layout's global position settings

Setup:

  1. Create an Address Template for the Bill-to address (table = Sales Invoice Header): define all fields and position settings.
  2. Create a separate Address Template for the Ship-to address (same table): define fields and position settings (e.g. placed to the right of the bill-to block).
  3. Open Report Address Templates and create a new record with a code (e.g. SINV-ADDR), set Table No. to Sales Invoice Header.
  4. Set Bill-to Address Template Code to the bill-to template. Set Ship-to Address Template Code to the ship-to template.
  5. In Document Customizer Content, set Address Template Code to SINV-ADDR.
  6. The Layout-level address position fields are now overridden by the template positions.
US-09: Suppress the local country on domestic documents

As a Business Manager
I want to hide the country name on invoices sent to customers in the same country as our company, while still showing it for international customers
So that domestic invoices look cleaner without redundant country information

Setup:

  1. In Document Customizer Content, find the relevant document row and enable Blank Local Country/Region.
  2. Ensure the address rows include a country field configured with Using Table = Country/Region (so the Country Field flag is set).
  3. At print time, if the customer's country code matches the company's country code from Company Information, the country name is suppressed.
US-10: Configure a Ship-from address for Transfer Orders

As a Business Manager
I want to print the ship-from location address on transfer orders so that the receiving warehouse knows exactly where the shipment is coming from
So that transfer documents contain full origin and destination address information

Setup:

  1. Create an Address Template for the Transfer Header table, for the ship-from address type. Add lines for the transfer-from location's address fields (Name, Address, City, Country).
  2. Create or update a Report Address Template for Transfer Header. Set Ship-from Address Template Code to the ship-from template.
  3. In Document Customizer Content for the Transfer Order, set Address Template Code to this Report Address Template.

Note: Ship-from address is only available as an Address Template type for the Transfer Header table, based on the source code. It is not exposed as a classic Address Setup type.


Field Reference

Field Where to find it What it does Default
Table No Address Setup (classic) The document header table this address definition applies to
Type Address Setup (classic) Address type: Customer, Bill-to, or Ship-to
Field No. Address Setup (classic) Field from the document table to include in the address
New Line Address Setup (classic) Inserts a line break after this field's value Disabled
Caption Address Setup (classic) Caption code prefix printed before the field value
Using Table Address Setup (classic) Related table for indirect field lookup
Using Field Address Setup (classic) Field in Using Table to display
Country Field Address Setup (classic) Auto-set when Using Table is Country/Region; triggers blank-country logic Auto
Code Address Templates Unique code for this address template
Table No. Address Templates BC table this template defines address lines for
Address Vertical Position Address Templates Vertical offset of this address block from the top of the page
Address Horizontal Position Address Templates Horizontal offset of this address block
Address Position Text Align Address Templates Left or Right alignment of the address block Left
Order Address Template Lines Sequence of this line within the address block
Field No. Address Template Lines Field to display on this address line
New Line Address Template Lines Line break after this field Disabled
Font Address Template Lines Font override for this specific address line
Font Size Address Template Lines Font size for this line 8
Bold Address Template Lines Bold formatting for this line Disabled
Italic Address Template Lines Italic formatting for this line Disabled
Underline Address Template Lines Underline formatting for this line Disabled
Code Report Address Templates Unique code for this grouped address template
Table No. Report Address Templates BC document table this report address template applies to
Bill-to Address Template Code Report Address Templates Address Template for the bill-to address
Ship-to Address Template Code Report Address Templates Address Template for the ship-to address
Ship-from Address Templ. Code Report Address Templates Address Template for the ship-from address (Transfer Header only)
Customer Address Template Code Report Address Templates Address Template for the customer address (Customer table documents)
Address Template Code Document Customizer Content Assigns a Report Address Template to this document; overrides Layout positions
Blank Local Country/Region Document Customizer Content Suppresses country when it matches the company's own country Enabled
Show Both Addresses Document Customizer Content Displays both bill-to and ship-to address blocks simultaneously Disabled
Currency Code Bank Accounts per Currency Currency that triggers selection of the linked bank account
Bank Account Bank Accounts per Currency The bank account to use when this currency/payment method combination is matched
Payment Method Bank Accounts per Currency Optional payment method filter for bank account selection