latestOpenAPI 3.0.12026-08-20112309904.6 KB
466169815b78
Suppliers - Sites
Delete an identifier for a supplier
Delete an identifier (supplier ID, customer ID, or own site ID) from all suppliers in your organization.
Related Endpoints:
- To create an identifier, use POST /public/v2/suppliers/sites/identifiers.
- To find suppliers by identifier, use GET /public/v2/suppliers/sites/find-by-identifier.
- To get all suppliers, use GET /public/v2/suppliers/sites.
How It Works:
This endpoint deletes a specific identifier across all suppliers that have it. You specify:
- type: The type of identifier to delete (supplierId, customerId, or ownId)
- id: The identifier value to delete
- source: Optional source system of the identifier to delete
Query Parameters:
- type (required): Must be one of: supplierId, customerId, ownId
- id (required): The identifier value (e.g., "SUP-12345")
- source (optional): Source system (e.g., "SAP", "Coupa"). If not provided, will search for identifiers without a source or with the default source.
Examples:
-
Delete a supplier ID:
DELETE /public/v2/suppliers/sites/identifiers?type=supplierId&id=SUP-12345&source=SAP -
Delete a customer ID:
DELETE /public/v2/suppliers/sites/identifiers?type=customerId&id=CUST-67890&source=SAP -
Delete an own site ID:
DELETE /public/v2/suppliers/sites/identifiers?type=ownId&id=OWN-SITE-01&source=SAP
Important Notes:
- The identifier must exist for at least one supplier
- If the identifier doesn't exist, a 404 Not Found error is returned
- All identifier changes are automatically audited
- If source is not provided, the system will search for identifiers without a source or with the default source
Required Permission: MANAGE_PUBLIC_SUPPLIER_IDS
delete/public/v2/suppliers/sites/identifiers
Query parameters
type'SUPPLIER_ID' | 'CUSTOMER_ID' | 'OWN_ID' required
Type of identifier
Example:SUPPLIER_ID
The type of identifier to delete
idstring required
The identifier value to delete
sourcestring
Optional source system of the identifier to delete. If not provided, will search for identifiers without a source or with the default source.
Response
No Content - Identifier deleted successfully.