Customer Portal can be configured for a variety of scenarios. This reference explains each setting and when it would be applicable.

Customer Portal Config

Customer Portal general configuration settings are accessible in SAP Business One using the Manager Add-On. Start the add-on and navigate to: zedSuite Manager > Administration > Customer Portal Config.

General Tab

The general tab is used to configure general settings related to Customer Portal. Expand the sections below for details.

Edit basic configuration details on the Customer Portal Config General tab.
Edit basic configuration details on the Customer Portal Config General tab.
General Tab sections
Basic Settings

As needed, allow users to reset their own password.

On the General tab (1), allow users to reset their own password (2);
On the General tab (1), allow users to reset their own password (2);

When checked, Enable users to reset password will prompt users to answer their security question, then email their registered address with a reset password link.

Single sign-on with zed eCommerce

On installations that include zed eCommerce, optionally manage settings related to single-sign-on.

Enable single sign-on (3); Assign a token name - typically NPX. (4); set a login page for zed eCommerce (5).
Enable single sign-on (3); Assign a token name - typically NPX. (4); set a login page for zed eCommerce (5).

If checked, Enable Single Sign on with zed eCommerce (marker 3) will direct all logins through the configured zed eCommerce login page (marker 5). If customized, the Single Sign On Login Page URL may be updated to your customized eCommerce login page, otherwise, the default login page may be used.

Ensure the Single Sign On Token Name is set to NPX. (note the dot at the end).

Report View editing settings

For installations with advanced reporting, configure Report View editing settings and roles.

Enable report view editing (6); configure an admin-level access role (7).
Enable report view editing (6); configure an admin-level access role (7).

Typical Customer users should not have access to this feature.

If checked, Enable Report View Editing (marker 6) allows users with the assigned role (marker 7) to edit report view layouts on behalf of other users.

This is appropriate for test administrator accounts, or for customers who have special access permissions, such as priority customers with customized reporting.

Configure Customer Portal Web Address

Configure this setting on all installations. This will allow admin settings to automatically refresh on the web.

Enter the Customer Portal web address (8) to update admin settings immediately. Enter the Search Engine Service Address (9) to enable B2B configuration.
Enter the Customer Portal web address (8) to update admin settings immediately. Enter the Search Engine Service Address (9) to enable B2B configuration.

Customer Portal Web Address points to the website URL, while Search Engine Service Address points to the B2B Marketplace search engine, if applicable. For installations of Customer Portal that does not implement B2B Marketplace, Search Engine Service Address must be left blank.

If configured, once you press the OK button, the website will be refreshed automatically.

If this setting is not configured, or if the website is inaccessible, configuration settings may be manually refreshed manually on the website using the URL /resetconfig.ashx. This will re-load config settings and redirect you to Customer Portal home page.

Email Setup Tab

Use the Email Setup tab to configure SMTP connection details and settings related to notification emails. Expand the sections below for more details.

Edit email and SMTP configuration details on the Customer Portal Config Email Setup tab.
Edit email and SMTP configuration details on the Customer Portal Config Email Setup tab.
Email Setup Tab sections
Default 'From' address

Configure this setting if email notifications are used.

Set the Default from address (1).
Set the Default from address (1).

The Default 'From' address for emails (marker 1) is used for outgoing emails when no override addresses are specified.

'From' address overrides

Configure these settings only if unique 'From' addresses are needed for specific feature notifications.

Override default 'from' address for specific emails (2), if desired; Configure Payment default from address (3), order default from address (4), service call default from address (5).
Override default 'from' address for specific emails (2), if desired; Configure Payment default from address (3), order default from address (4), service call default from address (5).

If checked, Override default 'from' address for specific emails (marker 2) will use the specified email addresses for those features. If unchecked, the default from address will be used for all features.

SMTP Connection Settings

Configure this section if email notifications are used.

Configure SMTP connection details.
Configure SMTP connection details.

Contact your email provider to determine which settings are needed to connect to your SMTP server.

Payments Tab

Use the Payments tab to define payment options per currency, as well as general options related to payments on Customer Portal. Expand the sections below for more details.

Edit payment gateway settings on the Customer Portal Config Payments tab.
Edit payment gateway settings on the Customer Portal Config Payments tab.
Payments Tab settings
General Settings

Review these settings for any system that accepts payments.

Enable pay on account (1); Allow paying quotes (2); Allow Partial Payments (3).
Enable pay on account (1); Allow paying quotes (2); Allow Partial Payments (3).

When checked, Enable pay on account allows customers to create payments against their account without selecting an invoice first. When unchecked, customers must select one or more invoice and pay directly against the selected invoices.

When checked, Allow Paying Quotes permits customers to select quotes to pay against.

When checked, Allow Partial Payment permits customers to pay a partial amount against a selected invoice. If unchecked, the whole invoice amounts must be paid for selected invoices.

Configuring payment options

If payments will be accepted on the web, perform the configuration below to set up payment options on a per-currency basis.

Note that for B2B installations, payments made at time of checkout will be captured, but must be settled manually within the time frame specified by the gateway vendor. ACH is not available for B2B checkout payments, but may be used to apply payments to invoices on the "Pay Balance" page.

Configure a payment gateway (4) or add a new gateway (5); delete the selected gateway configuration (6); Select supported countries (7).
Configure a payment gateway (4) or add a new gateway (5); delete the selected gateway configuration (6); Select supported countries (7).
Add a new gateway configuration using the plus button (marker 5 in the previous screenshot). This will open the New Gateway screen shown here.
Add a new gateway configuration using the plus button (marker 5 in the previous screenshot). This will open the New Gateway screen shown here.
Edit an existing gateway configuration using the golden arrow drill-down (marker 4 in the previous screenshot). This will open the Edit Gateway screen shown here.
Edit an existing gateway configuration using the golden arrow drill-down (marker 4 in the previous screenshot). This will open the Edit Gateway screen shown here.

Open the gateway configuration screen in either Edit or Add mode (marker 4 or 5 above). This will open the Payment Gateway details screen shown below.

Select the currency for this gateway (8); Enable this currency's gateway (9); Select the gateway provider (10) and configure that provider's credentials (11, 12, 13, 14); Special fields required by a gateway provider may be added (15, 16); Add supported credit card options (17).
Select the currency for this gateway (8); Enable this currency's gateway (9); Select the gateway provider (10) and configure that provider's credentials (11, 12, 13, 14); Special fields required by a gateway provider may be added (15, 16); Add supported credit card options (17).

First, select the currency (marker 8). If a gateway can be used by multiple currencies, settings must be configured seperately for each supported currency.

When the gateway is ready to be used on the web, enable the gateway (marker 9). Configure the gateway details (markers 10 through 14) as defined by your gateway vendor. If required by the vendor, additional custom fields may be added using the Special Fields section (markers 15 and 16).

Note that the instructions above apply whether you're configuring Credit Card gateway details as shown in the screenshot above, or ACH gateway details as shown in the screenshot below.

ACH payments are only available in USD currency.

For USD only, ACH may be configured: Enable ACH (9); Select the gateway provider (10) and configure that provider's credentials (11, 12, 13, 14); Special fields required by a gateway provider may be added (15, 16).
For USD only, ACH may be configured: Enable ACH (9); Select the gateway provider (10) and configure that provider's credentials (11, 12, 13, 14); Special fields required by a gateway provider may be added (15, 16).
Ogone payment gateway advanced settings

Apply these advanced settings when configuring Ogone payment gateway.

For Merchant Login, use the PSPID (1); For Merchant Password, use your password (2); Add a special field, named APIUSERID, and set the value as per your account (3).
For Merchant Login, use the PSPID (1); For Merchant Password, use your password (2); Add a special field, named APIUSERID, and set the value as per your account (3).

Ogone Payment gateway requires special settings, as shown in the screenshot above. Configure the payment gateway (see the section above "Configuring payment options"), noting these Ogone-specific settings:

  • For Merchant ID, use your Ogone PSPID. See marker 1 in the screenshot above.

  • Ensure your Merchant Password is set to your Ogone password. See marker 2 in the screenshot above.

  • Make sure to add a Special Field. Set the Field to APIUSERID and set the Value to your unique API User ID. See marker 3 in the screenshot above.

Payment Transaction Folder setup

Configure this setting for any system that accepts payments.

Specify a folder on the web server (18).
Specify a folder on the web server (18).

This folder is used to save payment transaction records on the web server. Files saved here contain basic details such as a transaction ID from the payment provider and the payment amount, but does not include secure details such as credit card number.

Ensure this folder is configured for any system where payments are accepted. Also, ensure this folder permits write-access by the IIS user assigned to Customer Portal (typically NETWORK SERVICE).

Configure email notifications for payments

Configure these settings if email notifications should be sent when web payments are made by a customer.

Send an email to the customer after web payment (19); Send an email to accounting after web payment (20 and 21).
Send an email to the customer after web payment (19); Send an email to accounting after web payment (20 and 21).

If the customer user should receive an email notification after they have made a payment on the web, the option Notify user on receipt of payment (marker 19) should be checked. This will not send an email if a payment has been created in SAP Business One, only if the payment has been originated by the user on Customer Portal.

If checked, Notify account of receipt of pay (marker 20) will send a notification email to the specified accounting email address (marker 21).

Service Calls Tab

Use this tab to manage Service Call settings.

Edit settings related to Service Calls.
Edit settings related to Service Calls.
Service Calls Tab settings
Service Calls Tab settings

Configure this section only if Service Call functionality will be used.

Enable attachments (1) and configure upload settings (2 and 3); Enable custom service call processing (4); Enable email noficiations (5, 6, 7).
Enable attachments (1) and configure upload settings (2 and 3); Enable custom service call processing (4); Enable email noficiations (5, 6, 7).

If the Service Call module is used in SAP Business One, this may be enabled on the web as well.

If checked, Enable Attachments (marker 1) allows users to upload certain file types (specified on the web front-end), and they will be uploaded to the URL and folder specified (markers 2 and 3). Note that attachments are web-only and will not be loaded directly into SAP Business One.

If service calls must be custom processed using XSLT, check Enable service call xslt processing. This will apply the XSLT before loading the Service Call into SAP Business One.

If you have an email address for your service team, you may enable email notifications (marker 6) and provide a service desk email address (marker 7). This will generate an email whenever the customer creates a new service call on the web.

Shipping Tab

Use this tab to enable tracking number links on Customer Portal.

Use this tab to enable shipment tracking links on Customer Portal.
Use this tab to enable shipment tracking links on Customer Portal.
Shipping Tab settings
Shipping Tab settings

Configure these settings if tracking numbers are used for deliveries in SAP Business One.

Enable tracking number links (1); Enable a fall-back lookup (2 and 3) if the configured providers (4) don't match the tracking number.
Enable tracking number links (1); Enable a fall-back lookup (2 and 3) if the configured providers (4) don't match the tracking number.

If checked, Enable Tracking Numbers (marker 1) creates a link on Delivery tracking numbers. The link uses a Regular Expression (RegEx) configured based on provider (marker 4), and if the RegEx pattern doesn't match what's been entered in the tracking number field, the fallback provider will be linked (marker 3) instead.

Welcome Tab (deprecated)

If you see the “Welcome” Tab, this indicates that you have a previous version of Customer Portal. Visit our Documentation Archive for your specific version to see this and other version-specific settings.

To update “Welcome message” settings for the Customer Portal landing page, this may be edited within the website’s AppStrings file: /App_GlobalResources/AppStrings.resx. Edit the value corresponding to the tags below:

Tag Purpose Default Value
PageHeader Displayed as the heading for the landing page. Welcome to CUSTOMER PORTAL!
WelcomeImage If configured, the configured image file is displayed on the landing page. (blank - no image is displayed by default)
WelcomeLink If configured, a link is displayed on the landing page. This opens in a new browser tab. (blank - no link is displayed by default)
WelcomeText If configured, additional text is displayed on the landing page. (blank - no details are displayed by default)

Customer Portal Order Pad

Order Pad configuration settings for Customer Portal are accessible in SAP Business One using the Manager Add-On. Start the add-on and navigate to: zedSuite Manager > Administration > Customer Portal Order Pad.

General Tab

Use the General tab to configure settings related to Customer Portal orders and quotes, and order/quote notifications.

Edit settings related to orders, order notifications and additional fields.
Edit settings related to orders, order notifications and additional fields.
Order Pad Configuration
Basic Order Pad Settings

Review these settings on any system that uses Order Pad.

Select the Order Type (1); Configure Custom Address settings (2 and 3); Enable Orders (4) and/or Quotes (5); Enable editing Orders (6) and/or Quotes (7); Allow quick-add entry (8); Enable Simple Checkout Mode for non-B2B implementations (9).
Select the Order Type (1); Configure Custom Address settings (2 and 3); Enable Orders (4) and/or Quotes (5); Enable editing Orders (6) and/or Quotes (7); Allow quick-add entry (8); Enable Simple Checkout Mode for non-B2B implementations (9).

Order Type (marker 1 above) may be Unapproved Order or Sales Order. If Unapproved Order, the order must first be manually approved in the order's logistics tab within SAP Business One, otherwise, the order will be a normal Sales Order document.

Note that this setting is restricted based on the B1 Per Document setting for sales orders, found in Administration > System Initialization > Document Settings > Per Document tab > Sales Order document. If this setting is un-checked, the portal setting above will not apply.

Administration - System Initialization - Document Settings - Per Document tab - Sales Order document: When it is un-checked, the Sales Order Approved setting overrides Customer Portal Order Pad approval settings.
Administration - System Initialization - Document Settings - Per Document tab - Sales Order document: When it is un-checked, the Sales Order Approved setting overrides Customer Portal Order Pad approval settings.

Note: If this setting is changed, users must log out and log back in again to see this change. This may be enforced by recycling the Portal website's application pool in IIS.

If checked, Enable Custom Addresses (marker 2) allows the customer to create an address during checkout. The selected tax rate (marker 3) will be applied to all such addresses.

If checked, Allow Creating Orders (marker 4) and Allow Creating Quotes (marker 5) allows customers to submit Orders and Quotes online. Both may be enabled at once, or just a single option may be enabled.

If checked, Enable QuickAdd Query (marker 8) allows a customer to view a multiple-item quick entry form based on the QuickAdd query. This query can be customized with an implementation customization.

Order Pad Email Notifications

Configure this section only if email notifications are required after a customer has placed a web order.

Send an email to the customer who placed the order (10); Send an email to the customer's sales person (11); Send an email to a specified address (12, 13); Notify an admin upon order errors (14, 15).
Send an email to the customer who placed the order (10); Send an email to the customer's sales person (11); Send an email to a specified address (12, 13); Notify an admin upon order errors (14, 15).

If checked, Notify user of new orders\Quotes (marker 10) will send an email to the customer who placed the order. This can be used as an automated order confirmation, and is appropriate in systems where the Order Type is set to Sales Order.

If checked, Notify sales employee of new orders\Quotes (marker 11) will send an email to the customer's assigned sales employee, if an email address is associated with that employee master data record.

If checked, Notify inside sales of new orders\Quotes (marker 12) will send an email to the configured email address (marker 13) whenever any customer places a web order.

If checked, Notify admin user of order pad failure (marker 14) will send an email to the configured admin email address (marker 15) only when a customer encounters an error during web order creation.

OP UDFs Tab

Use the OP UDFs Tab to configure User Defined Fields (UDFs) for web orders. Out-of-the-box, support is provided to document header UDFs (for ex. UDF’s on the ORDR database table or OQUT database table) and document lines (for ex. UDF’s on the RDR1 database table or QUT1 database table).

Configure Additional Fields for Order Pad.
Configure Additional Fields for Order Pad.
Order Pad Configuration
Header-level Additional Fields

Header-level Additional Fields are applied to the document header (ex. ORDR table or OQUT table). Header-level Additional Fields can be configured on the top section of this tab.

Configure Additional Fields on Order Pad using the top section. Shown here, Header-level configuration.
Configure Additional Fields on Order Pad using the top section. Shown here, Header-level configuration.
Select a field (1); Give the field a user-friendly name (2); Set whether a user must complete the field (3); Set whether a user can see this field (4); Configure valid value settings based on a query (5).
Select a field (1); Give the field a user-friendly name (2); Set whether a user must complete the field (3); Set whether a user can see this field (4); Configure valid value settings based on a query (5).

From the field details screen, select the field (marker 1) and give it a user-friendly name (marker 2). Note that the available fields include all configured UDFs on the Order document (header) level. Also included are a subset of core fields from SAP Business One.

If checked, Is Required? (marker 3) will prevent the order from being submitted until a value is selected for this field.

If checked, Active (marker 4) will display this field to the user.

If checked, Use a query to provide Valid Values on web? (marker 5) will allow a user to only select from a set of values, as defined by the query. If the selected field is defined as a UDF with Valid Values, these will be displayed automatically without configuring this query, however you may use this query to display a subset of the available options.

Line-level Additional Fields

Line-level Additional Fields are applied to the document lines (ex. RDR1 table or QUT1 table). Line-level Additional Fields can be configured on the bottom section of this tab.

Configure Additional Fields on Order Pad using the bottom section. Shown here, Line-level configuration.
Configure Additional Fields on Order Pad using the bottom section. Shown here, Line-level configuration.
Select a field (1); Give the field a user-friendly name (2); Set whether a user must complete the field (3); Set whether a user can see this field (4); Configure valid value settings based on a query (5).
Select a field (1); Give the field a user-friendly name (2); Set whether a user must complete the field (3); Set whether a user can see this field (4); Configure valid value settings based on a query (5).

From the field details screen, select the field (marker 1) and give it a user-friendly name (marker 2). Note that the available fields include all configured UDFs on the document line level. Also included are a subset of core fields from SAP Business One.

If checked, Is Required? (marker 3) will prevent the order from being submitted until a value is selected for this field.

If checked, Active (marker 4) will display this field to the user.

If checked, Use a query to provide Valid Values on web? (marker 5) will allow a user to only select from a set of values, as defined by the query. If the selected field is defined as a UDF with Valid Values, these will be displayed automatically without configuring this query, however you may use this query to display a subset of the available options.

B2B Global Config

B2B Global Config applies only to B2B Marketplace implementations. To configure Global B2B settings, in SAP Business One, start the Manager Add-On and go to: zedSuite Manager > Customer Portal B2B > Setup > Global Config.

This will load the screen below:

Configure default settings for B2B Marketplace.
Configure default settings for B2B Marketplace.
B2B Marketplace Configuration Settings
Global Config (B2B)

Apply global defaults for B2B Marketplace. These settings may be overridden at the customer level, store front level, or product level.

Store Front sets the default store front layout that will be used by B2B Marketplace. Customers may be assigned another Store Front using Business Partner configuration.

Shipping Group sets the default shipping group assigned to customers who use B2B Marketplace. Customers may be assigned to another Shipping Group using Business Partner Configuration.

Search Results Layout sets the default Search Collection assigned to a B2B Marektplace web store. This may be overridden in Store Front configuration settings.

Product Details Template sets the default template used to display products within a B2B Marketplace web store. This may be overridden in Web Product configuration options.