#! /usr/bin/env node
const fs = require('fs');
const openapi_schema = require("../openapi.json");


// Clean up server urls byt removing trailing /
for (const server of openapi_schema.servers) {
    server.url = server.url.replace(/\/$/,"");
}

// Override openapi.json file with changes
fs.writeFileSync("openapi.json", JSON.stringify(openapi_schema));




#! /usr/bin/env node
const fs = require('fs');
const openapi_schema = require("../openapi.json");

const groups = {};
const navigationTree = []

for (const [uri, subPaths] of Object.entries(openapi_schema.paths)) {
    for (const [method, pathObj] of Object.entries(subPaths)) {
        const title = pathObj.summary;
        const openapi = `${method.toUpperCase()} ${uri}`;
        const description = pathObj.description? pathObj.description.replaceAll("\n", " ") : pathObj.summary;
        const fileName = title.toLowerCase().replaceAll(" ", "-");
        const folder = pathObj.tags[0].toLowerCase().replaceAll(" ", "-");
        const text = `---\ntitle: "${title}"\nopenapi: "${openapi}"\ndescription: "${description}"\n---`;
        const page = `api-reference/${folder}/${fileName}`;
        
        const group = pathObj.tags[0]
        if (!(group in groups)) groups[group] = [];
        groups[group].push(page)
        
        fs.writeFileSync(`${page}.mdx`, text);
    }
}

for (const [group, pages] of Object.entries(groups)) {
    navigationTree.push({group, pages})
}

const sortedNavigationTree = navigationTree.sort((a, b ) => { 
    const aIndex = navigationTree.indexOf(a); 
    const bIndex = navigationTree.indexOf(b); 
    return navigationTree[aIndex].group.toLowerCase().localeCompare(navigationTree[bIndex].group.toLowerCase());
})

console.log("Navigation object suggestion:")
console.log(JSON.stringify(sortedNavigationTree, null, 2));

Create a QuickBooks account mapping and return the associated Ledger

Link Account

DebitCredit

FinancialAccountType

Indicates if the ledger is a credit or debit ledger.

Whether line entries can be manually added or removed from the ledger.

Editable

Indicates that the ledger represents a real-world financial account.

Indicates that the ledger is one of the four system ledgers required for Teal to work. In the default chart of accounts, these are named one of: `Transfers Between Accounts`, `Opening Balance Retained Earnings`, `Uncategorized Cash Inflow`, `Uncategorized Cash Outflow`. You can update the names of these to fit your needs.

Is Required

Name

Expandable. If the ledger is a child ledger, the parent ledger object.

If the ledger is a child Ledger, the ID of the parent ledger object.

Parent Id

Whether Teal includes this ledger in the cash flow report.

Report Cash Flow

Determines the display order in reports, ordered digit by digit, starting from the leftmost position. For example, `20010` will come before `3050`.

Sort Code

Indicates similar characteristics and accounting treatment for a group of ledgers within a `type`.

Indicates the purpose and location of the funds and value recorded in the ledger and which report it is included in: `asset`, `liability` and `equity` ledgers are displayed on the balance sheet; `revenue` and `expenses` are displayed on the income statement.

Ledger

LedgerSubType

LedgerType

QuickBooksSpecialAccountType

TealErrorCode

Creates a link between a QuickBooks Account and Ledgers in Teal. Used to
identify which Accounts represent financial accounts. Only available
for Instances that have a `write` permissions level.

QuickBooksAccountMappingCreate

OAuth2PasswordBearer

TealErrorResponse

Link an Account to a Ledger

Teal

Explore our guides, API reference, and changelog

Overview

Follow these steps to begin using the Teal API.

Initial setup

See Teal in action by building a real cash flow report.

Quickstart

Accounting infrastructure for SMB Neobanks and Vertical SaaS.

Use Cases

A glossary of accounting terms and Teal specific definitions

Core concepts

Chart of accounts

Invoices and Bills

How to migrate data from QuickBooks into Teal.

QuickBooks migration

Managing ledgers

How to set opening balances to ensure accurate balance sheets.

Opening balances

Customers need to be able to manually create and edit journal entries.

Journal Entry Interface

How and why to generate Excel exports from your Teal data

Excel exports

Authentication

Pagination

Expanding responses

Instances

Rate Limits

API Reference

Changelog

Guides

Developer Portal

How Teal's auto-categorization pipeline works

Categorization

Crafting rules

Use our data integrations so that Teal can do the work of fetching and reconciling transactions from a 3rd party data source.

Integrations

Import via API

Build a banking feed style transactions page enriched with accounting data

Enriching Transactions

Reviewing transactions

Reports introduction

Cash flow report

View a company's revenues, expenses, and profits over time

Income statement

Balance sheet

How to build a ledger statement using Teal.

Ledger statement

How to build a general ledger report using Teal.

General ledger report

Fetching Teal data to add to your non-Teal reports

Enriching non-Teal reports

Lists all the Platform categorization rules.

List all Platform rules

Creates a new Platform categorization rule.

Create a Platform rule

Delete a Platform rule

Lists all the Instance categorization rules.

List all Instance rules

Creates a new Instance categorization rule.

Create an Instance rule

Delete an Instance rule

Create a Chart of Accounts Template

Lists all Chart of Accounts Templates for the Platform.

List all Chart of Accounts Templates

Retrieves details of an existing Chart of Accounts Template.

Retrieve a Chart of Accounts Template

Deletes a Chart of Accounts Template. Instances already using the Chart of Accounts Template will not be affected.

Delete a Chart of Accounts Template

Clones a Chart of Accounts Template and all its Ledger Templates.

Clone a Chart of Accounts Template

Creates a new Ledger Template within a Chart of Accounts Template.

Create a Ledger Template

Update a Ledger Template

Delete a Ledger Template

Retrieves the details of an existing Instance.

Retrieve an Instance

Deletes an Instance in the sandbox environment. To deactivate an Instance in a production environment, use the [Update Subscription](https://docs.teal.dev/api-reference/update-an-instance's-subscription) endpoint.

Delete an Instance

Updates the `start_date` or `name` of an Instance.

Update an Instance

Updates an Instance's `subscription`. Set to `tier0` to deactivate the Instance.

Update an Instance's subscription

Creates a new Instance based on the given parameters.

Create an Instance

Lists all Instances belonging to a Platform.

List all Instances

Assign a Bookkeeping Provider

Retrieves information about an existing Journal Entry.

Retrieve a Journal Entry

Updates an existing Journal Entry's details or Line Entries. When updating Line Entries in the Journal Entry, debit and credit amounts must equal.

Update a Journal Entry

Updates multiple existing Journal Entry's details.

Update multiple Journal Entries

Delete a Journal Entry

List all the Journal Entries an Instance.

List all Journal Entries

Creates a new Journal Entry object. The debit and credit amounts of the Line Entries must match.

Create a Journal Entry

Uploads a file and associates it with a Journal Entry.

Create a Journal Entry File

Deletes an existing file associated with a Journal Entry.

Delete a Journal Entry File

Retrieves an existing file associated with a Journal Entry.

Retrieve a Journal Entry File

List all Ledgers

Create a Ledger

Update a Ledger

Deletes a Ledger. Ledgers with line entries cannot be deleted.

Delete a Ledger

Sets the opening balance for a Ledger on the entries start date for the Instance, or updates opening balance if the Ledger already has one. Returns a journal entry.

Set a Ledger's opening balance

Returns the opening balance journal entry

Get all ledgers opening balances

Triggers a request for new transactions from a Ledger's data source, if it has one. Success or error messages will be sent via the `transactions.source` webhooks.

Check a Ledger for new transactions

Retrieves the Ledger's current balanced status and the most recent datetime it was balanced.

Retrieve a Ledger's balanced status

Update a Line Entry

Retrieves the category ID or IDs of a Line Entry.

Retrieve a Line Entry's categories

Lists all the Line Entries in a Journal Entry.

List all Line Entries in a Journal Entry

List all Line Entries in a Ledger

Get Ledger Payables

Create Payable

Get Payable

Update Payable

Delete Payable

Get Payable Status

Retrieves details about an existing Platform.

Retrieve Platform

Creates a URL for connecting an Instance to a QuickBooks Company file.

Create a QuickBooks Auth link

Get QuickBooks sources

Get Migrate Quickbooks Task

Migrate a QB instance. The migration is asynchronous.

Migrate Quickbooks Instance

Get Ledger Receivables

Create Receivable

Get Receivable

Update Receivable

Delete Receivable

Get Receivable Status

Retrieves the income statement for the business. Returns a list of ledger     summaries grouped by ledger `sub_type` and profit calculations.   Related     guide: [Income statement](https://docs.teal.dev/guides/reports/income_statement)

Retrieve the Income Statement

Retrieves the balance sheet for the business. Returns a list of ledger summaries grouped by ledger `type`. Requires a Tier 2 subscription.

Retrieve the Balance Sheet

Retrieves a ledger statement for an existing ledger containing the opening and closing balances with all the line entries within the period.

Retrieve a ledger statement

Retrieves the cash flow report for the business. Returns an object with all ledgers whose balanced changed during the period and the starting and ending balances for each cash flow ledger.

Retrieve the Cash Flow Report

Retrieves a list of the cash flow data across all cash flow ledgers segmented by period.

List cash flow totals by period

Retrieves a list of cash flow data segmented by ledger.

List cash flow totals by ledger

Lists the top expenses for the business within the period.

List top expenses

List net profit by period

Lists gross profit calculations by period.

List gross profit by period

List financial summaries by period

Retrieves a list of ledger statements for all ledgers and sub-ledgers in the chart of accounts within the period. Instances with a large chart of accounts or many transactions may encounter slower processing times.

Retrieve the General Ledger Report

Retrieve a tag group

Deletes an existing tag group from the platform. This will also remove all tags this tag group from all line entries and transactions.

Delete a tag group

Updates an existing tag group. Unspecified fields will not be updated.

API overview

Teal API Endpoints

API Migration

Link Account

Authorizations

Headers

Body

Response