Skip to main content
POST
/
service
/
general-ledger
/
bill-payments
curl -X POST https://kube.acho.io/service/general-ledger/bill-payments \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bill_payment_id": "BP-2024-001",
    "vendor_id": "a3-vendor-xxx",
    "account_id": "a3-cash-account-xxx",
    "ap_account_id": "a3-ap-account-xxx",
    "tran_date": "2024-02-10",
    "posting_period_id": "a3-period-xxx",
    "total": 1000,
    "currency": "USD",
    "exchange_rate": 1.0,
    "memo": "Payment for BILL-2024-001",
    "status": "Draft"
  }'

{
  "bill_payment_id": "BP-2024-001",
  "vendor_id": "a3-vendor-xxx",
  "vendor_name": "Office Supplies Inc",
  "account_id": "a3-cash-account-xxx",
  "ap_account_id": "a3-ap-account-xxx",
  "tran_date": "2024-02-10",
  "posting_period_id": "a3-period-xxx",
  "total": 1000,
  "currency": "USD",
  "exchange_rate": 1.0,
  "memo": "Payment for BILL-2024-001",
  "status": "Draft",
  "created_at": "2024-02-10T10:00:00Z"
}

​
Request

Create a new bill payment to pay one or more vendor bills.

​
Headers

​
Authorization
string
required
JWT authentication token. Format: jwt YOUR_TOKEN
​
Content-Type
string
required
Must be application/json

​
Body Parameters

​
bill_payment_id
string
required
Unique identifier for the payment
​
vendor_id
string
required
Vendor being paid
​
account_id
string
required
Cash/bank account for the payment
​
ap_account_id
string
required
Accounts Payable GL account
​
tran_date
string
required
Payment date (YYYY-MM-DD)
​
posting_period_id
string
required
Accounting period ID
​
total
number
required
Total payment amount
​
currency
string
default:"USD"
Payment currency
​
exchange_rate
number
default:"1.0"
Exchange rate for multi-currency
​
memo
string
Payment memo/description
​
status
string
default:"Draft"
Initial status
curl -X POST https://kube.acho.io/service/general-ledger/bill-payments \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bill_payment_id": "BP-2024-001",
    "vendor_id": "a3-vendor-xxx",
    "account_id": "a3-cash-account-xxx",
    "ap_account_id": "a3-ap-account-xxx",
    "tran_date": "2024-02-10",
    "posting_period_id": "a3-period-xxx",
    "total": 1000,
    "currency": "USD",
    "exchange_rate": 1.0,
    "memo": "Payment for BILL-2024-001",
    "status": "Draft"
  }'

{
  "bill_payment_id": "BP-2024-001",
  "vendor_id": "a3-vendor-xxx",
  "vendor_name": "Office Supplies Inc",
  "account_id": "a3-cash-account-xxx",
  "ap_account_id": "a3-ap-account-xxx",
  "tran_date": "2024-02-10",
  "posting_period_id": "a3-period-xxx",
  "total": 1000,
  "currency": "USD",
  "exchange_rate": 1.0,
  "memo": "Payment for BILL-2024-001",
  "status": "Draft",
  "created_at": "2024-02-10T10:00:00Z"
}