Add New Journal

curl --location -g --request POST 'https://.daftra.com/api2/journals' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer ' \ --header 'apikey: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "Journal": { "number": "0700000AAAAA0001", "staff_id": 0, "name": "string", "entity_type": "invoice", "entity_id": "string", "is_automatic": true, "description": "string", "total_debit": 0, "total_credit": 0, "currency_code": "USD", "currency_credit": 0, "currency_debit": 0, "alter_description": "string" }, "JournalTransaction": [ { "debit": 0, "credit": 0, "currency_debit": 0, "currency_credit": 0, "currency_code": "USD", "currency_rate": 0, "subkey": "client", "description": "string", "journal_account_id": "string", "alter_description": "string" } ] }'

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

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

Journal

object

JournalBase

optional

number

string | null

optional

Journal number, this field is auto generated but can be overridden

<= 255 characters

Example:

0700000AAAAA0001

staff_id

integer <int64>

optional

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

Default:

Example:

name

string

optional

Name of the treasury

<= 255 characters

entity_type

enum<string>

required

entity type which this journal follows

Allowed values:

invoicerefund_receiptcredit_notepurchase_orderpurchase_refundinvoice_sales_costexpenseincomeinvoice_paymentpurchase_order_paymentstock_transactionstock_transfertreasury_transfertreasury_transfer_fromtreasury_transfer_toassetasset_deprecationasset_operationrequisition

entity_id

string

required

the id of the item of the entity type

is_automatic

boolean

optional

0/1 if this was generated automatically or not

description

string

required

Description of the journal

total_debit

number <double>

required

total debit of the journal, should always be equal to total_credit

total_credit

number <double>

required

total credit of the journal, should always be equal to total_debit

currency_code

string

required

Currency Code

<= 3 characters

Example:

USD

currency_credit

number <double>

optional

total credit in the local currency of the credit

currency_debit

number <double>

optional

total debit in the local currency of the debit

alter_description

string

optional

Alter description of the journal

JournalTransaction

array [object {10}]

optional

debit

number <double>

required

total debit of the account

credit

number <double>

required

total credit of the account

currency_debit

number <double>

optional

total debit in the local currency of the debit

currency_credit

number <double>

optional

total credit in the local currency of the credit

currency_code

string

optional

Currency Code

<= 3 characters

Example:

USD

currency_rate

number <double>

optional

currency conversion rate

subkey

enum<string>

optional

transaction sub-key

Allowed values:

clientsupplierincome_taxoutcome_taxtreasurystoreincome_categoryexpense_categoryassetasset_deprecationasset_deprecation_expensestaff_petty_cash

description

string

optional

Description of the journal transaction

journal_account_id

string

optional

Journal Account REF #

alter_description

string

optional

Alter description of the journal

Examples

Created

Request

Responses