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:

  1. Delete a supplier ID:

    DELETE /public/v2/suppliers/sites/identifiers?type=supplierId&id=SUP-12345&source=SAP
    
  2. Delete a customer ID:

    DELETE /public/v2/suppliers/sites/identifiers?type=customerId&id=CUST-67890&source=SAP
    
  3. 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.