Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

...

User Debtor Integration allows for 2-way integration between

...

certain Website Users and PRONTO debtors.

...

For most sites that use this feature, Users are typically the B2C Roles but can be custom-defined B2B ones as well, depending on your business needs. The integration process ensures that when Website Users matching your User Debtor criteria register accounts, corresponding PRONTO customers will also be created.

...

Likewise, new PRONTO

...

debtor customers will trigger the creation of linked Website Users. Integration also extends to

...

User and customer updates

...

. For example, if a User changes their shipping address online, their linked PRONTO

...

customer record will also be updated.


Multiexcerpt
hiddentrue
MultiExcerptNameFeature Overview

Allows for 2-way integration between certain Website Users and PRONTO debtors to ensure new debtors and website users are synchronised and consistent across the various retail channels. 

...

User Debtor Integration is primarily of use to our

...

clients that use an ERP as well as online to maintain customer records, e.g,, those with physical, brick and mortar shopfronts. The process is there to ensure customer experience is synchronised and consistent across the various retail channels. Order history is maintained, communication is uninterrupted, and data is always up-to-date. Depending on your website version, this feature can also ensure that for Users that are active in more than one Customer account, their User records are always updated against specific Customers.

Implementation

Due to complex field mappings between your ERP (PRONTO) and the website, it is not advisable that this functionality is self-implemented. If you're interested in User Debtor Integration for your site, please contact Commerce Vision for guidance. 


Panel

On this page:

Table of Contents




Example scenarios

1. Online

...

to PRONTO

Any time a Website User that matches your PRONTO User Debtor criteria is created, a linked PRONTO customer will be created. 

    1. A new User registers on your website.

...

    1.  
    2. If their default role matches

...

    1. your User Debtor criteria

...

    1. ,

...

    1. a new PRONTO account is automatically created

...

    1. The User logs into your site and updates their details (billing address, phone number)
    2. On integration, the

...

    1. PRONTO record is also updated.

...

    1.  
    2. The User enters one of your physical store locations and makes a purchase. 
    3. At the point of sale, their email address

...

    1. is queried and the

...

    1. transaction is linked to their

...

    1. PRONTO customer account, ensuring order history data is complete.
    2. The User logs in and navigates to the Order History page. 

...

    1. All orders, both online and in store, are visible in the User's history. 


2. PRONTO to online

When a new PRONTO debtor customer record is created, it will trigger the creation of a linked Website User on your website.

    1. There is a new offline customer, e.g., they enter your retail location and makes a purchase

...

    1. , are added by your sales rep, or their credit account application is successful, etc. 
    2. A new PRONTO account is created

...

    1. .   
    2. On integration, a linked Website User is created. 
    3. The new User is sent an email advising them of their Website login details

...

    1. . NOTE - if Auto Part Registration is active for a Customer account, the User must be approved before the registration process continues. 
    2. The User logs in and can now: 
      1. update contact and delivery information 
      2. view Order History
      3. purchase online.   
         
Info

...

Minimum version requirements: 

  • Customer Self Service version 3.88
  • Commerce Vision Integrator version 4.63
  • PRONTO proledb version 3.11 

 

Implementation guide

To Enable and Configure User Debtor Integration: 

...

Update the values as required. Settings are defined below:

...

For sites on versions 4.31,

Multiexcerpt include
MultiExcerptName4.25
PageWithExcerptLTS 2021 actual min. versions
an enhancement is available for scenarios where a debtor user is linked to more than one debtor customer account (using CrmContacts and Crm Master) in PRONTO. On integration, the system checks all Website User records against contacts for debtor customers. A User record linked to a specific Customer will be created if one does not exist. The User will be sent a new user registration email.    

  Example:

  1. There is a new offline customer or an additional contact is entered for an existing debtor customer. 
  2. For the new customer, a debtor customer PRONTO account is created.   
  3. On integration, the system checks User Customer records for Customers flagged as Debtor customers. A Website User linked to the Customer is created if it does not exist. 
  4. The User is sent a registration email advising them of their Website login details.


Sample Emails 

Content of emails can be edited in the following templates via the Content menu (Content Emails):

  • User Debtor New User Email
  • User Debtor Warning / Error Email
User Debtor New User EmailUser Debtor Warning / Error Email - Warning Email to Administrator (data conflicts)
Image Added
Image Added


User Debtor Settings

If applicable, these settings are available after implementation of the User Debtor feature for your site. 


  1. Navigate to SettingsFeature ManagementUser.

  2. Toggle ON User Debtor Integration, then click Configure. NOTE - If this toggle is not available, contact Commerce Vision.
    Image Added

  3. Configure settings in the User Debtor Feature Settings page.
     

    SettingComment
    Enable User Debtor SettingTo enable the User Debtor on your site, toggle ON.
    User Roles that require a PRONTO Account

    Enter one or more user Roles that trigger creation of a PRONTO debtor. For multiple role entry, each role entered must be separated by a comma. 

    When a user is assigned one of these roles online, upon integration, a PRONTO debtor is created.

    Prefix for New PRONTO Accounts

    Enter the prefix that added to the debtor code when it’s created in PRONTO

...

  1. . This is prepended to a numeric value and assigned as the

...

  1. website user’s customer code.

    Example: WEB_

...

  1. Customer

...

  1. Template for New PRONTO AccountsEnter the base PRONTO debtor code that all new customers are copied from

...

  1. . Using this ensures correct pricing structure, tax code,

...

  1. etc.
    Default Role

...

  1. for New Web Users

...

  1. Enter the default role the new user is assigned online when a customer makes an instore purchase and the new PRONTO debtor triggers creation of the

...

  1. website user.

...

  1. Send Warning Emails To

    Enter the email address for receipt of errors

...

  1. and warnings

...

  1. sent by the system. Examples of notifications: when. a PRONTO debtor is deleted,

...

  1. a PRONTO debtor's email address is updated to one that already exists

...

  1. online.

    For more on each email's content, see: User Debtor Warning /Error Widget, User Debtor New User Widget.

    Filter Query for Customer Master table integrationEnter the query used to filter records sent by the integrator when a send of 'Customer Master For Users' is triggered (e.g. dr-cust-type like "WEB_").
    Filter Query for CSS Customer

...

  1. table integrationEnter the query that matches the 'Filter Query for Customer Master table integration' but is used for integration of the CSS Customer table instead.
    Web Fields for New PRONTO Account Creation

    Enter the comma-separated list of online fields sent to PRONTO for the creation of the new debtor.

...

  1. Example:  Code,OrderEmailAddress,Name,Address1,Address2,Address3,Address4,Address5,Address6,PhoneNumber,Postcode,ABN,addressname,industrycode

...

...

  1. Web Fields to Sync with PRONTOEnter the online fields sent to PRONTO for updates to the debtor. 

...


Additional Information

...

Enabling User Debtor Integration also creates 2 new email templates which are available for customisation: 

  1. User For Customer Warnings -  the template used for warning emails to the administrator when conflicts or issues arise with User Debtor Integration. 
  2. New User For Customer  - the template used for welcome emails sent to new users created as a result User Debtor Integration. This template replaces the standard new user registration email for these users only. 

 

To customise these templates:  

  1. Login to the CMS. 
  2. Navigate to Content --> Emails
  3. Select the required email template. 
  4. Edit / add / delete widgets as required. Main content is found in: 
    • 'User For Customer Warnings Email Content' widget
    • 'User For Customer Registration' widget 
  5. Use the 'Test Email' function to verify changes are correct. 
    Image Removed 

 

 

Field Mapping

Bi-directional User <----> Customer field mapping is configured by default for User Debtor Integration. The following is for information purposes only.

If you require additional fields or altered mapping, custom implementation may be required - please contact Commerce Vision for guidance. 

Default field mapping is configured as follows: 

Web User FieldPRONTO Customer Field
First NameName
SurnameName
DeliveryAddress1Address1
DeliveryAddress2Address2
DeliveryAddress3Address3
DeliveryPostcodePostcode

KK - Where are the Billing fields? 

 

KK - What are these then? Web info for what? Why did I list these? 

  • First Name + Surname
  • Email Address
  • Customer Code
  • Initial Role 
  • Password
  • Delivery Address
  • Billing Address

 

...


Multiexcerpt

Image Removed

...

hiddentrue
MultiExcerptNameAdditional Info
Useful for businesses that use an ERP as well as online to maintain customer records, e.g,, those with physical, brick and mortar shopfronts.


Multiexcerpt
hiddentrue
MultiExcerptNameFeature Title

User Debtor Integration


Minimum Version Requirements


Multiexcerpt
MultiExcerptNameMinimum Version Requirements
03.88.00


Prerequisites


Multiexcerpt
MultiExcerptNamePre reqs

Commerce Vision Integrator version 4.63

PRONTO proledb version 3.11


Self Configurable


Multiexcerpt
MultiExcerptNameSelf Configurable

No


Business Function


Multiexcerpt
MultiExcerptNameBusiness Function

User


BPD Only?


Multiexcerpt
MultiExcerptNameBPD Only

Yes


B2B/B2C/Both


Multiexcerpt
MultiExcerptNameB2B/B2C/Both

B2C


Third Party Costs


Multiexcerpt
MultiExcerptNameThird Party Costs
n/a



Related help

Content by Label
showLabelsfalse
max5
spacesKB
showSpacefalse
sortmodified

...

reversetrue
typepage
excludeCurrenttrue
cql

...

label = "integration" and label = "pronto" and type = "page" and space = "KB"
labelshow-to cms settings

Content by Label
showLabelsfalse
showSpacefalse
excludeCurrenttrue
cqllabel = "widget" and title ~ "debtor"