@pingleware/bestbooks-api v1.3.0
BestBooks Accounting Application Framework - API Module
The API module for interfacing with the BestBooks Accounting Application Framework - HELPERS which also imports the CORE module
The bestbooks.db sqlite database file is located in the system directory of .bestbooks under the current user home directory.
You may import this module into another project or invoke the stndalone server option using the following arguments,
| ARGUMNET | VALUE | DESCRIPTION |
|---|---|---|
| server | false | set to true to bypass module.exports and start the server in standalone mode, defaults: false |
| host | string | the host name or IP address, defaults: localhost. Ignored when server=false |
| port | number | a unused port number, defaults: 5000. Ignored when server=false |
The benefit of a standalone API server, will permit a client to reside anywhere on the same network without duplicating accounting entries, By using VPN with VLAN subnetting and a layer 3 switch, you can protect your accounting data from unauthroized access.
JSON-RPC Server
Using the endpoint of /, you will make json-rpc requests. This permits one API route to handle multiple requests
JSON-RPC Methods
| METHOD | ARGUMENTS | DESCRIPTION |
|---|---|---|
| total | - | obtains the total count of JSON-RPC methods, current;y at 119. |
| list | - | obtains a sorted list of all JSON-RPC methods with the total count. |
| version | - | retrieves the pckage.json version number |
The current list of methods is,
"account_types",
"accountsReceivablePayment",
"accruedExpense",
"accruedIncome",
"accruedIncomePayment",
"accruedInterest",
"add",
"addCredit",
"addDebit",
"addFundsToPostageDebitAccount",
"addJournalTransaction",
"addTransaction",
"allocateFundingAccount",
"asset",
"badDebt",
"balance",
"bankfee",
"bondDiscount",
"bondPremium",
"bondPremiumInterestPayment",
"bondsIssuedWOAccruedInterest",
"bondsIssuedWithAccruedInteres",
"cardPayment",
"cashDividendDeclared",
"cashDividendPayable",
"cashPayment",
"chartofaccounts",
"cogs",
"commissionPaid",
"commissionPayable",
"createAccount",
"createNewUser",
"credit",
"customer_estimate",
"customer_invoice",
"debit",
"deferredExpense",
"deferredRevenue",
"distribution",
"dividendDeclared",
"dividendPaid",
"editJournalTransaction",
"editTransaction",
"encumber",
"equity",
"exchangeCryptocurrencyToUSD",
"exchangeUSDToCryptocurrency",
"expense",
"getTransactions",
"getUsersByType",
"googleAdsenseEarning",
"googleAdsensePayout",
"googleAdsenseReceivePayout",
"headers",
"initializeEquity",
"interestExpense",
"inventoryFinishedGoods",
"inventoryPurchase",
"inventoryRawMaterials",
"inventoryShrinkage",
"inventoryShrinkageReserve",
"inventorySold",
"inventoryWIP",
"investment",
"isJournalInbalance",
"liability",
"list",
"loanPayment",
"mailer-ReadFromDatabas",
"mailer-SaveToDatabase",
"mailer-SendEMail",
"mailer-base64_decode",
"mailer-base64_encode",
"mailer-start_smtp_server",
"paidInCapitalStock",
"payAssetsByCheck",
"payAssetsByCredit",
"payExpenseByCard",
"payExpenseByCheck",
"payrollPayable",
"postageExpense",
"prepaidSubscriptions",
"recognizeDeferredExpense",
"recognizeDeferredRevenue",
"recognizePrepaidSubscription",
"reporting-BalanceSheet",
"reporting-CustomerEstimate",
"reporting-IncomeStatement",
"reporting-NoteToFinancialStatements",
"reporting-PurchaseOrder",
"reporting-RetainedEarnings",
"reporting-StatementCashFlows",
"reporting-StatementChangeInEquity",
"reporting-TrialBalance",
"reporting-array2xml",
"reporting-copy",
"reporting-format",
"reporting-getReportFileName",
"reporting-getReportRootFileName",
"reporting-init",
"reporting-parseString",
"reporting-transform_xml_xslt",
"revenue",
"salesCard",
"salesCash",
"salesViaPaypal",
"securityDepositPaid",
"securityDepositReceived",
"softwareLicense",
"spendFundingAccount",
"stockDividend",
"stocksIssuedOtherThanCash",
"subtract",
"total",
"unearnedRevenue",
"vendor_new_purchase",
"vendor_update_purchase",
"version",
"workingHours"The following functions are available when the --server option is false.
| FUNCTION | ARGUMENTS | DESCRIPTION |
|---|---|---|
| start_server | host,port | start the JSON-RPC server |
| stop_server | - | stops the JSON-RPC server |
End of Life Doctrine
When a piece of software is useful there should never be an end-of-life doctrine. The goal of this software is to achieve immortality ;). When this software has reached that stage, this project may appear abandon but the opposit is true. This software has achieve that state where maintenance is no longer required.
Patrick O. Ingle