Skip to main content

Document Layout Setup

Theta Document Template Setup

This setup allows you to adjust settings related to all the Theta Document layouts.

Document Template Setup - 1

General

FieldDescription
Default LanguageSpecifies the language code for documents to use as a default. Supported languages: ENZ, ENA and ENU. You will generally select this if you are an NZ or AU user that needs to print documents in a different company that is a foreign entity. If a customer or vendor has a language code specified, this will be copied to their related documents and used instead of the value specified here.
Use Responsibility CenterSpecifies that the documents will use the Responsibility Center's details instead of the company information. Read here for more information.
Set Assigned User Id as creator (Internal)Specifies that the Assigned User ID defaults to the creator for Transfer Orders, Production Orders and Assembly Orders

Contact Information

FieldDescription
Sales Phone No.Specifies the phone no. that should be printed on sales documents.
Sales Fax No.Specifies the fax no. that should be printed on sales documents.
Sales EmailSpecifies the email address the app should print on sales documents.
Purchases Phone No.Specifies the phone no. that should be printed on purchase documents.
Purchases Fax No.Specifies the fax no. that should be printed on purchase documents.
Purchases EmailSpecifies the email address the app should print on purchase documents.
note

If you do not specify values for any of the above fields, the app will use the values from the company information. You only need to specify values that are different to the company information.

info
  • If you specify to use Responsibility Center details, the contact details are sourced from the Responsibility Center.
  • You can also specify the Phone, Fax and Email on the Theta Document Settings for the report.

Document Formatting

FieldDescription
Log Position on DocumentsSpecifies the Logo Position on printed documents.
Show GST/ABN No.Specifies whether to print the company's GST Registration No. or ABN on documents.
Date Format TextSpecifies the long date format to be used in Documents like the Sales Invoice etc.
Short Date Format TextSpecifies the short date format for documents. The short-date format gets used on the lines of documents where space is limited.
Display LCY SymbolSpecifies if the app should display the local currency symbol with amounts shown on the documents.
LCY SymbolSpecifies the symbol that the app uses to represent local currency amounts.
info

Here's a link to the Microsoft help on date formats.

Sales and Purchase

This app also provides some additional features in sales and purchase document processing.

Document Template Setup - 2

Sales

FieldDescription
Set Assigned User ID as Creator (SO)Specifies that the Assigned User ID field defaults to the creator in sales documents
Email Sales Order To Customer On ReleaseSpecifies that the sales order will be emailed to the customer when it is first released (or approved if workflows are configured).
Email Sales Return Order To Customer On ReleaseSpecifies that the sales return order will be emailed to the customer when it is first released (or approved if workflows are configured).
Print Packing Slip on Register PickSpecifies that a packing slip should be printed when a warehouse pick is registered.
Use Sales Order Packing SlipSpecifies that you can print or email a packing slip from the sales order before the sales order is shipped. This feature is not enabled by default because most companies prefer to produce packing slips based on posted shipments.
Use Proforma Credit MemoSpecifies that you can print or email a Proforma Credit Memo from the Sales Credit Memo page. Most companies prefer to provide details of the credit only after it is posted, so this is not enabled by default.
Show Prices On ShipmentSpecify if prices should be shown on the sales shipment/packing slip. You can also change this for individual customers on the customer card. The setting here will be used as a default but is overridden by the customer setting.
Email Sales Return Order To Customer On Release Options
OptionDescription
-The app will not send Emails automatically.
Send to External EmailsThe email gets sent to the external email configured for the sales document in the following priority: The document layout (if specified), else the Email field from the sales document (if specified), else the customer email address (if specified) else the contact email (if specified)
Send Internally When External Emails Not FoundThe email gets sent emailed to the customer if the email address can be determined (as above); else, it is sent internally in the following priority: Salesperson, Assigned User, Created by User.
note

The app will only even send the document automatically once. If you reopen and rerelease the sales order, the program does not send it again.

Purchases

FieldDescription
Set Assigned User Id as Creator (PO)Specifies that Assigned User ID field defaults to the creator in purchase documents
Email Order To Vendor On ReleaseSpecifies that the purchase order will be emailed to the vendor when it is first released (or approved if workflows are configured).
Allow Unpriced Purchase OrdersSpecifies that it is possible to select to print an unpriced purchase order. The default is to print a priced order even when set, but you can change this on the purchase order. A scenario where you could use this is for repair services where the provider can only determine the cost after the service has been delivered
Use Draft Purchase InvoiceSpecifies that you can print or email a Draft Purchase Invoice before posting it. You could use this in scenarios where you raise the purchase invoice based on the information you hold, and you want to share this with your vendor before posting the invoice (e.g. Consignment Inventory or Buyer-Created Tax Invoices).
Email Order To Vendor On Release Options
OptionDescription
-The app will not send Emails automatically.
Send to External EmailsThe email gets sent to the external email configured for the purchase document in the following priority: The document layout (if specified), else the Email field from the purchase document (if specified in the buy-from section), else the contact email (if specified), else the vendor email address (if specified).
Send Internally When External Emails Not FoundThe email gets emailed to the vendor if the email address can be determined (as above). Else, it is sent internally in the following priority: Purchaser, Assigned User, Created by User
note

The app will only even send the document automatically once. If you reopen and rerelease the purchase order, the program does not send it again.

Exclude Users for Subscription Purposes

There is often a requirement for implementation consultants to have licensed users in your environment. These users can be excluded from the user count by your partner. This can prevent you from being pushed into a different pricing tier when your total user count is close to the threshold. Your partner can specify the users that should be excluded. To do this, click the Exclude Users from User Count action. The following page gets opened:

User Authorisation

  1. Select the users that should not be counted towards the total user count.
  2. Enter the subscription key. The subscription key is only available to implementation partners.
  3. Click the Save Changes action.

Clicking the Check User Count action will display a message confirming the user count.

User Count

note

The user count only includes enabled users with an Essentials, Premium or Device license. The users specified in this list only get excluded if they are enabled and have an Essentials, Premium or Device license. GDAP or CSP users get excluded from the user count and do not need to be specified here.

Responsibility Centers with different company details

The Base Pack can use responsibility centres to change the company information shown on documents, including logos. Enable Use Responsibility on Theta Document Template Setup to enable this feature.

Responsibility Center Card

Additional Fields

|Field|Purpose| |Picture|You can load a different logo for the responsibility center, which the app can use for your documents.| |GST Registration No.|You can specify a different GST Registration number here if the entity the responsibility centre represents has a different GST Registration No. Do not specify a value here if you only have one registration number.| |ABN|You can specify a different ABN here if the entity the responsibility centre represents has a different ABN. Do not specify a value here if you only have one registration number.| |Show GST/ABN No.|This field overrides the setting specified on Theta Document Template Setup.|

Changing the document layout

Business Central allows you to create different document layouts for reports. The standard Business Central functionality allows you to change the layouts without doing any customisation. However, you cannot add additional fields without first doing customisation. The Theta Document Layouts allow you to add custom fields to the layouts without having to do customisation. To change the layouts you will need to be familiar with the Business Central help on this topic.

Theta Document Settings

Here you can adjust settings for the different document layouts. You can also configure custom fields, which you can add to the document layout.

Document Settings

Fields - General

FieldPurpose
Report TypeSpecifies the report type concerning Document Extended Text. This only relates to sales documents.
Prevent Settings InitialisationSpecifies that the document settings and custom fields will not be updated automatically from defaults defined in a custom extension. You can do this if a specific company significantly differs from the default values and do not want this to change.
Lines on First PageSpecifies the number of lines that can print on the first page of a report. As the Theta document templates usually print additional header information on the first page, this number is usually lower than what can print on subsequent pages.
Lines After First PageSpecifies the number of lines that can print on subsequent report pages.
Additional Footer LinesSpecifies an additional number of lines taken up by a custom footer on the report layout.
Place Footer at BottomSpecifies if the footer should always print at the bottom of the document. When this is selected, the report will print additional blank lines to accommodate the additional lines. The default setting is Yes.
Hide Company GST/ABNSpecifies that the document will not show your Company GST/ABN number.
Hide Customer/Vendor GST/ABNSpecifies that the document will not show your Customer or Vendor GST/ABN number.
Show Zero LinesSpecifies if the lines and their relevant comment lines (comments under the actual line) are printed if the quantity on the line is zero.
Show Serial/Lot No.Show Serial/Lot details on the document. Not all documents support this feature.
Allow Print/Send if OpenSpecify if you wish to allow documents that are not released to be printed or sent. This feature is used for unposted documents such as purchase orders or sales order confirmations.
Show Shipping DetailsSpecifies if the document should display the shipments/returns details on the sales invoice and credit memo.
Vendor/Customer Item No.Specify if the Vendor or Customer Item number gets shown as an additional line or column. Note that the default layout does not have a column for the vendor/customer item number, so you must apply a custom layout if you want an additional column.
Hide Description 2The value from the Description 2 field will be appended to the description. Select this if you do not wish to print the Description 2.
Description WidthSpecifies the width of the description field on this document. If not specified, the default of 50 characters gets used due to space limitations in the default layout.
Comment WidthSpecifies the width of the description field for comment lines on this document. If not specified, the default of 50 characters gets used due to space limitations in the default layout.
Barcode TypeSpecify if you wish to generate a barcode on the report. Not all documents support this feature.
Document NameSpecifies the document name that will print on the report. Note: remember to specify %1 as a placeholder for the word "Copy" if you want to show when the document is getting reprinted. Alternatively, you can remove the %1 placeholder if you do not wish to print the word 'Copy'.
Copy Name StringAllows you to optionally specify a copy name for each copy that gets printed. When printing more than one copy at a time, you can also specify a comma-separated string to assign a different name to each copy (e.g. Sales Shipment - Internal Copy,Sales Shipment - Customer Copy)
Default No. of CopiesDefault No. of Copies
Legal NoticeSpecifies a legal notice that will print on the document if the layout provides this. Use the assist edit button if you wish to make changes. You can use HTML in this field to include hyperlinks and other formatting.
E-MailSpecify the email address the app should use for this document's company information instead of the default.
Phone No.Specify the phone number the app should use for this document's company information instead of the default.
Fax No.Specify the fax number the app should use for this document's company information instead of the default.

Responsibility Centers

If you want to show different company details for responsibility centers, you can also show other contact details, legal notices and email bodies. On this sub-page on the Theta Document Settings, you can add a record per responsibility center and record this information.

Responsibility Centers

note
  • You need to enable Use Responsibility Center on Theta Document Template Setup to show different company details for responsibility centers.
  • Creating a record here will replace the same values from the document settings when the document relates to the current responsibility center.
  • If the customer/vendor has an email body selected on a custom layout, then the app will use this in preference to the one specified on the responsibility center.

Custom Fields

Here you can select additional fields that you want to display on your document. You can then add these fields to the document layout.

tip

You can also specify default custom fields in an extension. This allows you to publish the default custom fields when you deploy your extension. You can also use the sample extension as a starting point or use the code snippets.

System Fields

The system fields feature allows you to change the format of fields that print on the document. The different documents have different system fields that can be changed. Here is an example of the Customer Statement's system fields:

System Fields

For the Customer Statement, you can change the captions of the fields and columns that display on the report.

Copy Setup

This function allows you to:

  • Copy the setup from one report to another report within the same company. For example, copy the setup from the Sales Invoice to the Sales Credit Memo.
  • Copy the setup from the same report in a different company. For example, copy the setup from the invoice in a different company.
  • Specify more than one destination company. For example, copy the setup from the invoice to all other companies.

Copy Settings

FieldDescription
Source ReportThis is the report from which you want to copy the setup.
To ReportThis is the report to which you want to copy the settings. The Source Report and To Report can be different (for example, you want to copy the settings from an invoice to a credit memo).
Copy from CompanySpecifies the company from which the app will copy the settings.
Copy to Multiple CompaniesSpecifies that you wish to copy the settings to multiple companies. When you select this, the companies page gets opened. You can select one or more companies here by highlighting the companies.
Company FilterThis shows a filter representing the companies to which the app will copy the setup.
Copy Custom Field MappingSpecifies that the app will copy the custom field mapping. This will result in the To Report's custom field mapping and system field settings getting replaced by the source report's settings.
Replace MappingSpecifies that the app will replace the custom field mapping. You can choose not to replace data, replace only copied IDs or replace All.
Copy Report SettingsSpecifies that the app will copy the document settings.
tip

You can also specify default custom fields in an extension. This allows you to publish the default custom fields when you deploy your extension. You can also use the sample extension as a starting point or use the code snippets.

Bank Details on Documents

This feature allows you specify scenarios in which you want different bank details to be used by your customers.

Email Name Formats

This feature allows you to configure the subjects of the emails and the attachment file names when sending documents.

Email Name Formats

Fields

FieldDescription
UsageSpecifies the report usage for which the email name format is defined.
EnableSpecifies that this setup is enabled. This setup will only be used if the setup is enabled.
Subject FormatSpecifies the format of the string that gets generated for the subject. This field can include free text and use tokens that you can map to fields from the table related to the document.
Attachment FormatSpecifies the format of the string that gets generated for the attachment filename. This field can include free text and use tokens that you can map to fields from the table related to the document. If you do not specify this field, then Business Central will use the default name.
info

The email name formats for remittance advices get created when the app gets installed to provide more meaningful details than the Business Central standard for these reports.

Token Translations

The Token Translations are used to map fields to place holders in the subject and attachment filenames.

Token Translations

In the example above, the following applies

  • %P1% gets replaced with the EFT No. of the EFT Transfer.
  • %P2% gets replaced with the Source No. of the EFT Transfer. The Source No. on the EFT Transfer is the Vendor, Customer or Employee number.
  • %P3% replaced with the Source No. of the EFT Transfer. The Source No. on the EFT Transfer is the Vendor, Customer or Employee name.

Document Email Log

The records on this page get created when a document gets successfully sent. From this page, you can see when Business Central sent an email and to whom Business Central sent it. The document email log provides more structured data tailored for document sending. We use this data for our automated sales document sending batch job to prevent duplication of sending.