Creating General Day Book Page and Lines

By using this Isah Finance API, you can create a new general day book page with one or more lines. If the call is successful, the day book processing will be started.

Call

finance-api/GeneralDayBooks/

Content

A JSON object containing a daybook page and one or more lines as nested JSON objects:

{

"Company": {string},

"FiscalYear": {string},

"DayBook": {string},

"Period": {integer},

"PageDescription": {string},

"Lines": [

{

"Account": {string},

"Debtor": {string},

"Creditor": {string},

"Description": {string},

"InvoiceReference": {string},

"CostCenterCode": {string},

"CostCategoryCode": {string},

"VATFinCode": {string}

"CurrencyCode": {string},

"CurrencyVATAmount": {floating point},

"CurrencyAmount": {floating point},

"TransactionDate": {string that represents a date}

}

]

Some of the members are mandatory and others are optional, as indicated in the tables below:

Page

Field	Description	Mandatory	Validations
Company	Company code	Y	Company code exists
FiscalYear	Fiscal year	Y	Fiscal year exists Fiscal year is not closed
DayBook	Day book code	Y	Day book code exists Type is set to general VAT input type is set to gross Blocked for manual changes is set to true
Period	Period	Y	Period exists Period is not closed
PageDescription	Page description	Y

Lines

Field	Description	Mandatory	Validations
Account	Ledger account	Y	Ledger account exists Ledger account is not blocked for manual changes Ledger account is not blocked
Debtor	Debtor code		Debtor is present in the company/fiscal year
Creditor	Creditor code		Creditor is present in the company/fiscal year
Description	Description	Y
InvoiceReference	Invoice reference		Invoice reference does not exist
CostCenterCode	Cost center code	Y, when set to mandatory	Cost center code exists If the cost center of the specified account is set to required, the CostCenterCode is mandatory
CostCategoryCode	Cost category code		Line cost category code exists
VATFinCode	VAT code	Y, when set to mandatory	Line VAT code exists If VAT Code of the specified account is set to required, the VATFinCode is mandatory
CurrencyCode	Currency code		Currency code exists
CurrencyVATAmount	Line VAT amount
CurrencyAmount	Line amount incl. VAT	Y

Http Method

POST

Return value

The return value of the call depends on the outcome:

In case of success – i.e. when the day book page and lines have no validation errors and were saved without errors - a success status code without any content will be returned.
The day book processing will be started by Isah Finance (asynchronous).
In case of errors, all error messages will be returned. Most errors are validation errors for the input values. However, an error will also occur if the line currency amount total is anything else than zero.