🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Akaunting
πŸ¦€ ClawHub

Akaunting

by @liekzejaws

Interact with Akaunting open-source accounting software via REST API. Use for creating invoices, tracking income/expenses, managing accounts, and bookkeeping automation. Triggers on accounting, bookkeeping, invoicing, expenses, income tracking, or Akaunting mentions.

Versionv1.0.0
Downloads1,441
Installs1
#api#audio#finance#legal#automation
TERMINAL
clawhub install akaunting

πŸ“– About This Skill

name: akaunting description: Interact with Akaunting open-source accounting software via REST API. Use for creating invoices, tracking income/expenses, managing accounts, and bookkeeping automation. Triggers on accounting, bookkeeping, invoicing, expenses, income tracking, or Akaunting mentions.

Akaunting Skill

CLI and API integration for Akaunting, a free open-source accounting platform.

Quick Start

# Test connection
akaunting ping
List data

akaunting accounts
akaunting categories  
akaunting transactions
Create transactions

akaunting income --amount 100 --category Sales --description "Payment received"
akaunting expense --amount 50 --category Other --description "Office supplies"

Setup

1. Deploy Akaunting

# Use the provided docker-compose
cp skills/akaunting/assets/docker-compose.yml ~/akaunting/
cd ~/akaunting && docker compose up -d

Access web UI at http://YOUR_IP:8080 and complete the setup wizard.

2. Apply Required Fix

Critical: Akaunting has a bug where module event listeners don't auto-register. Run:

python3 skills/akaunting/scripts/fix_event_listener.py

Or manually add to /var/www/html/app/Providers/Event.php in the $listen array:

'App\Events\Module\PaymentMethodShowing' => [
    'Modules\OfflinePayments\Listeners\ShowAsPaymentMethod',
],

3. Configure Credentials

mkdir -p ~/.config/akaunting
cat > ~/.config/akaunting/config.json << EOF
{
  "url": "http://YOUR_IP:8080",
  "email": "your@email.com",
  "password": "your-password"
}
EOF

Or set environment variables: AKAUNTING_URL, AKAUNTING_EMAIL, AKAUNTING_PASSWORD

CLI Commands

| Command | Description | |---------|-------------| | akaunting ping | Test API connection | | akaunting accounts | List bank accounts | | akaunting categories [--type income\|expense] | List categories | | akaunting transactions [--type income\|expense] | List transactions | | akaunting items | List products/services | | akaunting income --amount X --category Y | Create income | | akaunting expense --amount X --category Y | Create expense | | akaunting item --name X --price Y | Create item |

Add --json to any command for JSON output.

API Reference

See references/api.md for full endpoint documentation.

Key Endpoints

  • GET /api/ping - Health check
  • GET/POST /api/accounts - Bank accounts
  • GET/POST /api/categories - Income/expense categories
  • GET/POST /api/transactions - Income/expense records
  • GET/POST /api/items - Products/services

    • Authentication: HTTP Basic Auth with user email/password. User needs read-api permission (Admin role has this by default).

    Troubleshooting

    "Payment method is invalid" error: The event listener fix wasn't applied. Run fix_event_listener.py.

    401 Unauthorized: Check credentials in config.json. User must have API access permission.

    403 Forbidden on contacts/documents: User needs additional permissions for these endpoints.

    πŸ’‘ Examples

    # Test connection
akaunting ping
    List data
    
akaunting accounts
akaunting categories  
akaunting transactions
    Create transactions
    
akaunting income --amount 100 --category Sales --description "Payment received"
akaunting expense --amount 50 --category Other --description "Office supplies"

    βš™οΈ Configuration

    1. Deploy Akaunting

    # Use the provided docker-compose
cp skills/akaunting/assets/docker-compose.yml ~/akaunting/
cd ~/akaunting && docker compose up -d

    Access web UI at http://YOUR_IP:8080 and complete the setup wizard.

    2. Apply Required Fix

    Critical: Akaunting has a bug where module event listeners don't auto-register. Run:

    python3 skills/akaunting/scripts/fix_event_listener.py

    Or manually add to /var/www/html/app/Providers/Event.php in the $listen array:

    'App\Events\Module\PaymentMethodShowing' => [
    'Modules\OfflinePayments\Listeners\ShowAsPaymentMethod',
],

    3. Configure Credentials

    mkdir -p ~/.config/akaunting
cat > ~/.config/akaunting/config.json << EOF
{
  "url": "http://YOUR_IP:8080",
  "email": "your@email.com",
  "password": "your-password"
}
EOF

    Or set environment variables: AKAUNTING_URL, AKAUNTING_EMAIL, AKAUNTING_PASSWORD

    πŸ“‹ Tips & Best Practices

    "Payment method is invalid" error: The event listener fix wasn't applied. Run fix_event_listener.py.

    401 Unauthorized: Check credentials in config.json. User must have API access permission.

    403 Forbidden on contacts/documents: User needs additional permissions for these endpoints.