# Financial Reconciliation API

The **Financial Reconciliation API** provides a comprehensive view of financial transactions across multiple locations, enabling accurate tracking and reconciliation of payments, deductions, and discrepancies. This API includes:

1. **Deductions Breakdown** – Retrieve a detailed breakdown of deductions, including commissions, error charges, adjustments, and other fee components.
    
2. **Estimated vs. Actual Payout** – Access store-wise comparisons between estimated and actual payouts to identify discrepancies.
    
3. **Tax Bifurcation** – Retrieve store-level tax details, differentiating between taxes remitted to the merchant and those remitted to the state.
    
4. **POS vs. Third-Party Reconciliation** – Compare POS data with third-party platform records to identify order mismatches, status differences, and unclaimed revenue at the store level.
    
5. **Deposit Data** – Get store-wise deposit details to track payment settlements and ensure financial accuracy.
    

This API helps partners maintain financial transparency and optimize reconciliation processes across platforms.

## Financial Deduction Breakdown

 - [GET /finance-manager/financial/overview](https://api.voosh.ai/main/financial-reconciliation-api/financialdeductionbreakdown.md): This endpoint retrieves the financial overview for a specific client.

### Request

- Method: GET
    
- Base URL: {{base-url}}
    
- Path: /finance-manager/financial/overview
    
- Query Parameters:
    
    - clientId (string, required): The unique identifier of the client for whom the financial overview is being requested.
        

#### Request Body

- Type: Raw (JSON)
    
- Description: The request body includes the following parameters:
    
    - startDate (string): The start date for the overview.
        
    - endDate (string): The end date for the overview.
        
    - listingIds (array): An array of listing IDs.
        
    - channel (array): An array of channels.
        
    - payoutDates (array): An array of payout dates.
        

### Response

- Status: 200
    
- Content-Type: application/json
    
- Description: The response will be a JSON object with the following schema:
    



## Store Wise Tax-Details

 - [GET /finance-manager/financial/tax-details](https://api.voosh.ai/main/financial-reconciliation-api/storewisetaxdetails.md): This endpoint makes an HTTP GET request to retrieve tax details for provide stores(listingIds). The request should include the client ID as a query parameter. The request body should be in raw format and include the start date, end date, listing IDs, channel, and payout dates.

### Request Body

- startDate (string): The start date for the tax details.
    
- endDate (string): The end date for the tax details.
    
- listingIds (array): An array of listing IDs.
    
- channel (array): An array of channels.
    
- payoutDates (array): An array of payout dates.
    

#### Example



### Response

Upon a successful execution, the endpoint returns a status code of 200 and a JSON response in the format below:



The response includes the status, status code, message, and tax details for each store, including the store ID, tax remitted to the state, and tax remitted to the merchant.

### Summary

This endpoint retrieves tax details for a specific client based on the provided start date, end date, listing IDs, and channel. The response includes the status, status code, message, and tax details for each store, including the store ID, tax remitted to the state, and tax remitted to the merchant.

## Store Wise Deposit-Details

 - [GET /finance-manager/financial/deposit-details](https://api.voosh.ai/main/financial-reconciliation-api/storewisedepositdetails.md): This endpoint retrieves deposit details for stores.

### Request

- Method: GET
    
- URL: 
    
- Query Parameters:
    
    - : 604517c0-fae8-41b7-8c20-0fe4778e415c
        

#### Request Body

- Type: Raw
    
- { "startDate": "2025-02-23", "endDate": "2025-03-26", "listingIds": \["P5441"\], "channel": \["DOORDASH"\], "payoutDates": \[\]}
    

### Response

- Status: 200
    
- Content-Type: application/json
    

#### Response Body



## Store Wise Estimted Vs Actual Payout

 - [GET /finance-manager/financial/estimate-vs-actual-payouts-details](https://api.voosh.ai/main/financial-reconciliation-api/storewiseestimtedvsactualpayout.md): # Financial Estimate vs Actual Payouts Details

This endpoint retrieves the financial estimate versus actual payouts details for a specific client.

## Request

### Endpoint



### Query Parameters

-  (string, required): The unique identifier of the client.
    

### Request Body



-  (string): The start date for the financial estimate.
    
-  (string): The end date for the financial estimate.
    
-  (array of strings): The listing IDs for which the estimate is being calculated.
    
-  (array of strings): The channels for which the estimate is being calculated.
    
-  (array): The payout dates.
    

## Response

### JSON Schema



The response returns the status of the request, along with the financial estimate versus actual payouts details for the specified client.

## Store Wise POS Vs Off-Premise Details

 - [GET /finance-manager/financial/pos-vs-off-premise-details](https://api.voosh.ai/main/financial-reconciliation-api/storewiseposvsoffpremisedetails.md): # GET /finance-manager/financial/pos-vs-off-premise-details

This endpoint retrieves the details of point of sale (POS) versus off-premise financial data for a specific client.

## Request

- Method: GET
    
- Base URL: {{base-url}}
    
- Path: /finance-manager/financial/pos-vs-off-premise-details
    
- Query Parameters:
    
    - clientId (string, required): The unique identifier of the client.
        

### Request Body

- Type: Raw
    
- { "startDate": "2025-02-23", "endDate": "2025-03-26", "listingIds": \["P5441"\], "channel": \["DOORDASH"\], "payoutDates": \[\] }
    

## Response

- Status: 200
    
- Content-Type: application/json
    
- { "status": true, "statusCode": 0, "message": "", "result": { "up_sell": true, "pos": { "name": "", "color": "", "icon": "" }, "is_incomplete": true, "first_date": "", "last_updated": "", "is_pos_available": true, "first_date_off_premise": "", "last_date_off_premise": "", "is_off_premise_available": true, "storeWise": \[ { "storeId": "", "orderDiff": { "offPremise": 0, "pos": 0, "missedOffPremise": 0, "missedPos": 0, "totalMissedOrders": 0 }, "subTotalDiff": { "pos": 0, "offPremise": 0, "diffOffPremise": 0, "diffPos": 0, "totalDiff": 0 }, "statusDifference": { "totalDiff": 0 }, "revenueToClaimBack": 0 } \] }, "error": null }