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:
- Open Address Fields (from Document Customizer Content → Address action, or by searching).
- The system comes pre-configured with address field definitions for all supported document tables. Review the existing rows to understand the current setup.
- 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.
- Enable Blank Local Country/Region in Document Customizer Content to suppress the country name for domestic addresses.
Using Address Templates (recommended for precise control):
- Open Address Templates and create a new template with a Code and Description. Set Table No. to the relevant BC document table.
- 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.
- For each line, optionally set Font, Font Size, Bold, Italic, or Underline for per-line typography.
- Set the template's address position (Address Vertical Position, Address Horizontal Position, alignment) to place the block precisely on the page.
- Create a Report Address Template that groups the individual Address Templates (Bill-to, Ship-to, Ship-from, Customer) for a specific BC table.
- 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:
- Open Address Fields and locate the rows for the Sales Invoice Header table with Type = Billto.
- 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.
- Ensure the Country field row uses Using Table = Country/Region and Using Field = Name (to show the country name rather than the code).
- 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:
- In Document Customizer Content, enable Show Both Addresses for the Sales Invoice.
- Ensure the Address Fields table has rows defined for both Type = Billto and Type = Shipto for the Sales Invoice Header table.
- 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:
- Create a new Address Template for the Sales Invoice Header table. Set:
- Address Vertical Position =
50, Address Vertical Pos. Unit =mm(usecmif mm is not available; 5 cm = 50 mm) - Address Horizontal Position =
25, unit =cm(2.5 cm) - Address Position Text Align =
Left
- Address Vertical Position =
- Add the address line rows in the template.
- Create a Report Address Template for the Sales Invoice Header table. Set the Bill-to Address Template Code to your new template.
- 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:
- Open the Address Template for the relevant document table.
- In the template Lines, find the row for the Name field.
- Enable Bold on that row.
- Leave all other rows with Bold unchecked.
- 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:
- In the Address Template (or classic Address Setup) for the Ship-to address type, add a row at the top of the sequence.
- 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.
- Enable New Line on this row so the caption appears on its own line above the name.
- 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:
- In Address Fields (or Address Template Lines), find the row for the country field.
- Set Field No. to the Country/Region Code field on the document table.
- Set Using Table to the Country/Region table.
- Set Using Field to the Name field on Country/Region.
- 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.
- 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:
- Open Bank Accounts per Currency from Document Customizer Content (or from the navigation).
- Add a row for each currency: set Currency Code to
EUR(orDKK) and Bank Account to the relevant bank account code. - 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).
- 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:
- Create an Address Template for the Bill-to address (table = Sales Invoice Header): define all fields and position settings.
- 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).
- Open Report Address Templates and create a new record with a code (e.g.
SINV-ADDR), set Table No. to Sales Invoice Header. - Set Bill-to Address Template Code to the bill-to template. Set Ship-to Address Template Code to the ship-to template.
- In Document Customizer Content, set Address Template Code to
SINV-ADDR. - 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:
- In Document Customizer Content, find the relevant document row and enable Blank Local Country/Region.
- Ensure the address rows include a country field configured with Using Table = Country/Region (so the Country Field flag is set).
- 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:
- 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).
- Create or update a Report Address Template for Transfer Header. Set Ship-from Address Template Code to the ship-from template.
- 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 | — |