---
updatedAt: 2026-07-09T07:01:21.000Z
agentTools:
  projectIndex: https://rivhit-api.readme.io/llms.txt
---

# 🗄️ Accounting Journals

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.

<br />

# Add a New Journal

<br />

Method-

[Accounting.AddJournal](https://rivhit-api.readme.io/reference/post_online-rivhitonlineapi-svc-accounting-addjournal#/)

<br />

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

<br />

> Payments codes may change by specific account settings

<br />

<br />

`**'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

<br />

> Income codes may change by specific account settings

<br />

### Relevant methods

[Customer.List](https://rivhit-api.readme.io/reference/post_online-rivhitonlineapi-svc-customer-list#/)

Get customers list and identifiers

<br />

[Accounting.SortCodeList](https://rivhit-api.readme.io/reference/post_online-rivhitonlineapi-svc-accounting-sortcodelist#/)

Get a list of the specific account sort codes

<br />

<br />

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

<br />

<Accordion title="Accounting.AddJournal Example Invoice" icon="fa-info-circle">
  ```json
  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
  }

  ```
</Accordion>

<Accordion title="Accounting.AddJournal Example Receipt" icon="fa-info-circle">
  ```json
  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
  }

  ```
</Accordion>

<br />

<br />

# Reports

<br />

## Account General Report

<br />

Method-

[Accounting.JournalsReport](https://rivhit-api.readme.io/reference/post_online-rivhitonlineapi-svc-accounting-journalsreport#/)

<br />

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

<br />

<br />

## Specific Customer Report

<br />

Method-

[Customer.JournalReport](https://rivhit-api.readme.io/reference/post_online-rivhitonlineapi-svc-customer-journalreport#/)

<br />

The method will return by default only current year.

It is possible to return a different time frame.

<br />

To change the time frame send request parameters:

`**'year'**`

Send Relevant year to display the customer journal report.

<br />

`**'all_years = true'**`

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