Daftra API

Add New Journal Account

Production

https://{{subdomain}}.daftra.com/api2

POST

/journal_accounts{format}

Journal Accounts

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://.daftra.com/api2/journal_accounts' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "JournalAccount": {
        "journal_cat_id": "11101",
        "code": "11101",
        "type": "0",
        "staff_id": 0,
        "total_debit": 0,
        "total_credit": 0,
        "entity_type": "client",
        "entity_id": "string",
        "name": "string",
        "is_recalculated": true,
        "parent_cat_ids": "17,18",
        "disabled": true
    }
}'

Response Example

202 - Example 1

{
  "code": 202,
  "result": "successful",
  "id": "2415"
}

Request

Path Params

format

string

required

Header Params

string

optional

Default:

application/json

Content-Type

string

optional

Default:

application/json

Authorization

string

optional

You can generate the bearer token using the the authorization endpoint then use it here to be able to operate over your account's data

Default:

Bearer {{access_token}}

apikey

string

deprecated

You can find/generate your apikey(s) from inside your Daftra Account

Default:

Body Params application/json

JournalAccount

object

JournalAccountBase

optional

journal_cat_id

string

optional

Journal Category REF #

<= 255 characters

Example:

11101

code

string

optional

Journal code

<= 255 characters

Example:

11101

type

enum<string>

required

account type

Allowed values:

staff_id

integer <int64>

optional

Staff ID who created the account get it from GET STAFF API if it's 0 that means the site owner is the staff that created it

Default:

Example:

total_debit

number <double>

optional

total debit of the account

total_credit

number <double>

optional

total credit of the account

entity_type

enum<string>

optional

entity type which this journal follows

Allowed values:

clientsupplierincome_taxoutcome_taxtreasurystoreincome_categoryexpense_categoryassetasset_deprecationasset_deprecation_expensestaff_petty_cash

entity_id

string

optional

the id of the item of the entity type

name

string

required

Name of the treasury

<= 255 characters

is_recalculated

boolean

optional

0/1 if this was recalculated or not

parent_cat_ids

string

optional

comma separated category ids

Example:

17,18

disabled

boolean

optional

0/1 if this is disabled or not

Examples

Responses

🟢202Accepted

application/json

Created

Body

code

integer

optional

Example:

202

result

string

optional

Example:

successful

integer

optional

Example:

2415

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

GET All Journal Accounts

GET Single Journal Cat