Skip to main content

 

 

Coupa Success Portal

Release 20 Outbound API Changes

All attributes are new unless otherwise specified.

Contracts

Contract

Attribute Description Req'd Unique Type Allowable Values Feature
type Contract type false false string(255) MasterContract, AmendmentContract  
used_for_buying Used for Buying false false boolean any  
strict_invoicing_rules Strict Invoicing Rules false false boolean any  
term_type Term type false false string(255) fixed, auto_renew, perpetual  
termination_notice Termination Notice false false string(255) yes, no  
consent Notice to Consent false false string(255) notice, consent, not_required, not_assignable  
no_of_renewals No of Renewals false false string(255) any  
renewal_length_unit Unit of Renewal Length(Days/Years) false false string(255) days, years  
renewal_length_value Value of Renewal Length false false string(255) any  
length_of_notice_unit Unit of Length of Termination notice(Days/Years) false false string(255) days, years  
length_of_notice_value Value of Length of Termination notice false false string(255) any  
quote_response_id Id of Quote Response false false integer any  
end_date Now a required field  

Inventory

Cycle Count Line Count (NEW)

Attribute Description Req'd Unique Type Allowable Values Feature
id Coupa unique identifier false false integer any  
created_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  
updated_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  
quantity   true false decimal(30,6) any  
on_hand_balance   false false   any  
discrepancy   false false   any  
inventory_balance   true false   any  
cycle_count_line_adjustments   false false [] any  
non_voided_inventory_transactions   false false [] any  

Expenses 

We've updated the Expense APIs with some new elements and data types, shown below.

Expense Reports

Attribute Description Req'd Unique Type Allowable Values Feature
expense_preapprovals Applied expense preapprovals false false   any Travel Expense Preapprovals

Expense Preapproval (NEW)

This is a new data type for the Expense Report API added as part of the new Travel Expense Preapprovals feature.

Attribute Description Req'd Unique Type Allowable Values
id Coupa unique identifier false false integer any
created_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any
updated_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any
description Additional information for preapproval request true false string(255) any
type Type of preapproval request (trip, cash advance, gifts, entertainment) true false string(255) any
available A flag to show the availability & validity of this preapproval false false boolean any
amount Original preapproved amount true false decimal(32,4) any
available_amount Remaining preapproved amount false false decimal(32,4) any
start_date   false false datetime any
end_date   false false datetime any
for_user User who requested expense preapproval false false integer any
currency Original preapproved currency false false   any
available_amount_currency Remaining preapproved currency false false   any
created_by User who created preapproval request false false integer any
updated_by User who last updated preapproval request false false integer any

Expense Category

Attribute Description Req'd Unique Type Allowable Values Feature
attendee_tracking_enabled   false false boolean any Advanced Mileage Reimbursement
expense_mileage_config   false false   any Advanced Mileage Reimbursement
expense_attendee_types   false false   any Advanced Mileage Reimbursement

Expense Line

Attribute Description Req'd Unique Type Allowable Values Feature
parent_external_src_name Parent External Source Name false false string any  
parent_external_src_data Parent External Source Data false false string any  
parent_external_src_ref Parent External Source Ref false false string any  
expense_preapproval Applied expense preapproval false false expense_preapproval any  
expense_line_mileage   false false   any  

Expense Attendee

Attribute Description Req'd Unique Type Allowable Values Feature
expense_attendee_type_id   false false integer any  
user_id   false false integer any  
active   false false boolean any  
expense_attendee_type_name   false false   any  
expense_attendee_type Field is no longer supported  
user Field is no longer supported  

Expense Line Attendee (NEW)

Attribute Description Req'd Unique Type Allowable Values Feature
id Coupa unique identifier false false integer any  
created_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  
updated_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  
expense_line_id   false false integer any  
expense_attendee_id   false false integer any  

Expense Attendee Type 

Attribute Description Req'd Unique Type Allowable Values Feature
active_dependent_fields   false false   any  

Expense Line Mileage (NEW)

Added as part of Advanced Mileage Reimbursement.

Attribute Description Req'd Unique Type Allowable Values
id Coupa unique identifier false false integer any
created_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any
updated_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any
passenger_count   false false integer any
start_address   true false string(255) any
end_address   true false string(255) any
distance   true false decimal(32,4) any
distance_unit   true false string(255) any
round_trip   false false boolean any
expense_mileage_vehicle_type   false false   any
expense_mileage_region   false false   any
expense_line_mileage_allocations   false false   any

Expense Line Mileage Allocation (NEW)

Attribute Description Req'd Unique Type Allowable Values Feature
id Coupa unique identifier false false integer any  
created_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  
updated_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  
expense_mileage_rate_type_id   false false integer any  
applied_distance   false false decimal(32,4) any  
applied_rate   false false decimal any

Itemized Expense Line

Attribute Description Req'd Unique Type Allowable Values Feature
parent_external_src_name Parent External Source Name false false string any  
parent_external_src_data Parent External Source Data false false string any  
parent_external_src_ref Parent External Source Ref false false string any  

Platform

Integration History Record

Field Name Details
document_type Now a required attribute
document_id Now a required attribute

Item

Field Name Description
reorder_alerts Attribute no longer supported

Invoicing

Invoice Header

Attribute Description Req'd Unique Type Allowable Values Feature
payment_order_reference Payment Order Reference false false string(255) any
withholding_tax_lines   false false   any Withholding Tax
clearance_document Clearance document attachment file name. Accessible via /retrieve_clearance_document false false string any  
coupa_accelerate_status Status indicating whether the invoice has discount payment terms via Coupa Accelerate false false string(255) accelerated  
inbound_invoice Attribute is no longer supported  

Invoice Line

Attribute Description Req'd Unique Type Allowable Values Feature
withholding_tax_lines   false false [] any Withholding Tax
unspsc UNSPSC false false string(255) any Mexico Compliance

Tax Line

Attribute Description Req'd Unique Type Allowable Values Feature
type WithholdingTaxLine or TaxLine false false string(255) WithholdingTaxLine, TaxLine Withholding Tax
base Base to Calculate Withholding false false decimal(30,4) any Withholding Tax
withholding_amount Withholding Amount false false decimal(30,4) any Withholding Tax
supplier_rate Supplier Withholding Rate Suggestion false false decimal(30,4) any Withholding Tax
basis Supplier Withholding Base Suggestion false false decimal(30,6) any Withholding Tax

Purchase Orders

Order Header

Attribute Description Req'd Unique Type Allowable Values Feature
invoice_stop Invoice Stop flag false false boolean any Soft Close Purchase Orders
coupa_accelerate_status Status indicating whether the invoice has discount payment terms via Coupa Accelerate false false string(255) accelerated  

Order Line

Attribute Description Req'd Unique Type Allowable Values Feature
invoice_stop Invoice Stop flag false false boolean any Soft Close Purchase Orders
service_type Service type false false non_service any  
extra_line_attribute   false false   any  

Order Amount Line

Attribute Description Req'd Unique Type Allowable Values Feature
service_type Service type false false non_service any  
extra_line_attribute   false false   any  

Sourcing

Quote Request

Field Name Details
commodity No longer a required field
quote_suppliers No longer a required field

Registered Company

Field Name Details
registration_authority Registration Authority was renamed to QST Registration Number

Supplier User

Field Name Details
default_locale New locales added: en-ME, en-PH,

Tax Code

Field Name Details
country Now a required field

Tax Rate

Attribute Description Req'd Unique Type Allowable Values Feature
reverse_charge Whether Tax Rate is Reverse Charge or not false true boolean any  

User

Field Name Details
Default Locale New locales added: en-ME, en-PH,

User Group Membership (NEW)

Attribute Description Req'd Unique Type Allowable Values Feature
user_group_id User group Id false false integer any  
user_id User Id false false integer any  
owner Indicates whether the user is admin or not false false boolean any  
participant Indicates whether the user is participant or not false false boolean any  
user   true false   any  
user_group   true false   any  
id Coupa unique identifier false false integer any  
created_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  
updated_at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ false false datetime any  

 

  • Was this article helpful?