Suppliers API (/suppliers)
Overview
Use the suppliers API to create, update, and query the suppliers in Coupa.
The URL to access suppliers is: https://<instance>/api/suppliers
See Integration Best Practices for more info.
Actions
The Suppliers API allows you to:
| Verb | Path | Action | Description |
|---|---|---|---|
| POST | /api/suppliers |
create | Create supplier |
| POST | /api/suppliers/create_supplier_user_preferences |
create_supplier_user_preferences | Create supplier user preferences |
| GET | /api/suppliers |
index | Query suppliers |
| DELETE | /api/suppliers/logout_iframe_session |
logout_iframe_session | Log out (CSP)iframe session |
| GET | /api/suppliers/:id |
show | Show supplier |
| POST | /api/suppliers/sync_supplier_user_locale |
sync_supplier_user_locale | Sync supplier user locale |
| PUT | /api/suppliers/:id |
update | Update supplier |
Elements
The following elements are available for the Suppliers API:
| Element | Description | Required Field? | Unique? | Allowable Value | Api_In Field? | Api_Out Field? | Data Type |
|---|---|---|---|---|---|---|---|
| account-number | Account number | yes | yes | string | |||
| allow-change-requests | Allows suppliers to create change requests from CSP | yes | yes | boolean | |||
| allow-csp-access-without-two-factor | Allows supplier to access Customer's data from CSP without Two Factor | yes | yes | boolean | |||
| allow-cxml-invoicing | Allow cXML invoicing for Supplier | yes | yes | boolean | |||
| allow-inv-choose-billing-account | Allow inv choose billing account | yes | yes | boolean | |||
| allow-inv-from-connect | If yes, then the supplier can create invoices against their POs or Contracts in the CSP | yes | yes | boolean | |||
| allow-inv-no-backing-doc-from-connect | If yes, then the supplier can create invoices without a backing PO or Contract in the CSP. | yes | yes | boolean | |||
| allow-inv-unbacked-lines-from-connect | If yes, then the supplier can create unbacked invoices without a backing PO or Contract in the CSP. | yes | yes | boolean | |||
| business-groups | business groups | yes | yes | ContentGroup | |||
| buyer-hold | Hold all POs for buyer review | yes | yes | boolean | |||
| contacts | no | no | any | yes | Supplier Information Contacts | ||
| commodity | Default commodity, selectable from drop-down | yes | yes | ||||
| corporate-url | Corporate URL | yes | string | ||||
| coupa-connect-secret | Coupa connect secret | yes | string | ||||
| created-at | Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ | yes | datetime | ||||
| created-by | User who created | yes | User | ||||
| cxml-domain |
"From" , our domain cXML domain |
yes |
yes | yes | string(255) | ||
| cxml-http-password | cXML HTTP password | yes | |||||
| cxml-http-username | cXML HTTP username | yes | yes | string | |||
| cxml-identity |
"From", our identity cXML identity |
yes |
yes | yes | string(255) | ||
| cxml-invoice-buyer-domain | Buyer Domain for cXML Invoicing | yes | yes | yes | string | ||
| cxml-invoice-buyer-identity | Buyer Identity for cXML Invoicing | yes | yes | yes | string | ||
| cxml-invoice-secret | Secret Key for cXML Invoicing Authentication | yes | yes | yes | string | ||
| cxml-invoice-supplier-domain | Supplier Domain for cXML Invoicing | yes | yes | yes | string | ||
| cxml-invoice-supplier-identity | Supplier Identity for cXML Invoicing | yes | yes | yes | yes | string | |
| cxml-protocol |
Transmission protocol |
yes |
yes | yes | string(255) | ||
| cxml-secret | Shared secret |
yes |
yes | yes | string(940) | ||
| cxml-ssl-version | cXML SSL version | yes | yes | string | |||
| cxml-supplier-domain |
"To", supplier domain cXML supplier domain |
yes |
yes | yes | string(255) | ||
| cxml-supplier-identity |
"To", supplier identity cXML supplier identity |
yes |
yes | yes | string(255) | ||
| cxml-url | URL where POs are sent if PO transmission is "cxml" |
yes |
yes | yes | string(255) | ||
| default-locale | Default Locale for sending emails to this supplier | no | no | any | yes | string(255) | |
| disable-cert-verify |
Disable cert verify |
yes | yes | boolean | |||
| display-name | Display name | yes | yes | string | |||
| duns | Supplier DUNS number | yes | yes | string | |||
| enterprise | Enterprise | True | yes | yes | Enterprise | ||
| hold-invoices-for-ap-review | Prevent invoices from this supplier from being approved before AP reviews them. | yes | boolean | ||||
| id | Coupa Internal ID | yes | integer | ||||
| invoice-emails | Registered email addresses allowed to send invoices via email to invoices@yourhost.coupahost.com. |
yes | yes | ||||
| invoice-matching-level | Invoice matching level | yes | 2-way, 3-way, 3-way-direct, none | yes | yes | string | |
| name | Supplier name | yes | yes | yes | yes | string(100) | |
| number | Supplier number | yes | yes | yes | string | ||
| on-hold | Supplier On Hold | yes | yes | boolean | |||
| online-store | Supplier website | yes | yes | yes | |||
| parent | parent | yes | yes | Supplier | |||
| payment-method | Default payment method, selectable from drop down | yes | invoice, pcard, invoice_only, pcard_only, virtual_card | yes | yes | string(255) | |
| payment-term | Default payment term, selectable from drop down | yes | yes | ||||
| payment-term-id-for-api | Payment term ID for API | yes | |||||
| po-change-method |
Purchase order change transmission method |
true | false | cxml, xml, email, prompt, mark_as_sent, buy_online | yes | yes | string(255) |
| po-email | Email where POs are sent if PO transmission is "email" |
yes |
yes | yes | string(255) | ||
| po-method | Purchase order transmission method | cxml, xml, email, prompt, mark_as_sent, buy_online | yes | yes | string(255) | ||
| primary-address | Primary address | yes | Supplier Address | yes | yes | Supplier Information Address | |
| primary-contact | Primary supplier contact email | yes | yes | yes | |||
| remit-to-addresses | Remit to addresses | yes | yes | RemitToAddress | |||
| restricted-account-types | Restricted account types | yes | yes | AccountType | |||
| savings-pct | Savings for using this supplier | yes | yes | decimal | |||
| send-invoices-to-approvals | If yes, then invoices will all be sent thru approvals, regardless of total amount. | yes | yes | boolean | |||
| scf-configs | Supply chain finance configurations whitelisted for supplier | yes | yes | string | |||
| shipping-term | Supplier shipping term, selectable from drop down | yes | yes | ||||
| status | Supplier status | yes | string | ||||
| storefront-url | Supplier website | yes | string | ||||
| supplier-addresses | no | no | any | yes | [] | ||
| yes | SupplierSite | ||||||
| supplier-status | Supplier status | yes | draft | ||||
| tax-code | Supplier tax code | yes | yes | ||||
| tax-id | Supplier DUNS number | yes | yes | string | |||
| updated-at | Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ | yes | datetime | ||||
| updated-by | User who updated | yes | User | ||||
| website | Supplier website | yes | yes | string | |||
| whitelist-dd | Whitelist suppliers for Dynamic Discounting | false | false | any | yes | yes | boolean |
| dd-settings | Dynamic Discounting Settings whitelisted for supplier | yes | yes | string | |||
| customer-support-contacts | Contains list of supplier account owners (customer support contacts) with their purpose | yes | yes | [] | |||
| diversities | List of Supplier Diversities. | Refer to Diversity Marker Codes | yes | yes | [] |
- There are dependent fields that can become queryable based on the value from the source field. For example, if you query against po-method=email, then po-email can be added as an additional query criteria. Please see fields with Yes*.
- For large data set and performance optimization, always limit your result with some GET criteria.
- If you do not set a status for the supplier, the system defaults to draft.
- If you do not set a default payment method, the system defaults to invoice.
- For the API to recognize custom fields, the fields must be set as API editable in the setup.
- If you have Coupa Supplier Portal (CSP) enabled in your environment, the Allow Supplier to Create Invoice field defaults to checked.
- When updating the primary address of the supplier, you can update every attribute on the address object, but you cannot associate a different address ID to the supplier record.
- When updating the primary contact on the supplier record, you can update every attribute on the contact information, but you cannot assign a completely different contact ID to the supplier record.
Diversity marker codes
| Diversity Marker Code | Description |
|---|---|
| MBE | Minority-Owned Business Enterprise |
| WBE | Woman-Owned Business Enterprise |
| SBE | Small Business Enterprise |
| LGBTBE | Lesbian, Gay, Bisexual, Transgender Business Enterprise |
| DOB | Disability Owned Businesses |
| NPO | Non-profit Organization |
| DBE | Disadvantaged Business Enterprise |
| SDB | Small Disadvantaged Business |
| SDVBE | Service Disabled Veteran Owned Business Enterprise |
| WOSB | Woman-Owned Small Business |
| VOB | Veteran Owned Business |
| DVBE | Disabled Veteran Business Enterprise |
| SDVOSB | Service Disabled Veteran Owned Small Business |
| HUBZone | Historically Underutilized Business Zone |
| SBA8A | SBA-8(A) |
| ACDBE | Airport Concession Disadvantaged Business Enterprise |
| ANC | Alaskan Native Corporation |
| HBCU | Historically Black College or University / Minority Institution |
| LSA | Labor Surplus Area |
| VVO | Vietnam Veteran Owned |
| ABILITYONE | Ability One Program |
| EDWOSB | Economically Disadvantaged Women-Owned Small Business |
| NAO | Native American owned |
| IOB | Indigenous-owned business |
| AMS | Aboriginal and Minority Supplier |
| BOB | Black-owned business |
| MGOB | Minority group owned business |
| EMB | Ethnic minority businesses (EMBs) |