Oracle NetSuite: Best practices and additional information

This article provides more information about how the sync works with Oracle NetSuite, and outlines our best practices for syncing between Bill Manager and Oracle NetSuite.

Table of Contents

• Record types and known limitations
• General best practices
• Best practice by record type
  • Vendors
  • Customers
  • Chart of Accounts
  • Departments
  • Locations
  • Classes
  • Items
  • Jobs/Projects
  • Custom Fields
  • Currencyacross
  • Attachments
  • Bills
  • Invoices
  • Sales Orders
  • Vendor Credits
  • Credit Memos
  • Bill Payments
  • Invoice Payments
  • Purchase Orders
  • AP Funds Transfers
  • AR Funds Transfers

Record types and known limitations

General best practices

Keeping the sync Bundle Up-to-Date

• The Oracle NetSuite bundle updates automatically. Oracle NetSuite will alert users each time the bundle is updated.

Preferred Forms and Required Fields

• When syncing records from Bill Manager to Oracle NetSuite, the sync will use the preferred form for that record type
• Fields that do not sync with Bill Manager cannot be set as required fields on the preferred form for a given record type

Locked and Closed Periods

• The sync cannot use periods that are closed. If a period is closed, the sync will use the most recent open period.
• The sync will be able to write to periods that have been locked. If this is an issue, we recommend completely closing periods to prevent the sync from making changes.

Amortization Schedules

• When an amortization schedule is in use, the Bill Manager sync will not change line items for bills and vendor credits covering sublists, expenses, and items
  • Any changes to line items for bills/vendor credits should be made in Oracle NetSuite

Best practice by record type

Vendors

General

• Bill Manager supports vendors shared across subsidiaries (with bundle 3.2.0 or later). If a single vendor spans across multiple subsidiaries, that vendor record will sync over to each Bill Manager account linked to a subsidiary the vendor is shared with
• Vendors shared across subsidies in Oracle NetSuite need to be updated in Oracle NetSuite. Updating the vendor in Bill Manager will cause sync errors
• Vendors with Access enabled in Oracle NetSuite need to be updated in Oracle NetSuite. Updating the vendor in Bill Manager will cause sync errors

From Oracle NetSuite to Bill Manager

• The Oracle NetSuite character limit for Vendor ID is 83 characters. The sync with Bill Manager recognizes the full Vendor ID length
• When Vendor Auto-Numbering is enabled in both Oracle NetSuite and Bill Manager, the vendor ID generated in Oracle NetSuite will sync to Bill Manager
• Vendor as a Tax Agency will sync to Bill Manager when it is first created. Any changes later will not sync

From Bill Manager to Oracle NetSuite

• For vendors of type: Company, Company Name is required to sync to Oracle NetSuite
• For vendors of type: Individual, First Name and Last Name are required to sync to Oracle NetSuite
  • If the first and last name fields are left blank, then we will split vendor name with " " and use the first part of the name as first Name in Oracle NetSuite and the remaining part as the last Name in Oracle NetSuite
  • If we cannot split the name, we will repeat the vendor name for first name and last name

Customers

General

• Child customer will sync even if subsidiary does not have access to the parent
• Customers with Access enabled in Oracle NetSuite need to be updated in Oracle NetSuite. Updating the customer in Bill Manager will cause sync errors

From Oracle NetSuite to Bill Manager

• The Oracle NetSuite character limit for Character ID is 83 characters. The sync with Bill Manager recognizes the full Character ID length
• For OneWorld users:
  • The Bill Manager sync has no limit on Customer hierarchy
• For non-OneWorld users:
  • The Bill Manager sync limits Customer hierarchy to 3 levels deep
• When Customer Auto-Numbering is enabled in both Oracle NetSuite and Bill Manager, the customer ID generated in Oracle NetSuite will sync to Bill Manager

From Bill Manager to Oracle NetSuite

• For customers of type: Company, Company Name is required to sync to Oracle NetSuite
• For customers of type: Individual, First Name and Last Name are required to sync to Oracle NetSuite
  • If the first and last name fields are left blank, then we will split customer name with " " and use the first part of the name as the first Name in Oracle NetSuite and the remaining part as the last Name in Oracle NetSuite
  • If we can’t split the name, we will repeat the customer name for first name and last name

Chart of Accounts

From Oracle NetSuite to Bill Manager

• Bill Manager does not support Summary accounts

From Bill Manager to Oracle NetSuite

• Account Numbers are required for syncing an account from Bill Manager to Oracle NetSuite

Departments

• Child department will sync even if subsidiary does not have access to the parent

Locations

• Child location will sync even if subsidiary does not have access to the parent

Classes

• Child classes will sync even if subsidiary does not have access to the parent

Items

• Sales Tax Items and Shipping Items are 1-way to Bill.com (if AR sync is enabled)
• Child items will sync even if subsidiary does not have access to the parent

From Bill Manager to Oracle NetSuite

• Items created in Bill Manager will sync to Oracle NetSuite with the subtype: For Resale
  • If an item needs to have a different subtype, it must be created in Oracle NetSuite

Jobs/Projects

• The Oracle NetSuite character limit for Jobs/Projects is 100 characters.

Custom Fields

• Custom fields do not sync from Oracle NetSuite to Bill Manager
  • Custom fields are ignored by the sync. They will not prevent the bills from syncing to Bill Manager
  • Custom fields will be preserved in Oracle NetSuite but will not be visible in Bill Manager
• When creating custom fields in Oracle NetSuite, assign a default value to avoid any conflicts

Currency

From Oracle NetSuite to Bill Manager

• Transactions in Oracle NetSuite that are not in US dollars will be ignored by the sync

From Bill Manager to Oracle NetSuite

• Transactions in Bill Manager will always sync to Oracle NetSuite using the US dollar currency

Attachments

From Oracle NetSuite to Bill Manager

• Upload and handle documents in Oracle NetSuite. Attachments will sync from Oracle NetSuite to Bill Manager

From Bill Manager to Oracle NetSuite

• Attachments will not sync from Bill Manager to Oracle NetSuite

Bills

General

• All users, regardless of their assigned role, have access to the View in Bill.com button in Oracle NetSuite
• Customers coded in the bill line items can be prevented from syncing to/from Oracle NetSuite

From Oracle NetSuite to Bill Manager

• If a bill is created from a PO, it will sync to Bill Manager
  • Edit line items for these bills in Oracle NetSuite, editing in Bill Manager will unlink the bill from the PO in Oracle NetSuite. The Description field for the line item in Bill Manager will indicate the bill is connected to a PO in Oracle NetSuite
• If a bill is partially or fully paid in Oracle NetSuite, it will not sync from Oracle NetSuite to Bill Manager
• If the currency for a bill is not US dollars, it will not sync from Oracle NetSuite to Bill Manager
• Documents/files attached to bills in Oracle NetSuite will sync to Bill Manager

From Bill Manager to Oracle NetSuite

• Bill Manager only supports classifications in the line items of a bill. Bills in Oracle NetSuite can be classified both in the general section of the bill, as well as the line items of the bill
  • When bills sync from Bill Manager to Oracle NetSuite, the general section of the bill will use the selections that are set as the Default Payables classification in the Bill Manager Preferences
  • To make it easier to reclassify these records (as needed), create a department, location, and/or class called Unclassified, Uncoded or something similar, and set that as the Default Payables classification. This will allow a report to be run in order to isolate the bills that need to be reclassified
• If Oracle NetSuite’s “Only Sync Approved Bills/Credits” is enabled, bills will not sync to Oracle NetSuite unless their Approval Status is Approved
  • When bills sync to Oracle NetSuite, their status will automatically be set as:
    • Approved in Oracle NetSuite, if Oracle NetSuite approvals are turned off
    • Pending Approval if Oracle NetSuite approvals are turned on
  • Once a bill is approved in Bill Manager and syncs to Oracle NetSuite, changes to the approval status will not sync.
• If Bill Manager’s “Sync only approved Bills/ Vendor Credits” preference is selected, bills will not sync to Oracle NetSuite unless their Approval Status is Approved in Bill Manager
  • When bills sync to Oracle NetSuite with this enabled, their Oracle NetSuite approval status will not be changed
  • Once a bill is approved in Bill Manager and syncs to Oracle NetSuite, changes to the approval status will not sync

Invoices

General

• All users, regardless of their assigned role, have access to the View in Bill.com button in Oracle NetSuite

From Oracle NetSuite to Bill Manager

• If an invoice is partially or fully paid in Oracle NetSuite, it will not sync from Oracle NetSuite to Bill Manager
• If the currency for an invoice is not USD (US dollars,) it will not sync from Oracle NetSuite to Bill Manager
• $0 invoices in Oracle NetSuite will sync to Bill Manager as unpaid invoices if they do not have payments on them in Oracle NetSuite
• Once invoice has synced with Oracle Netsuite, it can't be edited in Bill Manager. Edit will need to be managed in Oracle NetSuite.
• Sales tax will sync into Bill Manager as a line item from Oracle NetSuite. It will not be editable in Bill Manager.
• Discount Items:
  • Discount items at the header level of an invoice in Oracle NetSuite will not sync to Bill Manager
  • Discount Items at the line item level will sync into Bill Manager as a line item from Oracle NetSuite. It will not be editable in Bill Manager.
    • Discount line items will apply to the line item directly above it only
    • Discounts in Oracle NetSuite are a percentage, when synced to Bill Manager it will be a total amount based on the calculation in Oracle NetSuite. The percentage will not show in Bill Manager.
    • Edits to discount line item in Bill Manager will not sync back to Oracle NetSuite, they must be managed in Oracle NetSuite.
• Invoices created in non-USD currencies will not sync to Bill Manager
• If an invoice was created from a Sales order in Oracle NetSuite, the Sales Order # from Oracle NetSuite will sync and display in the PO # field on the invoice in Bill Manager
  • The Sales Order # in the PO # field will not be editable in Bill Manager

From Bill Manager to Oracle NetSuite

• Once an invoice has synced with NetSuite, it is not editable in Bill Manager
• Bill Manager only supports classifications in the line items of an invoice. Invoices in Oracle NetSuite can be classified both in the general section of the invoice, as well as the line items of the invoice.
  • When invoices sync from Bill Manager to Oracle NetSuite, the general section of the invoice will use the classification that is set as the Default Receivables classification in the Bill.com Preferences
  • To make it easier to reclassify these records (as needed), create a department, location, and/or class called Unclassified, Uncoded or something similar, and set that as the Default Receivables classification. This will allow a report to be run in order to isolate the invoices that need to be reclassified.

Sales Orders

• If an invoice was created from a Sales order in Oracle NetSuite, the Sales Order # from Oracle NetSuite will sync and display in the PO # field on the invoice in Bill Manager
  • The Sales Order # in the PO # field will not be editable in Bill Manager

Vendor Credits

General

• Customers coded in Vendor Credit line items can be prevented from syncing to/from Oracle NetSuite

From Oracle NetSuite to Bill Manager

• If a vendor credit is partially applied or fully applied in Oracle NetSuite, it will not sync from Oracle NetSuite to Bill Manager
• If the currency for a vendor credit is not US dollars, it will not sync from Oracle NetSuite to Bill Manager

From Bill Manager to Oracle NetSuite

• Bill Manager only supports classifications in the line items of a vendor credit. Vendor credits in Oracle NetSuite can be classified both in the general section of the bill, as well as the line items of the bill
  • When vendor credits sync from Bill Manager to Oracle NetSuite, the general section of the vendor credit will use the classification that is set as the Default Payables classification in the Bill Manager Preferences
  • To make it easier to reclassify these records (as needed), create a department, location, and/or class called Unclassified, Uncoded or something similar, and set that as the Default Payables classification. This will allow a report to be run in order to isolate the vendor credits that need to be reclassified
  • Vendor credit application syncs along with the bill to which it has been applied
• If Oracle NetSuite's Only Sync Approved Bills/Credits from Bill.com is selected, vendor credits will not sync from Bill Manager to Oracle NetSuite unless their Approval Status is Approved
  • When vendor credits sync to Oracle NetSuite their status will automatically be set as:
    • Approved in Oracle NetSuite, if Oracle NetSuite approvals are turned off
    • Pending Approval if Oracle NetSuite approvals are turned on
  • Once a vendor credit is approved in Bill Manager and syncs to Oracle NetSuite, changes to the approval status will not sync
• If Bill Manager’s “Sync only approved Bills/ Vendor Credits” preference is selected, vendor credits will not sync to Oracle NetSuite unless their Approval Status is Approved in Bill Manager
  • When vendor credits sync to Oracle NetSuite with this enabled, their Oracle NetSuite approval status will not be changed
  • Once a vendor credit is approved in Bill Manager and syncs to Oracle NetSuite, changes to the approval status will not sync
• To configure the sync to apply vendor credits in Oracle NetSuite when a period is closed, enable Non-GL Changes to the Accounting Period in Oracle NetSuite:
  1. Hover over Setup > Accounting, select Manage Accounting Periods
  2. Select the period in which the vendor credit is dated in order to edit the base period
  3. Check Allow Non-G/L Changes

Credit Memos

Credit memos do not sync in either direction.

• Credit memos have to be created and applied manually in both Bill Manager and Oracle NetSuite

Bill Payments

General

• If a bill is paid outside of Bill Manager, mark it as paid in Bill Manager and allow that payment record to sync into Oracle NetSuite
  • Recording the payment in Oracle NetSuite first will cause sync errors
• Payments made in Bill Manager can be edited in Oracle NetSuite
• All users, regardless of their assigned role, have access to the View in Bill.com button in Oracle NetSuite
• The memo field for Offline Payments in Bill Manager doesn't sync to Oracle NetSuite

From Oracle NetSuite to Bill Manager

• Bill Payments do not sync from Oracle NetSuite into Bill Manager

From Bill Manager to Oracle NetSuite

• Bill Manager does not support departments, locations, and/or classes on bill payments
• When a payment is voided in Bill Manager, the void will sync to Oracle NetSuite
• When bill payments sync from Bill Manager to Oracle NetSuite, they will use the classification that is set as the Default Payables classification in the Bill Manager Preferences
  • If these are set as mandatory in Netsuite, the default classifications must be set in Bill Manager sync preferences to avoid sync errors
• To make it easier to reclassify these records (as needed), you can create a department, location, and/or class called Unclassified, or Uncoded, or something similar, and set that as the Default Payables classification. This will allow a report to be run in order to isolate the bill payments that need to be reclassified.
• A payment made in Bill Manager can ONLY be voided in Bill Manager
• Supported Payment Methods:
  • Bank Account
  • Checks
  • Vendor Credits

Invoice Payments

From Oracle NetSuite to Bill Manager

Invoice Payments do not sync to Bill Manager from Oracle NetSuite. It is best practice to always enter payments in Bill Manager and allow them to sync to Oracle NetSuite, even if you made the payment outside of Bill Manager.

• If your customer pays an invoice outside of Bill Manager, mark the invoice as paid in Bill Manager and allow that payment to sync into Oracle NetSuite. Recording the payment in Oracle NetSuite first will cause sync errors.

_From Bill Manager to Oracle NetSuite

Bill Manager does not support departments, locations, and/or classes on invoice payments.

• When invoice payments sync from Bill Manager to Oracle NetSuite, the payment record uses the classification that is set as the Default Receivables classification in Bill.com Preferences within Oracle NetSuite
• To make it easier to reclassify these records as needed, create a department, location, and/or class called Unclassified, Uncoded or something similar, and set that as the Default Receivables classification. This will allow you to run a report in Oracle NetSuite in order to isolate the invoice payments that need to be reclassified.

Purchase Orders

• The purchase order record only exists in Oracle NetSuite, therefore it cannot be viewed in Bill Manager
  • When a bill is created from a purchase order in Oracle NetSuite, that bill will sync into Bill Manager. The bill can then be paid in Bill Manager.
  • Edit line items for these bills in Oracle NetSuite, editing in Bill Manager will unlink the bill from the PO in Oracle NetSuite. If a bill has extra item lines that are not linked to the PO and you edit this bill in Bill Manager then on the next sync those extra item lines will be removed from the bill in Netsuite.
• The PO Number field on bills in Bill Manager will populate with the Oracle NetSuite Purchase Order number

AP Funds Transfers

From Bill Manager to Oracle NetSuite

• AP funds transfers sync to Oracle NetSuite as journal entries
• Bill Manager does not support departments, locations, and/or classes on AP funds transfers
  • When AP funds transfers sync from Bill Manager to Oracle NetSuite, they will use the classification that is set as the Default Payables classification in the Bill Manager Preferences
  • If these are set as mandatory in Netsuite, the default classifications must be set in Bill Manager sync preferences to avoid sync errors
  • To make it easier to reclassify these records (as needed), you can create a department, location, and/or class called Unclassified, or Uncoded, or something similar, and set that as the Default Payables classification. This will allow a report to be run in order to isolate the funds transfers that need to be reclassified

AR Funds Transfers

• AR funds transfers sync to Oracle NetSuite as journal entries
• Bill Manager does not support departments, locations, and/or classes on AR funds transfers
  • When AR funds transfers sync to Oracle NetSuite, the entry will use the classification that is set as the Default Receivables classification in Bill.com Preferences within Oracle NetSuite
• To make it easier to reclassify these records (as needed), create a department, location, and/or class called Unclassified, Uncoded or something similar, and set that as the Default Receivables classification. This will allow a report to be run in order to isolate the AR funds transfers that need to be reclassified.