Application / Business & Account Settings

Excel Mapping

The Excel Mapping page is located in Settings .

  1. Choose a Mapping Excel Type from the drop-down menu. You can also click on Download Current Mapping to download a mapping template to your device.

  2. Click on the SELECT FILE button to upload the modified file to the system.

  3. Check this section which contains Logs (information appears after a file uploading and enlists changes applied to the system records). After a file is selected, a log appears showing all the changes applied to the system records.

Do NOT change the following parameters :

  • File name 
  • Tab name 
  • Column name


Common Steps for All Excel Mapping Types:

  1. Choose the required option from the Mapping Excel Type drop-down menu.
  2. Click on Download Current Mapping button to download an Excel file with the current mapping, e.g. system custom fields that are defined in Settings | System Custom Fields. Their names then appear as column titles in the downloaded Excel file.
  3. Save the file on your device.
  4. Modify the file and save the changes. Read the details for each mapping type below.
  5. Go back to the Excel Mapping page in YayPay and click on Select File.
  6. Select the modified file on your device to upload it to the system.
  7. After the file is uploaded, click Save to apply the changes.
  8. Check the MAPPING IMPORT LOGS section which displays a list of changes and make sure it does not contain any issues.

Please find details and notes for each type of mapping below:

AR Mapping Excel

There are two tabs in the AR Mapping Excel file: Customer Mapping and AR Managers

Note: the AR Mapping Excel can not be used to create new users, only to assign/unassign existing AR Specialists to customers. 

 

When you make any changes to the file, please note that you should leave only the records that have been edited.


Collection Workflow Mapping Excel

Customer mapping tab: Column E: 0 = no 1 = yes  


Companies mapping excel

This is a deprecated feature that used to map customer companies synced from your ERP system to the same customer/companies maintained in your Salesforce system.

Because this feature is deprecated, you should not use this file any longer. Instead, use the mapping and sync features of the Salesforce connector instead.


 


Contacts Mapping Excel

Select Contacts mapping from Mapping Excel Type to manage customer contacts.

However, you cannot use this file to: 

  • Delete any contacts, i.e. you can only add new ones.
  • Modify the contact’s email (column C). 
    If you modify the email, the import will add a new contact in YayPay with the modified e-mail address.

Additionally, for the Email column (column C), the following applies:

  • If you add an email address to the Email column and it does not exist in YayPay, a new contact will be created using this email address.
  • If an email address already exists in YayPay before the import, the first contact in YayPay with a matching email address will be updated with the imported one.

You can use these values in the following columns:

  • Role (column H):
Role in app UI  Role to populate Column H
CEO CEO
CFO CFO
Head of department HEAD_OF_DEPARTMENT
Main billing MAIN_BILLING
Secondary Billing SECONDARY_BILLING
Accounts Payable ACCOUNT_PAYABLE
Invoice Delivery INVOICE_DELIVERY
Admin ADMIN
HR HR
Controller CONTROLLER
  • Is Billing Contact (column I):
    The possible values are 0 indicating that the contact is not a billing contact or 1 indicating that the contact is a billing contact.


Credit Mapping Excel

Select Credit mapping from Mapping Excel Type to Manage Credit Limit inside YayPay.

The Credit Mapping Excel file contains the following columns:

Customer ID

Shows unique ID of a customer.

Customer name

Shows name of a customer.

Credit limit

Shows credit limits.

Credit limits can be updated through Excel mapping but not through ERP or CSV integration in YayPay.

Credit risk

Shows information on credit risk which is categorized into three levels: High, Medium, and Low.

ERP ID

Shows ID of a customer in the ERP system.

DUNS number

Shows the DUNS number.

The DUNS number is initially obtained from the ERP system and you can manually update it in YayPay using this excel mapping file. To ensure that changes made via excel mapping are saved and not removed during the next sync, you can enable the Use YayPay as the system of record for DUNS numbers check box in Settings | Business.

Other columns

The remaining columns display the credit provider IDs and rates for each credit provider:

  • D&B PAYDEX – from 0 to 100.
  • Creditsafe ID
  • Creditsafe Rate – from 0 to 100.
  • Experian ID
  • Experian Rate – from 0 to 100.
  • Year Started – from 1900 to the current year.
  • Coface ID
  • Coface Rate from 0 to 10.


Delete

Important

If you update the credit limit via Excel mapping, the following applies:
  • It does not affect the ERP system, i.e. the updates are not pushed to ERP system.
  • If the credit limit is subsequently updated using CSV integration or API, these updates will not be applied in YayPay. This only applies to records updated through Excel mapping; other records can be updated as usual.
  • If you upload the updated Excel mapping file back to YayPay, the system will automatically recalculate the credit score of customers. Additionally, this information will be logged on the MAPPING IMPORT LOGS panel and on the ACTIVITY tab at the bottom of the Statement page.


Sales Mapping Excel

Select Sales mapping from Mapping Excel Type to assign a Sales Specialist and/or Customer Success Specialist to your customers in YayPay. This is similar to the assignment done on the Statement page.

The Sales Mapping Excel file has two tabs:

  • Customer Mapping

  • Sales Managers

To assign or manage Sales or Customer Success Specialists:

  1. Go to the Sales Managers tab.

  2.  Specify your Sales Specialist and/or Customer Success user in YayPay, including their unique email addresses and the appropriate role. Role names must be written in upper case, i.e. SALES or CUSTOMER_SUCCESS.

  3. Go to the Customer Mapping tab.

  4. Assign Sales or Customer Success Specialists to your customers by pasting their email address into the Sales/CS Email column, use one column for Sales Specialist and another one for the Customer Success Specialist.
    The email address must match to the one defined in the Sales/CS Email column on the Sales Managers tab.

    For example, to assign John Lewis as a Sales Specialist and Kevin Smith as a Customer Success Specialist for Bosco LLC, enter their email address into the Sales/CS Email columns in any order.

    However, the same email address can only be used once in either columns, i.e. a person cannot be linked as both a Sales and Customer Success Specialist at the same time.

  5. Save the changes and continue by following the steps described in the Common Steps for All Excel Mapping Types section.

Delete

Note

If your Sales Reps are synced from Salesforce or NetSuite, the SalesMapping.xlsx file will only link/ update Customer Success Specialists assigned to your customers in YayPay.



Notes Mapping Excel

Select Notes mapping from Mapping Excel Type to upload customer or invoice level notes to YayPay. 

To upload customer or invoice level notes:

  1. Download the mapping file.

  2. Fill in the following fields as needed:
    • TypeInvoice or Customer (for invoice or customer level notes).

    • ERP ID – Invoice ERP ID for invoice level notes or Customer ERP ID for customer level notes.

    • Text – Note's details.

    • Date – Note's creation date in the yyyy-mm-dd or mm/dd/yyyy format.

  3. Save the changes and continue by following the steps described in the Common Steps for All Excel Mapping Types section.

Delete

Note

Currently Notes Mapping functionality serves only for mapping purposes for further uploading, i.e. it does not pull out the actual notes from the system. 



Date Format in Excel Mapping

Make sure you enter the date in the correct format when modifying the mapping files: YayPay is using ISO_8601 standard: yyyy-mm-dd


System Custom Fields Mapping Excel

Using the System custom fields mapping option, you can easily map and update/delete system custom fields for individual customers and/or invoices.

There are two sheets in the downloaded SystemCustomFieldsMapping.xlsx file: Customer Mapping and Invoice Mapping. These sheets contain system custom fields that are defined in Settings | System Custom Fields. Although the names of these system custom fields appear as column titles in the downloaded Excel file, their values are empty.

Delete

Tip

To fill the downloaded SystemCustomFieldsMapping.xlsx file with values from YayPay, navigate to the Invoices or Aging Report page and click on the Export to Excel icon. Subsequently, copy the values from this exported Excel file to the downloaded SystemCustomFieldsMapping.xlsx file and update/delete the individual fields as required.

For example, if you enable the ERP ID column on the Aging Report page, the exported Excel file will contain fields (and values) such as Customer Name, ERP ID, etc. Similarly, if you enable the Invoice ERP ID column on the Invoices page, the exported Excel file will contain fields (and values) such as Invoice number, Invoice ERP ID, etc.


Delete

Note

To be able to see the System custom fields mapping option, make sure that you have the Setting System Custom Fields check-box located on your Security Groups page checked.

You can upload files in XLS or XSLX format that have a maximum size of 100 MB.

Can't find what you need?

Contact our support team support@yaypay.com for help.