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’.

​

Bills

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

​

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.

​

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.

​

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.

​

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.

​

Suppliers

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

​

Tracking categories

A Tracking category represents a categorization method used to classify transactions within an accounting platform. They are often used to group records for reporting and analysis purposes. The most common types of Tracking categories are Classes, Departments and Regions.

​

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

​

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.