Journal reports are essential records that summarize all journal entries made within a specific period. Adding them to an accounting system helps maintain accurate financial data and supports audit and compliance processes.

To add journal reports, the user will input or import journal entries - including date, accounts affected, debit and credit codes, and descriptions - into the system.

Once entered, the system organizes these entries into a journal report, allowing for easy review, tracking of financial activity, and preparation of financial statements.

This are the journal reports actions available through Rivhit API.

Add a New Journal

Method-

Accounting.AddJournal

To Send the debit and credit request parameters:

**'customer_id_debit'**

Journal for Invoice - send the relevant customer id number

Journal for Receipt - send Rivhit payment code:

Check = 7

Cash = 8

Payments codes may change by specific account settings

**'customer_id_credit'**

Journal for Invoice - send the Rivhit Income code:

With VAT = 4

Exempt Vat = 6

Journal for Receipt - send the relevant customer id number

Income codes may change by specific account settings

Relevant methods

Customer.List

Get customers list and identifiers

Accounting.SortCodeList

Get a list of the specific account sort codes

Invoice Receipt Example (will be divided in 2 journal reports):

Request
{
"api_token": "DECD03E5-E35C-41E8-84F7-FBA2FB483928",
"year": 2025,
"month": 8,
"sort_code": 100,
"customer_id_debit": 5546,
"customer_id_credit": 4,
"reference_date": "10/08/2025",
"due_date": "10/08/2025",
"amount": 280,
"reference1": "12345",
"details": "New Invoice",
"currency_id": 1,
"id_number": 123456790
}

Request
{
"api_token": "DECD03E5-E35C-41E8-84F7-FBA2FB483928",
"year": 2025,
"month": 8,
"sort_code": 3,
"customer_id_debit": 8,
"customer_id_credit":  5546,
"reference_date": "10/08/2025",
"due_date": "10/08/2025",
"amount": 280,
"reference1": "12345",
"details": "New Receipt",
"currency_id": 1,
"id_number": 123456790
}

Reports

Account General Report

Method-

Accounting.JournalsReport

The method will return all account journal report by a specific day.

Specific Customer Report

Method-

Customer.JournalReport

The method will return by default only current year.

It is possible to return a different time frame.

To change the time frame send request parameters:

**'year'**

Send Relevant year to display the customer journal report.

**'all_years = true'**

Send to display the report of all the years that exist in the account on the specific customer.