# FinancialV2

V2 endpoints (`/f/v2/...`) for retrieving sales and financial data.

### Endpoint Mapping

| V1 Endpoint | V2 Endpoint |
|-------------|-------------|
| `getFinancials` (`/f/finance/{id}/financials/{from}/{to}`) | `getSales` (`/f/v2/business-location/{id}/sales`) |
| `getDailyFinancials` (`/f/finance/{id}/dailyFinancials`) | `getBusinessDaySales` (`/f/v2/business-location/{id}/sales-daily`) |

Response DTOs are nearly identical to V1 with the exceptions noted below

### V2 behaviour

- **Sorting**: Explicitly sorted by `timeClosed`
- **Transitory Accounts /  Unsettled Sales**: Returns closed transactions and ensures no transitory (unclosed) transactions are included in reporting
- **Pagination**: `pageSize` max of 100. No HATEOAS `_links`; uses `nextPageToken` string for pagination instead
- **Daily endpoints** (`getBusinessDaySales`): No pagination, no hard cap on results. May have slower response times for larger data sets
- **Backoffice transactions**: Historical dating not currently supported — transactions appear as if created at current time. Transactions can only be found by the date/time they were actually created. *Historical dating support is planned for a future release.*
- **Backoffice modifications** (payment method change and canceling): Modifications appear on the date the modification was performed, not the original transaction date

If you need to query transactions by their original business date (e.g. for historical reporting or reconciliation); The V1 endpoints may be more suitable until backwards compatibility is added to V2 for this aspect.



## Operations
- [Get Sales](https://api-docs.lsk.lightspeed.app/operation/operation-financial-apigetbusinesslocationsales.md)
- [Get business day sales](https://api-docs.lsk.lightspeed.app/operation/operation-financial-apigetbusinesslocationsalesofabusinessday.md)
- [Lightspeed Payments Data](https://api-docs.lsk.lightspeed.app/operation/operation-financial-apigetlightspeedpayments.md)
- [BETA - Get Aborted Orders](https://api-docs.lsk.lightspeed.app/operation/operation-financial-apigetbusinesslocationabortedordersofabusinessday.md)

[Powered by Bump.sh](https://bump.sh)