Chart of Accounts

The Chart of Accounts (COA) is the backbone of the Finindex General Ledger. Each account has a code, a name, a type, and a currency. Mappings connect Cutmake business events (bills, invoices, payments) to the GL accounts they post to, so that postings flow automatically from PLM/MES into the ledger.

List Accounts

GET /api/v1/gl/accounts
Authorization: Bearer <access_token>

Response (200):

[
  {
    "id": "uuid",
    "code": "1000",
    "name": "Cash",
    "type": "asset",
    "currency": "VND"
  }
]

Create Account

code

string

required

Unique account code (e.g. “1000”)

name

string

required

Account name (e.g. “Cash”)

type

string

required

Account type: asset, liability, equity, revenue, expense

currency

string

ISO currency code (default: VND)

POST /api/v1/gl/accounts
Authorization: Bearer <access_token>

{
  "code": "1000",
  "name": "Cash",
  "type": "asset",
  "currency": "VND"
}

Response (201):

{
  "id": "uuid",
  "code": "1000",
  "name": "Cash",
  "type": "asset",
  "currency": "VND"
}

Mappings

Mappings tell Finindex which GL account a given business event posts to — for example, which account a vendor bill debits, or which account a customer receipt credits. This is what lets postings flow automatically from Cutmake procurement and sales into the ledger.

List Mappings

GET /api/v1/gl/mappings
Authorization: Bearer <access_token>

Response (200):

[
  {
    "id": "uuid",
    "event": "bill.posted",
    "debit_account_code": "5100",
    "credit_account_code": "2000"
  }
]

Create Mapping

event

string

required

The business event key (e.g. bill.posted, invoice.posted, payment.posted)

debit_account_code

string

required

Account code to debit when the event fires

credit_account_code

string

required

Account code to credit when the event fires

POST /api/v1/gl/mappings
Authorization: Bearer <access_token>

{
  "event": "bill.posted",
  "debit_account_code": "5100",
  "credit_account_code": "2000"
}

Define mappings before posting bills or invoices so events resolve to the correct accounts on the first run.

See the API Reference tab for the full list of GL endpoints, including recurring templates and statement lines.

​Chart of Accounts

​List Accounts

​Create Account

​Mappings

​List Mappings

​Create Mapping

Chart of Accounts

List Accounts

Create Account

Mappings

List Mappings

Create Mapping