Improved
Sales Data: Daily Sales Guide & Improved Docs
10 days ago by ReadMe API
The Sales Data API now has a dedicated guide for daily sales endpoints, with clearer descriptions, response semantics, and worked examples.
What's New
- New guide page: Managing Daily Sales — a single place that documents both the GET aggregation and PUT projection endpoints, with end-to-end examples and use cases.
- Improved endpoint descriptions for
GET /sales/v1/daily-salesandPUT /sales/v1/locations/{locationId}/daily-salesin the API Reference. - Refreshed the Sales Data overview to include daily-sales endpoints, scopes, and the new guide.
Key Clarifications
totalSalesvsprojectedSales:totalSalesis computed automatically from the Transactions API and cannot be set directly.projectedSalesis your forecast and is set via the PUT endpoint — the two values are independent.- Sparse GET results: days with no aggregation data are omitted from the response (not returned as zero). Treat missing days as 'no data yet'.
- PUT semantics: each
dateinupdatesmay appear at most once and replaces only the projected value —totalSalesis never modified. - Date format: all daily-sales dates are ISO 8601
YYYY-MM-DD. - Error cases: documented
400responses for invalid ranges, unknown locations, and duplicate dates.
Authentication
sales_data.read— required forGET /sales/v1/daily-salessales_data.write— required forPUT /sales/v1/locations/{locationId}/daily-sales
For full details, see the Daily Sales Guide and the API Reference.
