Order Retrieval APIs

Summary of APIs that can be utilized to retrieve Orders from SpotOn Enterprise

SpotOn Enterprise provides three different avenues for retrieving Orders from our system, each suited for different scenarios:

  1. Transactions API
  2. Transactions PubSub
  3. Reporting API

To best choose which product suits your needs, let's dive into how they work and what they provide.

Transactions API

Transactions API is a pull-based API that enables retrieval of individual orders and order batches filtered by properties like local_order_uuid, start_date, end_date, and retrieval_status.

πŸ‘

Optimal Uses

  • Retrieving a snapshot of completed orders in a given time range
  • Pulling large quantities of completed orders infrequently
  • Populating a data warehouse for long-term, aggregate reporting purposes

🚧

Non-Optimal Uses

  • Real-time reporting or war room dashboards

Transactions PubSub

Transactions PubSub is a stream-based API that enables the retrieval of individual orders as they are entering our system.

πŸ‘

Optimal Uses

  • Real-time reporting
  • War Room dashboards
  • Event Day financial, loss prevention, and inventory insight

🚧

Non-Optimal Uses

  • Historical order data retrieval

Reporting API

Reporting API is our legacy pull-based API that enables retrieval of individual orders and order batches.

πŸ‘

Optimal Uses

  • Event information
  • High level sales statistics
  • Legacy Item information
  • Reporting on orders using legacy items
  • Venue and vendor information

🚧

Non-Optimal Uses

  • Real-time reporting or war room dashboards
  • Near real time reporting
  • Reporting on non legacy items

What’s Next