Remit-To Addresses API (/suppliers/addresses)
Use the remit to address API to create, update, or query addresses. This address will be used in send payment to suppliers.
The URL to access remit-to addresses is: https://<instance>/api/suppliers/<supplierid>/addresses
See Integration Best Practices for more info.
Actions
The Remit-To Addresses API allows you to:
Verb | Path | Action | Description |
---|---|---|---|
POST | /api/invoices/:invoice_id/remit_to_addresses |
create | Create remit to address |
POST | /api/suppliers/:supplier_id/addresses |
create | Create remit to address |
DELETE | /api/suppliers/:supplier_id/remit_to_addresses/:id |
destroy | Delete remit to address |
DELETE | /api/suppliers/:supplier_id/addresses/:id |
destroy | Delete remit to address |
GET | /api/invoices/:invoice_id/remit_to_addresses |
index | Query remit to addresss |
GET | /api/suppliers/:supplier_id/addresses |
index | Query remit to addresss |
GET | /api/invoices/:invoice_id/remit_to_addresses/:id |
show | Show remit to address |
GET | /api/suppliers/:supplier_id/addresses/:id |
show | Show remit to address |
PUT | /api/invoices/:invoice_id/remit_to_addresses/:id |
update | Update remit to address |
PATCH | /api/suppliers/:supplier_id/addresses/:id |
update | Update remit to address |
PUT | /api/suppliers/:supplier_id/addresses/:id |
update | Update remit to address |
Elements
The following elements are available for the Remit-To Addresses API:
Element | Description | Required Field? | Unique? | Allowable Value | Api_In Field? | Api_Out Field? | Data Type |
---|---|---|---|---|---|---|---|
active |
Is the item given for this supplier & contract active? and if NOT then DELETE |
yes | yes | boolean | |||
city | City Name | yes | yes | yes | string | ||
country | ISO Country Code | yes | yes | yes | Country | ||
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 | ||||
external-src-name | Name of the source system. | yes | yes | string(255) | |||
external-src-ref | Reference number from source system. | yes | yes | string(255) | |||
id | Coupa Internal Address ID | yes | integer | ||||
local-tax-number | local_tax_number | yes | yes | yes | string | ||
name | Address 'Nickname' | yes | yes | string | |||
postal-code | Postal Code | yes | yes | yes | string | ||
remit-to-code | Remit To Code (if a Supplier address) | yes | yes | yes | yes | string | |
state | State Abbreviation | yes | yes | string | |||
street1 | Address Line 1 | yes | yes | yes | string | ||
street2 | Address Line 2 | 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 | ||||
vat-country | vat_country | yes | yes | Country | |||
vat-number | vat_number | yes | yes | string(255) |
- You can create a remit-to address in active and inactive status. If you don't send a value for the active flag, the system doesn't assign any status.
- The supplier and country must already exist in the system.