---
title: "Add a New Accounting Journal."
method: POST
path: "/online/RivhitOnlineAPI.svc/Accounting.AddJournal"
---

# Add a New Accounting Journal.

`POST /online/RivhitOnlineAPI.svc/Accounting.AddJournal`

## Request body

- object
  - `api_token` string, uuid, required — Rivhit Merchant API Identifier. **Default:** No
  - `year` integer, nullable — Year of the Accounting Journal. **Format:** YYYY **Default:** Current year
  - `month` integer, nullable — Month of the Accounting Journal. **Format:** MM **Default:** Current month
  - `sort_code` integer, required — The Sort Code Type. **Common:** 100 = With Vat 150 = Exempt Vat **Range:** 0 to 999 **Default:** No
  - `customer_id_debit` integer, required — Journal Debit Code. ~ Invoice - Customer ID, Receipt - Rivhit Payment Code (Check 7 Cash 8..) **Range:** 0 to 999999999 **Default:** No
  - `customer_id_credit` integer, nullable — Journal Credit Code. ~ Invoice - Rivhit Income Code (With VAT 4 Exempt Vat 6), Receipt - Customer ID **Range:** 0 to 999999999 **Default:** 0
  - `reference_date` string, date, nullable — Reference Date for the Accounting Journal. **Format:** DD-MM-YY or DD/MM/YYYY **Default:** Current day
  - `due_date` string, date, nullable — Due Date for the Accounting Journal. **Format:** DD-MM-YY or DD/MM/YYYY **Default:** Current day
  - `amount` number, float, required — Amount of the Accounting Journal in ILS. **Range:** Decimal limit (can be negative) **Default:** No
  - `reference1` string, nullable — The First Reference Value - Will be Saved in the Accounting Journal. **Length:** 1 to 10 **Default:** Rivhit settings
  - `reference2` string, nullable — The Second Reference Value - Will be Saved in the Accounting Journal. **Length:** 1 to 10 **Default:** Rivhit settings
  - `details` string, nullable — Details for the Accounting Journal. **Length:** 1 to 80 **Default:** No
  - `currency_id` integer, nullable — Accounting Journal Currency Type (Rivhit Settings). **Options:** (1 = NIS 2 = USD 3 = EURO 4 = GBP 5 = AUD 6 = CAD 7 = CHF 8 = SEK 9 = DKK 10 = NOK) **Default:** NIS
  - `foreign_amount` number, float, nullable — Amount of the Accounting Journal in MTC. **Range:** Decimal limit (can be negative) **Default:** 0
  - `exchange_rate` number, double, nullable — Fixed Currency Exchange Rate to ILS. ~ From MTC to ILS **Range:** Decimal limit **Default:** 0
  - `project_id` integer, nullable — Project Id Serial Number (Rivhit system). **Range:** 0 to 999999999 **Default:** No
  - `id_number` integer, nullable — Customer Israeli Id (by Custom Format). **Range:** 8-9 digits **Default:** No
  - `request_reference` string, nullable — The Accounting Journal Creation Request Reference. ~ Use for future search with method - Status.LastRequest ~ Should be unique value **Length:** 2GB **Default:** No
  - `shaam_invoice` integer, nullable — Tax Assignment number. **Range:** 0 to 999999999 **Default:** No

## Response `200`

Success - Accounting Journal Added.

- object
  - `error_code` integer — The Response Error/Status Number (0 = Success).
  - `client_message` string — The Client Error Message.
  - `debug_message` string — The Response Error Message.
  - `data` object
    - `year` integer — Year of the Journal Report (YYYY).
    - `month` integer — Month of the Journal Report (MM).
    - `line` integer — The New Journal Report Serial Number.

## Other responses

- `400` — Request Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/rivhit/apis/get-payment-url-22-12.md) · [All operations](https://skmtc.net/rivhit/apis/get-payment-url-22-12/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivhit/get-payment-url-22-12/versions/ed5261a52458/schema)