Overview

AccelBooks provides a sophisticated reporting feature that allows businesses to generate essential financial reports and leverage artificial intelligence to produce custom documents based on specific prompts. This enables insightful and predictive financial analysis.

Available Reports

AccelBooks supports several types of financial reports, including standard reports and custom AI-generated documents:

  • Balance Sheets: Snapshot of the company’s financial position at a specific date.
  • Profit and Loss Statements: Detailed account of revenues, costs, and expenses over a period.
  • Cash Flow Reports: Analysis of cash inflows and outflows during a specific timeframe.
  • Custom AI-Generated Reports: Customized reports generated using AI based on user-defined prompts for in-depth analysis.

API Endpoints

Below are the API endpoints available for generating and retrieving financial reports. These descriptions assume a RESTful API design.

Generate Balance Sheet

Generates a balance sheet for the specified date and company.

POST company/{company_id}/reports/balance-sheet
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "start_date": "2024-01-01",
  "end_date": "2024-12-31"
}

Returns:

{
  "report_id": "bs-123456",
  "report_type": "balance_sheet",
  "company_id": "company_123",
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "generated_at": "2024-01-02T12:00:00Z",
  "download_url": "https://api.accelbooks.com/reports/bs-123456.pdf"
}

Generate Profit and Loss Statement

Retrieves a profit and loss statement for a defined period for the specified company.

POST company/{company_id}/reports/profit-loss
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "start_date": "2024-01-01",
  "end_date": "2024-12-31"
}

Returns:

{
  "report_id": "pl-789012",
  "report_type": "profit_and_loss",
  "company_id": "company_123",
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "generated_at": "2024-01-02T12:05:00Z",
  "download_url": "https://api.accelbooks.com/reports/pl-789012.pdf"
}

Generate Cash Flow Report

Produces a cash flow report by comparing two periods for the selected company.

POST company/{company_id}/reports/cash-flow
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "current_period_start": "2024-01-01",
  "current_period_end": "2024-06-30",
  "previous_period_start": "2023-01-01",
  "previous_period_end": "2023-06-30"
}

Returns:

{
  "report_id": "cf-345678",
  "report_type": "cash_flow",
  "company_id": "company_123",
  "current_period_start": "2024-01-01",
  "current_period_end": "2024-06-30",
  "previous_period_start": "2023-01-01",
  "previous_period_end": "2023-06-30",
  "generated_at": "2024-01-02T12:10:00Z",
  "download_url": "https://api.accelbooks.com/reports/cf-345678.pdf"
}

Generate Custom AI-Generated Report

Creates a custom report using AI based on a user-defined prompt for predictive financial insights.

POST company/{company_id}/reports/custom-ai
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "prompt": "Provide a 12-month revenue forecast based on current trends and seasonal adjustments."
}

Returns:

{
  "report_id": "ai-901234",
  "report_type": "custom_ai",
  "company_id": "company_123",
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "prompt": "Provide a 12-month revenue forecast based on current trends and seasonal adjustments.",
  "generated_at": "2024-01-02T12:15:00Z",
  "download_url": "https://api.accelbooks.com/reports/ai-901234.pdf"
}

Retrieving Reports

Access previously generated reports using the following endpoint:

GET /reports/{report_id}
Authorization: Bearer {access_token}

Returns:

{
  "report_id": "report_id",
  "report_type": "balance_sheet|profit_and_loss|cash_flow|custom_ai",
  "company_id": "company_123",
  "generated_at": "2024-01-02T12:00:00Z",
  "download_url": "https://api.accelbooks.com/reports/report_id.pdf",
  // Additional fields depending on the report type
}

This endpoint allows you to retrieve any of the generated reports by providing the report’s unique identifier.