> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maesn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Accounting API

You can use this API to access all Accounting API endpoints.

## Base URL

The base URL for all endpoints is
`https://api.maesn.dev`

## Data models

The following unified data models are supported in the Accounting API:

### Accounts

An `Account` represents a category in a company’s ledger in which a financial transaction is recorded against. The aggregation of each Account object is often referred to as the 'Chart of Accounts'.

### Bank account

A `Bank account` is a company’s financial account, used to manage cash flow and record transactions like deposits and payments. It includes details like iban, bank name, and currency.

### Bills

A `Bill` object represents an itemized record of goods and/or services bought from a supplier.

### Booking proposal

A `Booking proposal` is a suggested accounting entry that includes all the relevant data needed for a financial transaction, such as the accounts involved, amounts, and any additional information required.

### Booking

A `Booking` is a confirmed accounting entry that has been recorded in the accounting system, typically resulting from a booking proposal. It includes all the necessary details such as accounts, amounts, and any additional information required for the transaction.

### Contacts

A `Contact` is an individual or business entity to which products and services are sold to or purchased from. The contact model contains both Customers, whom products and services are sold to, and Suppliers (or Vendors), whom products and services are purchased from. Note that it is preferred to use the `Customers` and `Suppliers` models and that contacts are only supported as an exception, for systems where a contact cannot be classied as a customer or supplier in a deterministic way.

### Customers

The `Customer` object represents an individual or business entity to which products and services are sold.

### Dimensions

A `Dimension` is a categorization method used to classify transactions within an accounting platform.

### Credit notes

A `Credit note` is a transaction issued to a customer, indicating a reduction or cancellation of the amount owed by the customer. It is most generally used as an adjustment note used to rectify errors, returns, or overpayments related to a sales transaction.

### Expenses

An `Expense` represents a direct purchase by a business, typically made with a check, credit card, or cash. Each Expense object is dedicated to a grouping of expenses, with each expense recorded in the lines object.

The Expense object is also used used to represent refunds to direct purchases. Refunds can be distinguished from purchases by the amount sign of the records. Expense objects with a negative amount are purchases and Expense objects with a positive amount are refunds to those purchases. is a transaction issued to a customer, indicating a reduction or cancellation of the amount owed by the customer. It is most generally used as an adjustment note used to rectify errors, returns, or overpayments related to a sales transaction.

### Files

A `File` is simply a data file, typically representing a "voucher", such as an invoice, a bill, a credit note, a delivery note, a delivery confirmation, a receipt or similar in an accounting system.

### Fiscal years

A `Fiscal year` represents the financial reporting period configured for a company. It defines the start and end dates used for accounting, reporting, and tax purposes.

### Goods Receipts

A Goods receipt is a record that confirms items were received from a supplier and updates inventory accordingly.

### Invoices

The `Invoice` object represents an itemized record of goods and/or services sold to a customer.

### Items

An `Item` refers to any product, material, or service that a business manages, tracks, or sells within its operations.

### Journals

A Journal is a collection of related journal entries used to organize financial transactions by category or source, such as sales, purchases, or bank activities, within a company's ledger.

### Journal entry

A `Journal entry` is a record of a transaction or event that is entered into a company's accounting system. The JournalEntry common model contains records that are automatically created as a result of a certain type of transaction, like an `invoice`, and records that are manually created against a company’s ledger.

The lines of a given journal entry object should always sum to 0. A positive net\_amount means the line represents a debit and a negative net\_amount represents a credit.

### Offers

An `Offer` is a formal document provided by a seller to a potential buyer that outlines the details and pricing of goods or services the seller proposes to provide.

### Open items

An `Open item` is a receivable or payable that has been recorded in the accounting system but is not yet fully settled.

### Payments

A `Payment` is a financial transaction that transfers funds from one account to another.

### Payment terms

A `Payment term` defines the agreed conditions between a buyer and a seller regarding when and how an invoice must be paid, including due dates, early payment discounts, and late fees.

### Projects

A `Project` is a financial entity used to track revenues, expenses, budgets, and profitability for a specific initiative or objective.

### Purchase orders

A Purchase order is a document sent by a buyer to a supplier to request goods or services. It includes details like items, quantities, prices, and delivery terms, serving as a formal agreement.

### Sales orders

A `Sales order` is a record that documents and tracks a customer's purchase request, serving as an internal authorization for the sale and a basis for generating invoices, managing inventory, and recognizing revenue.

### Suppliers

A `Supplier` is an individual or business entity from which products and services are bought.

### Tax rates

A `Tax rate` is a predefined classification that determines the applicable tax percentage and rules for financial transactions.

### Transactions

The `Transaction` common model includes records of all types of transactions that do not appear in other common models. It will contain all types of transactions outside of:

* Bills
* Credit notes
* Invoices
* Vendor credits

### Trial balance

The `Trial balance` is a report that provides an overview of all ledger accounts and their balances.

### Units

A `Unit` is a measurement standard used to quantify and describe the amount of a product or service, such as pieces, kilograms, liters, or hours.

### Users

A `User` represents a user account in an accounting system.

### Vendor credits

A `Vendor credit` is a transaction issued by a supplier to the accounting company, indicating a reduction or cancellation of the amount owed to the supplier. It is most generally used as an adjustment note used to rectify errors, returns, or overpayments related to a purchasing transaction.
