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},

"StartFiscalYearAccrual": {string},

"StartFiscalPeriodAccrual": {integer},

"EndFiscalYearAccrual": {string},

"EndFiscalPeriodAccrual": {integer}

}

]

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
StartFiscalYearAccrual	From accrual fiscal year		All acrual parameters exist with value. Day book line ledger account is of profit & loss type. Accrual settings are specified (i.e. day book and ledger). From fiscal year cannot be later than To fiscal year. From fiscal year cannot be before Company fiscal year. All fiscal years in fiscal year range exist.
StartFiscalPeriodAccrual	From accrual period		All acrual parameters exist with value. Day book line ledger account is of profit & loss type. Accrual settings are specified (i.e. day book and ledger). From period cannot be later than To period. All periods in period range exist. All periods in period range are open. All periods in period range have assigned permissions for accruals daybook.
EndFiscalYearAccrual	To accrual fiscal year		All acrual parameters exist with value. Day book line ledger account is of profit & loss type. Accrual settings are specified (i.e. day book and ledger). From fiscal year cannot be later than To fiscal year. All fiscal years in fiscal year range exist.
EndFiscalPeriodAccrual	To accrual period		All acrual parameters exist with value. Day book line ledger account is of profit & loss type. Accrual settings are specified (i.e. day book and ledger). From period cannot be later than To period. All periods in period range exist. All periods in period range are open. All periods in period range have assigned permissions for accruals daybook.

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.