To read data from or insert data to custom fields in Coupa, you must configure the Custom Field Config property when you create a Coupa V2 connection.
You need to specify the field name, the field type, and the IsAPIGlobalNamespace for a custom object.
You can specify custom fields for different objects, separated by a line break. When you specify multiple custom fields for a particular object, separate the custom fields with an empty new line. Enter ;\ at the end of the line except for the last entry.
Note: If a field name contains an underscore, the Secure Agent replaces the underscore with a hyphen.
Custom object names
Enter the object name based on the Coupa metadata file and the field name that is generated by Coupa.
The following table lists the object names that you can specify in the connection based on the Coupa metadata file:
Coupa Resource Name
Coupa Sub Resources
Object Name
Expense Reports
Items
expense-report
item
Advance Ship Notices
Headers
asn-header-summary
Lines
asn-line-summary
Suppliers
Supplier Sites
supplier
supplier-site
Items
Supplier Items
item
supplier-item
Invoices
Lines
invoice-header
invoice-line-summary
Purchase Orders
Lines
order-header
order-line-summary
Requisitions
Items
requisition-header
item
Receipts
NA
inventory-transaction
Commodities
NA
commodity-summary
Department
NA
department
Contracts
NA
contract
Address
NA
address
Lookup Values
NA
lookup-value
Asset Tag
NA
asset-tag-summary
Warehouse
NA
warehouse-summary
Forms
NA
form-summary
Punchout Sites
NA
punchout-site-summary
User
NA
user
Custom field types and data types
The following table lists the various custom fields and data types that you can use:
Coupa Field Type
Data Type
Check Box
Boolean
Date
Date/Time
Drop Down (Single Select)
String
Number
Integer
Radio Group
String
Text Field
String
IsAPIGlobalNamespace field
The IsAPIGlobalNamespace field controls the organization of custom fields in Coupa and manages the data hierarchy. You need to set the value of IsAPIGlobalNamespace to true or false in the connection properties based on the corresponding value in Coupa. This property determines whether custom fields appear under the root tag or the custom-field tag in the data structure when reading or writing data.
If the custom field does not have the API global namespace property enabled in Coupa, set IsAPIGlobalNamespace to false in the connection properties.
The data structure follows this pattern based on the IsAPIGlobalNamespace value:
•True. The custom field appears under the root tag.
•False. The custom field appears under the custom-field tag.
•If you do not specify a value, true is considered as the default.
When you configure a mapping to read from or write data to Coupa, you can view the custom fields categorized on the Field Mapping tab according to these values.