Supplier Sites API (/supplier_sites)
Use the supplier sites API to create, update, and query the site locations (a child record of suppliers) in Coupa.
The URL to access supplier sites is: https://<instance>/api/suppliers/:supplier_id/supplier_sites
See Integration Best Practices for more info.
Actions
The Supplier Sites API allows you to:
Verb | Path | Action | Description |
---|---|---|---|
POST | /api/suppliers/:supplier_id/supplier_sites | create | Create supplier site |
GET | /api/suppliers/:supplier_id/supplier_sites | index | Query supplier sites |
GET | /api/suppliers/:supplier_id/supplier_sites/:id | show | Show supplier site |
PATCH | /api/suppliers/:supplier_id/supplier_sites/:id | update | Update supplier site |
PUT | /api/suppliers/:supplier_id/supplier_sites/:id | update | Update supplier site |
DELETE | /api/suppliers/:supplier_id/supplier_sites/:id | delete | Deletes the supplier site by id |
Elements
The following elements are available for the Supplier Sites API:
Element | Description | Required Field? | Unique? | Allowable Value | Api_In Field? | Api_Out Field? | Data Type |
---|---|---|---|---|---|---|---|
active | True if the site is active. Defaults to "true" if value not provided in payload in POST operation. |
true, false
|
yes | yes | boolean | ||
account-types | Account types | yes | yes | AccountType | |||
addresses | Supplier Site addresses | yes | yes | [] | |||
allow_change_requests | Allows suppliers to create change requests from CSP | yes | yes | boolean | |||
buyer-hold | Hold all POs for buyer review | true, false | yes | yes | boolean | ||
code | supplier_code | yes | yes | yes | yes | string(20) | |
contacts | Supplier Site contacts | yes | yes | [] | |||
content-groups | Content group that controls visibility of supplier site to end users. Defaults to "Everyone" content group if no value is provided in the payload in POST operation. | yes | yes | ContentGroup | |||
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 |
yes (if po-method = cxml) |
yes | yes | string | ||
cxml-http-username | User name required to access the Supplier's online store | yes | yes | string | |||
cxml-identity | "From", our identity | yes (if po-method = cxml) | yes | yes | string | ||
cxml-protocol | Transmission protocol | yes (if po-method = cxml) | yes | yes | string | ||
cxml-secret | Shared secret | yes (if po-method = cxml) | yes | yes | string | ||
cxml-ssl-version | Specify the SSL version used for cXML communication with the supplier | TLSv1_2, TLSv1_1, TLSv1 | yes | yes | string | ||
cxml-supplier-domain | "To", supplier domain | yes (if po-method = cxml) | yes | yes | string | ||
cxml-supplier-identity | "To", supplier identity | yes (if po-method = cxml) | yes | yes | string | ||
cxml-url | URL where POs are sent if PO transmission is "cxml" | yes (if po-method = cxml) | yes | yes | string | ||
default_locale | Default Locale for sending emails to this supplier site | no | no | any | yes | string(255) | |
disable-cert-verify | Specify whether to ignore SSL certificate mismatch errors | true, false | yes | yes | boolean | ||
id | Coupa Internal ID of the Supplier Site record | yes | integer | ||||
name | Supplier Site name | yes | yes | yes | string | ||
payment-method | Default payment method, selectable from drop down | yes | yes | string(255) | |||
payment-term | Default payment term, selectable from drop down | yes |
yes (only if supplier site is associated with payment term) |
Payment term should exist in Coupa. |
|||
po-change-method | Purchase order change transmission method | yes | cxml, xml, email, prompt, mark_as_sent, buy_online | yes | yes | string | |
po-email | Email where POs are sent if PO transmission is "email" |
yes (if po-method = email) |
yes | yes | string | ||
po-method | Purchase order transmission method | yes | cxml, xml, email, prompt, mark_as_sent, buy_online | yes | yes | string | |
shipping-term | Supplier shipping term, selectable from drop down | yes |
yes (only if supplier site is associated with shipping term) |
Shipping term must exist in Coupa. |
|||
supplier_id | Supplier id | yes | yes | integer | |||
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 |