Monitoring an Event and Getting Supplier Responses with the Event Management API

Use this procedure to monitor an event and get supplier responses with the Event Management API. Supplier response information includes alternative bids and bids for multi-round events.

Prerequisites

Context

You can use the Event Management API to get the following information about supplier responses (bids):
  • Summary information: the number of suppliers in the following categories: intend to bid, declined to bid, and submitted bids for an event.

  • Supplier information: Invitation IDs for all suppliers invited to an event and supplier entity (organization) information, including contact information.

  • Monitoring information: bid status and last submission time and date for each supplier.

  • Detailed information about all responses submitted by a specific supplier, optionally filtered by item ID. Responses include information about alternative bids and bids for multi-round events.

Procedure

  1. Use one of the following methods to obtain the ID of the event you want to work with.
    • If the event was created using the POST /events endpoint, use the internalId in the response as the event ID.

    • If the event was created from a sourcing request received from an external system, use the GET /events endpoint and specify the RFQ ID sent by the external system (the RequestID sent in the cXML QuoteRequest) as the externalSystemCorrelationId query parameter value. Use the internalId in the response as the event ID.

    • View the event ID in the user interface. The classic SAP Ariba Sourcing user interface shows the event ID below the Overview tab, in the ID field. The guided sourcing user interface shows the event ID in the upper left corner of the event page, below the event name.

  2. Use any of the following endpoints to get information about the event:
    • GET /events/{eventId}/bidSummary: Get the number of suppliers in the following categories: intend to bid, declined to bid, and submitted bids for a specified event.

    • GET /events/{eventId}/supplierInvitations: Get invitation IDs and detailed supplier information (such as contact information) for all suppliers invited to the event.

    • GET /events/{eventId}/items/{itemId}/supplierInvitations: Get a list of all suppliers invited for an item. An empty response indicates that all suppliers invited to the event are invited for the item.

    • GET /events/{eventId}/supplierInvitations&$select=supplierBidStatus,submissionDate: For each supplier invited to the event, return the supplier invitation ID, the supplier bid status (such as participated), and the date and time the supplier last submitted a response. You can periodically send requests to this endpoint to determine which suppliers have submitted new responses, then use the GET /events/{eventId}/supplierBids/{invitationId} to get details about responses from a specific supplier.

    • GET /events/{eventId}/supplierBids: Get all supplier bids (responses) for the event. The response may be paginated and you can specify maxpagesize in the request header to control the amount of information returned in each page, as described in About Paginating Event Management API Responses.

    • GET /events/{eventId}/supplierBids/{invitationId}: Get all bids (responses) for the event submitted by the specified supplier. You can optionally specify the query filter itemId to retrieve the supplier bids for a specific item. For example, $filter=(itemId eq ID12345).

    Supplier bid information includes:
    • itemId

    • invitationId: The invitation ID of the supplier who submitted the bid.

    • Term values (responses) submitted by the supplier, such as Price.

    • submissionDate

    • submitRound: Submission round, for multi-round events.

    • alternativeId: Value is generated and assigned once the supplier submits the bid.

    • Information about alternative bids. For alternative bids, the bidType is not Primary, but a type of alternative bid: Pricing, Bundle, or Tier. Alternative bids can have values for the following fields:

      • alternateBidName

      • alternateBidBundleOrTierId

      • alternateBidTierMinValue and alternateBidTierMaxValue

  3. If a supplier response includes an attachment (a term or response with "valueTypeName": "Attachment", you can download the attachment, as described in Downloading Attachments from Suppliers with the Event Management API.