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.

​

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.

​

Purchase orders

A Purchase order is a request to purchase goods or services from a supplier. It outlines the details of the purchase, such as the items or services requested, quantities, prices, and delivery details.

A Purchase order is a crucial component of the procurement process, but does not typically result in any impact on the company’s general ledger. The general ledger is typically only affected when the Purchase order is fulfilled as an Accounts Payable Invoice object (also known as a Bill).

​

Sales orders

A Sales order represents a request to purchase goods or services from a customer. It outlines the details of the purchase, such as the items or services requested, quantities, prices, and delivery details.

A sales order does not typically result in any impact on the company’s general ledger. The general ledger is typically only affected when the sales order is fulfilled as an Accounts Receivable Invoice object (also known as an Invoice).

​

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

​

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.