This document outlines the key points from a meeting about Best Buy’s Fulfillment APIs for partners (Our Client). Here’s a breakdown of the main topics covered:

Catalog API

• Not currently exposed to partners.
• Requires manual configuration with Best Buy’s business team.
• Partners can map their SKUs to Best Buy’s SKUs for fulfillment.

Store Location APIs

• Two APIs are available:
  • Get all store location IDs.
  • Get details for a specific store ID.
• Caching store details is recommended due to infrequent changes.

Product Availability APIs

• There are two main APIs:
  • Product Availability: Provides nearest, fastest, or “best” availability (within a 25-mile radius) for a given SKU and postal code. Partners cannot change the search radius.
  • Store Finder and Availability Details: Used on the cart or store finder page. Allows retrieving availability details for multiple SKUs and a postal code. This API also generates an Availability Token for reservation purposes.

Reservation API

• Partners can reserve items in the customer’s cart using the Availability Token from the previous API.
• Two reservation options are available:
  • Short-term reservation (default): Holds the item for 15 minutes (configurable) while the customer browses the cart.
  • Long-term reservation (optional): Holds the item for a longer period (typically a few hours) to accommodate fraud checks or other processing before order submission.

Order Submit API

• Used to submit the final order to Best Buy after reservation and any necessary checks on the partner’s side.
• Requires the reservation ID and other order details.
• Best Buy splits multi-quantity orders into individual line items for easier fulfillment.

Event API

• Best Buy uses a polling mechanism for order status updates. Partners cannot subscribe to real-time streams.
• There are two main APIs for events:
  • Event List: Retrieves a list of events within a specific date range and event types (optional).
  • Event Details: Provides details for specific event IDs retrieved from the Event List API.

Cancel API

• Allows canceling orders at the line-item level. Not supported at the order level.
• Cancellation requests may not succeed immediately due to various order states. Partners should rely on subsequent event notifications for confirmation.
• Different response statuses indicate success, failure reasons, or pending cancellations.

Returns

• In-store returns are initiated by the customer at the store.
• Best Buy notifies partners about returns through the Event API, allowing them to initiate refunds.

Additional Notes

• Best Buy is considering adding an SQS queue for future API updates.
• Partners can leverage Kafka or similar tools to build custom streaming pipelines on top of the provided APIs.
• The current focus is on pickup fulfillment for the Minimum Viable Product (MVP). Parcel fulfillment events will be addressed in future discussions.