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.


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. 

On this page:



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. 
    2. If their default role matches your User Debtor criteria, a new PRONTO account is automatically created. 
    3. The User logs into your site and updates their details (billing address, phone number). 
    4. On integration, the PRONTO record is also updated. 
    5. The User enters one of your physical store locations and makes a purchase. 
    6. At the point of sale, their email address is queried and the transaction is linked to their PRONTO customer account, ensuring order history data is complete.
    7. The User logs in and navigates to the Order History page. 
    8. 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, are added by your sales rep, or their credit account application is successful, etc. 
    2. A new PRONTO account is created.   
    3. On integration, a linked Website User is created. 
    4. The new User is sent an email advising them of their Website login details. NOTE - if Auto Part Registration is active for a Customer account, the User must be approved before the registration process continues. 
    5. The User logs in and can now: 
      1. update contact and delivery information 
      2. view Order History
      3. purchase online.   
         

For sites on versions 4.31, 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)


User Debtor Settings

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


  1. Navigate to Settings → Feature Management → User.

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


  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. This is prepended to a numeric value and assigned as the website user’s customer code.

    Example: WEB_

    Customer Template for New PRONTO AccountsEnter the base PRONTO debtor code that all new customers are copied from. Using this ensures correct pricing structure, tax code, etc.
    Default Role for New Web UsersEnter 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 website user.
    Send Warning Emails To

    Enter the email address for receipt of errors and warnings sent by the system. Examples of notifications: when. a PRONTO debtor is deleted, a PRONTO debtor's email address is updated to one that already exists 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 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.

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

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

Additional Information



Minimum Version Requirements


03.88.00

Prerequisites


Commerce Vision Integrator version 4.63

PRONTO proledb version 3.11

Self Configurable


No

Business Function


User

BPD Only?


Yes

B2B/B2C/Both


B2C

Third Party Costs


n/a


Related help



© Copyright 2001-2023 Commerce Vision Pty Ltd. Use of this site signifies your acceptance of Commerce Vision’s Terms & Conditions. CV Connect, the Commerce Vision logos, and other Commerce Vision marks are assets of Commerce Vision Pty Ltd.