Credit Mapping Group
Use the Credit mapping group to export information on credit (negative invoice) records in OpenAir to credit memo transaction 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 the internal IDs of the customer and the invoice being credited in NetSuite, credit reason, and date. 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 [ |
OpenAir Record Type [ |
Mapping Group [ |
---|---|---|
Credit Memo [ Schema: CreditMemo (2020.1)|CreditMemo (2023.1) XSD: tranCust (2020.1)|tranCust (2023.1) XSD (pullback): |
Invoice [ Data Dictionary: invoice |
Credit Memo [ |
Default and Custom Filters
By default, credit (negative invoice) records are exported from OpenAir to NetSuite if the following conditions are met:
-
The credit (negative invoice) is approved in OpenAir. Invoice approvals must be enabled for your OpenAir account.
-
The invoice must be a credit invoice —
Invoice.total
is negative. -
The credit (negative invoice) was not already exported —
Invoice.exported
is empty. -
The NetSuite Credit Memo ID [
netsuite_credit_memo_invoice_id
] custom field is empty OR the Allow objects with a NetSuite ID to be exported during integration run box is checked on the OpenAir NetSuite Connector administration form. See Allow objects with a NetSuite ID to be exported during integration run.
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 Credit mapping group tab.
NetSuite Field |
D |
OpenAir Field |
Notes |
---|---|---|---|
|
![]() |
Looked up OpenAir field value —
|
The internal ID for:
|
|
![]() |
|
— |
|
![]() |
Looked up OpenAir field value —
|
Active only when the credit invoice record was created using the Credit and Rebill Invoices optional feature in OpenAir. In this case, the credit invoice references the original invoice that was credited ( |
|
![]() |
|
The Memo field on the NetSuite credit memo is set to the Credit Reason on the original invoice when the credit invoice record was created using the Credit and Rebill Invoices optional feature in OpenAir, or on the credit invoice otherwise. If the Credit Reason is empty, the Memo field is set to "Created from NetSuite OpenAir credit invoice <name>." |
|
![]() |
Looked up OpenAir field value —
|
Not visible on mapping definition table Active only if Project Management feature is enabled for your NetSuite account and the Consolidate Projects on Sales Transactions box is not checked on the Accounting Preferences Items/Transactions subtab in NetSuite (Setup > Accounting > Preferences > Accounting Preferences). The internal ID of the NetSuite project record corresponding to the project associated with the credit invoice in OpenAir |
|
![]() |
Looked up OpenAir field value —
|
Not visible on mapping definition table Active only if the Multiple Currency feature (or the Multi-Currency Customer feature, if available separately) is enabled for your NetSuite account and there is no original invoice to source the subsidiary information from. |
|
![]() |
|
Not visible on mapping definition table [Pullback] When you export a new credit invoice record from OpenAir to NetSuite, OpenAir stores the internal ID of the NetSuite credit memo in the NetSuite Credit Memo ID [ |
— |
![]() |
|
Not visible on mapping definition table OpenAir adds a timestamp on the credit invoice for the date and time the record was exported. |
|
![]() |
|
Not visible on mapping definition table Active only if the Import taxes applied to exported OA Credit (negative invoice) box is checked on the Send OpenAir Credits (Negative Invoices) as NetSuite Credit Memos export workflow settings form. [Pullback] The tax amount calculated in NetSuite is imported back into OpenAir. See Import taxes applied to exported OA Credit (negative invoice). |
— |
![]() |
|
Not visible on mapping definition table Active only if the Import taxes applied to exported OA Credit (negative invoice) box is checked on the Send OpenAir Credits (Negative Invoices) as NetSuite Credit Memos export workflow settings form. See Import taxes applied to exported OA Credit (negative invoice). [Pullback] The tax amount calculated in NetSuite is added to the total amount for the invoice in OpenAir. See Import taxes applied to exported OA Credit (negative invoice). |
— |
![]() |
|
Not visible on mapping definition table Active only if the Import taxes applied to exported OA Credit (negative invoice) box is checked on the Send OpenAir Credits (Negative Invoices) as NetSuite Credit Memos export workflow settings form. See Import taxes applied to exported OA Credit (negative invoice). [Pullback] The tax amount calculated in NetSuite is added to the total amount for the credit invoice in OpenAir. See Import taxes applied to exported OA Credit (negative invoice). |
Additional Field Mappings
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