Fields on the Country Maintenance page


Country tab

Province tab


Country tab

Setting the country name and IDs

Country name In the Country name field, type or edit the name of the country. For example, France.
Pub ID In the Pub ID field, type the ID number assigned to the country by the publisher.
Active To make the country available to select in Poetic, check the Active check box.

If the check box is not checked, then this country is not available to be selected anywhere else in Poetic, including for addresses, currencies, and languages.

ISO 2 and ISO 3 In the ISO 2 and ISO 3 fields, type the country codes as defined by the International Standards Organization.

Setting the language and time zone

Default language From the Default language dropdown, select the standard language used in Poetic for the country.
Time zone From the Time zone dropdown, select the default time zone for the country.

Setting the name and address format requirements

Name format From the Name format dropdown, select the format used for capturing and displaying user names.

On Poetic pages, name information displays in the format selected for the country in which the current user is located based on the mailing address.

This allows users to view information in the format they are familiar with.

Address format From the Address format dropdown, select the format used for addresses.

As with name information, on a Poetic page address fields display in the format selected for the user's country.

Province/state required To indicate that a province or state is required as part of the address for companies located in this country, check the Province/state required check box.
Zip code required To require a zip code for addresses located in the country, check the Zip code required check box.
Zip code pattern In the Zip code pattern field, type the zip code pattern for the country. This is used to validate the information entered by users. Zip code patterns are regular expressions. Within a pattern, some of the more commonly used elements are:
  • [A-Z] represents a single uppercase letter.
  • [a-z] represents a single lowercase letter
  • \d represents a single digit.
  • \w{6} represents a string of letters or numbers. The number in the braces indicates the number of characters.
  • \d{6} represents a string of digits. The number in the braces indicates the number of digits.
  • ()? indicates that the information enclosed in the parentheses is optional

You can then include spaces, punctuation, and other text as needed.

More detailed information about regular expressions is available online. One source is the documentation for the Java Pattern class.

For example:

  • For a country whose zip code is 4 letters, the pattern is "\w{4}", with a sample code being OFCW.
  • For Canada, the pattern would be "[A-Z]\d[A-Z] \d[A-Z]\d", with a sample zip code being L1X 8B8.
  • For Finland, the pattern would be "FIN-\d{5}", with a sample zip code being FIN-12345.

If part of the zip code is optional, as with the 4-digit extension in the U.S., you can place that portion in parentheses followed by a question mark.

The pattern for the U.S. zip code is "\d{5}(-\d{4})?".

Display zip code format In the Display zip code format field, type the sample format to display in error messages when a user enters a zip code incorrectly.

In the field, A represents a letter, and # represents a number

You can then include spaces, punctuation, and other text as needed.

For example:

  • For a country whose zip code consists of 4 letters, the display would be "AAAA", with a sample code being OFCW.
  • For Canada, the display is "A#A #A#", with a sample zip code being L1X 8B8.
  • In Finland, the display is "FIN-#####", with a sample zip code being FIN-12345.

You can also use "or" to set up alternate zip codes. For example, U.S. postal codes consist of 5 digits, with an optional 4-digit extension.

The display format is then "##### or #####-####", with sample codes being 12345 or 12345-6789.

Address validation option From the Address validation option dropdown, select the type of address validation requirement for this country. Address validation involves having a third-party system verify that an entered address exists. If the address is close to an existing address or addresses, the user is given the option to select a matching address.

To never validate addresses for this country, select None.

To only validate order ship-to addresses for this country, select Order ship-tos only.

To validate all ship-to addresses for this country, select All ship-tos.

Setting tax and payment information for the country

Taxation type From the Taxation type dropdown, select the method used to calculate the tax on orders for this country.
Tax rate If the taxation type is Country rate, then in the Tax rate field, type the tax rate charged in the country or province.
VAT number display format In the VAT number display format field, type the format of the country's Value Added Tax number.
VAT number validation In the VAT number validation field, type the validation format for identifying Value Added Tax numbers for the country.
Default currency From the Default currency dropdown, select the currency to use for the country unless another currency is selected.
Currencies allowed Lists the currencies for which this country has been allowed.

This list is empty until you use the currency maintenance function to add the country to the list for at least one currency. See Adding and editing currencies.

Default payment method From the Default payment method dropdown, select the payment method used for the country unless another method is selected.
Other payment methods allowed Lists the payment methods accepted in the country.

This list is empty until you have used the payment method maintenance function to add the country to the list for at least one payment method. See Adding and editing order payment methods.

Allow freight on board (FOB) To have the publisher pay shipping charges for shipments to the country, check the Allow freight on board (FOB) check box.

Back to top

Province tab

The Province tab contains a table listing the provinces that make up the country. For each province:

Province Name In the Province Name column, type the name of the province or state. The province name is what displays in dropdowns.
Active To make the province available to be selected in Poetic, check the Active check box.

If the check box is not checked, this province cannot be used as a part of any address.

Pub ID In the Pub ID column, type the identifier assigned to the province by the publisher.
Province Code In the Province Code column, type the code stored in the database to represent the province.
Province Tax Rate If the taxation type for the country is Country rate, then in the Province Tax Rate column, type the tax rate used in the province.
Time Zone In the Time Zone column, select the time zone in which the province is located.

If the entire country is located within a single time zone, you do not need to select a time zone for each province.

Back to top