FAfactorialhr
Finance > JournalEntry

Creates a Journal entry

Changed on

Creates a Journal entry

post/api/2026-10-01/resources/finance/journal_entries

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/journal_entries
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: finance
    • or API key in header x-api-key

Request body

external_idstring

External identifier for the journal entry

legal_entity_idstring required

The associated Legal Entity ID

type'bank' | 'bill' | 'invoice' | 'credit_note' | 'merged_ledger_account' | 'reconciliation' | 'tax' | 'receipt' | 'payroll_result' | 'external'

Journal entry type (e.g. bank, invoice, tax)

reference_datestring required

Date of the associate source

descriptionstring

Description of the journal entry

status'published' | 'reversed'

Status of the journal entry (reversed, published, etc.)

Example request

{
  "external_id": "EXT-001",
  "legal_entity_id": "1001",
  "type": "external",
  "lines": [
    {
      "account_id": 9876,
      "debit_amount_cents": 0,
      "credit_amount_cents": 100,
      "external_id": "LINE-001"
    },
    {
      "account_id": 9876,
      "debit_amount_cents": 100,
      "credit_amount_cents": 0,
      "external_id": "LINE-002"
    }
  ],
  "reference_date": "2025-01-01",
  "description": "Payment for invoice",
  "status": "published"
}

Response

CREATED

idstring required

Journal entry ID

numberinteger required

Incremental number assigned to the journal entry

published_atstring required

Timestamp when the journal entry was published.

type'bank' | 'bill' | 'invoice' | 'credit_note' | 'merged_ledger_account' | 'reconciliation' | 'tax' | 'receipt' | 'payroll_result' | 'external' required

Journal entry type (e.g. bank, invoice, tax)

source_idstring

Source id related with this journal entry

source_type'bank_transaction' | 'invoice' | 'reconciliation' | 'finance_reconciliation' | 'account' | 'expense' | 'payroll_result' | 'journal_entry'

Source type related with this journal entry

reference_datestring required

Date of the associate source

descriptionstring

Description of the journal entry

legal_entity_idstring required

The associated Legal Entity ID

external_idstring

External identifier for the journal entry

status'published' | 'reversed' required

The status of the journal entry (draft, published, etc.)

updated_atstring required

Timestamp when the journal entry was last updated.

Example response

{
  "id": "4321",
  "number": 1,
  "published_at": "2025-01-01T00:00:00.000Z",
  "type": "bank",
  "source_id": "15",
  "source_type": "bank_transaction",
  "reference_date": "2025-01-01",
  "description": "Payment for invoice",
  "legal_entity_id": "1001",
  "external_id": "EXT-001",
  "status": "published",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Changes