Vendors (Vendors) Import Field Mapping Definition

The Vendors (Vendors) import workflow includes one mapping group:

Vendor [ Integration point: VENDOR_TO_VENDOR] — See Vendor Mapping Group Tab.

Vendor Mapping Group Tab

Use the Vendor mapping group to map information on vendor records in OpenAir with information on vendor records in NetSuite. The mapping group supports filters.

For reference information and best practice guidelines, review the following topics:

References — Overview of record types in OpenAir and NetSuite with links to the relevant reference material for information about fields available for mapping.
Default and Custom Filters — Overview of default filters and how to modify the default behavior, and custom filters. Custom filters are supported for this mapping group.
Default Field Mappings — Overview of default field mapping definitions including notes and best practice guidelines where relevant. Information imported by default includes name, email, address, website, and currency. Filters are supported.
Additional Field Mappings — There are no specific guidelines for custom field mapping definitions in this mapping group.

References

The following table gives reference information about the records and fields available for custom field mapping definition with links to the relevant reference material. See also Schema Reference Documentation.

NetSuite Record type [`SOAP object`]	OpenAir Record Type [`table`]	Mapping Group [`Integration point`]
Vendor [`Vendor`] Schema: Vendor (2020.1)\|Vendor (2023.1) XSD: `VendorSearchRowBasic` platformCommon (2020.1)\|platformCommon (2023.1)	Vendor [`vendor`] Data Dictionary: vendor	Vendor [`VENDOR_TO_VENDOR`]

NetSuite Record type [SOAP object]

OpenAir Record Type [table]

Mapping Group [Integration point]

Vendor [Vendor]

Schema: Vendor (2020.1)|Vendor (2023.1)

XSD: VendorSearchRowBasic platformCommon (2020.1)|platformCommon (2023.1)

Vendor [vendor]

Data Dictionary: vendor

Vendor [VENDOR_TO_VENDOR]

Default and Custom Filters

By default, vendor records are imported from NetSuite into OpenAir as employees if the following conditions are all met:

The Inactive box is NOT checked on the vendor record in NetSuite.
The Export to OpenAir [custentity_oa_export_to_openair] box is checked on the vendor record in NetSuite.
If the Employees (Vendors) import workflow is also active, the OpenAir: User or Vendor [custentity_oa_user_or_vendor] field is set to Vendor on the vendor record in NetSuite.

Custom filters are supported for this mapping group. For more information about adding filter conditions, see Using Filters and Filter Definition.

Default Field Mappings

The following table describes the default field mapping definitions for the Vendor mapping group tab.

NetSuite Field	OpenAir Field	Notes
`Vendor.internalId`	`Vendor.netsuite_vendor_id__c`	When you import a new vendor record from NetSuite into OpenAir, OpenAir stores the internal ID of the NetSuite vendor in the NetSuite Vendor ID [`netsuite_vendor_id`] custom field. This custom field is used to link the OpenAir and NetSuite records for future updates and matching record associations.
`="1"`	`Vendor.active`	[Initial Only] By default, the Active box is checked when the Vendors (Vendors) import workflow creates a new vendor record in OpenAir. If the Inactive box is checked on the vendor record in NetSuite, OpenAir NetSuite Connector does not import the vendor into OpenAir — the record is excluded from the integration. If you clear the Inactive box on the NetSuite employee record, OpenAir NetSuite Connector will import the vendor record in the next integration run, and create or update the corresponding vendor record in OpenAir according to the field mapping definitions set for the workflow. Checking the Inactive box on the NetSuite vendor record does not clear the Active box automatically on the OpenAir vendor record. If you check the Inactive box on the NetSuite vendor record, clear the Active box manually on the demographic form for this vendor in OpenAir.
`Vendor.entityId`	`Vendor.name`	—
`Vendor.email`	`Vendor.email`	—
`Vendor.fax`	`Vendor.fax`	—
`Vendor.billPhone`	`Vendor.phone`	—
`Vendor.billAddress1`	`Vendor.address1`	—
`Vendor.billAddress2`	`Vendor.address2`	—
`Vendor.billAddress3`	`Vendor.address3`	—
`Vendor.billCity`	`Vendor.city`	—
`Vendor.billstate`	`Vendor.state`	—
`Vendor.billZipCode`	`Vendor.zip`	—
`Vendor.url`	`Vendor.web`	—
`Vendor.currency`	`Vendor.currency`	Active and visible only if the Multicurrency feature is enabled for your OpenAir account. Multiple currency — The Currency on the vendor record in OpenAir is set to the Currency on the vendor record in NetSuite.

NetSuite Field

Direction

OpenAir Field

Notes

Vendor.internalId

Vendor.netsuite_vendor_id__c

When you import a new vendor record from NetSuite into OpenAir, OpenAir stores the internal ID of the NetSuite vendor in the NetSuite Vendor ID [netsuite_vendor_id] custom field. This custom field is used to link the OpenAir and NetSuite records for future updates and matching record associations.

="1"

Vendor.active

[Initial Only] By default, the Active box is checked when the Vendors (Vendors) import workflow creates a new vendor record in OpenAir. If the Inactive box is checked on the vendor record in NetSuite, OpenAir NetSuite Connector does not import the vendor into OpenAir — the record is excluded from the integration.

If you clear the Inactive box on the NetSuite employee record, OpenAir NetSuite Connector will import the vendor record in the next integration run, and create or update the corresponding vendor record in OpenAir according to the field mapping definitions set for the workflow.
Checking the Inactive box on the NetSuite vendor record does not clear the Active box automatically on the OpenAir vendor record. If you check the Inactive box on the NetSuite vendor record, clear the Active box manually on the demographic form for this vendor in OpenAir.

Vendor.entityId

Vendor.name

—

Vendor.email

—

Vendor.fax

—

Vendor.billPhone

Vendor.phone

—

Vendor.billAddress1

Vendor.address1

—

Vendor.billAddress2

Vendor.address2

—

Vendor.billAddress3

Vendor.address3

—

Vendor.billCity

Vendor.city

—

Vendor.billstate

Vendor.state

—

Vendor.billZipCode

Vendor.zip

—

Vendor.url

Vendor.web

—

Vendor.currency

Active and visible only if the Multicurrency feature is enabled for your OpenAir account.

Multiple currency — The Currency on the vendor record in OpenAir is set to the Currency on the vendor record in NetSuite.

Additional Field Mappings

Important:

Review the following guidelines

You should contact your OpenAir Professional Services representative if you need to make changes to your integration configuration and field mapping definitions.
For advanced mapping usage and best practice guidelines, see Advanced Field Mapping Definition.
Familiarize yourself with the NetSuite and OpenAir technical documentation before attempting to set field mapping definitions using the advanced notation — See Schema Reference Documentation.

No specific guidelines