ABCS Contacts API

1.0.0OAS 3.0
REST API for managing contacts in the ABCS Accounting system. ## Authentication Flow 1. Call `POST /api/token` with your `apiKey` and `secret`. 2. Use the returned JWT token on all protected endpoints as `Authorization: Bearer <token>`. 3. Each successful contacts endpoint response returns a new `nextToken` — use it on the next request. ## Rate Limiting All endpoints (except health check) have rate limiting. Response headers include: - `X-RateLimit-Limit` - `X-RateLimit-Remaining` - `X-RateLimit-Reset`
Servers
http://localhost:3000— Current server

Health

Service health check

GET/api/healthHealth Check

Authentication

Token generation

POST/api/tokenGenerate JWT Token

Contacts

Contact CRUD operations

GET/api/contactsList Contacts🔒
POST/api/contactsCreate Contact🔒
GET/api/contacts/{id}Get Contact by ID🔒
PUT/api/contacts/{id}Update Contact🔒
DELETE/api/contacts/{id}Delete Contact (Soft Delete)🔒

Banks

Enrolled bank accounts (tbl_banks). Immediate write. DELETE sets isActive=0 (soft deactivate). Use GET /api/lookups/banks for institution and Cash-in-Bank GL dropdowns.

GET/api/banksList Banks🔒
POST/api/banksCreate Bank Account🔒
GET/api/banks/{id}Get Bank by ID🔒
PUT/api/banks/{id}Update Bank🔒
DELETE/api/banks/{id}Deactivate Bank🔒

Chart of Accounts

GL accounts (tbl_coa). Immediate write. DELETE sets isBlocked=1. glClass: Asset | Liability | Equity | Expense | Revenue normalBal: Dr | Cr Use GET /api/lookups/coa for class/type/category/taxType.

GET/api/coaList GL Accounts🔒
POST/api/coaCreate GL Account🔒
GET/api/coa/{id}Get GL Account by ID🔒
PUT/api/coa/{id}Update GL Account🔒
DELETE/api/coa/{id}Block GL Account🔒

Inventory

Inventory items (tbl_inventory). Immediate write. DELETE sets isBlocked=1. Use GET /api/lookups/inventory for type, category, and UOM.

GET/api/inventoryList Inventory Items🔒
POST/api/inventoryCreate Inventory Item🔒
GET/api/inventory/{id}Get Inventory Item by ID🔒
PUT/api/inventory/{id}Update Inventory Item🔒
DELETE/api/inventory/{id}Block Inventory Item🔒

Acknowledgement Receipt

Acknowledgement Receipt pending CRUD. Status: -1 = pending, 0 = posted. Dropdown values: - payment_method: cash | check - transaction_type: Cash Return | Donations or Similar | Payment - bank: bank institution ID - receive_to_account: enrolled bank account ID - tags: tag IDs (groups 1 / 2 / 4) - details account/code: chart of accounts title + code

GET/api/ar-requestsList Acknowledgement Receipts🔒
POST/api/ar-requestsCreate Pending AR Request🔒
GET/api/ar-requests/{id}Get AR Request by ID🔒
PUT/api/ar-requests/{id}Update Pending AR Request🔒
DELETE/api/ar-requests/{id}Delete Pending AR Request🔒

Accounts Receivable

Create Invoice / ARV billing. Status: -1 = pending, 0 = approved/posted. Server computes VAT, CWT, discount, and A/R lines from user `details`. Use GET /api/lookups/invoice for dropdown predict.

GET/api/invoice-requestsList Accounts Receivable🔒
POST/api/invoice-requestsCreate Pending Invoice (ARV)🔒
GET/api/invoice-requests/{id}Get Invoice Request by ID🔒
PUT/api/invoice-requests/{id}Update Pending Invoice Request🔒
DELETE/api/invoice-requests/{id}Delete Pending Invoice Request🔒
POST/api/invoice-requests/{id}/approveApprove Invoice Request🔒

AP Requests

Bills to Pay (AP) pending CRUD. Status: -1 = pending, 0 = posted. Dropdown values (use GET /api/lookups/ap for search): - btpType: bill type name - btpBiller: contact ID - btpPayTerms / btpPayType: payment term and type codes - btpTag1–btpTag4: tag IDs (0 if unused) - details[].btpAcctCode: chart of accounts GL code - details[].btpATC: BIR ATC code (optional) - details[].btpEWTRate: 0, 0.005, 1, 2, 5, 10, 15

GET/api/ap-requestsList AP Requests🔒
POST/api/ap-requestsCreate Pending AP Request🔒
GET/api/ap-requests/{id}Get AP Request by ID🔒
PUT/api/ap-requests/{id}Update Pending AP Request🔒
DELETE/api/ap-requests/{id}Delete Pending AP Request🔒
POST/api/ap-requests/{id}/approveApprove AP Request🔒

Collection Requests

Collection Receipt (CRB) pending CRUD. Status: -1 = pending, 0 = posted. Approve posts CRB journal lines and updates invoice balance.

GET/api/collection-requestsList Collection Requests🔒
POST/api/collection-requestsCreate Pending Collection Request🔒
GET/api/collection-requests/{id}Get Collection Request by ID🔒
PUT/api/collection-requests/{id}Update Pending Collection Request🔒
DELETE/api/collection-requests/{id}Delete Pending Collection Request🔒
POST/api/collection-requests/{id}/approveApprove Collection Request🔒

Check Voucher

Check Voucher / Cash Disbursement (CDB) pending CRUD. Status: -1 = pending, 0 = posted. Approve inserts payment record and updates BTP balance.

GET/api/cv-requestsList Check Voucher Requests🔒
POST/api/cv-requestsCreate Pending Check Voucher🔒
GET/api/cv-requests/{id}Get Check Voucher by ID🔒
PUT/api/cv-requests/{id}Update Pending Check Voucher🔒
DELETE/api/cv-requests/{id}Delete Pending Check Voucher🔒
POST/api/cv-requests/{id}/approveApprove Check Voucher🔒

Journal Voucher

Manual Journal (MJ) pending CRUD. Resource `{id}` is the journal reference (`trxRef`). Status: -1 = pending, 0 = posted. Dr/Cr lines must balance.

GET/api/journal-requestsList Journal Voucher Requests🔒
POST/api/journal-requestsCreate Pending Journal Voucher🔒
GET/api/journal-requests/{id}Get Journal Voucher by Reference🔒
PUT/api/journal-requests/{id}Update Pending Journal Voucher🔒
DELETE/api/journal-requests/{id}Delete Pending Journal Voucher🔒
POST/api/journal-requests/{id}/approveApprove Journal Voucher🔒

Void Transactions

Void billing invoices or disbursements. Requires `confirm: true`. Sets document status to 3; creates reverse JV when paid/partial.

GET/api/void-requestsList Void Records🔒
POST/api/void-requestsVoid Invoice or Disbursement🔒

Closing Periods

Month-end closing control. Insert-only; requires `confirm: true`.

GET/api/closing-periodsList Closed Periods🔒
POST/api/closing-periodsClose Accounting Period🔒

Lookups

Dropdown search for docs Try-it-out and API callers

GET/api/lookups/invoiceInvoice dropdown lookup🔒
GET/api/lookups/apAP dropdown lookup🔒
GET/api/lookups/arAR dropdown lookup🔒
GET/api/lookups/banksBank dropdown lookup🔒
GET/api/lookups/coaCOA dropdown lookup🔒
GET/api/lookups/inventoryInventory dropdown lookup🔒
GET/api/lookups/collectionCollection dropdown lookup🔒
GET/api/lookups/cvCheck voucher dropdown lookup🔒