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.

​

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.

​

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

​

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.