API reference

Accounting

Books, bank lines, bills, expenses, reports, tax packs and e-invoices.

Scopes for this area: accounting:read, accounting:write and accounting:admin.

81 operations

overview

MethodRouteWhat it doesLevelCommand
GET/accounting/overviewWho owes you, what you owe, cash and profit this month, what needs attention.readrivier accounting overview get

customer

MethodRouteWhat it doesLevelCommand
GET/accounting/customersCustomers with balances and what is overdue.readrivier accounting customer list
GET/accounting/customers/{key}One customer's account: balances, open invoices, open credit, limit and terms.readrivier accounting customer get
GET/accounting/customers/{key}/statementA customer's statement between two dates.readrivier accounting customer statement
GET/accounting/customers/{key}/credit-checkWhether a new sale fits the customer's credit limit.readrivier accounting customer credit check
PATCH/accounting/customers/{key}Set a customer's credit limit, terms, hold and dunning.writerivier accounting customer update
POST/accounting/receipts-inRecord money received from a customer, spread over invoices; the rest stays their credit.writerivier accounting customer receive

receivables

MethodRouteWhat it doesLevelCommand
GET/accounting/receivables/agedAged receivables.readrivier accounting receivables aged

bill

MethodRouteWhat it doesLevelCommand
GET/accounting/bills/agedAged payables.readrivier accounting bill aged
GET/accounting/billsSupplier bills by status.readrivier accounting bill list
GET/accounting/bills/{id}One supplier bill with its lines.readrivier accounting bill get
POST/accounting/billsDraft a supplier bill; it reaches the books when a person approves it.writerivier accounting bill draft
POST/accounting/bills/{id}/approveApprove a bill: it becomes a debt and the cost is booked.writerivier accounting bill approve
POST/accounting/bills/{id}/payPay a bill.writerivier accounting bill pay
POST/accounting/bills/{id}/voidVoid an unpaid bill.writerivier accounting bill void

expense

MethodRouteWhat it doesLevelCommand
GET/accounting/expensesExpenses, including proposals waiting for a person.readrivier accounting expense list
POST/accounting/expensesRecord an expense (a person's is booked at once; a key's is a proposal a person confirms).writerivier accounting expense create
POST/accounting/expenses/{id}/confirmConfirm a proposed expense, with corrections.writerivier accounting expense confirm
POST/accounting/expenses/{id}/rejectReject a proposed expense.writerivier accounting expense reject

supplier

MethodRouteWhat it doesLevelCommand
GET/accounting/suppliersSuppliers and what is owed to each.readrivier accounting supplier list
POST/accounting/suppliersAdd a supplier.writerivier accounting supplier create

journal

MethodRouteWhat it doesLevelCommand
GET/accounting/journalEntries in the books.readrivier accounting journal list
GET/accounting/journal/{id}One entry with its lines.readrivier accounting journal get
POST/accounting/journalPost a manual entry.writerivier accounting journal post
POST/accounting/journal/{id}/reverseReverse an entry.writerivier accounting journal reverse

account

MethodRouteWhat it doesLevelCommand
GET/accounting/accountsThe chart of accounts.readrivier accounting account list
POST/accounting/accountsAdd an account to the chart.adminrivier accounting account create
PATCH/accounting/accounts/{id}Rename or switch off an account.adminrivier accounting account update

settings

MethodRouteWhat it doesLevelCommand
GET/accounting/settingsBase currency, edition, closed-through date and the notice.readrivier accounting settings get
POST/accounting/setupSet up the books for an edition and a base currency.adminrivier accounting settings setup

trial balance

MethodRouteWhat it doesLevelCommand
GET/accounting/trial-balanceTrial balance.readrivier accounting trial balance get

trail

MethodRouteWhat it doesLevelCommand
GET/accounting/trailWhat people did in the books, in order.readrivier accounting trail list

report

MethodRouteWhat it doesLevelCommand
GET/accounting/reports/profit-and-lossProfit and loss.readrivier accounting report profit and loss
GET/accounting/reports/balance-sheetBalance sheet as of a date.readrivier accounting report balance sheet
GET/accounting/reports/cash-flowCash in and out by purpose.readrivier accounting report cash flow
GET/accounting/reports/forecastWeekly cash look-ahead (rule-based).readrivier accounting report forecast
GET/accounting/reports/taxTax summary working paper.readrivier accounting report tax
GET/accounting/reports/marginSales and margin by product, room and service.readrivier accounting report margin
GET/accounting/month-end/{month}What is open before a month can be closed.readrivier accounting report month end

tax

MethodRouteWhat it doesLevelCommand
GET/accounting/tax/packsTax rule packs and which are applied and reviewed.readrivier accounting tax packs
POST/accounting/tax/packs/{key}/reviewMark a tax rule pack reviewed by an accountant.adminrivier accounting tax review
POST/accounting/tax/packs/{key}/applyApply a tax rule pack (it stays unverified until reviewed).adminrivier accounting tax apply

export

MethodRouteWhat it doesLevelCommand
GET/accounting/exportA file for the accountant (journal, trial balance, sales or purchase documents, SIE 4).readrivier accounting export get

bank

MethodRouteWhat it doesLevelCommand
GET/accounting/bank/accountsBank accounts with the ledger balance and what is left to reconcile.readrivier accounting bank accounts
GET/accounting/bank/linesBank lines with suggested matches.readrivier accounting bank lines
GET/accounting/bank/feedWhere the bank feed stands: what is connected, which accounts are linked, the last read and the last error.readrivier accounting bank feed
GET/accounting/bank/feed/accountsThe accounts the connected bank offers, and which bank account each is linked to.readrivier accounting bank feed accounts
POST/accounting/bank/transferMove money between two of your bank accounts.writerivier accounting bank transfer
POST/accounting/bank/lines/{id}/pairSettle two bank lines as the two ends of one transfer.writerivier accounting bank pair
POST/accounting/bank/accept-confidentAccept every bank suggestion Rivier is very sure of.writerivier accounting bank accept confident
POST/accounting/bank/lines/{id}/matchAccept a bank line as the payment of an invoice or bill.writerivier accounting bank match
POST/accounting/bank/lines/{id}/postAccept a bank line as an entry against an account.writerivier accounting bank post
POST/accounting/bank/lines/{id}/payoutAccept a bank line as a payout from the payment provider.writerivier accounting bank payout
POST/accounting/bank/lines/{id}/ignoreIgnore a bank line.writerivier accounting bank ignore
POST/accounting/bank/accountsAdd a bank account.adminrivier accounting bank create
POST/accounting/bank/accounts/{id}/syncFetch new lines from the bank feed.adminrivier accounting bank sync
POST/accounting/bank/accounts/{id}/importImport pasted statement lines.adminrivier accounting bank import

stock

MethodRouteWhat it doesLevelCommand
GET/accounting/stock/valuationStock at cost by variant, next to what the books say.readrivier accounting stock valuation
POST/accounting/stock/receiptsRecord what received stock cost.writerivier accounting stock receive

einvoice

MethodRouteWhat it doesLevelCommand
GET/accounting/e-invoice/{id}The invoice or credit note as UBL 2.1 (EN 16931, Peppol BIS Billing 3.0 identifiers).readrivier accounting einvoice get
GET/accounting/e-invoice/{id}/checkWhich e-invoice rules a document fails, in plain words.readrivier accounting einvoice check
GET/accounting/e-invoice/{id}/historyWhere a document was sent as an e-invoice.readrivier accounting einvoice history
GET/accounting/e-invoicingWhether this workspace can send e-invoices, and through which connection.readrivier accounting einvoice state
POST/accounting/e-invoice/{id}/sendSend a document as an e-invoice through the connection of the workspace; a test workspace sends through the test provider.writerivier accounting einvoice send
POST/accounting/e-invoice/{id}/refreshAsk the provider what became of the e-invoices sent for a document.writerivier accounting einvoice refresh

accountant

MethodRouteWhat it doesLevelCommand
GET/accounting/accountantAccountant invitations and the files taken.readrivier accounting accountant list
POST/accounting/accountantInvite an accountant for a time.writerivier accounting accountant invite
POST/accounting/accountant/{id}/revokeEnd an accountant's access.writerivier accounting accountant revoke

receipt

MethodRouteWhat it doesLevelCommand
POST/accounting/receiptsRead a receipt into a proposed expense (marked as read by a model).writerivier accounting receipt capture

revalue

MethodRouteWhat it doesLevelCommand
POST/accounting/revalueRestate open foreign-currency items at a date's rate.writerivier accounting revalue run

dunning

MethodRouteWhat it doesLevelCommand
POST/accounting/dunning/runSend the payment reminders that are due now.writerivier accounting dunning run

credit

MethodRouteWhat it doesLevelCommand
POST/accounting/credit/applyUse a customer's credit to pay an invoice.writerivier accounting credit apply

invoice

MethodRouteWhat it doesLevelCommand
POST/accounting/invoices/{id}/write-offWrite an invoice off as uncollectible.writerivier accounting invoice write off

period

MethodRouteWhat it doesLevelCommand
POST/accounting/periods/closeClose the books through a date.writerivier accounting period close
POST/accounting/periods/reopenReopen the last closed period.writerivier accounting period reopen

post

MethodRouteWhat it doesLevelCommand
POST/accounting/postPost what has happened in invoices, refunds and provider fees.writerivier accounting post run

notice

MethodRouteWhat it doesLevelCommand
POST/accounting/noticeAccept the notice that Rivier is software, not an accountant.writerivier accounting notice accept

costing

MethodRouteWhat it doesLevelCommand
PUT/accounting/costingChoose how stock is costed (locked after the first costed sale).adminrivier accounting costing set

rate

MethodRouteWhat it doesLevelCommand
PUT/accounting/ratesSet an exchange rate for a day.adminrivier accounting rate set