Release 23 Inbound API Changes
Introduction
This list shows the changes we've made to our API inbound formats across the Coupa platform. Unless otherwise stated, all elements are new.
Check out the Coupa API documentation to learn more.
New API inbound objects
These are no new inbound API formats in R23.
Updated API inbound objects
These are the existing API inbound formats that were updated in R23:
Addresses
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| street3 | Address Line 3 | false | false | string(100) | any | |
| street4 | Address Line 4 | false | false | string(100) | any | |
| purposes | false | false | [] | any | Multiple Contacts and Addresses for Suppliers |
The JSON output for /api/addresses and /api/suppliers/<id>/addresses now fully resolves the created_by and updated_by user records instead of just specifying the user ID. This change in output behavior is consistent with the existing XML output behavior.
Contact
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| purposes | false | false | [] | any | Multiple Contacts and Addresses for Suppliers |
Easy form widget
| Element | Change | Feature |
|---|---|---|
| prompt | Type changed from string(255) to text | Updated Design of Questionnaires |
Easy form widget response
| Element | Change | Feature |
|---|---|---|
| answer | name changed from encrypted_answer; type changed from string(20000) to text | Updated Design of Questionnaires |
Expense category
| Element | Change | Feature |
|---|---|---|
| expense_per_diem_config | Now a required field | |
| expense_mileage_config | Now a required field |
Expense preapproval
| Element | Change | Feature |
|---|---|---|
| type | No longer a required field |
Internal supplier
| Element | Change | Feature |
|---|---|---|
| primary_address | Type changed from Address to SupplierAddress | Multiple Contacts and Addresses for Suppliers |
Invoice header
| Element | Change | Feature |
|---|---|---|
| account_type | Now a required field |
Invoice line
| Element | Change | Feature |
|---|---|---|
| account | Now a required field |
Quote request
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| easy-forms | Forms | false | false | easyform | any | Updated Design of Questionnaires |
| forms | This field is deprecated. Use easy-forms instead. | Updated Design of Questionnaires | ||||
Quote request line
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| need_by_date | Date by which the line item is required | false | false | datetime | any | New Fields - Need by Date and Lead Time |
| weight | Type is now a decimal instead of an integer | Weighting of Responses for Scoring | ||||
Remit to address
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| external_src_ref | Reference number from source system. | false | false | string(255) | any | |
| external_src_name | Name of the source system. | false | false | string(255) | any |
Supplier
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| default_locale | Default Locale for sending emails to this supplier | false | false | string(255) | any | 23.0.0 Resolved issue |
| supplier_addresses | false | false | [] | any | Multiple Contacts and Addresses for Suppliers | |
| contacts | false | false | [] | any | Multiple Contacts and Addresses for Suppliers | |
| primary_address | Type changed from Address to Supplier Address | Multiple Contacts and Addresses for Suppliers | ||||
| payment_method | New allowable values: "invoice", "pcard", "invoice_only", "pcard_only", "virtual_card" | |||||
Supplier site
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| default_locale | Default Locale for sending emails to this supplier site | false | false | string(255) | any |
Tax code rule
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature | |
|---|---|---|---|---|---|---|---|
| tax_rate_customer_accounting | false | false | false | boolean | Customer accounting rate for Singapore |
Tax rate
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| tax_description | Tax Rate Description | false | false | string(255) | any | Customer accounting rate for Singapore |
User
| Element | Description | Req'd | Unique | Type | Allowable Values | Feature |
|---|---|---|---|---|---|---|
| spend_guard_user | Does the user have a Spend Guard License? | false | false | boolean | any | Entitlement, Licenses, and Roles |
| aic_user | Does the user have an AI Classification License? | false | false | boolean | any | AI Classification Spend Visualization in Coupa |
| default_locale | New allowable values: ["en", "tr", "ja", "bg", "cs", "da", "de-AT", "de-BE", "de-CH", "de-LU", "de", "el", "en-AU", "en-CA", "en-CN", "en-GB", "en-HK", "en-IE", "en-IN", "en-ME", "en-MT", "en-MY", "en-NZ", "en-PH", "en-SG", "en-TW", "en-ZA", "es-CO", "es-IC", "es-MX", "es-PR", "es", "et", "fi", "fr-BE", "fr-CA", "fr-CH", "fr-LU", "fr", "hr", "hu", "it-CH", "it", "ko", "lt", "lv", "nl", "no", "sv", "zh-CN", "zh-TW", "mt", "nl-BE", "pl", "pt-BR", "pt", "ro", "ru", "sk", "sl", "sr", "vi", "zh-HK"] | |||||