Skip to main content

​
Authentication

All Aden API requests require authentication using a JWT token.
1

Get your API credentials

Contact your Aden administrator to obtain your API credentials and JWT token.
2

Add the Authorization header

Include the JWT token in all API requests:
curl -X GET https://kube.acho.io/service/general-ledger/accounts \
  -H "Authorization: jwt YOUR_TOKEN"
3

Make your first API call

Try listing your chart of accounts:
curl -X GET https://kube.acho.io/service/general-ledger/accounts \
  -H "Authorization: jwt YOUR_TOKEN"

​
Common Operations

curl -X POST https://kube.acho.io/service/general-ledger/accounts \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "1000",
    "account_name": "Cash",
    "account_type": "Asset",
    "normal_balance": "Debit",
    "is_active": true
  }'

curl -X POST https://kube.acho.io/service/general-ledger/journal-entries \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entry_id": "JE-2024-001",
    "tran_date": "2024-01-15",
    "memo": "Recording office supplies purchase",
    "lines": [
      {
        "account_id": "6300",
        "debit": 500,
        "credit": 0
      },
      {
        "account_id": "1000",
        "debit": 0,
        "credit": 500
      }
    ]
  }'

curl -X POST https://kube.acho.io/service/general-ledger/bills \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bill_id": "BILL-2024-001",
    "vendor_id": "vendor-xxx",
    "ap_account_id": "2000",
    "tran_date": "2024-01-15",
    "due_date": "2024-02-15",
    "lines": [
      {
        "account_id": "6300",
        "description": "Office Supplies",
        "amount": 500
      }
    ]
  }'

​
Document Workflow

Most financial documents in Aden follow a standard approval workflow: 
Draft → Pending Approval → Approved → Posted
              ↓
          Rejected / On Hold

​
Submit for Approval

POST /service/general-ledger/journal-entries/{entry_id}/submit-for-approval

​
Approve

POST /service/general-ledger/journal-entries/{entry_id}/approve

​
Post to General Ledger

POST /service/general-ledger/journal-entries/{entry_id}/post

​
Next Steps

Chart of Accounts

Set up your account structure.

Journal Entries

Record financial transactions.

Approval Rules

Configure approval workflows.

Reports

Generate financial reports.