Create JournalEntryV2 record

curl --request POST \
  --url https://api.dualentry.com/public/v3-alpha/journal-entries/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "date": "2023-12-25",
  "company_id": 123,
  "items": [
    {
      "account_number": 123,
      "debit": 123,
      "credit": 123,
      "position": 123,
      "custom_fields": [
        {}
      ],
      "not_aging_eligible_reason": "",
      "is_billable": false,
      "billable_customer_id": 123,
      "billable_project_id": 123,
      "billable_markup_pct": 500,
      "id": 123,
      "memo": "",
      "classifications": [],
      "customer_id": 123,
      "vendor_id": 123,
      "eliminated": false
    }
  ],
  "transaction_date": "2023-12-25",
  "custom_fields": [
    {}
  ],
  "memo": "<string>",
  "reference_number": "<string>",
  "exchange_rate": 123,
  "reversal_date": "2023-12-25",
  "reversal_aging_overrides": [
    {
      "original_line_id": 123,
      "not_aging_eligible_reason": ""
    }
  ],
  "related_journal_entry_number": 123,
  "accrual_template_id": 123,
  "book_ids": [
    123
  ],
  "attachments": [],
  "record_status": "posted",
  "is_adjusting_entry": false
}
'

import requests

url = "https://api.dualentry.com/public/v3-alpha/journal-entries/"

payload = {
    "date": "2023-12-25",
    "company_id": 123,
    "items": [
        {
            "account_number": 123,
            "debit": 123,
            "credit": 123,
            "position": 123,
            "custom_fields": [{}],
            "not_aging_eligible_reason": "",
            "is_billable": False,
            "billable_customer_id": 123,
            "billable_project_id": 123,
            "billable_markup_pct": 500,
            "id": 123,
            "memo": "",
            "classifications": [],
            "customer_id": 123,
            "vendor_id": 123,
            "eliminated": False
        }
    ],
    "transaction_date": "2023-12-25",
    "custom_fields": [{}],
    "memo": "<string>",
    "reference_number": "<string>",
    "exchange_rate": 123,
    "reversal_date": "2023-12-25",
    "reversal_aging_overrides": [
        {
            "original_line_id": 123,
            "not_aging_eligible_reason": ""
        }
    ],
    "related_journal_entry_number": 123,
    "accrual_template_id": 123,
    "book_ids": [123],
    "attachments": [],
    "record_status": "posted",
    "is_adjusting_entry": False
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    date: '2023-12-25',
    company_id: 123,
    items: [
      {
        account_number: 123,
        debit: 123,
        credit: 123,
        position: 123,
        custom_fields: [{}],
        not_aging_eligible_reason: '',
        is_billable: false,
        billable_customer_id: 123,
        billable_project_id: 123,
        billable_markup_pct: 500,
        id: 123,
        memo: '',
        classifications: [],
        customer_id: 123,
        vendor_id: 123,
        eliminated: false
      }
    ],
    transaction_date: '2023-12-25',
    custom_fields: [{}],
    memo: '<string>',
    reference_number: '<string>',
    exchange_rate: 123,
    reversal_date: '2023-12-25',
    reversal_aging_overrides: [{original_line_id: 123, not_aging_eligible_reason: ''}],
    related_journal_entry_number: 123,
    accrual_template_id: 123,
    book_ids: [123],
    attachments: [],
    record_status: 'posted',
    is_adjusting_entry: false
  })
};

fetch('https://api.dualentry.com/public/v3-alpha/journal-entries/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dualentry.com/public/v3-alpha/journal-entries/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'date' => '2023-12-25',
    'company_id' => 123,
    'items' => [
        [
                'account_number' => 123,
                'debit' => 123,
                'credit' => 123,
                'position' => 123,
                'custom_fields' => [
                                [
                                                                
                                ]
                ],
                'not_aging_eligible_reason' => '',
                'is_billable' => false,
                'billable_customer_id' => 123,
                'billable_project_id' => 123,
                'billable_markup_pct' => 500,
                'id' => 123,
                'memo' => '',
                'classifications' => [
                                
                ],
                'customer_id' => 123,
                'vendor_id' => 123,
                'eliminated' => false
        ]
    ],
    'transaction_date' => '2023-12-25',
    'custom_fields' => [
        [
                
        ]
    ],
    'memo' => '<string>',
    'reference_number' => '<string>',
    'exchange_rate' => 123,
    'reversal_date' => '2023-12-25',
    'reversal_aging_overrides' => [
        [
                'original_line_id' => 123,
                'not_aging_eligible_reason' => ''
        ]
    ],
    'related_journal_entry_number' => 123,
    'accrual_template_id' => 123,
    'book_ids' => [
        123
    ],
    'attachments' => [
        
    ],
    'record_status' => 'posted',
    'is_adjusting_entry' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dualentry.com/public/v3-alpha/journal-entries/"

	payload := strings.NewReader("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"items\": [\n    {\n      \"account_number\": 123,\n      \"debit\": 123,\n      \"credit\": 123,\n      \"position\": 123,\n      \"custom_fields\": [\n        {}\n      ],\n      \"not_aging_eligible_reason\": \"\",\n      \"is_billable\": false,\n      \"billable_customer_id\": 123,\n      \"billable_project_id\": 123,\n      \"billable_markup_pct\": 500,\n      \"id\": 123,\n      \"memo\": \"\",\n      \"classifications\": [],\n      \"customer_id\": 123,\n      \"vendor_id\": 123,\n      \"eliminated\": false\n    }\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"custom_fields\": [\n    {}\n  ],\n  \"memo\": \"<string>\",\n  \"reference_number\": \"<string>\",\n  \"exchange_rate\": 123,\n  \"reversal_date\": \"2023-12-25\",\n  \"reversal_aging_overrides\": [\n    {\n      \"original_line_id\": 123,\n      \"not_aging_eligible_reason\": \"\"\n    }\n  ],\n  \"related_journal_entry_number\": 123,\n  \"accrual_template_id\": 123,\n  \"book_ids\": [\n    123\n  ],\n  \"attachments\": [],\n  \"record_status\": \"posted\",\n  \"is_adjusting_entry\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dualentry.com/public/v3-alpha/journal-entries/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"items\": [\n    {\n      \"account_number\": 123,\n      \"debit\": 123,\n      \"credit\": 123,\n      \"position\": 123,\n      \"custom_fields\": [\n        {}\n      ],\n      \"not_aging_eligible_reason\": \"\",\n      \"is_billable\": false,\n      \"billable_customer_id\": 123,\n      \"billable_project_id\": 123,\n      \"billable_markup_pct\": 500,\n      \"id\": 123,\n      \"memo\": \"\",\n      \"classifications\": [],\n      \"customer_id\": 123,\n      \"vendor_id\": 123,\n      \"eliminated\": false\n    }\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"custom_fields\": [\n    {}\n  ],\n  \"memo\": \"<string>\",\n  \"reference_number\": \"<string>\",\n  \"exchange_rate\": 123,\n  \"reversal_date\": \"2023-12-25\",\n  \"reversal_aging_overrides\": [\n    {\n      \"original_line_id\": 123,\n      \"not_aging_eligible_reason\": \"\"\n    }\n  ],\n  \"related_journal_entry_number\": 123,\n  \"accrual_template_id\": 123,\n  \"book_ids\": [\n    123\n  ],\n  \"attachments\": [],\n  \"record_status\": \"posted\",\n  \"is_adjusting_entry\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dualentry.com/public/v3-alpha/journal-entries/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"items\": [\n    {\n      \"account_number\": 123,\n      \"debit\": 123,\n      \"credit\": 123,\n      \"position\": 123,\n      \"custom_fields\": [\n        {}\n      ],\n      \"not_aging_eligible_reason\": \"\",\n      \"is_billable\": false,\n      \"billable_customer_id\": 123,\n      \"billable_project_id\": 123,\n      \"billable_markup_pct\": 500,\n      \"id\": 123,\n      \"memo\": \"\",\n      \"classifications\": [],\n      \"customer_id\": 123,\n      \"vendor_id\": 123,\n      \"eliminated\": false\n    }\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"custom_fields\": [\n    {}\n  ],\n  \"memo\": \"<string>\",\n  \"reference_number\": \"<string>\",\n  \"exchange_rate\": 123,\n  \"reversal_date\": \"2023-12-25\",\n  \"reversal_aging_overrides\": [\n    {\n      \"original_line_id\": 123,\n      \"not_aging_eligible_reason\": \"\"\n    }\n  ],\n  \"related_journal_entry_number\": 123,\n  \"accrual_template_id\": 123,\n  \"book_ids\": [\n    123\n  ],\n  \"attachments\": [],\n  \"record_status\": \"posted\",\n  \"is_adjusting_entry\": false\n}"

response = http.request(request)
puts response.read_body

{
  "book_ids": [
    123
  ],
  "internal_id": 123,
  "number": 123,
  "transaction_id": 123,
  "company_id": 123,
  "company_name": "<string>",
  "company_currency": "<string>",
  "memo": "<string>",
  "date": "2023-12-25",
  "transaction_date": "2023-12-25",
  "currency_iso_4217_code": "AED",
  "amount": "<string>",
  "exchange_rate": "<string>",
  "record_status": "draft",
  "is_adjusting_entry": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "custom_fields": [],
  "attachments": [],
  "reversal_items": [],
  "items": [],
  "bank_match_status": "<string>",
  "reconciliation_status": "<string>",
  "created_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "updated_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "approval_status": "<string>",
  "next_approvers": [
    {
      "id": 123,
      "first_name": "<string>",
      "last_name": "<string>",
      "email": "<string>",
      "full_name": "<string>",
      "avatar_url": "<string>"
    }
  ],
  "rejected_by": {
    "id": 123,
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "full_name": "<string>",
    "rejection_reason": "<string>"
  },
  "code": "<string>",
  "reference_number": "<string>",
  "enable_elimination": false,
  "created_by_id": 123,
  "created_by_name": "<string>",
  "reversal_date": "2023-12-25",
  "related_journal_entry_number": 123,
  "accrual_template_id": 123,
  "recurring_record_number": 123,
  "has_more_lines": false,
  "lines_count": 0
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

Journal Entries

Create JournalEntryV2 record

Create a new JournalEntryV2 record with the provided data. Validates all required fields and business rules.

Side effects

If an approval workflow matches this request, DualEntry can set record_status back to draft.
If a line sets eliminated to true, DualEntry writes an elimination transaction in the elimination company, with the date, memo, and status of the entry. If the entry has a reversal, DualEntry writes a second elimination transaction for that reversal, with the date, memo, and status of the reversal.

Additional validations

Fails with 503 if the exchange rate for the transaction date is unavailable.
Fails with 422 and the error code posting_date_after_limit if date is after the latest posting date that your organization allows.
Fails with 422 if a line has both a debit and a credit above 0, or a negative debit or credit.
Fails with 422 and the error code independent_transaction_dates_disabled when transaction_date differs from date and the organization does not have Separate posting and transaction dates enabled.
Fails with 422 if you set an inactive, archived, or draft customer or vendor, or an inactive company.
Fails with 422 if a line account is not available to the line’s company, or to the record’s company when the line sets none.
Fails with 422 if you set the customer or vendor that stands for the record’s own company as a party.
A reference that the record or its linked source record already holds passes these checks.

POST

public

v3-alpha

journal-entries

Create JournalEntryV2 record

curl --request POST \
  --url https://api.dualentry.com/public/v3-alpha/journal-entries/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "date": "2023-12-25",
  "company_id": 123,
  "items": [
    {
      "account_number": 123,
      "debit": 123,
      "credit": 123,
      "position": 123,
      "custom_fields": [
        {}
      ],
      "not_aging_eligible_reason": "",
      "is_billable": false,
      "billable_customer_id": 123,
      "billable_project_id": 123,
      "billable_markup_pct": 500,
      "id": 123,
      "memo": "",
      "classifications": [],
      "customer_id": 123,
      "vendor_id": 123,
      "eliminated": false
    }
  ],
  "transaction_date": "2023-12-25",
  "custom_fields": [
    {}
  ],
  "memo": "<string>",
  "reference_number": "<string>",
  "exchange_rate": 123,
  "reversal_date": "2023-12-25",
  "reversal_aging_overrides": [
    {
      "original_line_id": 123,
      "not_aging_eligible_reason": ""
    }
  ],
  "related_journal_entry_number": 123,
  "accrual_template_id": 123,
  "book_ids": [
    123
  ],
  "attachments": [],
  "record_status": "posted",
  "is_adjusting_entry": false
}
'

import requests

url = "https://api.dualentry.com/public/v3-alpha/journal-entries/"

payload = {
    "date": "2023-12-25",
    "company_id": 123,
    "items": [
        {
            "account_number": 123,
            "debit": 123,
            "credit": 123,
            "position": 123,
            "custom_fields": [{}],
            "not_aging_eligible_reason": "",
            "is_billable": False,
            "billable_customer_id": 123,
            "billable_project_id": 123,
            "billable_markup_pct": 500,
            "id": 123,
            "memo": "",
            "classifications": [],
            "customer_id": 123,
            "vendor_id": 123,
            "eliminated": False
        }
    ],
    "transaction_date": "2023-12-25",
    "custom_fields": [{}],
    "memo": "<string>",
    "reference_number": "<string>",
    "exchange_rate": 123,
    "reversal_date": "2023-12-25",
    "reversal_aging_overrides": [
        {
            "original_line_id": 123,
            "not_aging_eligible_reason": ""
        }
    ],
    "related_journal_entry_number": 123,
    "accrual_template_id": 123,
    "book_ids": [123],
    "attachments": [],
    "record_status": "posted",
    "is_adjusting_entry": False
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    date: '2023-12-25',
    company_id: 123,
    items: [
      {
        account_number: 123,
        debit: 123,
        credit: 123,
        position: 123,
        custom_fields: [{}],
        not_aging_eligible_reason: '',
        is_billable: false,
        billable_customer_id: 123,
        billable_project_id: 123,
        billable_markup_pct: 500,
        id: 123,
        memo: '',
        classifications: [],
        customer_id: 123,
        vendor_id: 123,
        eliminated: false
      }
    ],
    transaction_date: '2023-12-25',
    custom_fields: [{}],
    memo: '<string>',
    reference_number: '<string>',
    exchange_rate: 123,
    reversal_date: '2023-12-25',
    reversal_aging_overrides: [{original_line_id: 123, not_aging_eligible_reason: ''}],
    related_journal_entry_number: 123,
    accrual_template_id: 123,
    book_ids: [123],
    attachments: [],
    record_status: 'posted',
    is_adjusting_entry: false
  })
};

fetch('https://api.dualentry.com/public/v3-alpha/journal-entries/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dualentry.com/public/v3-alpha/journal-entries/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'date' => '2023-12-25',
    'company_id' => 123,
    'items' => [
        [
                'account_number' => 123,
                'debit' => 123,
                'credit' => 123,
                'position' => 123,
                'custom_fields' => [
                                [
                                                                
                                ]
                ],
                'not_aging_eligible_reason' => '',
                'is_billable' => false,
                'billable_customer_id' => 123,
                'billable_project_id' => 123,
                'billable_markup_pct' => 500,
                'id' => 123,
                'memo' => '',
                'classifications' => [
                                
                ],
                'customer_id' => 123,
                'vendor_id' => 123,
                'eliminated' => false
        ]
    ],
    'transaction_date' => '2023-12-25',
    'custom_fields' => [
        [
                
        ]
    ],
    'memo' => '<string>',
    'reference_number' => '<string>',
    'exchange_rate' => 123,
    'reversal_date' => '2023-12-25',
    'reversal_aging_overrides' => [
        [
                'original_line_id' => 123,
                'not_aging_eligible_reason' => ''
        ]
    ],
    'related_journal_entry_number' => 123,
    'accrual_template_id' => 123,
    'book_ids' => [
        123
    ],
    'attachments' => [
        
    ],
    'record_status' => 'posted',
    'is_adjusting_entry' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dualentry.com/public/v3-alpha/journal-entries/"

	payload := strings.NewReader("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"items\": [\n    {\n      \"account_number\": 123,\n      \"debit\": 123,\n      \"credit\": 123,\n      \"position\": 123,\n      \"custom_fields\": [\n        {}\n      ],\n      \"not_aging_eligible_reason\": \"\",\n      \"is_billable\": false,\n      \"billable_customer_id\": 123,\n      \"billable_project_id\": 123,\n      \"billable_markup_pct\": 500,\n      \"id\": 123,\n      \"memo\": \"\",\n      \"classifications\": [],\n      \"customer_id\": 123,\n      \"vendor_id\": 123,\n      \"eliminated\": false\n    }\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"custom_fields\": [\n    {}\n  ],\n  \"memo\": \"<string>\",\n  \"reference_number\": \"<string>\",\n  \"exchange_rate\": 123,\n  \"reversal_date\": \"2023-12-25\",\n  \"reversal_aging_overrides\": [\n    {\n      \"original_line_id\": 123,\n      \"not_aging_eligible_reason\": \"\"\n    }\n  ],\n  \"related_journal_entry_number\": 123,\n  \"accrual_template_id\": 123,\n  \"book_ids\": [\n    123\n  ],\n  \"attachments\": [],\n  \"record_status\": \"posted\",\n  \"is_adjusting_entry\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dualentry.com/public/v3-alpha/journal-entries/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"items\": [\n    {\n      \"account_number\": 123,\n      \"debit\": 123,\n      \"credit\": 123,\n      \"position\": 123,\n      \"custom_fields\": [\n        {}\n      ],\n      \"not_aging_eligible_reason\": \"\",\n      \"is_billable\": false,\n      \"billable_customer_id\": 123,\n      \"billable_project_id\": 123,\n      \"billable_markup_pct\": 500,\n      \"id\": 123,\n      \"memo\": \"\",\n      \"classifications\": [],\n      \"customer_id\": 123,\n      \"vendor_id\": 123,\n      \"eliminated\": false\n    }\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"custom_fields\": [\n    {}\n  ],\n  \"memo\": \"<string>\",\n  \"reference_number\": \"<string>\",\n  \"exchange_rate\": 123,\n  \"reversal_date\": \"2023-12-25\",\n  \"reversal_aging_overrides\": [\n    {\n      \"original_line_id\": 123,\n      \"not_aging_eligible_reason\": \"\"\n    }\n  ],\n  \"related_journal_entry_number\": 123,\n  \"accrual_template_id\": 123,\n  \"book_ids\": [\n    123\n  ],\n  \"attachments\": [],\n  \"record_status\": \"posted\",\n  \"is_adjusting_entry\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dualentry.com/public/v3-alpha/journal-entries/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"items\": [\n    {\n      \"account_number\": 123,\n      \"debit\": 123,\n      \"credit\": 123,\n      \"position\": 123,\n      \"custom_fields\": [\n        {}\n      ],\n      \"not_aging_eligible_reason\": \"\",\n      \"is_billable\": false,\n      \"billable_customer_id\": 123,\n      \"billable_project_id\": 123,\n      \"billable_markup_pct\": 500,\n      \"id\": 123,\n      \"memo\": \"\",\n      \"classifications\": [],\n      \"customer_id\": 123,\n      \"vendor_id\": 123,\n      \"eliminated\": false\n    }\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"custom_fields\": [\n    {}\n  ],\n  \"memo\": \"<string>\",\n  \"reference_number\": \"<string>\",\n  \"exchange_rate\": 123,\n  \"reversal_date\": \"2023-12-25\",\n  \"reversal_aging_overrides\": [\n    {\n      \"original_line_id\": 123,\n      \"not_aging_eligible_reason\": \"\"\n    }\n  ],\n  \"related_journal_entry_number\": 123,\n  \"accrual_template_id\": 123,\n  \"book_ids\": [\n    123\n  ],\n  \"attachments\": [],\n  \"record_status\": \"posted\",\n  \"is_adjusting_entry\": false\n}"

response = http.request(request)
puts response.read_body

{
  "book_ids": [
    123
  ],
  "internal_id": 123,
  "number": 123,
  "transaction_id": 123,
  "company_id": 123,
  "company_name": "<string>",
  "company_currency": "<string>",
  "memo": "<string>",
  "date": "2023-12-25",
  "transaction_date": "2023-12-25",
  "currency_iso_4217_code": "AED",
  "amount": "<string>",
  "exchange_rate": "<string>",
  "record_status": "draft",
  "is_adjusting_entry": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "custom_fields": [],
  "attachments": [],
  "reversal_items": [],
  "items": [],
  "bank_match_status": "<string>",
  "reconciliation_status": "<string>",
  "created_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "updated_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "approval_status": "<string>",
  "next_approvers": [
    {
      "id": 123,
      "first_name": "<string>",
      "last_name": "<string>",
      "email": "<string>",
      "full_name": "<string>",
      "avatar_url": "<string>"
    }
  ],
  "rejected_by": {
    "id": 123,
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "full_name": "<string>",
    "rejection_reason": "<string>"
  },
  "code": "<string>",
  "reference_number": "<string>",
  "enable_elimination": false,
  "created_by_id": 123,
  "created_by_name": "<string>",
  "reversal_date": "2023-12-25",
  "related_journal_entry_number": 123,
  "accrual_template_id": 123,
  "recurring_record_number": 123,
  "has_more_lines": false,
  "lines_count": 0
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

Authorizations

X-API-KEY

string

header

required

Headers

Idempotency-Key

string

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Maximum string length: 255

Query Parameters

apply_default_classifications

boolean

default:true

When false, store submitted line classifications, including an empty list. When omitted, organization defaults apply to new lines with omitted or empty classifications only when the organization setting is enabled.

Body

application/json

date

string<date>

required

company_id

integer

required

items

PublicJournalEntryItemIn · object[] | null

Show child attributes

transaction_date

string<date> | null

custom_fields

Custom Fields · object[] | null

memo

string | null

reference_number

string | null

Required string length: 1 - 128

currency_iso_4217_code

enum<string> | null

Available options:

AED,

AFN,

ALL,

AMD,

ANG,

AOA,

ARS,

AUD,

AWG,

AZN,

BAM,

BBD,

BDT,

BGN,

BHD,

BIF,

BMD,

BND,

BOB,

BRL,

BSD,

BTN,

BWP,

BYN,

BZD,

CAD,

CDF,

CHF,

CLF,

CLP,

CNY,

COP,

CRC,

CUP,

CVE,

CZK,

DJF,

DKK,

DOP,

DZD,

EGP,

ERN,

ETB,

EUR,

FJD,

FKP,

GBP,

GEL,

GHS,

GIP,

GMD,

GNF,

GTQ,

GYD,

HKD,

HNL,

HTG,

HUF,

IDR,

ILS,

INR,

IQD,

IRR,

ISK,

JMD,

JOD,

JPY,

KES,

KGS,

KHR,

KMF,

KPW,

KRW,

KWD,

KYD,

KZT,

LAK,

LBP,

LKR,

LRD,

LSL,

LYD,

MAD,

MDL,

MGA,

MKD,

MMK,

MNT,

MOP,

MRU,

MUR,

MVR,

MWK,

MXN,

MYR,

MZN,

NAD,

NGN,

NIO,

NOK,

NPR,

NZD,

OMR,

PAB,

PEN,

PGK,

PHP,

PKR,

PLN,

PYG,

QAR,

RON,

RSD,

RUB,

RWF,

SAR,

SBD,

SCR,

SDG,

SEK,

SGD,

SHP,

SLL,

SOS,

SRD,

STN,

SVC,

SYP,

SZL,

THB,

TJS,

TMT,

TND,

TOP,

TRY,

TTD,

TWD,

TZS,

UAH,

UGX,

USD,

UYU,

UZS,

VES,

VND,

VUV,

WST,

XAF,

XAG,

XAU,

XCD,

XDR,

XOF,

XPD,

XPF,

XPT,

YER,

ZAR,

ZMW,

ZWL

exchange_rate

If you omit this field or send null, DualEntry calculates the rate from the company base currency, the transaction currency, and the transaction date. A date of today or later uses the rate for yesterday (UTC). A rate you send is stored, including 1.0.

reversal_date

string<date> | null

reversal_aging_overrides

JournalEntryReversalAgingOverrideIn · object[] | null

Show child attributes

Number of the journal entry this entry reverses or relates to.

accrual_template_id

integer | null

book_ids

integer[] | null

Accounting book ids. Omit to assign every active book.

attachments

AttachmentSchemaOut · object[]

Show child attributes

record_status

enum<string>

default:posted

Available options:

draft,

posted,

archived

is_adjusting_entry

boolean

default:false

Marks the journal entry as an adjusting entry. Omit on update to keep the stored value.

Response

book_ids

integer[]

required

internal_id

integer

required

number

integer

required

transaction_id

integer

required

company_id

integer

required

company_name

string

required

company_currency

string

required

memo

string

required

date

string<date>

required

Posting date (GL date) - the date when the transaction is recorded in the general ledger

transaction_date

string<date>

required

Transaction date (inception date) - the date when the transaction actually occurred

currency_iso_4217_code

enum<string>

required

Available options:

AED,

AFN,

ALL,

AMD,

ANG,

AOA,

ARS,

AUD,

AWG,

AZN,

BAM,

BBD,

BDT,

BGN,

BHD,

BIF,

BMD,

BND,

BOB,

BRL,

BSD,

BTN,

BWP,

BYN,

BZD,

CAD,

CDF,

CHF,

CLF,

CLP,

CNY,

COP,

CRC,

CUP,

CVE,

CZK,

DJF,

DKK,

DOP,

DZD,

EGP,

ERN,

ETB,

EUR,

FJD,

FKP,

GBP,

GEL,

GHS,

GIP,

GMD,

GNF,

GTQ,

GYD,

HKD,

HNL,

HTG,

HUF,

IDR,

ILS,

INR,

IQD,

IRR,

ISK,

JMD,

JOD,

JPY,

KES,

KGS,

KHR,

KMF,

KPW,

KRW,

KWD,

KYD,

KZT,

LAK,

LBP,

LKR,

LRD,

LSL,

LYD,

MAD,

MDL,

MGA,

MKD,

MMK,

MNT,

MOP,

MRU,

MUR,

MVR,

MWK,

MXN,

MYR,

MZN,

NAD,

NGN,

NIO,

NOK,

NPR,

NZD,

OMR,

PAB,

PEN,

PGK,

PHP,

PKR,

PLN,

PYG,

QAR,

RON,

RSD,

RUB,

RWF,

SAR,

SBD,

SCR,

SDG,

SEK,

SGD,

SHP,

SLL,

SOS,

SRD,

STN,

SVC,

SYP,

SZL,

THB,

TJS,

TMT,

TND,

TOP,

TRY,

TTD,

TWD,

TZS,

UAH,

UGX,

USD,

UYU,

UZS,

VES,

VND,

VUV,

WST,

XAF,

XAG,

XAU,

XCD,

XDR,

XOF,

XPD,

XPF,

XPT,

YER,

ZAR,

ZMW,

ZWL

amount

string

required

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

exchange_rate

string

required

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,16}0*$

record_status

enum<string>

required

Available options:

draft,

posted,

archived

is_adjusting_entry

boolean

required

created_at

string<date-time>

required

Date and time the record was created

updated_at

string<date-time>

required

Date and time the record was last updated

custom_fields

CustomFieldValuePairOutputSchema · object[]

Show child attributes

attachments

PublicAttachmentSchemaOut · object[]

Show child attributes

reversal_items

PublicJournalEntryItemOut · object[]

deprecated

Deprecated: superseded by reversal_date plus reversal_line_id/reversal_entry_id on each line in items. Capped at 100 rows; a reversal always mirrors every line, so lines_count is also its total.

Show child attributes

items

PublicJournalEntryV2ItemOut · object[]

Show child attributes

bank_match_status

string | null

reconciliation_status

string | null

created_by

AuditActorSchemaOut · object | null

Schema for audit actor information.

Show child attributes

updated_by

AuditActorSchemaOut · object | null

Schema for audit actor information.

Show child attributes

approval_status

string | null

next_approvers

ApproverDictSchema · object[] | null

Show child attributes

rejected_by

RejectedBySchema · object | null

Schema for rejector information including rejection reason.

Show child attributes

code

string | null

reference_number

string | null

enable_elimination

boolean

default:false

created_by_id

integer | null

created_by_name

string | null

reversal_date

string<date> | null

Posting date of the reversal, or null when the journal entry is not reversed. Mirrors the reversal_date accepted on create/update.

accrual_template_id

integer | null

recurring_record_number

integer | null

has_more_lines

boolean

default:false

lines_count

integer

default:0

Overview

Organization

Accounting Setup

Transactions

Money In

Money Out

Financial & Banking

Assets

Tax

Financial Planning

Reporting

Governance

Developers

Monitoring

OAuth

Create JournalEntryV2 record

Authorizations

Headers

Query Parameters

Body

Response