API حسابداری برای برنامه‌نویسان: تمام دفاتر از طریق REST

curl -X POST https://api.hesabdar.my/api/v1/journal-entries \
  -H "Authorization: Bearer $ACCOUNTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10482" \
  -d '{
    "entry_date": "2026-09-25",
    "voucher_type": "SAL",
    "reference": "INV-10482",
    "description": "Online order 10482",
    "status": "posted",
    "lines": [
      { "account_code": "1111", "debit": 1250.00, "party_code": "C001" },
      { "account_code": "4101", "credit": 1250.00 }
    ]
  }'

const res = await fetch("https://api.hesabdar.my/api/v1/journal-entries", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ACCOUNTING_API_KEY}`,
    Accept: "application/json",
    "Content-Type": "application/json",
    "Idempotency-Key": "order-10482", // same key on retry = same entry
  },
  body: JSON.stringify({
    entry_date: "2026-09-25",
    voucher_type: "SAL",
    reference: "INV-10482",
    description: "Online order 10482",
    status: "posted",
    lines: [
      { account_code: "1111", debit: 1250.0, party_code: "C001" },
      { account_code: "4101", credit: 1250.0 },
    ],
  }),
});

if (!res.ok) {
  const err = await res.json(); // { code, message, errors }
  throw new Error(`${res.status} ${err.code}: ${err.message}`);
}

const { data: entry } = await res.json();
console.log(entry.number, res.headers.get("X-Credits-Balance"));

import os
import requests

resp = requests.post(
    "https://api.hesabdar.my/api/v1/journal-entries",
    headers={
        "Authorization": f"Bearer {os.environ['ACCOUNTING_API_KEY']}",
        "Accept": "application/json",
        "Idempotency-Key": "order-10482",
    },
    json={
        "entry_date": "2026-09-25",
        "voucher_type": "SAL",
        "reference": "INV-10482",
        "description": "Online order 10482",
        "status": "posted",
        "lines": [
            {"account_code": "1111", "debit": 1250.00, "party_code": "C001"},
            {"account_code": "4101", "credit": 1250.00},
        ],
    },
    timeout=30,
)

if resp.status_code >= 400:
    err = resp.json()
    raise RuntimeError(f"{resp.status_code} {err['code']}: {err['message']}")

entry = resp.json()["data"]
print(entry["number"], resp.headers.get("X-Credits-Balance"))