Here we explain how to import data from Sage Intacct into YayPay. 

Data imported from Sage Intacct to YayPay includes: custom and native fields; billing contacts; AR Invoices; Sales Invoices; as well as DUNS Number. In YayPay, this data is typically imported as customer or invoice level custom fields.

Customer Level Custom Fields 

In order to set up your integration, please use the names from the Integration name column to populate Source Field Name in YayPay Settings > Integration > Sage Intacct Customer Level

1. Enter the Source Field Name of the Custom Field from your Intacct system that you intend to sync with YayPay. Consult your Intacct Administrator on this.
2. Enter the name as you would like it to be displayed in YayPay (for the YayPay Display Name column).
3. If you want to use this field/value as an Aging filter, check the 'Aging filter' checkbox.
4. If you want this field/value to appear in the Invoices/Statement page of YayPay, check the 'Display on Statement' checkbox.
5. Click Add Field to add more or Save. 
6. Approach YayPay Support or your Account Rep to request a re-sync. 

Intacct Customer Native Field > YayPay Customer Custom Field 

You can configure YayPay to bring over Native Fields/values from your Intacct system

For example, a summary of frequently seen native fields at the Customer level, which you can consider configuring YayPay may include:

• CUSTOMERID (this refers to the Intacct Customer ID)
• STATUS (this refers to the Account Status in Intacct)
• TERMNANE (this refers to the Payment Terms in Intacct)
• CUSTREPID (this refers to the Sales Rep Employee ID in Intacct)

The full list is represented below.

Refer to the Intacct Developer Reference link for more context.

Enter the native field name in the Source Field Name column, and a display name for YayPay. Click Add Field to add more or Save. 

Intacct Customer Custom Field > YayPay Customer Custom Field

1. Navigate to Account Receivable > Customers:

2. Open any customer in view or edit mode. 

3. In the top right corner click on “More actions” and select Object Definition

4. New screen will appear: 

In the screenshot above Integration Name represents a custom field name, for example:

If you need ACCOUNTLABEL name to be pulled to YayPay the custom field configuration in YayPay will be:

Pulling the Customer Level Billing Contact from Intacct

To bring over the standard, the primary email address is maintained for the customer in Intacct as the customer billing contact in YayPay, check the "Auto create billing contact" checkbox. 

This is found in the Sage Intacct panel, under the Settings > Integrations page in YayPay:

The primary email address of the Customer will be synced from Intacct into YayPay.

This is how the Customer Contact will be created in YayPay:

• The Company name will be used as the 'First Name' of the contact, the Last Name will be left blank
• The Email field of the Customer Contact in YayPay will contain the email address maintained in Intacct
• This contact will also be marked as the "Billing Contact" (for the Customer) in YayPay

• If you also use the Secondary Email address field in Intacct stored against the customer, this email address will also be brought over under the same Billing Contact. The Email field of the Customer Contact in YayPay will contain 2 email addresses separated by a comma

Invoice Level Custom Fields

The Source Field Name is the technical Integration name of the Native/Custom field from your Intacct system.

In order to set up your integration, please use the names from the Integration name column to populate Source Field Name in YayPay Settings > Integration > Sage Intacct Invoice Level

•  Configure your Intacct field name and YayPay Display Name:

• The checkbox for 'Display on Statement' works the same way as the one found also in the Customer Level custom field.
• If you want to make this field appear on the Customer Portal page, check the 'Display on Customer Portal' checkbox.
• Add more rows and Save when completed. Approach YayPay Support or your Account Rep to request a re-sync if you are adding these fields after the AR sync has been occurring for some time.

Below please find instructions on how to find Native and Custom Field IDs in Intacct.

Intacct Invoice Native Field > YayPay Invoice Custom Field

A summary of frequently seen native fields at the Invoice level, which you can consider configuring YayPay may include:

• MEGAENTITYID (this refers to the Intacct Entity ID)
• PONUMBER (this refers to the PO / Reference # in Intacct)

Refer to the Intacct Developer Reference link for more context

Intacct Invoice Custom Field > YayPay Invoice Custom Field

How to find Integration Name: 

1. Navigate to Account Receivable > Invoices:

2. Open any invoice in view or edit mode.

3. In the top right corner click on “More actions” and select Object Definition

4. New screen will appear:

In the example above Integration Name represents a custom field name, for example:

If you need BILLTO.COMPANYNAME name to be pulled to YayPay the custom field configuration in YayPay will be:

Pulling the Invoice level Billing Contacts from Intacct

The configuration involved to bring the email address of the Billing Contact at the invoice transaction in Intacct is outlined as follows:

Scenario #1 - Invoice Contact from the Bill To section

In Intacct:

To receive the Invoice billing contact and the Invoice billing contact name, it is necessary to add the BILL TO contact to the Customer.

Example:

By default, Invoice billing contacts from Intacct are always pulled over and created to YayPay. This Invoice-level billing contact in YayPay will be the contact/email address from the Bill-to section of the invoice transaction in Intacct: 

In YayPay:

Invoice level billing contacts are displayed next to the Invoice Number. You can view this info either using the INVOICES menu in YayPay or within a particular customer using the Statement page (look under the Open/Closed Invoices tab), e.g.

The Statement Page

The Invoices Journal

Scenario #2 - Invoice Contact from the Primary Contact

In Intacct:

To receive the Invoice billing contact and the Invoice billing contact name, it is necessary to fill in the Primary Contact to the Customer.

Example:

In YayPay:

Invoice level billing contacts are displayed next to the Invoice Number. You can view this info either using the INVOICES menu in YayPay or within a particular customer using the Statement page (look under the Open/Closed Invoices tab), e.g.

The Statement Page

Delete

Pay attention, that the Invoice Billing name corresponds to the Customer Contact name. 

The Invoices Journal

Note: Pay attention, that the Connector doesn’t sync the Primary Phone number and JOB Title.

 

Scenario #3 - Invoice Contact from a Custom field in Intacct

In Intacct:

If you keep the billing contact's email address associated with the Invoice using a custom field in Intacct, it is also possible to bring that into YayPay (See: April 2020 Release Notes) 

Review your Intacct setup, under Platform Services > Object Customization > Custom Fields and check that the custom field is associated with the "Invoice" Object.

 

For example, this could be the custom field ("BILLING_CONTACT") that you created in Intacct to hold an email address (per Invoice):

In YayPay:

Enter the Intacct Field ID name (i.e. "BILLING_CONTACT") in the "Invoice billing contact custom field name" field:

The above field is found in the Settings > Integrations page of YayPay, where you configure YayPay with the Intacct Web Services User Credentials to initiate the AR Sync from Intacct and YayPay:

Click on "SAVE" to save your changes and press "Sync".

Note: You will need to re-enter the password of the Web Services User before Saving.

After the sync, the information brought into YayPay will look like this, e.g.:

Removing Invoice Level Billing Contacts from YayPay

If removing invoice level billing contacts imported from Sage Intacct, the following applies:

• If you remove an invoice billing contact from the custom field in Sage Intacct® and initiate a resynchronization, this contact will be removed from YayPay as well.

• If you remove an invoice billing contact in YayPay, the data and relationships in the database will not be changed. The contact record will only be marked as removed in the database.
  As a result, future sync iterations related to the modified invoice will not display the removed invoice billing contact in YayPay. However, all of the data and mappings still exist.
  

  

  Thus, if you subsequently update the invoice billing contact on the ERP side and perform a sync, the contact will become active again and YayPay will display the invoice billing contact once again.

  

  
  

AR Invoice

This section describes AR Invoices in Sage Intacct.

In Sage Intacct, an AR invoice object represents an invoice sent to a customer for goods or services provided.

Certain types of transaction definitions in the Order Entry section ( Sales Invoice, AR Invoice) are configured to create corresponding invoices in the Accounts Receivable application. If you need to look up an AR transaction related to an AR Invoice, you can do so using the >ARINVOICE< request.

The >ARINVOICE< request will return a list with all the fields and relationships for the invoice object that are available in Sage Intacct.

<lookup>

    <object>ARINVOICE</object>

</lookup>

To review your document type in Sage Intacct, go to Application| Account Receivable| Invoices.

To find where the custom field is located in Sage Intacct, go to Application | Platform Services| Custom fields.

If you want to add a new custom field, go to Platform Services| Custom fields| Add| Invoice:

For more details about AR Invoice objects, see the Sage Intacct website.

Sales Invoice

This section describes Sales Invoices in Sage Intacct.

In Sage Intacct, order entry transactions are the records of customer orders, including quotes, orders, invoices, and more.

Certain types of transaction definitions in Order Entry ( Sales Invoice, AR Invoice) are configured to create corresponding invoices in the Accounts Receivable application. If you need to look up an AR transaction related to a Sales Invoice, you can do so using the >SODOCUMENT< request.

The >SODOCUMENT< request will return a list with all the fields and relationships for the Order Entry transaction object that are available in Sage Intacct.

<lookup>

    <object>SODOCUMENT</object>

</lookup>

To review your document type in Sage Intacct, go to Order Entry| Invoice| Sales Invoice:

The Document type can be different than on the screenshot below but must be under the Sales Invoice item.

For more details about order entry transactions, see the Sage Intacct website.

Bringing DUNS Number from Intacct

To transmit the DUNS (Data Universal Numbering System) Number within the Customer from Intacct to YayPay the user should perform the following steps:

1. In YayPay, open Settings > Integrations and fill in the Custom field for DUNS number field with an Intacct Field ID value.

2. The Custom field for DUNS number field should include the Filed ID that corresponds to the Custom Field name in Intacct.

 

 

3. Once you fill in the Custom field for DUNS number field in YayPay, click Save.

4. After the sync process, YayPay depicts the DUNS Number within the Customer.