Endpoints
- Welcome
- Bank Accounts
- Bids
- EOIs
- EOI Responses
- Invoices
- Jobs
- Milestones
- Offers
- Orgs
- Purchase Orders
- Sales Invoices
- Sales Milestones
- Skill Categories
- Skill Taxonomies
- Skills
- Suppliers
- GETRetrieve all suppliers, filter by query
- POSTCreate a Supplier
- GETRetrieve a supplier by ID
- DELDelete a Supplier by ID
- PATCHUpdate a Supplier by ID
- GETRetrieve a supplier's users
- GETRetrieve a supplier's documents
- GETRetrieve a documents attachments
- GETRetrieve a supplier's catalogs
- GETRetrieve a supplier's catalog
- GETRetrieve a supplier's resources
- GETRetrieve a supplier's resource
- GET
- Supplier Lists
- Users
- Variation Orders
Update a Supplier by ID
curl --request PATCH \
--url https://api.zivio.net/api/v3/suppliers/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--header 'zivio-tenant-id: <api-key>' \
--data '{
"supplier": {
"supplier": {
"name": "My New Supplier",
"description": "Specialist in Construction",
"headline": "Nice people to do business with",
"tax_number": "1234568983",
"vetting_status": "PASSED"
}
}
}'
{
"id": "77",
"name": "Company Inc",
"description": "A detailed biography of the supplier.",
"headline": "Proven track record in medical procurement",
"email": "jack_jones@companyinc.com",
"active": "true",
"vetting_status": "PASSED",
"tax_number": "9876543234",
"duns_number": "12345678910",
"linkedin_url": "https://www.linkedin.com/2342342",
"onboarding_template_name": "Sole Trader Onboarding",
"invited_by": {
"id": "66",
"first_name": "Lorna",
"last_name": "Lawless",
"email": "lorna@example.com",
"org_name": "Example Org",
"org_id": "186",
"business_unit": "Resident Services",
"division": "Environment & Streetscene",
"department": "Housing",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"archived_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"admin_custom_fields": {
"key": "value"
},
"primary_address": {
"id": "326",
"line1": "326",
"line2": "Westbourne Grove",
"city": "Brighton",
"region": "East Sussex",
"postcode": "BN99 9XX",
"country_code": "GB",
"formatted": "326, Westbourne Grove, Brighton, East Sussex, BN99 9XX, United Kingdom"
},
"invoice_address": {
"id": "326",
"line1": "326",
"line2": "Westbourne Grove",
"city": "Brighton",
"region": "East Sussex",
"postcode": "BN99 9XX",
"country_code": "GB",
"formatted": "326, Westbourne Grove, Brighton, East Sussex, BN99 9XX, United Kingdom"
},
"bank_accounts": [
{
"id": "132",
"currency": "GBP",
"country_code": "GB",
"account_holder_name": "Organistation Ltd",
"account_holder_type": "Business",
"account_number": "****1234",
"sort_code": "123456",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
]
}
Path Parameters
Body
"My New Supplier"
"Specialist in Construction"
"Nice people to do business with"
"1234568983"
PASSED
, FAILED
, PENDING
Response
"77"
"Company Inc"
"A detailed biography of the supplier."
"Proven track record in medical procurement"
"jack_jones@companyinc.com"
"true"
"PASSED"
"9876543234"
"12345678910"
"https://www.linkedin.com/2342342"
"Sole Trader Onboarding"
"66"
"Lorna"
"Lawless"
"lorna@example.com"
"Example Org"
"186"
"Resident Services"
"Environment & Streetscene"
"Housing"
"PASSED"
"true"
"326"
"326"
"Westbourne Grove"
"Brighton"
"East Sussex"
"BN99 9XX"
"GB"
"326, Westbourne Grove, Brighton, East Sussex, BN99 9XX, United Kingdom"
"326"
"326"
"Westbourne Grove"
"Brighton"
"East Sussex"
"BN99 9XX"
"GB"
"326, Westbourne Grove, Brighton, East Sussex, BN99 9XX, United Kingdom"
"132"
"GBP"
"GB"
"Organistation Ltd"
"Business"
"****1234"
"123456"
curl --request PATCH \
--url https://api.zivio.net/api/v3/suppliers/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--header 'zivio-tenant-id: <api-key>' \
--data '{
"supplier": {
"supplier": {
"name": "My New Supplier",
"description": "Specialist in Construction",
"headline": "Nice people to do business with",
"tax_number": "1234568983",
"vetting_status": "PASSED"
}
}
}'
{
"id": "77",
"name": "Company Inc",
"description": "A detailed biography of the supplier.",
"headline": "Proven track record in medical procurement",
"email": "jack_jones@companyinc.com",
"active": "true",
"vetting_status": "PASSED",
"tax_number": "9876543234",
"duns_number": "12345678910",
"linkedin_url": "https://www.linkedin.com/2342342",
"onboarding_template_name": "Sole Trader Onboarding",
"invited_by": {
"id": "66",
"first_name": "Lorna",
"last_name": "Lawless",
"email": "lorna@example.com",
"org_name": "Example Org",
"org_id": "186",
"business_unit": "Resident Services",
"division": "Environment & Streetscene",
"department": "Housing",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"archived_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"admin_custom_fields": {
"key": "value"
},
"primary_address": {
"id": "326",
"line1": "326",
"line2": "Westbourne Grove",
"city": "Brighton",
"region": "East Sussex",
"postcode": "BN99 9XX",
"country_code": "GB",
"formatted": "326, Westbourne Grove, Brighton, East Sussex, BN99 9XX, United Kingdom"
},
"invoice_address": {
"id": "326",
"line1": "326",
"line2": "Westbourne Grove",
"city": "Brighton",
"region": "East Sussex",
"postcode": "BN99 9XX",
"country_code": "GB",
"formatted": "326, Westbourne Grove, Brighton, East Sussex, BN99 9XX, United Kingdom"
},
"bank_accounts": [
{
"id": "132",
"currency": "GBP",
"country_code": "GB",
"account_holder_name": "Organistation Ltd",
"account_holder_type": "Business",
"account_number": "****1234",
"sort_code": "123456",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
]
}